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