一、導(dǎo)語
微信為小程序開發(fā)者提供了直播組件，通過調(diào)用該組件，商家可以小程序中實(shí)現(xiàn)直播功能。
（學(xué)習(xí)視頻分享：編程視頻）
下面我們來介紹如何在小程序中引入直播組件。
二、使用方法說明
1.??【直播組件】如何引入
版本限制：
微信客戶端版本 7.0.7 及以上（基礎(chǔ)庫版本2.9.x 及以上支持同層渲染）可以觀看直播及使用直播間的功能，低版本剛進(jìn)入直播間時(shí)會(huì)提示用戶升級(jí)微信客戶端版本（低版本只能觀看直播，無法使用直播間的功能）。
在分包內(nèi)引入【直播組件】live-player-plugin代碼包，項(xiàng)目根目錄的 app.json 引用，示例代碼如下：
{
??"subpackages":?[
????{
??????"root":?"packageA",
??????"pages":?[
????????"pages/home/home"
??????],
??????"plugins":?{
????????"live-player-plugin":?{?????????
"version":?"1.0.0",?//?填寫該直播組件最新版本號(hào)，微信開發(fā)者工具調(diào)試時(shí)可獲取最新版本號(hào)
??????????"provider":?"wx2b03c6e691cd7370"?//?必須填該直播組件appid，該示例值即為直播組件appid
????????}
??????}
????}
??]
}
2.?? 【直播組件】如何使用
按第1步的方法把組件代碼包配置引入后，即可直接通過鏈接地址跳轉(zhuǎn)到直播組件頁面（即為進(jìn)直播間頁面）鏈接地址需要帶上直播房間id；房間id可通過下面【獲取直播房間列表】API獲取，示例代碼如下：
?
<navigator url="plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=[直播房間id]"> ??Go?to?Live?Player?page </navigator>
通過該鏈接可跳轉(zhuǎn)到直播組件頁面（當(dāng)前頁面入口僅開放‘live-player-plugin’）。
示例效果圖如下：
?
三、其他相關(guān)組件、接口和攜帶參數(shù)
●????訂閱組件：subscribe
●????獲取直播狀態(tài)API：getLiveStatus
●????直播間到商詳頁面攜帶參數(shù)：room_id
●????從群分享卡片返回直播間時(shí)攜帶參數(shù)：shareTicket
●????后臺(tái)獲取直播房間列表API
●????后臺(tái)獲取回放源視頻API
注：以上2個(gè)后臺(tái)調(diào)用的接口總上限500次/天
1.?? 【訂閱】組件
功能解釋：
用戶進(jìn)入直播間內(nèi)，可對(duì)一場(chǎng)未開播的直播進(jìn)行單次訂閱，開播時(shí)直播組件會(huì)自動(dòng)下發(fā)開播提醒給用戶，無需開發(fā)者額外開發(fā)
組件使用：
如果需要在直播組件頁以外小程序其他頁面也有同樣的開播提醒的功能，可以引入【訂閱】組件subscribe；需在page頁面（如home頁面）的 home.json 引用訂閱組件，示例代碼如下：
{
??"usingComponents":?{
????"subscribe":?"plugin-private://wx2b03c6e691cd7370/components/subscribe/subscribe"
??}
}
然后便可在home.wxml里使用訂閱組件，其中直播房間id可通過；房間id可通過下面【獲取直播房間列表】API獲取
<subscribe room-id="[直播房間id]"></subscribe>
2.?? 【獲取直播狀態(tài)】接口
接口說明：
首次獲取立馬返回直播狀態(tài)，往后間隔1分鐘或更慢的頻率去輪詢獲取直播狀態(tài)；
直播狀態(tài)說明：
l? 101直播中：表示主播正常開播，直播正常的狀態(tài)；
l? 102未開始：表示主播還未開播；
l? 103已結(jié)束：表示在直播端點(diǎn)擊【結(jié)束】按鈕正常關(guān)閉的直播，或直播異常15分鐘后系統(tǒng)強(qiáng)制結(jié)束的直播；
l? 104禁播：表示因違規(guī)受到運(yùn)營處罰被禁播；
l? 105暫停中：表示在MP小程序后臺(tái)-控制臺(tái)內(nèi)操作暫停了直播；
l? 106異常：表示主播離開、切后臺(tái)、斷網(wǎng)等情況，該直播被判定為異常狀態(tài)，15分鐘內(nèi)恢復(fù)即可回到正常直播中的狀態(tài)；如果15分鐘后還未恢復(fù)，直播間會(huì)被系統(tǒng)強(qiáng)制結(jié)束直播；
l? 107已過期：表示直播間一直未開播，且已達(dá)到在MP小程序后臺(tái)創(chuàng)建直播間時(shí)填寫的直播計(jì)劃結(jié)束時(shí)間，則該直播被判定為過期不能再開播；
調(diào)用方法：
若要調(diào)用【獲取直播狀態(tài)】接口getLiveStatus，需在小程序頁面頂部引用【直播組件】live-player-plugin，示例代碼如下：
let livePlayer = requirePlugin('live-player-plugin') // 引入獲取直播狀態(tài)接口
// 首次獲取立馬返回直播狀態(tài)，往后間隔1分鐘或更慢的頻率去輪詢獲取直播狀態(tài)
const?roomId?=?xxx
//?房間id
livePlayer.getLiveStatus({?room_id:?roomId?})
??.then(res?=>?{
????//
101:?直播中,?102:?未開始,?103:?已結(jié)束,
104:?禁播,?105:?暫停中,?106:?異常，107：已過期
????const
liveStatus?=?res.liveStatus
??})
??.catch(err?=>
{
????console.log(err)
??})
3.?? 攜帶參數(shù)
版本限制：
直播組件版本1.0.1及以上支持?jǐn)y帶以下參數(shù)
shareTicket：分享直播間卡片到微信群，點(diǎn)擊此卡片后可以在 ApponShow 里獲取該參數(shù)
room_id：點(diǎn)擊直播組件頁面里的貨架商品跳轉(zhuǎn)到商家小程序的商品詳情頁面時(shí)，會(huì)帶上房間號(hào)參數(shù)
4.?? 【獲取直播房間列表】接口，僅供后臺(tái)調(diào)用
接口規(guī)則：
該接口僅供商家后臺(tái)調(diào)用，調(diào)用限額500次/天，建議開發(fā)者自己做緩存（此接口與下面【獲取回放視頻】接口共用500次/天限制，請(qǐng)合理分配調(diào)用頻次）。
請(qǐng)求URL：
http://api.weixin.qq.com/wxa/business/getliveinfo?access_token=?
請(qǐng)求方式：
POST
請(qǐng)求示例：
Request
{
?"start":?0,?//?起始拉取房間，start=0表示從第1個(gè)房間開始拉取
?"limit":?10?//?每次拉取的個(gè)數(shù)上限，不要設(shè)置過大，建議100以內(nèi)
}
Response
{
?"errcode":?0,?//?errcode=0代表成功；errcode=1代表未創(chuàng)建直播房間
?"errmsg":?"ok",
?"room_info":?[{
"name":?"直播房間名",?
"roomid":?1,
"cover_img":?"http:\/\/mmbiz.qpic.cn\/mmbiz_jpg\/Rl1RuuhdstSfZa8EEljedAYcbtX3Ejpdl2et1tPAQ37bdicnxoVialDLCKKDcPBy8Iic0kCiaiaalXg3EbpNKoicrweQ\/0?wx_fmt=jpeg",?
"live_satus":?101,
"start_time":?1568128900,
"end_time":?1568131200,
"anchor_name":?"李四",
"anchor_img":?"http:\/\/mmbiz.qpic.cn\/mmbiz_jpg\/Rl1RuuhdstSfZa8EEljedAYcbtX3Ejpdlp0sf9YTorOzUbGF9Eib6ic54k9fX0xreAIt35HCeiakO04yCwymoKTjw\/0?wx_fmt=jpeg",
"goods":[????????????
{????"cover_img":"http://mmbiz.qpic.cn/mmbiz_png/FVribAGdErI2PmyST9ZM0JLbNM48I7TH2FlrwYOlnYqGaej8qKubG1EvK0QIkkwqvicrYTzVtjKmSZSeY5ianc3mw/0?wx_fmt=png",
??????"url":"pages/index/index.html",
??????"price":1100,
??????"name":"fdgfgf"???
}??
],
?"total":1
}
返回字段：
name 房間名
roomid 房間id
注：需先在小程序MP后臺(tái)創(chuàng)建直播房間，否則會(huì)報(bào)錯(cuò)（錯(cuò)誤碼1）
cover_img 封面圖片url
start_time 直播計(jì)劃開始時(shí)間，列表按照 start_time 降序排列
end_time 直播計(jì)劃結(jié)束時(shí)間
anchor_name 主播名
goods 商品列表
live_status 直播狀態(tài)?? 101: 直播中, 102: 未開始, 103: 已結(jié)束, 104: 禁播, 105: 暫停中, 106: 異常,107:已過期（直播狀態(tài)解釋可參考【獲取直播狀態(tài)】接口）
5.?? 【獲取回放源視頻】接口，僅供后臺(tái)調(diào)用
接口規(guī)則：
該接口僅供商家后臺(tái)調(diào)用，調(diào)用限額500次/天，此接口與上面【獲取房間列表】接口共用500次/天限制，請(qǐng)合理分配調(diào)用頻次）。
?
接口說明：
該接口可在直播結(jié)束后拿到回放源視頻（直播結(jié)束后大約10分鐘會(huì)生成回放，源視頻無評(píng)論等內(nèi)容）
拿到源視頻后需要開發(fā)者自行開發(fā)、使用回放視頻
如果把源視頻直接放在小程序上使用，需要小程序具備視頻資質(zhì)（具體資質(zhì)要求請(qǐng)參考《小程序開發(fā)的類目服務(wù)》）
后續(xù)官方會(huì)直接提供無需開發(fā)的直播回放功能，敬請(qǐng)期待。
請(qǐng)求URL：
http://api.weixin.qq.com/wxa/business/getliveinfo?access_token=?
請(qǐng)求方式：
POST
請(qǐng)求示例：
Request
{
"action":?"get_replay",?//?獲取回放
"room_id":?354,?//?直播間id
"start":?0,?//?起始拉取視頻，start=0表示從第1個(gè)視頻片段開始拉取
"limit":?10?//?每次拉取的個(gè)數(shù)上限，不要設(shè)置過大，建議100以內(nèi)
}
Response
{
"live_replay":?[??
{
??????"expire_time":?"2020-11-11T03:49:55Z",?//?回放視頻url過期時(shí)間
??????"create_time":?"2019-11-12T03:49:55Z",?//?回放視頻創(chuàng)建時(shí)間
??????"media_url":?"http://xxxxx.vod2.myqcloud.com/xxxxx/xxxxx/f0.mp4"?//?回放視頻???
}?
],?
"errcode":?0,?
"total":?1,?
"errmsg":?"ok"
}?//?一場(chǎng)直播可能會(huì)產(chǎn)生多個(gè)視頻片段。
四、其他說明
1、直播間小程序碼
說明：
小程序引入直播組件后必須進(jìn)行一次小程序發(fā)布上線，否則小程序碼不生效
在MP小程序直播后臺(tái)創(chuàng)建好直播間后，可以直接拿到直播間分享小程序碼，無需額外開發(fā)
如果商家在后臺(tái)自己生成的直播間小程序碼，需要做以下配置（否則直播間左上角返回鍵將失效）：
在跳轉(zhuǎn)進(jìn)入直播間的路徑加上 type=9 標(biāo)識(shí)場(chǎng)景入口為小程序碼：
"plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=[直播房間id]&type=9"
2、商家公眾號(hào)文章添加小程序卡片
說明：
商家在公眾號(hào)文章中添加跳轉(zhuǎn)進(jìn)入直播間的小程序卡片時(shí)，需要做以下配置（否則直播間左上角返回鍵將失效）：
在跳轉(zhuǎn)進(jìn)入直播間的路徑加上 type=10 標(biāo)識(shí)場(chǎng)景入口為小程序卡片：
"plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=[直播房間id]&type=10"
3、商品詳情頁面需添加返回按鈕
點(diǎn)擊直播組件頁面里的貨架商品跳轉(zhuǎn)到商家小程序的商品詳情頁面后，為了避免用戶無法再返回直播間，商家需在小程序商品詳情頁面左上角加上返回按鈕，用于返回到直播組件頁面。
4、快速更新直播組件版本的方法
商家小程序?qū)?yīng)的管理員微信號(hào)收到【公眾平臺(tái)安全助手】下發(fā)的直播組件版本更新的服務(wù)通知后，可點(diǎn)擊通知進(jìn)行快速發(fā)布，移動(dòng)端即可快速更新小程序內(nèi)直播組件的新版本，無需修改代碼或重新提交審核。
服務(wù)通知如下圖所示：
相關(guān)推薦：小程序開發(fā)教程
以上是通過直播組件實(shí)現(xiàn)小程序直播功能的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！
熱AI工具
Undress AI Tool
免費(fèi)脫衣服圖片
Undresser.AI Undress
人工智能驅(qū)動(dòng)的應(yīng)用程序，用于創(chuàng)建逼真的裸體照片
AI Clothes Remover
用于從照片中去除衣服的在線人工智能工具。
Clothoff.io
AI脫衣機(jī)
Video Face Swap
使用我們完全免費(fèi)的人工智能換臉工具輕松在任何視頻中換臉！
熱門文章
熱工具
記事本++7.3.1
好用且免費(fèi)的代碼編輯器
SublimeText3漢化版
中文版，非常好用
禪工作室 13.0.1
功能強(qiáng)大的PHP集成開發(fā)環(huán)境
Dreamweaver CS6
視覺化網(wǎng)頁開發(fā)工具
SublimeText3 Mac版
神級(jí)代碼編輯軟件(SublimeText3)
使用Python開發(fā)微信小程序
Jun 17, 2023 pm 06:34 PM
隨著移動(dòng)互聯(lián)網(wǎng)技術(shù)和智能手機(jī)的普及，微信成為了人們生活中不可或缺的一個(gè)應(yīng)用。而微信小程序則讓人們可以在不需要下載安裝應(yīng)用的情況下，直接使用小程序來解決一些簡(jiǎn)單的需求。本文將介紹如何使用Python來開發(fā)微信小程序。一、準(zhǔn)備工作在使用Python開發(fā)微信小程序之前，需要安裝相關(guān)的Python庫。這里推薦使用wxpy和itchat這兩個(gè)庫。wxpy是一個(gè)微信機(jī)器
實(shí)現(xiàn)微信小程序中的卡片翻轉(zhuǎn)特效
Nov 21, 2023 am 10:55 AM
實(shí)現(xiàn)微信小程序中的卡片翻轉(zhuǎn)特效在微信小程序中，實(shí)現(xiàn)卡片翻轉(zhuǎn)特效是一種常見的動(dòng)畫效果，可以提升用戶體驗(yàn)和界面交互的吸引力。下面將具體介紹如何在微信小程序中實(shí)現(xiàn)卡片翻轉(zhuǎn)的特效，并提供相關(guān)代碼示例。首先，需要在小程序的頁面布局文件中定義兩個(gè)卡片元素，一個(gè)用于顯示正面內(nèi)容，一個(gè)用于顯示背面內(nèi)容，具體示例代碼如下：<!--index.wxml-->&l
支付寶上線'漢字拾光-生僻字”小程序，用于征集、補(bǔ)充生僻字庫
Oct 31, 2023 pm 09:25 PM
本站10月31日消息，今年5月27日，螞蟻集團(tuán)宣布啟動(dòng)“漢字拾光計(jì)劃”，最近又迎來新進(jìn)展：支付寶上線“漢字拾光-生僻字”小程序，用于向社會(huì)征集生僻字，補(bǔ)充生僻字庫，同時(shí)提供不同的生僻字輸入體驗(yàn)，以幫助完善支付寶內(nèi)的生僻字輸入方法。目前，用戶搜索“漢字拾光”、“生僻字”等關(guān)鍵詞就可以進(jìn)入“生僻字”小程序。在小程序里，用戶可以提交尚未被系統(tǒng)識(shí)別錄入的生僻字圖片，支付寶工程師在確認(rèn)后，將會(huì)對(duì)字庫進(jìn)行補(bǔ)錄入。本站注意到，用戶還可以在小程序體驗(yàn)最新的拆字輸入法，這一輸入法針對(duì)讀音不明確的生僻字設(shè)計(jì)。用戶拆
小程序能用react嗎
Dec 29, 2022 am 11:06 AM
小程序能用react，其使用方法：1、基于“react-reconciler”實(shí)現(xiàn)一個(gè)渲染器，生成一個(gè)DSL；2、創(chuàng)建一個(gè)小程序組件，去解析和渲染DSL；3、安裝npm，并執(zhí)行開發(fā)者工具中的構(gòu)建npm；4、在自己的頁面中引入包，再利用api即可完成開發(fā)。
uniapp如何實(shí)現(xiàn)小程序和H5的快速轉(zhuǎn)換
Oct 20, 2023 pm 02:12 PM
uniapp如何實(shí)現(xiàn)小程序和H5的快速轉(zhuǎn)換，需要具體代碼示例近年來，隨著移動(dòng)互聯(lián)網(wǎng)的發(fā)展和智能手機(jī)的普及，小程序和H5成為了不可或缺的應(yīng)用形式。而uniapp作為一個(gè)跨平臺(tái)的開發(fā)框架，可以在一套代碼的基礎(chǔ)上，快速實(shí)現(xiàn)小程序和H5的轉(zhuǎn)換，大大提高了開發(fā)效率。本文將介紹uniapp如何實(shí)現(xiàn)小程序和H5的快速轉(zhuǎn)換，并給出具體的代碼示例。一、uniapp簡(jiǎn)介unia
教你如何在小程序中用公眾號(hào)模板消息（附詳細(xì)思路）
Nov 04, 2022 pm 04:53 PM
本篇文章給大家?guī)砹岁P(guān)于微信小程序的相關(guān)問題，其中主要介紹了如何在小程序中用公眾號(hào)模板消息，下面一起來看一下，希望對(duì)大家有幫助。
用Python編寫簡(jiǎn)單的聊天程序教程
May 08, 2023 pm 06:37 PM
實(shí)現(xiàn)思路x01服務(wù)端的建立首先,在服務(wù)端,使用socket進(jìn)行消息的接受,每接受一個(gè)socket的請(qǐng)求,就開啟一個(gè)新的線程來管理消息的分發(fā)與接受,同時(shí),又存在一個(gè)handler來管理所有的線程,從而實(shí)現(xiàn)對(duì)聊天室的各種功能的處理x02客戶端的建立客戶端的建立就要比服務(wù)端簡(jiǎn)單多了,客戶端的作用只是對(duì)消息的發(fā)送以及接受,以及按照特定的規(guī)則去輸入特定的字符從而實(shí)現(xiàn)不同的功能的使用,因此,在客戶端這里,只需要去使用兩個(gè)線程,一個(gè)是專門用于接受消息,一個(gè)是專門用于發(fā)送消息的至于為什么不用一個(gè)呢,那是因?yàn)?只
PHP與小程序的地理位置定位與地圖顯示
Jul 04, 2023 pm 04:01 PM
PHP與小程序的地理位置定位與地圖顯示地理位置定位與地圖顯示在現(xiàn)代科技中已經(jīng)成為了必備的功能之一。隨著移動(dòng)設(shè)備的普及，人們對(duì)于定位和地圖顯示的需求也越來越高。在開發(fā)過程中，PHP和小程序是常見的兩種技術(shù)選擇。本文將為大家介紹PHP與小程序中的地理位置定位與地圖顯示的實(shí)現(xiàn)方法，并附上相應(yīng)的代碼示例。一、PHP中的地理位置定位在PHP中，我們可以使用第三方地理位
