Implementieren Sie die Live-Übertragungsfunktion eines Miniprogramms über die Live-Übertragungskomponente

1. Einführung

WeChat bietet eine Live-Übertragungskomponente für Miniprogrammentwickler. Durch den Aufruf dieser Komponente können Händler die Live-Übertragungsfunktion in Miniprogrammen implementieren.

(Teilen von Lernvideos: Programmiervideo)

Jetzt stellen wir vor, wie man die Live-Übertragungskomponente in das Miniprogramm einführt.

2. Gebrauchsanweisung

1. So führen Sie

Versionseinschränkungen ein:

WeChat-Clientversion 7.0.7 und höher (Basisbibliotheksversion 2.9.x und höher unterstützt das Rendern auf derselben Ebene). Sehen Sie sich die Live-Übertragung an und verwenden Sie die Live-Übertragungsraumfunktion. Wenn die niedrigere Version den Live-Übertragungsraum zum ersten Mal betritt, wird der Benutzer aufgefordert, die WeChat-Client-Version zu aktualisieren (die niedrigere Version kann nur die Live-Übertragung ansehen und die Live-Übertragung nicht verwenden). Raumfunktion).

Fügen Sie das Live-Player-Plugin-Codepaket [Live-Streaming] in das Unterpaket ein und verweisen Sie auf app.json im Projektstammverzeichnis. Der Beispielcode lautet wie folgt:

{

  "subpackages": [

    {

      "root": "packageA",

      "pages": [

        "pages/home/home"

      ],

      "plugins": {

        "live-player-plugin": {         

"version": "1.0.0", // 填写该直播组件最新版本号，微信开发者工具调试时可获取最新版本号

          "provider": "wx2b03c6e691cd7370" // 必须填该直播组件appid，该示例值即为直播组件appid

        }

      }

    }

  ]

}

2 Komponente]

Klicken Sie auf Schritt 1 Methode: Nachdem die Komponentencode-Paketkonfiguration eingeführt wurde, können Sie über die Linkadresse direkt zur Seite der Live-Übertragungskomponente springen (d. h. die Linkadresse muss eingegeben werden). Bringen Sie die Live-Übertragungsraum-ID mit; die Raum-ID kann über die folgende API [Live-Übertragungsraumliste abrufen] abgerufen werden. Der Beispielcode lautet wie folgt:

<navigator url="plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=[直播房间id]">

  Go to Live Player page

</navigator>

Sie können über diesen Link zur Seite der Live-Übertragungskomponente springen ( Der aktuelle Seiteneingang ist nur für „Live-Player-Plugin“ geöffnet.

Beispieldarstellungen sind wie folgt:

3. Andere verwandte Komponenten, Schnittstellen und Übertragungsparameter

● Abonnementkomponente: subscribe

● Live-Übertragungsstatus-API abrufen: getLiveStatus

● Übertragung aus der Live-Übertragung Raum zur Geschäftsdetailseite Parameter: room_id

● Parameter, die bei der Rückkehr zum Live-Übertragungsraum von der Gruppenfreigabekarte übertragen werden: shareTicket

● Hintergrund, um die Live-Übertragungsraumlisten-API zu erhalten

● Hintergrund, um die Wiedergabe-Quellvideo-API zu erhalten

Hinweis: Die Gesamtobergrenze der beiden oben genannten Hintergrundanrufschnittstellen beträgt 500 Mal pro Tag Wenn die Übertragung nicht gestartet wurde, sendet die Live-Übertragungskomponente automatisch eine Starterinnerung an den Benutzer. Für Entwickler ist keine zusätzliche Entwicklung erforderlich. Komponentenverwendung: Wenn Sie dieselbe Übertragungserinnerungsfunktion benötigen Auf anderen Seiten des Miniprogramms als der Live-Übertragungskomponentenseite können Sie die Abonnementkomponente [Abonnement] einführen. Diese muss sich auf der Startseite der Seite befinden (z. B. auf der Startseite). .json verweist auf die Abonnementkomponente. Der Beispielcode lautet wie folgt:

{

  "usingComponents": {

    "subscribe": "plugin-private://wx2b03c6e691cd7370/components/subscribe/subscribe"

  }

}

Dann können Sie die Abonnementkomponente in home.wxml verwenden, wo die Live-Raum-ID übergeben werden kann; die Raum-ID kann über die API [Live-Raumliste abrufen] unten abgerufen werden

<subscribe room-id="[直播房间id]"></subscribe>

2. Schnittstelle [Live-Übertragungsstatus abrufen]

Schnittstellenbeschreibung:

Kehren Sie unmittelbar nach der ersten Erfassung zum Live-Übertragungsstatus zurück und rufen Sie dann alle 1 Minute oder langsamer den Live-Übertragungsstatus ab.

Beschreibung des Live-Übertragungsstatus:

l 101 Live-Übertragung: Zeigt an, dass der Moderator mit der Übertragung begonnen hat und sich in einem normalen Zustand befindet.

l 102 Nicht gestartet: Zeigt an, dass der Moderator noch nicht mit der Übertragung begonnen hat.

l 103 Beendet: Zeigt dies an Die Live-Übertragung wurde normal geschlossen, indem am Ende der Live-Übertragung auf die Schaltfläche [Ende] geklickt wurde, oder 15 Minuten nachdem die Live-Übertragung vom System beendet wurde.

l 104 gesperrt: Zeigt an, dass die Übertragung beendet wurde wurde aufgrund von Betriebsstrafen aufgrund von Verstößen gesperrt;

l 105 Angehalten: zeigt an, dass die Live-Übertragung durch die Bedienung in der MP-Applet-Hintergrundkonsole angehalten wurde;

l 106 Ausnahme: Zeigt an, dass in den Hintergrund gewechselt wird Wenn die Live-Übertragung innerhalb von 15 Minuten wiederhergestellt wird oder die Verbindung zum Internet unterbrochen wird, wird davon ausgegangen, dass sie sich in einem abnormalen Zustand befindet wird vom System zum Beenden gezwungen;

l 107 Abgelaufen: Dies bedeutet, dass der Live-Übertragungsraum nicht gestartet wurde und die Endzeit des Live-Übertragungsplans beim Erstellen des Live-Übertragungsraums im MP-Applet-Hintergrund eingetragen wurde erreicht ist, wird davon ausgegangen, dass die Live-Übertragung abgelaufen ist und nicht erneut gesendet werden kann. Player-Plugin oben auf der Mini-Programmseite. Der Beispielcode lautet wie folgt:

let livePlayer = requirePlugin('live-player-plugin') // Führt die Schnittstelle ein, um den Live-Übertragungsstatus abzurufen

// Zurück zum Live-Übertragungsstatus sofort nach der ersten Erfassung und Abfrage, um den Live-Übertragungsstatus alle 1 Minute oder langsamer zu erhalten Folgende Parameter

shareTicket: Geben Sie die Live-Übertragungsraumkarte für die WeChat-Gruppe frei. Nachdem Sie auf diese Karte geklickt haben, können Sie die Parameter in ApponShow abrufen

room_id: Klicken Sie auf den Regalproduktsprung auf der Live-Übertragungskomponentenseite Sie gehen zur Produktdetailseite des Händler-Applets, der Raumnummernparameter wird angezeigt

4 Die Schnittstelle [Live-Raumliste abrufen] ist nur für Hintergrundanrufe

Schnittstellenregeln:

该接口仅供商家后台调用，调用限额500次/天，建议开发者自己做缓存（此接口与下面【获取回放视频】接口共用500次/天限制，请合理分配调用频次）。

请求URL：

http://api.weixin.qq.com/wxa/business/getliveinfo?access_token= 

请求方式：

POST

请求示例：

Request

{

 "start": 0, // 起始拉取房间，start=0表示从第1个房间开始拉取

 "limit": 10 // 每次拉取的个数上限，不要设置过大，建议100以内

}



Response

{

 "errcode": 0, // errcode=0代表成功；errcode=1代表未创建直播房间

 "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后台创建直播房间，否则会报错（错误码1）

• cover_img 封面图片url

• start_time 直播计划开始时间，列表按照 start_time 降序排列

• end_time 直播计划结束时间

• anchor_name 主播名

• goods 商品列表

• live_status 直播状态   101: 直播中, 102: 未开始, 103: 已结束, 104: 禁播, 105: 暂停中, 106: 异常,107:已过期（直播状态解释可参考【获取直播状态】接口）

5.   【获取回放源视频】接口，仅供后台调用

接口规则：

该接口仅供商家后台调用，调用限额500次/天，此接口与上面【获取房间列表】接口共用500次/天限制，请合理分配调用频次）。

 

接口说明：

• 该接口可在直播结束后拿到回放源视频（直播结束后大约10分钟会生成回放，源视频无评论等内容）

• 拿到源视频后需要开发者自行开发、使用回放视频

• 如果把源视频直接放在小程序上使用，需要小程序具备视频资质（具体资质要求请参考《小程序开发的类目服务》）

后续官方会直接提供无需开发的直播回放功能，敬请期待。

请求URL：

http://api.weixin.qq.com/wxa/business/getliveinfo?access_token= 

请求方式：

POST

请求示例：

Request

{

"action": "get_replay", // 获取回放

"room_id": 354, // 直播间id

"start": 0, // 起始拉取视频，start=0表示从第1个视频片段开始拉取

"limit": 10 // 每次拉取的个数上限，不要设置过大，建议100以内

}



Response

{

"live_replay": [  

{

      "expire_time": "2020-11-11T03:49:55Z", // 回放视频url过期时间

      "create_time": "2019-11-12T03:49:55Z", // 回放视频创建时间

      "media_url": "http://xxxxx.vod2.myqcloud.com/xxxxx/xxxxx/f0.mp4" // 回放视频   

} 

], 

"errcode": 0, 

"total": 1, 

"errmsg": "ok"

} // 一场直播可能会产生多个视频片段。

四、其他说明

1、直播间小程序码

说明：

• 小程序引入直播组件后必须进行一次小程序发布上线，否则小程序码不生效

• 在MP小程序直播后台创建好直播间后，可以直接拿到直播间分享小程序码，无需额外开发

如果商家在后台自己生成的直播间小程序码，需要做以下配置（否则直播间左上角返回键将失效）：

在跳转进入直播间的路径加上 type=9 标识场景入口为小程序码：

"plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=[直播房间id]&type=9"

2、商家公众号文章添加小程序卡片

说明：

商家在公众号文章中添加跳转进入直播间的小程序卡片时，需要做以下配置（否则直播间左上角返回键将失效）：

在跳转进入直播间的路径加上 type=10 标识场景入口为小程序卡片：

"plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=[直播房间id]&type=10"

3、商品详情页面需添加返回按钮

点击直播组件页面里的货架商品跳转到商家小程序的商品详情页面后，为了避免用户无法再返回直播间，商家需在小程序商品详情页面左上角加上返回按钮，用于返回到直播组件页面。

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

商家小程序对应的管理员微信号收到【公众平台安全助手】下发的直播组件版本更新的服务通知后，可点击通知进行快速发布，移动端即可快速更新小程序内直播组件的新版本，无需修改代码或重新提交审核。

服务通知如下图所示：

相关推荐：小程序开发教程

Das obige ist der detaillierte Inhalt vonImplementieren Sie die Live-Übertragungsfunktion eines Miniprogramms über die Live-Übertragungskomponente. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!