初始化

@cloudbase/js-sdk 让您可以在 Web 端（如 PC Web 页面、微信公众平台 H5 等）使用 JavaScript 访问 Cloudbase 服务和资源。

提示

当前@cloudbase/js-sdk@latest 版本已升级至 v2 版本，若需使用 v1 版本，请参考v1 文档。

安装并初始化

安装 SDK

包管理器

# npm
npm install @cloudbase/js-sdk -S

# yarn
yarn add @cloudbase/js-sdk

初始化 SDK

import cloudbase from "@cloudbase/js-sdk";

const app = cloudbase.init({
  env: "your-env-id", // 替换为您的环境id
  region: "ap-shanghai", // 不传默认为上海地域
});

CDN 全量引入

提示

${version} 设置为 latest 表示使用最新版本

<script src="//static.cloudbase.net/cloudbase-js-sdk/${version}/cloudbase.full.js"></script>
<script>
  const app = cloudbase.init({
    env: "your-env-id", // 替换为您的环境id
    region: "ap-shanghai", // 不传默认为上海地域
  });
</script>

CDN 按需引入

提示

${version} 设置为 latest 表示使用最新版本

<!-- 内核 -->
<script src="//static.cloudbase.net/cloudbase-js-sdk/${version}/cloudbase.js"></script>
<!-- 登录模块 -->
<script src="//static.cloudbase.net/cloudbase-js-sdk/${version}/cloudbase.auth.js"></script>
<!-- 云函数模块 -->
<script src="//static.cloudbase.net/cloudbase-js-sdk/${version}/cloudbase.functions.js"></script>
<!-- 云存储模块 -->
<script src="//static.cloudbase.net/cloudbase-js-sdk/${version}/cloudbase.storage.js"></script>
<!-- 数据库模块 -->
<script src="//static.cloudbase.net/cloudbase-js-sdk/${version}/cloudbase.database.js"></script>
<!-- 实时推送模块，引入前必须首先引入数据库模块 -->
<script src="//static.cloudbase.net/cloudbase-js-sdk/${version}/cloudbase.realtime.js"></script>
<script>
  // 注册功能模块
  registerAuth(cloudbase);
  registerFunctions(cloudbase);
  registerStorage(cloudbase);
  registerDatabase(cloudbase);
  registerRealtime(cloudbase);
  registerModel(cloudbase);
  registerAi(cloudbase);

  const app = cloudbase.init({
    env: "your-env-id", // 替换为您的环境id
    region: "ap-shanghai", // 不传默认为上海地域
  });
</script>

💡 注意：功能模块必须在内核之后引入，并且登录模块必须引入

最新的版本号 version 可以前往 NPM 查看。

初始化参数

字段	类型	必填	默认值	说明
env	string	是	-	TCB 环境 ID
region	string	否	ap-shanghai	地域：ap-shanghai（默认）、ap-guangzhou、ap-singapore
lang	string	否	zh-CN	指定语言：zh-CN（默认）、en-US
accessKey	string	否	-	匿名用户鉴权参数，可以暴露在浏览器，用于请求公开访问的资源

⚠️ 注意：当前使用的环境所属地域，必须与当前指定的地域信息一致！

登录鉴权

js-sdk 使用 C 端 用户权限，需要登录后才可调用云开发能力。

匿名登录

详情请参考： 匿名登录

const app = cloudbase.init({
  env: "your-env-id", // 替换为您的环境id
});

const auth = app.auth();
await auth.signInAnonymously();

账号登录

详情请参考： 账号登录

const app = cloudbase.init({
  env: "your-env-id", // 替换为您的环境id
});

const auth = app.auth();

await auth.signIn({
  username: "your username",
  password: "your password",
});

Publishable Key

提示

使用此功能请升级 @cloudbase/js-sdk 至 2.21.0 及以后版本

Publishable Key 可以暴露在浏览器，用于请求公开访问的资源。Publishable Key 实际是一个匿名用户，可以有效降低 MAU。详细介绍请 参考文档说明 。

获取 Publishable Key

可前往 云开发平台/API Key 配置 中生成 Publishable Key

使用 Publishable Key

const app = cloudbase.init({
  env: "your-env-id", // 替换为您的环境id
  accessKey: "Publishable Key", // 填入生成的 Publishable Key
});

⚠️ 注意：Publishable Key 只能生成一次，并且是长期有效的、不能删除的，请妥善保管

初始化示例

新加坡地域

import cloudbase from "@cloudbase/js-sdk";

const app = cloudbase.init({
  env: "your-env-id", // 替换为您的环境id
  region: "ap-singapore",
});

使用英文提示

import cloudbase from "@cloudbase/js-sdk";

const app = cloudbase.init({
  env: "your-env-id", // 替换为您的环境id
  lang: "en-US",
});