@hw-agconnect/function-ohos NPM

AGConnect 云函数

简介

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

下载安装

ohpm install @hw-agconnect/function-ohos

OpenHarmony ohpm 环境配置等更多内容，请参考如何安装 OpenHarmony ohpm 包

使用说明

import agconnect from "@hw-agconnect/api-ohos";
import "@hw-agconnect/core-ohos";
import "@hw-agconnect/function-ohos";

需要权限

ohos.permission.INTERNET

使用示例

初始化

在您的项目中导入agc组件。

import agconnect from '@hw-agconnect/api-ohos';
import "@hw-agconnect/core-ohos";
import "@hw-agconnect/function-ohos";

在您的应用初始化阶段使用context初始化SDK，推荐在MainAbility 的onCreate中进行。

  //初始化SDK
  onCreate(want, launchParam) {
    //务必保证resources/rawfile中包含agconnect-services.json文件
    agconnect.instance().init(this.context.getApplicationContext());
  }

访问云函数

应用集成了云函数SDK后，可以在应用内直接通过SDK API调用AGC中的云函数，云函数SDK与AGC的函数调用基于HTTPS的安全访问。

调用wrap方法设置函数，在方法中传入触发器标识，返回得到可执行云函数的对象。
```
let functionCallable = agconnect.function().wrap("myhandlerxxxx-$latest");
```
（可选）可以通过设置timeout属性对云函数设置超时时长，单位为毫秒。
```
functionCallable.timeout = 3000;
```
调用call方法运行云函数。如果函数有入参，可以将参数转化为JSON对象或JSON字符串传入，如果没有参数则不传。
```
let functionResult = await functionCallable.call(reqBody);
```
如果您需要关注函数的返回值，可调用getValue方法获取。
```
let returnValue = functionResult.getValue();
```