Web 端初始化

Web 端初始化

web 端初始化应使用 new cloud.Cloud 方法，使用 new cloud.Cloud 新建 Cloud 实例时需要指定云环境 ID，方法定义如下

function cloud.Cloud(options): Cloud

options 参数定义：

字段	数据类型	必填	默认值	说明
appid	string	否		公众号 AppID，公众号网页、使用公众号登录态时必填
resourceAppid	string	是		小程序 AppID，指定接下来调用 API 时访问小程序的云开发资源
resourceEnv	string	是		环境ID，指定接下来调用 API 时访问哪个环境的云资源
identityless	boolean	是	false	是否使用未登录模式访问，如果是，必填 true
traceUser	boolean	否	true	是否在将用户访问记录到用户管理中，在控制台中可见

在新建完成实例后，必须先调用初始化方法 init 一次（只需一次，多次调用时只有第一次生效）。

公众号网页中使用的示例代码：

注意：在公众号网页中使用，必须先完成云开发公众号网页授权登录，详见文档。

const a = new cloud.Cloud({
  appid: '公众号 AppID',
  resourceAppid: '小程序 AppID',
  resourceEnv: 'a', // 资源方云环境 ID
  traceUser: true,
})

// init 过程中，资源方小程序对应环境下的 cloudbase_auth 函数会被调用，并需返回协议字段（见下）来确认允许访问、以及可自定义安全规则
await a.init()

// 可以调用云开发 API 访问云资源了，如
const res = await a.callFunction({
  name: 'test',
  data: {
    // ...
  },
})

任意网页中未登录模式的使用示例：

注意：在网页中使用未登录模式，需在控制台中开启允许未登录访问，详见文档。

const a = new cloud.Cloud({
  identityless: true,
  resourceAppid: '小程序 AppID',
  resourceEnv: 'a',
})
// 不同于登录模式，在未登录模式中，资源方小程序对应环境下的 cloudbase_auth 不会被调用，但此处 init 也是必须的。
await a.init()

// 可以调用云开发 API 访问云资源了，如
const res = await a.callFunction({
  name: 'test',
  data: {
    // ...
  },
})