QQ小程序 qq.cloud.callFunction

調(diào)用云函數(shù) qq.cloud.callFunction 方法的定義如下：

Cloud.callFunction(object: Object): Promise<Object>

object: Object

object.config 的結(jié)構(gòu)

返回值

Promise.<Object>

data 參數(shù)說明 在 data 中如果傳入了 Buffer 類型的數(shù)據(jù)，數(shù)據(jù)在 JSON 序列化的過程中會被轉(zhuǎn)成 {}，以小程序端調(diào)用為例：

// 小程序端調(diào)用
qq.cloud.callFunction({
  // ...
  data: {
    buf: ArrayBuffer // 此處填入了某種方式獲取得到的 Buffer 數(shù)據(jù)，可以是 request 下來的，可以是讀文件讀出來的等等
  },
})
// 云函數(shù)端收到的 event 參數(shù)的結(jié)構(gòu)：
{
  "buf": {},
}

這里應(yīng)當(dāng)避免傳入 Buffer 類型的數(shù)據(jù)，因為直接傳輸buffer數(shù)組JSON串會讓數(shù)據(jù)體積增大，增加傳輸耗時，如果需要傳遞 Buffer，有兩種替代的建議方式：

1. 若 Buffer 較大，可先上傳至文件存儲空間，然后調(diào)用云函數(shù)的時候傳遞 fileID / 文件 URL 而不是 Buffer，再在云函數(shù)中下載下來
2. 若 Buffer 非常小 (如 < 10k)，可將 Buffer 轉(zhuǎn)成 base64 再調(diào)用

示例代碼 假設(shè)已有一個云函數(shù) add：

exports.main = (event, context, cb) => {
  return event.x + event.y
}

在小程序端發(fā)起對云函數(shù) add 的調(diào)用：

qq.cloud.callFunction({
  // 要調(diào)用的云函數(shù)名稱
  name: 'add',
  // 傳遞給云函數(shù)的event參數(shù)
  data: {
    x: 1,
    y: 2,
  }
}).then(res => {
  // output: res.result === 3
}).catch(err => {
  // handle error
})