百度智能小程序 監(jiān)聽小程序切前臺事件

2020-09-04 16:28 更新

swan.onAppShow

基礎(chǔ)庫 3.60.2 開始支持,低版本需做兼容處理。

解釋: 監(jiān)聽小程序切前臺事件。該事件與 App.onShow 的回調(diào)參數(shù)一致。

Web 態(tài)說明:

由于 Web 態(tài)框架暫不支持當(dāng)前是否進(jìn)入前、后臺的狀態(tài)檢測,因此在下列場景中 swan.onAppShow 不會執(zhí)行

  • 當(dāng) Web 態(tài)小程序從后臺切換至前臺時,如從任務(wù)管理器進(jìn)入、或關(guān)閉顯示在上層的語音助手等

方法參數(shù)

function callback

小程序切前臺事件的回調(diào)函數(shù)。

callback 返回參數(shù)說明 :

Object res 返回的對象信息

屬性 類型 說明 最低版本

scene

String

打開智能小程序的場景值

path

String

打開小程序的路徑。

query

Object

打開小程序的 query。

shareTicket

String

標(biāo)記轉(zhuǎn)發(fā)對象。

referrerInfo

Object

從另一個小程序打開該小程序時,返回此字段。

entryType

String

頁面展現(xiàn)的來源標(biāo)識,可取的值為: ‘user’、‘schema’、‘sys’,對應(yīng)代表的意義如下表。

2.10.7

appURL

String

展現(xiàn)時的調(diào)起協(xié)議,僅當(dāng) entryType 值為 schema 時存在。

2.10.7

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

屬性 類型 說明

appId

String

來源小程序的 appKey。

extraData

Object

來源小程序傳過來的數(shù)據(jù)

entryType 的取值說明

屬性 類型 說明

user

String

表示通過 home 前后臺切換或解鎖屏幕等方式調(diào)起。

schema

String

表示通過協(xié)議調(diào)起。

sys

String

其它。

示例


圖片示例


代碼示例 1: 在 onShow 中使用 

在開發(fā)者工具中打開

// app.js
App({
    onShow: function (res) {
        console.log('onShow', res)
        swan.showModal({
            title: 'res',
            content: JSON.stringify(res),
            showCancel: false
        });
    }
});

代碼示例 2: 在生命周期的 onAppShow 中使用 

在開發(fā)者工具中打開

// app.js
App({
    onLaunch: function () {
        swan.onAppShow(function(res) {
            console.warn('請在真機(jī)中進(jìn)行中進(jìn)行驗證,在工具中點擊工具欄的刷新按鈕也可模擬onShow觸發(fā)事件,開發(fā)者按照自己的業(yè)務(wù)邏輯進(jìn)行監(jiān)聽,被觸發(fā)時機(jī)和App.onShow一致。');
            swan.showModal({
                title: 'res',
                content: JSON.stringify(res),
                showCancel: false
            });
            console.log('scene', res.scene);
            console.log('path', res.path);
            console.log('query', res.query);
            console.log('shareTicket', res.shareTicket);
            console.log('referrerInfo', res.referrerInfo);
            console.log('entryType', res.entryType);
            console.log('appURL', res.appURL);
        });
    }
});


Bug & Tip

  • 在解析 query 的時候,基礎(chǔ)庫會使用 decodeURIComponent 對 query 的參數(shù)值進(jìn)行一次解碼,該功能將在未來的基礎(chǔ)庫版本下線,并提前通知開發(fā)者下線的基礎(chǔ)庫版本號;
  • 如在打開或跳轉(zhuǎn)小程序時傳遞了 encode 后的值作為參數(shù),為避免發(fā)生頁面錯誤,使用時請自行將拿到的值使用 decodeURIComponent 進(jìn)行一次 decode 操作。


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號