Skip to main content
Version: 2.x

cloud

云开发 SDK 实例

参考文档

类型

typeof cloud

参数

CallFunctionResult

云函数通用返回

参数类型说明
result`stringRecord<string, any>`
errMsgstring调用结果

IAPIParam

云函数通用参数

参数类型必填说明
configIConfig配置
success(res: T) => void接口调用成功的回调函数
fail(err: CallbackResult) => void接口调用失败的回调函数
complete`(val: CallbackResultT) => void`

IInitConfig

初始化配置

参数类型必填说明
env`string{ database?: string; functions?: string; storage?: string; }`
traceUserboolean是否在将用户访问记录到用户管理中,在控制台中可见

IConfig

配置

参数类型必填说明
envstring使用的环境 ID,填写后忽略 init 指定的环境
traceUserboolean是否在将用户访问记录到用户管理中,在控制台中可见

ICloudAPIParam

云函数 API 通用参数

参数类型必填说明
configIConfig配置

CallFunctionParam

调用云函数参数

参数类型必填说明
namestring云函数名
dataRecord<string, any>传递给云函数的参数,在云函数中可通过 event 参数获取
slowboolean
configIConfig配置
complete`(res: CallFunctionResultCallbackResult) => void`
fail(res: CallbackResult) => void接口调用失败的回调函数
success(res: CallFunctionResult) => void接口调用成功的回调函数

UploadFileResult

上传文件结果

参数类型说明
fileIDstring文件 ID
statusCodenumber服务器返回的 HTTP 状态码
errMsgstring调用结果

UploadFileParam

上传文件参数

参数类型必填说明
cloudPathstring云存储路径,命名限制见文件名命名限制
filePathstring要上传文件资源的路径
headerRecord<string, any>
configIConfig配置
complete`(res: CallbackResultUploadFileResult) => void`
fail(res: CallbackResult) => void接口调用失败的回调函数
success(res: UploadFileResult) => void接口调用成功的回调函数

DownloadFileResult

下载文件结果

参数类型说明
tempFilePathstring临时文件路径
statusCodenumber服务器返回的 HTTP 状态码
errMsgstring调用结果

DownloadFileParam

下载文件参数

参数类型必填说明
fileIDstring云文件 ID
cloudPathstring
configIConfig配置
complete`(res: CallbackResultDownloadFileResult) => void`
fail(res: CallbackResult) => void接口调用失败的回调函数
success(res: DownloadFileResult) => void接口调用成功的回调函数

GetTempFileURLResult

获取临时文件结果

参数类型说明
fileListGetTempFileURLResultItem[]文件列表
errMsgstring调用结果

GetTempFileURLResultItem

临时文件列表

参数类型说明
fileIDstring云文件 ID
tempFileURLstring临时文件路径
maxAgenumber
statusnumber状态码
errMsgstring调用结果

GetTempFileURLParam

获取临时文件参数

参数类型必填说明
fileListstring[]
configIConfig配置
complete`(res: CallbackResultGetTempFileURLResult) => void`
fail(res: CallbackResult) => void接口调用失败的回调函数
success(res: GetTempFileURLResult) => void接口调用成功的回调函数

DeleteFileResult

删除文件结果

参数类型说明
fileListDeleteFileResultItem[]文件列表
errMsgstring调用结果

DeleteFileResultItem

删除文件列表

参数类型说明
fileIDstring云文件 ID
statusnumber状态码
errMsgstring调用结果

DeleteFileParam

删除文件参数

参数类型必填说明
fileListstring[]文件列表
configIConfig配置
complete`(res: CallbackResultDeleteFileResult) => void`
fail(res: CallbackResult) => void接口调用失败的回调函数
success(res: DeleteFileResult) => void接口调用成功的回调函数

init

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

参考文档

(config?: IInitConfig) => void
参数类型
configIInitConfig

示例代码

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

API 支持度

API微信小程序百度小程序支付宝小程序字节跳动小程序QQ 小程序H5React Native快应用
cloud.init✔️

callFunction

调用云函数

参考文档

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

示例代码

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

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

API 支持度

API微信小程序百度小程序支付宝小程序字节跳动小程序QQ 小程序H5React Native快应用
cloud.callFunction✔️

uploadFile

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

参考文档

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

示例代码

示例 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 支持度

API微信小程序百度小程序支付宝小程序字节跳动小程序QQ 小程序H5React Native快应用
cloud.uploadFile✔️

downloadFile

从云存储空间下载文件

参考文档

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

示例代码

示例 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 支持度

API微信小程序百度小程序支付宝小程序字节跳动小程序QQ 小程序H5React Native快应用
cloud.downloadFile✔️

getTempFileURL

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

参考文档

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

示例代码

示例 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 支持度

API微信小程序百度小程序支付宝小程序字节跳动小程序QQ 小程序H5React Native快应用
cloud.getTempFileURL✔️

deleteFile

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

参考文档

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

示例代码

示例 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 支持度

API微信小程序百度小程序支付宝小程序字节跳动小程序QQ 小程序H5React Native快应用
cloud.deleteFile✔️

database

获取数据库实例

参考文档

(config?: IConfig) => Database
参数类型
configIConfig

示例代码

示例 1

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

const db = Taro.cloud.database()
示例 2

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

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

API 支持度

API微信小程序百度小程序支付宝小程序字节跳动小程序QQ 小程序H5React Native快应用
cloud.database✔️