cloud

云开发 SDK 实例

参考文档

类型

typeof cloud

参数

CallFunctionResult

云函数通用返回

IAPIParam

云函数通用参数

IInitConfig

初始化配置

IConfig

配置

ICloudAPIParam

云函数 API 通用参数

CallFunctionParam

调用云函数参数

UploadFileResult

上传文件结果

UploadFileParam

上传文件参数

DownloadFileResult

下载文件结果

DownloadFileParam

下载文件参数

GetTempFileURLResult

获取临时文件结果

GetTempFileURLResultItem

临时文件列表

GetTempFileURLParam

获取临时文件参数

DeleteFileResult

删除文件结果

DeleteFileResultItem

删除文件列表

DeleteFileParam

删除文件参数

init

在调用云开发各 API 前，需先调用初始化方法 init 一次（全局只需一次，多次调用时只有第一次生效）

参考文档

(config?: IInitConfig) => void

示例代码

Taro.cloud.init({
  env: 'test-x1dzi'
})

API 支持度

callFunction

调用云函数

参考文档

{ (param: OQ<CallFunctionParam>): void; (param: Pick<CallFunctionParam, "name" | "data" | "slow" | "config">): Promise<CallFunctionResult>; }

示例代码

假设已有一个云函数 add，在小程序端发起对云函数 add 的调用：

Taro.cloud.callFunction({
// 要调用的云函数名称
name: 'add',
  // 传递给云函数的event参数
  data: {
    x: 1,
    y: 2,
  }
}).then(res => {
  // output: res.result === 3
}).catch(err => {
  // handle error
})

API 支持度

uploadFile

将本地资源上传至云存储空间，如果上传至同一路径则是覆盖写

参考文档

{ (param: OQ<UploadFileParam>): any; (param: Pick<UploadFileParam, "config" | "cloudPath" | "filePath" | "header">): Promise<UploadFileResult>; }

示例代码

示例 1

Taro.cloud.uploadFile({
  cloudPath: 'example.png',
  filePath: '', // 文件路径
  success: res => {
    // get resource ID
    console.log(res.fileID)
  },
  fail: err => {
    // handle error
  }
})

示例 2

Taro.cloud.uploadFile({
  cloudPath: 'example.png',
  filePath: '', // 文件路径
}).then(res => {
  // get resource ID
  console.log(res.fileID)
}).catch(error => {
  // handle error
})

API 支持度

downloadFile

从云存储空间下载文件

参考文档

{ (param: OQ<DownloadFileParam>): any; (param: Pick<DownloadFileParam, "config" | "cloudPath" | "fileID">): Promise<DownloadFileResult>; }

示例代码

示例 1

Taro.cloud.downloadFile({
  fileID: 'a7xzcb',
  success: res => {
    // get temp file path
    console.log(res.tempFilePath)
  },
  fail: err => {
    // handle error
  }
})

示例 2

Taro.cloud.downloadFile({
  fileID: 'a7xzcb'
}).then(res => {
  // get temp file path
  console.log(res.tempFilePath)
}).catch(error => {
  // handle error
})

API 支持度

getTempFileURL

用云文件 ID 换取真实链接，公有读的文件获取的链接不会过期，私有的文件获取的链接十分钟有效期。一次最多取 50 个。

参考文档

{ (param: OQ<GetTempFileURLParam>): void; (param: Pick<GetTempFileURLParam, "config" | "fileList">): Promise<GetTempFileURLResult>; }

示例代码

示例 1

Taro.cloud.getTempFileURL({
  fileList: [{
    fileID: 'a7xzcb',
    maxAge: 60 * 60, // one hour
  }]
}).then(res => {
  // get temp file URL
  console.log(res.fileList)
}).catch(error => {
  // handle error
})

示例 2

Taro.cloud.getTempFileURL({
  fileList: ['cloud://xxx', 'cloud://yyy'],
  success: res => {
    // get temp file URL
    console.log(res.fileList)
  },
  fail: err => {
    // handle error
  }
})

API 支持度

deleteFile

从云存储空间删除文件，一次最多 50 个

参考文档

{ (param: OQ<DeleteFileParam>): void; (param: Pick<DeleteFileParam, "config" | "fileList">): Promise<DeleteFileResult>; }

示例代码

示例 1

.cloud.deleteFile({
  fileList: ['a7xzcb']
}).then(res => {
  // handle success
  console.log(res.fileList)
}).catch(error => {
  // handle error
})

示例 2

Taro.cloud.deleteFile({
  fileList: ['a7xzcb'],
  success: res => {
    // handle success
    console.log(res.fileList)
  },
  fail: err => {
    // handle error
  },
  complete: res => {
    // ...
  }
})

API 支持度

database

获取数据库实例

参考文档

(config?: IConfig) => Database

示例代码

示例 1

以下调用获取默认环境的数据库的引用：

const db = Taro.cloud.database()

示例 2

假设有一个环境名为 test-123，用做测试环境，那么可以如下获取测试环境数据库：

const testDB = Taro.cloud.database({
  env: 'test-123'
})

API 支持度