支付寶小程序框架 事件·小程序場景值

版本需求： 基礎(chǔ)庫 1.10.0 開始支持，低版本需做兼容處理。

場景值用于描述用戶進入小程序的路徑。

由于 Android 系統(tǒng)限制，目前還無法獲取到按 Home 鍵退出到桌面，然后從桌面再次進小程序的場景值，對于這種情況，會保留上一次的場景值。

獲取場景值

開發(fā)者可以在 App 的 onLaunch 和 onShow 方法傳入的 options.scene 中獲取場景值。

場景值列表

示例代碼

App({
  onLaunch(options) {
    console.log('App onLaunch Scene:', options.scene);//options.scene 是 String 類型的 
  },
  onShow(options) {
    console.log('App onShow Scene:', options.scene);
  },
})

場景圖示

1. 首頁12宮格及更多用戶可以調(diào)整支付寶 App 首頁 12 宮格中的應(yīng)用，將自己常用的小程序放置在 12 宮格中。例如，螞蟻森林就是一個受大眾喜愛的小程序。

場景值ID：1000

場景值說明：首頁12宮格及更多。

2.小程序收藏

對于喜愛的或常用的小程序，用戶可以直接把它加入“小程序收藏”，方便下次打開使用。不過小程序收藏并不是首頁的固有應(yīng)用之一，在每次打開“小程序收藏”時，支付寶都會引導(dǎo)用戶將“小程序收藏”添加到首頁 12 宮格。

此外，支付寶 App 中的“朋友”tab 頂部，也有一個小程序入口，與“生活號”、“生活圈”并列。

場景值ID：1002

場景值說明：小程序收藏應(yīng)用入口，包含朋友 tab 中的入口。

3. 頂部搜索框的搜索結(jié)果頁

用戶可以在支付寶 App 頂部的搜索框檢索小程序，在搜索結(jié)果頁，即可進入小程序。

場景值ID：1005

場景值說明：頂部搜索框的搜索結(jié)果頁。

4. 單人聊天會話中的小程序消息卡片

支付寶的單人聊天會話中可以直接分享支付寶小程序，點擊小程序消息卡片即可打開對應(yīng)支付寶小程序。

場景值ID：1007

場景值說明：單人聊天會話中的小程序消息卡片。

5. 掃描二維碼

“掃一掃”可以說是所有小程序的核心入口。

場景值ID：1011

場景值說明：掃描二維碼。

5. 小程序模板消息

開發(fā)者可通過消息高效觸達用戶，通知用戶當前行為的結(jié)果及狀態(tài)等；同時可在消息中配置跳轉(zhuǎn)小程序指定頁面地址，當用戶查看消息時，在消息中點擊“進入小程序查看”返回小程序，進入開發(fā)者配置的小程序指定頁面。

場景值ID：1014

場景值說明：小程序模版消息（服務(wù)提醒）。

7. 生活號

生活號底部菜單欄、自定義菜單欄都會把用戶導(dǎo)向小程序。

場景值ID：1020

場景值說明：生活號 profile 頁相關(guān)小程序列表。

8.桌面圖標

用戶可以把支付寶小程序添加到手機桌面。即使用戶沒有打開支付寶 App，也能直接點擊桌面圖標打開支付寶小程序。

場景值ID：1023

場景值說明：系統(tǒng)桌面圖標。

9 . 小程序跳轉(zhuǎn)小程序

用戶也可以在一個小程序中打開另外一個小程序。以“城市服務(wù)”小程序為例，點擊“醫(yī)療”可進入“醫(yī)療健康”小程序。

同樣地，也可以從一個小程序返回另一個小程序。

場景值ID：1037 場景值說明：小程序打開小程序。 場景值ID：1038 場景值說明：從另一個小程序返回。

10.長按小程序右上角關(guān)閉按鈕

長按任意支付寶小程序右上角的關(guān)閉按鈕，即可喚起最近的小程序使用歷史，點擊即可跳轉(zhuǎn)接入。

場景值ID：1090

場景值說明：長按小程序右上角菜單喚出最近使用歷史。

11. 第三方 App 打開

用戶也可以從第三方 App（例如：釘釘）打開支付寶小程序。

場景值ID：1300

場景值說明：第三方 App（例如：釘釘）打開。

12.支付寶服務(wù)頻道打開

用戶還可以從以下 10 個支付寶服務(wù)頻道進入小程序：

以“醫(yī)療服務(wù)頻道”和“大學生活頻道”為例：

常見問題

Q：怎么獲取跳轉(zhuǎn)小程序鏈接？

A：需要開發(fā)者自己拼接，詳情參考文檔 小程序跳轉(zhuǎn) FAQ。