Web 端初始化

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

  1. function cloud.Cloud(options): Cloud

options 参数定义:

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

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

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

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

  1. const a = new cloud.Cloud({
  2. appid: '公众号 AppID',
  3. resourceAppid: '小程序 AppID',
  4. resourceEnv: 'a', // 资源方云环境 ID
  5. traceUser: true,
  6. })
  7. // init 过程中,资源方小程序对应环境下的 cloudbase_auth 函数会被调用,并需返回协议字段(见下)来确认允许访问、以及可自定义安全规则
  8. await a.init()
  9. // 可以调用云开发 API 访问云资源了,如
  10. const res = await a.callFunction({
  11. name: 'test',
  12. data: {
  13. // ...
  14. },
  15. })

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

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

  1. const a = new cloud.Cloud({
  2. identityless: true,
  3. resourceAppid: '小程序 AppID',
  4. resourceEnv: 'a',
  5. })
  6. // 不同于登录模式,在未登录模式中,资源方小程序对应环境下的 cloudbase_auth 不会被调用,但此处 init 也是必须的。
  7. await a.init()
  8. // 可以调用云开发 API 访问云资源了,如
  9. const res = await a.callFunction({
  10. name: 'test',
  11. data: {
  12. // ...
  13. },
  14. })