QQ小游戲 API

API

小程序開發(fā)框架提供豐富的QQ原生 API，可以方便的調(diào)起QQ提供的能力，如獲取用戶信息，本地存儲(chǔ)，支付功能等。詳細(xì)介紹請(qǐng)參考 API 文檔。 通常，在小程序 API 有以下幾種類型：

事件監(jiān)聽 API

我們約定，以 on 開頭的 API 用來監(jiān)聽某個(gè)事件是否觸發(fā)，如：qq.onSocketOpen，qq.onCompassChange 等。 這類 API 接受一個(gè)回調(diào)函數(shù)作為參數(shù)，當(dāng)事件觸發(fā)時(shí)會(huì)調(diào)用這個(gè)回調(diào)函數(shù)，并將相關(guān)數(shù)據(jù)以參數(shù)形式傳入。 代碼示例

qq.onCompassChange(function (res) {
  console.log(res.direction)
})

同步 API

我們約定，以 Sync 結(jié)尾的 API 都是同步 API， 如 qq.setStorageSync，qq.getSystemInfoSync 等。此外，也有一些其他的同步 API，如 qq.createWorker，qq.getBackgroundAudioManager 等，詳情參見 API 文檔中的說明。 同步 API 的執(zhí)行結(jié)果可以通過函數(shù)返回值直接獲取，如果執(zhí)行出錯(cuò)會(huì)拋出異常。 代碼示例

try {
  qq.setStorageSync('key', 'value')
} catch (e) {
  console.error(e)
}

異步 API

大多數(shù) API 都是異步 API，如 qq.request，qq.login 等。這類 API 接口通常都接受一個(gè) Object 類型的參數(shù)，這個(gè)參數(shù)都支持按需指定以下字段來接收接口調(diào)用結(jié)果：

Object 參數(shù)說明

回調(diào)函數(shù)的參數(shù)

success，fail，complete 函數(shù)調(diào)用時(shí)會(huì)傳入一個(gè) Object 類型參數(shù)，包含以下字段：

異步 API 的執(zhí)行結(jié)果需要通過 Object 類型的參數(shù)中傳入的對(duì)應(yīng)回調(diào)函數(shù)獲取。部分異步 API 也會(huì)有返回值，可以用來實(shí)現(xiàn)更豐富的功能，如 qq.request，

qq.connectSockets 等。
代碼示例
qq.login({
  success(res) {
    console.log(res.code)
  }
})