若项目仅连接一个服务空间,uniCloud框架会自动绑定服务空间,开发者无需手动做初始化工作(可理解为类调用)。只有存在多服务空间时,才需要根据本文进行初始化

    1. //项目仅连接了一个服务空间,则无需初始化
    2. //可通过uniCloud直接调用云开发的API
    3. uniCloud.callFunction()
    4. uniCloud.uploadFile()

    若项目连接了多个服务空间,uniCloud无法自动绑定;需开发者在客户端代码中,手动调用初始化方法uniCloud.init,绑定服务空间。

    uniCloud.init方法会返回一个uniCloud实例,之后云开发API的调用都需要通过该uniCloud实例发起(类似实例调用)。

    uniCloud.init方法定义如下:

    1. function init(options):uniCloud

    uniCloud.init方法接受一个options参数,返回uniCloud实例,uniCloud实例可调用云函数、云存储相关API。

    options 参数说明

    参数名类型必填默认值说明
    providerString-目前仅支持aliyun
    spaceIdString-服务空间ID,注意是服务空间ID,不是服务空间名称
    clientSecretString-可以在uniCloud控制台服务空间列表中查看

    示例代码

    1. //开发者创建了多个服务空间,则需手动初始化
    2. const myCloud = uniCloud.init({
    3. provider: 'aliyun',
    4. spaceId: 'xxxx-yyy',
    5. clientSecret: 'xxxx'
    6. });
    7. //通过uniCloud实例调用云开发的API
    8. myCloud.callFunction()
    9. myCloud.uploadFile()

    Tips:

    • 云函数会自动识别自己所属的服务空间,无需初始化。
    • HBuilderX 2.5.8版本在main.js使用uniCloud时,运行到H5端会报错,可以先使用其他平台进行调试。此问题会在HBuilderX 2.5.9修复

    发现错误?想参与编辑?在 GitHub 上编辑此页面!