云函数快速入门

云函数是一项Serverless计算服务，提供FaaS（Function as a Service）能力，一方面云函数将开发测试的对象聚焦到函数级别，可以帮助您大幅简化应用开发与运维相关的事务，另一方面您可以通过在应用中集成云函数SDK，便捷操作云数据库、云存储等，提升业务功能构建的便利性。云函数可以根据函数的实际流量对函数进行弹性伸缩，您无需对服务器资源进行管理，解决了开发者运维管理的难题。

主要功能

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

典型应用场景

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

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

版本更新说明

当前版本： [3.X]2.1.3_1.9.1.300
- 升级sdk版本。
0.5.0_1.4.1.300
- 集成华为 AGC 云函数服务。

一键接入云函数服务

开通服务

确保云函数服务测试资格申请已通过。
使用 Cocos Creator 打开需要接入云函数服务的项目工程。
点击菜单栏的 面板 -> 服务，打开服务面板，在 HUAWEI AppGallery Connect 下选择 云函数，进入服务详情页。然后点击右上方的启用按钮即可开通服务。

配置华为参数文件

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

登录 AppGallery Connect 后台，在 项目列表 -> 应用列表 中找到对应的应用。
在 项目设置 页面的应用区域，点击 agconnect-services.json 下载配置文件。agconnect-services.json 文件在下载或者更新完成后，必须手动拷贝 到工程目录的 settings 目录下。
Cocos Creator v2.4.3 及以上版本，若发布到 HUAWEI AppGallery Connect，开发者可直接在 构建发布 面板中选取下载或更新后的配置文件，不需要手动拷贝。

Sample 工程

开发者可以通过 Sample 工程快速体验云函数服务。

点击云函数服务面板中的 Sample 工程 按钮，Clone 或下载 HUAWEI Sample 工程，并在 Cocos Creator 中打开。
可根据华为文档创建并配置函数
参照上文开通云函数服务并配置华为参数文件后，可通过 Creator 编辑器菜单栏的 项目 -> 构建发布 打开 构建发布 面板来构建编译工程。Creator v2.4.1 及以上版本，可发布到 HUAWEI AppGallery Connect。Creator v2.4.1 以下的版本可发布到 Android 平台。
Sample 工程运行到手机后，点击首页的 Function 按钮，即可进入功能界面进行测试。
Sample 工程对应的云函数代码,可配置到华为agc后台

let myHandler = function (event, context, callback, logger) {
    var res = new context.HTTPResponse(context.env, {
        "res-type": "context.env",
        "faas-content-type": "json",
    }, "application/json", "200");


    if (event.body != null && event.body !="" && event.body !="{}" ) {
        let _body = {
            code:"200",
            msg: "云函数调用成功",
            hasParam: "携带参数",
            paramType: "参数类型: "+typeof (event.body),
            param: JSON.parse(event.body),
        }
        res.body = _body;
        context.callback(res);
    } else {
        let _body = {
            code:"200",
            msg: "云函数调用成功",
            hasParam: "未携带参数",
            paramType: "无",
            param: null,
        }
        res.body = _body;
        context.callback(res);
    }
}
module.exports.func = myHandler;

开发指南

本文档对应华为云函数服务 — 调用函数。

通过 wrap 方法设置函数，在方法中传入触发器标识。

wrap(trigger: string): AGCFunctionCallable

示例：

var function = huawei.agc.func.AGCFunctionService.wrap("func-$latest");

再通过 call 方法调用函数。

call(cb: FunctionCallback, param = {}): void

示例：

// without params
function.call((err, data) => {
    if (err !== null) {
        console.log("Cloud Function", `error: ${JSON.stringify(err)}`);
    }
    console.log("Cloud Function", `result: ${JSON.stringify(data)}`);
});

// with params
function.call((err, data) => {
    if (err !== null) {
        console.log("Cloud Function", `error: ${JSON.stringify(err)}`);
    }
    console.log("Cloud Function", `result: ${JSON.stringify(data)}`);
}, {
    param1: "value1",
    param2: {
        param3: "value3",
        param4: 123
    }
});

其他

详细的功能接口和 API 说明，请参考华为云函数相关开发文档。

云函数（AGC）