云函数（AGC）

业务介绍

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

主要功能

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

应用场景

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

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

申请开通服务

函数服务当前仍处于Beta开放状态，在使用此服务前，您需要向agconnect@huawei.com发送申请邮件，申请开通云函数服务。

邮件标题请使用如下格式：“[云函数]-[公司名称]-[开发者帐号ID]-[项目ID]”，开发者帐号ID及项目ID查询方法可参见查询开发者帐号ID及项目ID。

在收到您的申请后，华为运营人员会在1-3个工作日内给您答复。

如何收费

云函数属于资源消耗型服务，未来会基于调用次数、内存和网络占用情况来进行收费。目前云函数功能处于Beta测试期间，您可以免费使用。我们会在正式收费前一个月邮件通知并公告相关策略及费率。

华为账号设置

使用入门

一个典型的函数开发流程如下：

集成SDK：如果需要在应用客户端中调用云函数，则必须集成云函数的客户端SDK。
创建函数：需要在AGC中创建函数，并添加函数执行的代码。
测试函数：AGC提供了函数测试功能，可以直接测试函数代码。
调用函数：创建函数后可以在需要触发函数功能时调用函数，支持触发器调用和应用客户端调用。
监控函数：AGC提供了函数监控功能，可以查看函数的调用次数、执行成功率等。

集成云函数SDK

在将Cloud Function SDK集成到您的应用程序之前，您必须先集成AppGallery Connect SDK和插件。有关详细信息，请参阅AppGallery Connect快速入门。

创建函数

登录AppGallery Connect网站，点击 我的项目。
在项目列表中找到您的项目，在项目下的应用列表中选择您的应用。
选择 构建 > 云函数，进入 Cloud Functions 页面。
如果云函数尚未开通，需点击 立即开通 。

注意：

由于开通服务时可能需要设置数据存储位置，设置数据存储位置后会刷新 agconnect-services.json 文件里的配置。如果您开通服务时设置了数据存储位置，在开通完成后您需要重新下载 agconnect-services.json 文件并集成到您的工程中，具体操作参见添加配置文件。
在Unity Application中配置json文件。

将agconnect-services.json文件复制到Unity项目的Assets/Plugins/Android文件夹。
在函数页面，点击 创建函数。
在创建界面中，完成函数定义。
- “函数名称”和“描述”栏输入函数名称与描述。
- “代码输入类型”选择“在线编辑”或“*.zip文件”，选择“在线编辑”可以直接在“代码文件”中编辑函数的代码，AGC提供了默认的myHandler函数代码可供您编辑时参考。
- “部署信息”中输入部署信息，可使用默认配置。
- “环境变量”中输入调用函数时需要传入的变量信息。
有关函数的详细配置信息说明，请参见配置函数。有关函数代码的编辑方法，请参考编程模型。

下面的示例代码实现单个Sum函数：
```
//handler.js is a demo for handler function.
   
let myHandler = function(event, context, callback, logger) {
       
    let res = new context.HTTPResponse(context.env, {
        "res-type": "context.env", 
        "faas-content-type": "json"
    }, "application/json", "200");
   
    var number; 
    if (event.body) { 
        var _body = JSON.parse(event.body); 
        number = _body.number; 
    } else {
        number = event.number; 
    }
    var sum = number.number2 + number.number1;
      
    res.body = {
        "result": sum
    };
    context.callback(res);
};
   
module.exports.myHandler = myHandler;
   
```
函数创建完成后，点击保存。

创建Unity CloudFunction Android应用程序

设置 unity 自定义Android manifest and gradle

在player setting中将平台切换到android
在player setting中启用 custom manifest and gradle. 以下版本是unity 2019.4

安卓的结构在 Unity **2019.3 **版本进行了更新, manifest 和 gradle 被分到了多个文件 (Main, Launcher & Base)。
设置Package name

在 Edit -> Project Settings -> Player -> Android(icon) -> other settings -> Identification -> Package Name 中设置Package name。

Package Name即为华为项目中应用程序的Package Name。

启用配置并将其添加到项目Gradle

进入 Edit -> Project Settings -> Player -> Android(icon) -> Publishing Settings -> Build

启用 Custom Base Gradle Template 并在文件中添加 AppGallery Connect plugin 和 Maven repository。路径是Assets/Plugins/Android/baseProjectTemplate.gradle。

    allprojects {
        buildscript {
            repositories {
...
                maven { url 'https://developer.huawei.com/repo/' }
            }
           dependencies {
                classpath 'com.android.tools.build:gradle:3.4.0'
                classpath 'com.huawei.agconnect:agcp:1.4.1.300'
           }
...
        }
...
        repositories {
...
            maven { url 'https://developer.huawei.com/repo/' }
...
        }
    }

启用配置并将其添加到应用程序gradle

进入 Edit -> Project Settings -> Player -> Android(icon) -> Publishing Settings -> Build，启用 Custom Launcher Gradle Template 并在 launcherTemplate.gradle 中添加依赖。路径为 Assets/Plugins/Android/LauncherTemplate.gradle。

apply plugin: 'com.huawei.agconnect'

dependencies {
...
   implementation project(':unityLibrary')
   implementation 'com.android.support:appcompat-v7:28.0.0'
...
   }

添加CloudFunction Kit：

  dependencies {
…
   implementation 'com.huawei.agconnect:agconnect-core:1.6.1.300'
   implementation "com.huawei.agconnect:agconnect-function:1.6.1.300"
   implementation 'com.fasterxml.jackson.core:jackson-databind:2.8.5'
   implementation 'com.fasterxml.jackson.core:jackson-core:2.8.5'
   implementation 'com.fasterxml.jackson.core:jackson-annotations:2.8.5'
...
}

早期版本

如果Unity版本是2019.2或更早版本，则应在MainGradleTemplate.gradle中添加工具和其他配置。

buildscript {
            repositories {
...
                maven { url 'https://developer.huawei.com/repo/' }
...
            }
        dependencies {
            classpath 'com.android.tools.build:gradle:3.4.0'
            classpath 'com.huawei.agconnect:agcp:1.4.1.300'
       }

...
        }
…
allprojects {
        repositories {
...
            maven { url 'https://developer.huawei.com/repo/' }
...
        }
    }
…
apply plugin: 'com.huawei.agconnect'

dependencies {
...
   implementation 'com.android.support:appcompat-v7:28.0.0'
   implementation 'com.android.support:appcompat-v7:28.0.0'
   implementation 'com.huawei.agconnect:agconnect-core:1.6.1.300'
   implementation "com.huawei.agconnect:agconnect-function:1.6.1.300"
   implementation 'com.fasterxml.jackson.core:jackson-databind:2.8.5'
   implementation 'com.fasterxml.jackson.core:jackson-core:2.8.5'
   implementation 'com.fasterxml.jackson.core:jackson-annotations:2.8.5'
...
   }

SDK集成开发

设置场景

新建一个场景
右键单击并选择UI，然后选择button:
将Component添加到button并开发脚本：
编辑脚本:

双击脚本文件，然后您将在VS code中打开它
使用CloudFunction 接口

定义将用作输入和输出参数的模型类。

初始化AGConnectFunction实例，并使用上面创建的http触发器调用Wrap。然后，创建一个异步任务，并绑定onCompleteListener以处理函数结果。
绑定脚本中的按钮和界面
- 步骤1：点击“ +”添加功能
- 步骤2：选择具有您要使用的界面的对应场景
- 步骤3：单击“No Function”以选择脚本，然后选择相应的函数