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