微信小程序云開發(fā)SDK文檔 開發(fā)能力

Cloud.openapi

云調(diào)用 API 對(duì)象。

Cloud.CloudID(cloudID: string)

支持端：小程序 2.7.0

聲明字符串為 CloudID（開放數(shù)據(jù) ID），該接口傳入一個(gè)字符串，返回一個(gè) CloudID 特殊對(duì)象，將該對(duì)象傳至云函數(shù)可以獲取其對(duì)應(yīng)的開放數(shù)據(jù)。詳見通過云調(diào)用獲取開放數(shù)據(jù)

參數(shù)

cloudID: string

通過開放能力在小程序端獲取得到的 CloudID

示例代碼

小程序端調(diào)用

wx.cloud.callFunction({
  name: 'myFunction',
  data: {
    weRunData: wx.cloud.CloudID('xxx'), // 這個(gè) CloudID 值到云函數(shù)端會(huì)被替換
    obj: {
      shareInfo: wx.cloud.CloudID('yyy'), // 非頂層字段的 CloudID 不會(huì)被替換，會(huì)原樣字符串展示
    }
  }
})

在云函數(shù)端接收到的 event 將會(huì)包含對(duì)應(yīng)開放數(shù)據(jù)的對(duì)象，其中 event.weRunData 會(huì)因?yàn)榉弦?guī)則而包含開放數(shù)據(jù)，event.shareInfo 則不會(huì)，event 結(jié)構(gòu)將如下：

{
  "weRunData": {
    "cloudID": "27_Ih-9vxDaOhIbh48Bdpk90DUkUoNMAPaNtg7OSGM-P2wPEk1NbspjKGoql_g",
    "data": {
      "stepInfoList": [
        {
          "step": 9103,
          "timestamp": 1571673600
        },
        {
          "step": 9783,
          "timestamp": 1571760000
        }
      ],
      "watermark": {
        "appid": "wx3d289323f5900f8e",
        "timestamp": 1574338655
      }
    }
  },
  "obj": {
    "shareInfo": "xxx"
  }
}

Cloud.getOpenData(list: string[]): Object

支持端：云函數(shù)

獲取 CloudID 對(duì)應(yīng)的開放數(shù)據(jù)

參數(shù)

list: string[]

要獲取對(duì)應(yīng)開放數(shù)據(jù)的 CloudID 列表

返回值

Object

list 的結(jié)構(gòu)

說明

詳見通過云調(diào)用獲取開放數(shù)據(jù)

示例代碼

const cloud = require('wx-server-sdk')
cloud.init({
  env: cloud.DYNAMIC_CURRENT_ENV
})

exports.main = async (event, context) => {
  const res = await cloud.getOpenData({
    list: event.openData.list, // 假設(shè) event.openData.list 是一個(gè) CloudID 字符串列表
  })
  return res.list
}

返回的結(jié)果結(jié)構(gòu)類似如下（假設(shè) list 長度為 1，其中的 CloudID 是微信運(yùn)動(dòng)數(shù)據(jù)的 CloudID）：

[{
  "cloudID": "27_Ih-9vxDaOhIbh48Bdpk90DUkUoNMAPaNtg7OSGM-P2wPEk1NbspjKGoql_g",
  "data": {
    "stepInfoList": [
      {
        "step": 9103,
        "timestamp": 1571673600
      },
      {
        "step": 9783,
        "timestamp": 1571760000
      }
    ],
    "watermark": {
      "appid": "wx3d289323f5900f8e",
      "timestamp": 1574338655
    }
  }

Cloud.getVoIPSign(options: Object): Promise<Object>

支持端：云函數(shù)

獲取實(shí)時(shí)語音簽名

參數(shù)

options: Object

返回值

Promise.<Object>

示例代碼

const cloud = require('wx-server-sdk')
cloud.init({
  env: cloud.DYNAMIC_CURRENT_ENV
})

exports.main = async (event, context) => {
  const result = await cloud.getVoIPSign({
    groupId: 'xxx',
    timestamp: 1557056066,
    nonce: 'yyy'
  })
  return result.fileListt
}