3D建模

Cocos Service：云函数（AppGallery Connect）快速入门

ygtu

Jun 20, 2023 • 6 min read

推荐：将NSDT场景编辑器加入你的3D工具链

3D工具集：NSDT简石数字孪生

云函数（AppGallery Connect）快速入门

华为 AppGallery Connect（简称 AGC）云函数是一项 Serverless 计算服务，提供 FaaS（Function as a Service）能力，可以帮助开发者大幅简化应用开发与运维相关的事务，降低应用功能的实现门槛，快速构建业务能力。

主要功能

云函数提供了高效可靠的函数开发与运行框架，替开发者完全解决传统应用开发与运维中的诸多复杂事务（如服务器配置与管理、代码部署、负载均衡、弹性伸缩、高可用保证等等），开发者只需聚焦业务逻辑、开发并上传函数代码，即可构建高可用性、可伸缩的 Serverless 应用。
云函数作为 Serverless 的核心与枢纽，方便连接和扩展周边云服务，开发者可以像拼搭积木一样自由便捷地组织各项服务来实现业务逻辑。

典型应用场景

通过云函数，开发者能够运行函数代码以响应关注的事件，典型的应用场景大致可分为以下几类：

向用户发送某些事件通知
执行数据库清理和维护任务
在云端执行密集型任务
集成第三方服务和 API

申请测试资格

云函数服务当前仍处于 Beta 测试状态，若要使用该服务，开发者需要发送申请开通服务的邮件到邮箱 agconnect@huawei.com。

邮件标题请使用 [云函数]-[公司名称]-[开发者帐号 ID]-[项目 ID] 格式，开发者帐号 ID 及 项目 ID 的获取可参考文档查询开发者帐号 ID 及项目 ID。在收到开发者的申请后，华为运营人员会在 1-3 个工作日内答复。

如何收费

目前云函数服务处于 Beta 测试阶段，开发者可以免费使用。华为会在正式收费前一个月邮件通知并公告相关策略及费率。

版本更新说明

当前版本：0.5.0_1.4.1.300

集成华为 AGC 云函数服务。

一键接入云函数服务

开通服务

确保云函数服务测试资格申请已通过。
使用 Cocos Creator 打开需要接入云函数服务的项目工程。

点击菜单栏的 面板 -> 服务，打开服务面板，选择 云函数，进入服务详情页。然后点击右上方的启用按钮即可开通服务。详情可参考服务面板操作指南。

配置华为参数文件

大部分的华为相关项目都需要用到 agconnect-services.json 配置文件。若有新开通服务等操作，请及时更新该文件。

在 项目设置 页面的应用区域，点击 agconnect-services.json 下载配置文件。agconnect-services.json 文件在下载或者更新完成后，必须手动拷贝 到工程目录的 settings 目录下。

Cocos Creator v2.4.3 及以上版本，若发布到 HUAWEI AppGallery Connect，开发者可直接在 构建发布 面板中选取下载或更新后的配置文件，不需要手动拷贝。

验证服务是否接入成功

参考创建函数文档，在 AppGallery Connect 后台创建函数并完成函数定义，可直接使用 AGC 默认提供的 myHandler 函数代码。然后参考应用客户端调用查询并获取触发器标识。

参考上文开通云函数服务后，我们便可以通过在脚本中添加简单的代码，来验证接入是否成功。以获取到的触发器标识为 test-$latest 为例：

  huawei.agc.func.AGCFunctionService.wrap("test-$latest").call((err, data) => {
      if (err !== null) {
          console.log("Cloud Function", `error: ${JSON.stringify(err)}`);
      }
      console.log("Cloud Function", `result: ${JSON.stringify(data)}`);
  });