若项目仅连接一个服务空间,uniCloud
框架会自动绑定服务空间,开发者无需手动做初始化工作(可理解为类调用)。只有存在多服务空间时,才需要根据本文进行初始化
//项目仅连接了一个服务空间,则无需初始化
//可通过uniCloud直接调用云开发的API
uniCloud.callFunction()
uniCloud.uploadFile()
若项目连接了多个服务空间,uniCloud
无法自动绑定;需开发者在客户端代码中,手动调用初始化方法uniCloud.init
,绑定服务空间。
uniCloud.init
方法会返回一个uniCloud
实例,之后云开发API的调用都需要通过该uniCloud
实例发起(类似实例调用)。
uniCloud.init
方法定义如下:
function init(options):uniCloud
uniCloud.init
方法接受一个options
参数,返回uniCloud
实例,uniCloud
实例可调用云函数、云存储相关API。
options 参数说明
参数名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
provider | String | 是 | - | 目前仅支持aliyun |
spaceId | String | 是 | - | 服务空间ID,注意是服务空间ID,不是服务空间名称 |
clientSecret | String | 是 | - | 可以在uniCloud控制台服务空间列表中查看 |
示例代码
//开发者创建了多个服务空间,则需手动初始化
const myCloud = uniCloud.init({
provider: 'aliyun',
spaceId: 'xxxx-yyy',
clientSecret: 'xxxx'
});
//通过uniCloud实例调用云开发的API
myCloud.callFunction()
myCloud.uploadFile()
Tips:
- 云函数会自动识别自己所属的服务空间,无需初始化。
HBuilderX 2.5.8
版本在main.js
使用uniCloud
时,运行到H5端会报错,可以先使用其他平台进行调试。此问题会在HBuilderX 2.5.9
修复
发现错误?想参与编辑?在 GitHub 上编辑此页面!