微信小程序 小程序直播·其他能力

其他能力

1、 直播間小程序碼

說明：

• 小程序引入直播組件后必須進(jìn)行一次小程序發(fā)布上線，否則直播間的小程序碼不生效，具體表現(xiàn)是用戶掃碼進(jìn)入直播間會顯示“頁面不存在”。
• 在 MP 小程序直播后臺創(chuàng)建好直播間后，可以直接拿到直播間分享小程序碼，無需額外開發(fā)

如果商家在后臺自己生成的直播間小程序碼，需要做以下配置： 在跳轉(zhuǎn)進(jìn)入直播間的路徑加上 type = 9 標(biāo)識場景入口為小程序碼： "plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=[直播房間id]&type=9"。 若需要帶上自定義參數(shù)則還需要加上 custom_params： "plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=[直播房間id]&type=9&custom_params=encodeURIComponent(JSON.stringify(custom_params))"。

2、 商家公眾號文章添加小程序卡片

說明：

商家在公眾號文章中添加跳轉(zhuǎn)進(jìn)入直播間的小程序卡片時，需要做以下配置： 在跳轉(zhuǎn)進(jìn)入直播間的路徑加上 type = 10 標(biāo)識場景入口為小程序卡片： "plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=[直播房間id]&type=10"。 若需要帶上自定義參數(shù)則還需要加上 custom_params： "plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=[直播房間id]&type=10&custom_params=encodeURIComponent(JSON.stringify(custom_params))"。

3、 商品詳情頁注意事項(xiàng)

（1）添加返回按鈕: 點(diǎn)擊直播組件頁面里的貨架商品跳轉(zhuǎn)到商家小程序的商品詳情頁面后，為了避免用戶無法再返回直播間，商家需在小程序商品詳情頁面左上角加上返回按鈕，通過wx.navigateBack返回到直播組件頁面。

（2）不建議使用wx.switchTab：若在商品詳情頁點(diǎn)擊按鈕（如購物車按鈕等）通過wx.switchTab跳轉(zhuǎn)到tabbar頁，然后再點(diǎn)小窗回到直播間時會出現(xiàn)頁面卡死問題（微信客戶端7.0.15版本才修復(fù)）。此時可把頁面改為非tabbar頁并通過wx.navigateTo跳轉(zhuǎn)，也可通過關(guān)閉小窗來解決該問題。

（3）不建議使用wx.reLaunch：若在商品詳情頁及之后的頁面元素上使用wx.reLaunch跳轉(zhuǎn)，不僅會關(guān)閉小窗，而且無法返回到上一頁，體驗(yàn)不好。

4、 快速更新直播組件版本的方法

商家小程序?qū)?yīng)的管理員微信號收到【公眾平臺安全助手】下發(fā)的直播組件版本更新的服務(wù)通知后，可點(diǎn)擊通知進(jìn)行快速發(fā)布，移動端即可快速更新小程序內(nèi)直播組件的新版本，無需修改代碼或重新提交審核。

服務(wù)通知如下圖所示：

5、 直播小窗

版本限制：直播組件版本 1.1.4 及以上支持通過以下參數(shù)設(shè)置是否關(guān)閉小窗。

close_picture_in_picture_mode：默認(rèn)支持直播小窗，可通過close_picture_in_picture_mode=1關(guān)閉小窗功能，如 "plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=直播房間號&close_picture_in_picture_mode=1"。

6、 攜帶參數(shù)

版本限制：直播組件版本 1.1.4 及以上支持?jǐn)y帶以下參數(shù)，開發(fā)者可以根據(jù)這些參數(shù)建立用戶、直播間、商品之間的映射關(guān)系。

（1） shareTicket：分享直播間卡片到微信群，點(diǎn)擊此卡片后可以在 App onShow 里獲取該參數(shù)（默認(rèn)不可獲取該參數(shù)，可在跳轉(zhuǎn)直播間頁面路徑上配置 open_share_ticket=1 打開 shareTicket，如 "plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=直播房間號&open_share_ticket=1"，但長按分享卡片時不能轉(zhuǎn)發(fā)。）

（2） room_id + openid + share_openid + custom_params ：點(diǎn)擊直播間里的貨架商品跳轉(zhuǎn)到商家小程序的商品詳情頁或點(diǎn)擊直播間左上角首頁icon跳轉(zhuǎn)到商家小程序的首頁時，可以在Page onLoad options里獲取房間號、用戶openid、分享者share_openid（如果是從分享卡片進(jìn)入直播間再跳轉(zhuǎn)到商詳頁才有該參數(shù)）、開發(fā)者攜帶的自定義參數(shù)custom_params