W3Cschool
恭喜您成為首批注冊(cè)用戶
獲得88經(jīng)驗(yàn)值獎(jiǎng)勵(lì)
在小程序端開始使用云能力前,需先調(diào)用 qq.cloud.init 方法完成云能力初始化(注意小程序需先開通云服務(wù),開通的方法是點(diǎn)擊工具欄左上角的 “控制臺(tái)” 按鈕)。因此,如果要使用云能力,通常我們?cè)谛〕绦虺跏蓟瘯r(shí)即調(diào)用這個(gè)方法
qq.cloud.int方法的定義如下:
function init(options): void
qq.cloud.init 方法接受一個(gè)可選的options參數(shù),方法沒有返回值。方法只能調(diào)用一次,多次調(diào)用時(shí)只有第一次調(diào)用生效。
qq.cloud.init
方法接受一個(gè)可選的 options 參數(shù),方法沒有返回值。方法只能調(diào)用一次,多次調(diào)用時(shí)只有第一次調(diào)用生效。
options 參數(shù)定義了云開發(fā)的默認(rèn)配置,該配置會(huì)作為之后調(diào)用其他所有云 API 的默認(rèn)配置,options提供的可選配置如下:
字段 | 數(shù)據(jù)類型 | 必填 | 默認(rèn)值 | 說明 |
---|---|---|---|---|
env | string\object | 是 | 后續(xù) API 調(diào)用的默認(rèn)環(huán)境配置,傳入字符串形式的環(huán)境 ID 可以指定所有服務(wù)的默認(rèn)環(huán)境,傳入對(duì)象可以分別指定各個(gè)服務(wù)的默認(rèn)環(huán)境,見下方詳細(xì)定義 | |
traceUser | boolean | 否 | false | 是否在將用戶訪問記錄到用戶管理中,在控制臺(tái)中可見 |
當(dāng) env 傳入?yún)?shù)為對(duì)象時(shí),可以指定各個(gè)服務(wù)的默認(rèn)環(huán)境,可選字段如下:
字段 | 數(shù)據(jù)類型 | 必填 | 默認(rèn)值 | 說明 |
---|---|---|---|---|
database | string | 否 | 空 | 數(shù)據(jù)庫 API 默認(rèn)環(huán)境配置 |
storage | string | 否 | 空 | 存儲(chǔ) API 默認(rèn)環(huán)境配置 |
functions | string | 否 | 空 | 云函數(shù) API 默認(rèn)環(huán)境配置 |
注意:env 設(shè)置只會(huì)決定小程序端 API 調(diào)用的云環(huán)境,并不會(huì)決定云函數(shù)中的 API 調(diào)用的環(huán)境,在云函數(shù)中需要通過 qq-server-sdk 的 init 方法重新設(shè)置環(huán)境。
示例代碼:
// 初始化示例
const tcb = require("qq-server-sdk");
//云函數(shù)下指定環(huán)境
tcb.init({
env: "xxx"
});
init 方法的定義如下:
function init(options): void
init 方法接受一個(gè)可選的 options 參數(shù),方法沒有返回值。方法只能調(diào)用一次,多次調(diào)用時(shí)只有第一次調(diào)用生效。 options 參數(shù)定義了云開發(fā)的默認(rèn)配置,該配置會(huì)作為之后調(diào)用其他所有云 API 的默認(rèn)配置,options 提供的可選配置如下:
字段 | 數(shù)據(jù)類型 | 必填 | 默認(rèn)值 | 說明 |
---|---|---|---|---|
env | string | 是 | 后續(xù) API 調(diào)用的默認(rèn)環(huán)境配置,傳入字符串形式的環(huán)境 ID ,不填則使用默認(rèn)環(huán)境。 |
注意:env 設(shè)置只會(huì)決定本次云函數(shù) API 調(diào)用的云環(huán)境,并不會(huì)決定接下來其他被調(diào)云函數(shù)中的 API 調(diào)用的環(huán)境,在其他被調(diào)云函數(shù)中需要通過 init 方法重新設(shè)置環(huán)境。
云開發(fā)的 API 風(fēng)格與小程序框架組件和 API 風(fēng)格有所差異,接口同時(shí)支持Promise風(fēng)格和callback風(fēng)格。 在傳入 API 的 Object 參數(shù)中,如果傳入了 success、fail、complete 字段,則我們認(rèn)為是采用回調(diào)風(fēng)格,API 方法調(diào)用不返回 Promise。如果傳入 API 的 Object 參數(shù)中 success、fail、complete 這三個(gè)字段都不存在,則我們認(rèn)為是采用Promise風(fēng)格,API 方法調(diào)用返回一個(gè) Promise,Promise resolve 的結(jié)果同傳入 success 回調(diào)的參數(shù),reject 的結(jié)果同傳入 fail 的參數(shù)。
如果 init 時(shí)不傳 env 參數(shù),過去 API 調(diào)用將默認(rèn)請(qǐng)求到第一個(gè)創(chuàng)建的環(huán)境,但這種方式并不總是預(yù)期的,因此這種方式已廢棄,請(qǐng)務(wù)必明確傳入 env 參數(shù)
Copyright©2021 w3cschool編程獅|閩ICP備15016281號(hào)-3|閩公網(wǎng)安備35020302033924號(hào)
違法和不良信息舉報(bào)電話:173-0602-2364|舉報(bào)郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號(hào)
聯(lián)系方式:
更多建議: