@besovideo/webrtc-player 0.8.93 → 0.8.95

package/README.md

@@ -7,6 +7,7 @@
 ## 简介 Introduction
 
 > 设备视频播放、对讲封装
+[Webrtc 与 平台接口关系](README.webrtc.md)
 
 ## 安装 Installation
 
@@ -169,10 +170,10 @@ instance.playerStatus : {
     Get(): {type: "recordStart" | "recordStop"},
     // 设置录像状态
     Set(status: {type: "recordStart" | "recordStop"}): void;
-    // 添加事件监听
-    addEventListener(handle: ((status: {type: "recordStart" | "recordStop"}) => void)):void;
+    // 添加事件监听, type == "recordStop" recordInfo 才有值
+    addEventListener(handle: ((status: {type: "recordStart" | "recordStop", recordInfo?: { data: Blob, cancelAutoDownload: () => void} }) => void)):void;
     // 移除事件监听
-    removeEventListener(handle: ((status: {type: "recordStart" | "recordStop"}) => void)):void;
+    removeEventListener(handle: ((status: {type: "recordStart" | "recordStop", recordInfo?: {data: Blob, cancelAutoDownload: () => void} }) => void)):void;
   },
   rotate: {
     // 获取旋转状态，顺时针方向

package/README.webrtc.md

@@ -0,0 +1,21 @@
+这个包封装了[平台接口](https://bvcsp.apifox.cn/)流媒体相关的操作。
+包含 实时视频 对讲 会议的流媒体 操作
+
+流媒体基于webrtc 和 bvrtc两种
+
+### 先介绍Webrtc，介绍之后说下webrtc和bvrtc的区别：
+
+[简介](https://developer.mozilla.org/zh-CN/docs/Web/API/WebRTC_API/Session_lifetime)
+
+[Webrtc的信令事务流程](https://developer.mozilla.org/zh-CN/docs/Web/API/WebRTC_API/Signaling_and_video_calling#%E4%BF%A1%E4%BB%A4%E4%BA%8B%E5%8A%A1%E6%B5%81%E7%A8%8B)
+
+
+[平台接口打开设备音视频流webrtc](https://bvcsp.apifox.cn/api-171249025)接口用作信令交互，就是上图中交互[SDP](https://developer.mozilla.org/zh-CN/docs/Glossary/SDP)。
+
+通过webrtc打开设备实时视频 本包封装的过程就是，
+1、创建 const rtcPC = RTCPeerConnection
+2、创建Offer const {type, sdp} = await [rtcPC.createOffer()](https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/createOffer)
+3、设置本地SDP  await [rtcPC.setLocalDescription](https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/setLocalDescription)({type, sdp})
+4、通过 [平台接口打开设备音视频流webrtc](https://bvcsp.apifox.cn/api-171249025) 发送SDP到服务器，收到远程SDP, 保存 const remoteSDP = await post('/bvcsp/v1/dialog/device/webrtc', {...});
+5、设置rtcPC的远程SDP [rtcPC.setRemoteDescription()](https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/setRemoteDescription)({type: 'anwser', sdp: remoteSDP})
+