API指引

上傳文件

在小程序端可調(diào)用 qq.cloud.uploadFile 方法進(jìn)行上傳：

qq.cloud.uploadFile({
  cloudPath: 'example.png', // 上傳至云端的路徑
  filePath: '', // 小程序臨時(shí)文件路徑
  success: res => {
    // 返回文件 ID
    console.log(res.fileID)
  },
  fail: console.error
})

上傳成功后會(huì)獲得文件唯一標(biāo)識(shí)符，即文件 ID，后續(xù)操作都基于文件 ID 而不是 URL。

下載文件

可以根據(jù)文件 ID 下載文件，用戶僅可下載其有訪問(wèn)權(quán)限的文件：

qq.cloud.downloadFile({
  fileID: '', // 文件 ID
  success: res => {
    // 返回臨時(shí)文件路徑
    console.log(res.tempFilePath)
  },
  fail: console.error
})

刪除文件

可以通過(guò) qq.cloud.deleteFile 刪除文件：

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

更詳細(xì)的 API 可參考小程序端及后端存儲(chǔ) API 文件。

組件支持

支持在 image、audio 等組件中傳入云文件 ID

換取臨時(shí)鏈接

可以根據(jù)文件 ID 換取臨時(shí)文件網(wǎng)絡(luò)鏈接，文件鏈接有有效期為兩個(gè)小時(shí)：

qq.cloud.getTempFileURL({
  fileList: ['cloud://xxx.png'],
  success: res => {
    // fileList 是一個(gè)有如下結(jié)構(gòu)的對(duì)象數(shù)組
    // [{
    //    fileID: 'cloud://xxx.png', // 文件 ID
    //    tempFileURL: '', // 臨時(shí)文件網(wǎng)絡(luò)鏈接
    //    maxAge: 120 * 60 * 1000, // 有效期
    // }]
    console.log(res.fileList)
  },
  fail: console.error
})

管理文件

在云開(kāi)發(fā)控制臺(tái)中，選擇文件管理標(biāo)簽頁(yè)，可以在此看到云存儲(chǔ)空間中所有的文件，還可以查看文件的詳細(xì)信息、控制存儲(chǔ)空間的讀寫(xiě)權(quán)限。

文件名命名限制

• 不能為空
• 不能以/開(kāi)頭
• 不能出現(xiàn)連續(xù)/
• 編碼長(zhǎng)度最大為850個(gè)字節(jié)
• 推薦使用大小寫(xiě)英文字母、數(shù)字，即[a-z，A-Z，0-9]和符號(hào) -，!，_，.，* 及其組合
• 不支持 ASCII 控制字符中的字符上(↑)，字符下(↓)，字符右(→)，字符左(←)，分別對(duì)應(yīng) CAN(24)，EM(25) ，SUB(26)，ESC(27)
• 如果用戶上傳的文件或文件夾的名字帶有中文，在訪問(wèn)和請(qǐng)求這個(gè)文件或文件夾時(shí)，中文部分將按照 URL - Encode 規(guī)則轉(zhuǎn)化為百分號(hào)編碼。
• 不建議使用的特殊字符: ` ^ " \ { } [ ] ~ % # \ > < 及 ASCII 128-255 十進(jìn)制
• 可能需特殊處理后再使用的特殊字符: ， : ; = & $ @ + ?（空格）及ASCII 字符范圍：00-1F 十六進(jìn)制（0-31 十進(jìn)制）以及7F（127 十進(jìn)制）

組件支持

小程序組件支持傳入云文件 ID，支持列表如下：