作者：微信開(kāi)發(fā)者公眾號(hào)
為了實(shí)現(xiàn)小程序與視頻號(hào)的絲滑切換，微信團(tuán)隊(duì)提供 小程序 - 視頻號(hào)接口與組件 ，覆蓋瀏覽視頻、參與活動(dòng)、預(yù)約直播、觀看直播、查看主頁(yè)等常用場(chǎng)景，代碼更少、調(diào)用更高效、體驗(yàn)更絲滑！
快來(lái)看看如何高效應(yīng)用吧！
注意：在正式開(kāi)發(fā)前，開(kāi)發(fā)者需要獲取以下參數(shù)，否則將無(wú)法成功調(diào)用。
左右滑動(dòng)查看獲取操作
瀏覽視頻
在使用小程序過(guò)程中，豐富的視頻內(nèi)容讓用戶更全面、更便捷地了解產(chǎn)品，加速變現(xiàn)效率，幫助品牌獲得更好的曝光機(jī)會(huì)。
對(duì)于同主體或非同主體的情況，開(kāi)發(fā)者都能夠調(diào)用接口實(shí)現(xiàn)從小程序切換指定的視頻號(hào)視頻的效果。
前提條件：小程序與視頻號(hào)為相同主體或關(guān)聯(lián)主體
調(diào)用接口： 無(wú)彈窗切換至視頻號(hào)視頻
feed-id="yourfeedid" // 視頻 ID finder-user-name="yourfindusername" // 視頻號(hào) ID binderror="binderror" >channel-video>
前提條件： 無(wú)主體要求
調(diào)用接口： 有 彈窗切換至視頻號(hào)視頻
wx.openChannelsActivity({ feedId: "yourfeedid", // 視頻 ID finderUserName: "yourfindusername", // 視頻號(hào) ID })
參與活動(dòng)
以電商行業(yè)為例，商家希望用戶在小程序完成購(gòu)買流程后，參與官方視頻號(hào)的用戶反饋活動(dòng)，豐富服務(wù)內(nèi)容。此時(shí)，通過(guò)小程序直接跳轉(zhuǎn)視頻號(hào)活動(dòng)頁(yè)面能夠快速滿足場(chǎng)景需求。
現(xiàn)在，開(kāi)發(fā)者僅需 4 行代碼即可快速實(shí)現(xiàn)小程序切換視頻號(hào)活動(dòng)頁(yè)的效果。
前提條件：小程序與視頻號(hào)為相同主體或關(guān)聯(lián)主體
調(diào)用接口：
wx.openChannelsEvent({ finderUserName: "yourfindusername", // 視頻號(hào) ID eventId: "eventid", // 活動(dòng) id，可在「視頻號(hào)助手」-「內(nèi)容管理」-「活動(dòng)管理」獲取 })
預(yù)約直播
以游戲行業(yè)為例，游戲提供方通過(guò)小程序打造交流社區(qū)，也希望在小程序社區(qū)分享游戲直播預(yù)告信息，便于用戶及時(shí)觀看直播、提升社區(qū)活躍度。
現(xiàn)在，開(kāi)發(fā)者直接調(diào)用 2 個(gè)接口即可實(shí)現(xiàn)在小程序快速預(yù)約視頻號(hào)直播。
前提條件： 小程序與視頻號(hào)為相同主體或關(guān)聯(lián)主體
調(diào)用接口：
-
獲取直播預(yù)告信息
-
預(yù)約直播
// 獲取視頻號(hào)直播預(yù)告信息 wx.getChannelsLiveNoticeInfo({ finderUserName: "yourfindusername", // 視頻號(hào) ID success(res) { res.noticeId // 預(yù)告 id res.status // 預(yù)告狀態(tài)，0: 可用、1: 取消、2: 已用 res.startTime // 開(kāi)始時(shí)間 res.headUrl // 直播封面 res.nickname // 視頻號(hào)昵稱 res.reservable // 是否可預(yù)約 } })// 預(yù)約視頻號(hào)直播 wx.reserveChannelsLive({ noticeId: "noticeid" // 上面獲取到的直播預(yù)告 id })
觀看直播
以教育行業(yè)為例，用戶在小程序查看產(chǎn)品信息的同時(shí)及時(shí)通過(guò)直播了解到產(chǎn)品詳情，一定程度上提升下單率與復(fù)購(gòu)率。因此，小程序團(tuán)隊(duì)提供 3 個(gè)接口滿足小程序切換視頻號(hào)直播的場(chǎng)景需求。
開(kāi)發(fā)者需要注意：直播的不同狀態(tài)會(huì)導(dǎo)致直接切換至視頻號(hào)的承接頁(yè)面不同：
-
直播未開(kāi)始：顯示上一場(chǎng)直播的結(jié)束頁(yè)
-
直播中：顯示直播頁(yè)面
-
直播已結(jié)束（無(wú)回放）：顯示直播結(jié)束頁(yè)
-
直播已結(jié)束（有回放）：顯示直播回放頁(yè)
直播已結(jié)束且無(wú)回放的示例
現(xiàn)在，開(kāi)發(fā)者可通過(guò) 3 個(gè)接口實(shí)現(xiàn)小程序直接瀏覽視頻號(hào)直播的效果。
前提條件：小程序與視頻號(hào)為相同主體或關(guān)聯(lián)主體
調(diào)用接口： 獲取視頻號(hào)直播信息
// page.js 獲取視頻號(hào)直播信息 wx.getChannelsLiveInfo({ finderUserName: "yourfindusername", // 視頻號(hào) ID startTime: "", // 起始時(shí)間 endTime: "", // 結(jié)束時(shí)間 success(res) { res.feedId // 直播 feedId res.nonceId // 直播 nonceId res.status // 直播狀態(tài)，2: 直播中、3: 直播結(jié)束 res.description // 直播主題 res.replayStatus // 視頻號(hào)回放狀態(tài)，0: 未生成、1: 已生成、3: 生成中、6: 已過(guò)期 res.otherInfos // 除最近的一條直播外，其他的直播列表 } })
前提條件：小程序與視頻號(hào)為相同主體或關(guān)聯(lián)主體
調(diào)用接口： 無(wú)彈窗切換直播頁(yè)面
// page.wxml 視頻號(hào)直播組件 feed-id="yourfeedid" // 直播 feedId finder-user-name="yourfindusername" // 視頻號(hào) ID >channel-live>
前提條件：小程序與視頻號(hào)為相同主體或關(guān)聯(lián)主體
調(diào)用接口： 有彈窗切 換直播頁(yè)面
// 打開(kāi)視頻直播 wx.openChannelsLive({ finderUserName: "yourfindusername", // 視頻號(hào) ID feedId: "livefeedid", // 上面獲取到的直播 feedId nonceId: "livenonceid", // 上面獲取到的直播 nonceId })
查看主頁(yè)
除了滿足用戶對(duì)視頻 / 直播內(nèi)容的需求，微信團(tuán)隊(duì)提供專屬接口直接切換至視頻號(hào)主頁(yè)，便于用戶快速查看視頻號(hào)的所有內(nèi)容。
開(kāi)發(fā)者僅需 3 行代碼即可快速實(shí)現(xiàn)小程序切換視頻號(hào)主頁(yè)的效果：
前提條件：小程序與視頻號(hào)為相同主體或關(guān)聯(lián)主體
調(diào)用接口：
wx.openChannelsUserProfile({ finderUserName: "yourfindusername" // 視頻號(hào) ID })
開(kāi)發(fā)者根據(jù)不同的應(yīng)用場(chǎng)景及主體要求，選擇合適的接口 / 組件，滿足用戶的使用體驗(yàn)。
未來(lái)，微信各項(xiàng)能力仍將繼續(xù)緊密合作，提供更絲滑的使用體驗(yàn)，支持更豐富的開(kāi)發(fā)接口，建設(shè)更好的生態(tài)！
如有更多接口相關(guān)問(wèn)題，可點(diǎn)擊 發(fā)帖反饋，技術(shù)專員將為大家解答及進(jìn)行深度交流。
