百度智能小程序 監(jiān)聽(tīng)小程序切前臺(tái)事件

swan.onAppShow

基礎(chǔ)庫(kù) 3.60.2 開(kāi)始支持，低版本需做兼容處理。

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

Web 態(tài)說(shuō)明：

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

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

方法參數(shù)

function callback

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

callback 返回參數(shù)說(shuō)明 ：

Object res 返回的對(duì)象信息

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

entryType 的取值說(shuō)明

示例

圖片示例

代碼示例 1: 在 onShow 中使用 

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

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

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

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

// app.js
App({
    onLaunch: function () {
        swan.onAppShow(function(res) {
            console.warn('請(qǐng)?jiān)谡鏅C(jī)中進(jìn)行中進(jìn)行驗(yàn)證,在工具中點(diǎn)擊工具欄的刷新按鈕也可模擬onShow觸發(fā)事件，開(kāi)發(fā)者按照自己的業(yè)務(wù)邏輯進(jìn)行監(jiān)聽(tīng)，被觸發(fā)時(shí)機(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 的時(shí)候，基礎(chǔ)庫(kù)會(huì)使用 decodeURIComponent 對(duì) query 的參數(shù)值進(jìn)行一次解碼，該功能將在未來(lái)的基礎(chǔ)庫(kù)版本下線，并提前通知開(kāi)發(fā)者下線的基礎(chǔ)庫(kù)版本號(hào)；
• 如在打開(kāi)或跳轉(zhuǎn)小程序時(shí)傳遞了 encode 后的值作為參數(shù)，為避免發(fā)生頁(yè)面錯(cuò)誤，使用時(shí)請(qǐng)自行將拿到的值使用 decodeURIComponent 進(jìn)行一次 decode 操作。