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

        }

      }

    }

  ]

}

Nach dem Login kopieren

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>

Nach dem Login kopieren

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"

  }

}

Nach dem Login kopieren

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>

Nach dem Login kopieren

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

}

Nach dem Login kopieren

返回字段：

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"

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

Nach dem Login kopieren