ZLMRTCClient配置说明与用法（含示例）

webRTC播放视频

后面在项目中会用到通过推拉播放视频流的技术，所以最近预研了一下webRTC

首先需要引入封装好的webRTC客户端的js文件ZLMRTCClient.js

下面是地址需要的自行下载

http://my.zsyou.top/2024/ZLMRTCClient.js

配置说明

new ZLMRTCClient.Endpoint({})

1. element: 一个HTML视频元素的ID或引用，用于显示接收到的远程媒体流。这通常是一个video元素。
2. debug: 一个布尔值，指定是否启用调试模式。如果启用，则会输出调试日志，有助于问题的排查和调试。
3. zlmsdpUrl: 这是一个URL，指向用于SDP（会话描述协议）消息交换的服务器。在WebRTC通信中，SDP消息用于协商媒体流的参数，如编解码器、IP地址和端口等。
4. simulcast: 一个布尔值，指定是否启用多路复用（Simulcast）。多路复用允许同时发送多个分辨率和比特率的视频流，以便客户端可以根据其网络条件和能力选择合适的流。
5. useCamera: 一个布尔值，指定是否使用摄像头作为视频源。如果为false，可能需要使用屏幕共享或其他视频源。
6. audioEnable: 一个布尔值，指定是否启用音频流。
7. videoEnable: 一个布尔值，指定是否启用视频流。
8. recvOnly: 一个布尔值，指定是否仅接收媒体流（即作为接收端）。如果为true，则不会发送本地媒体流到远端。
9. resolution: 一个对象，指定期望的视频分辨率。包含w（宽度）和h（高度）属性。如果这两个值非零，则用于设置视频流的分辨率。
10. usedatachannel: 一个布尔值，指定是否使用数据通道（DataChannel）。数据通道允许在WebRTC连接上直接发送和接收任意数据。

方法

• receive():
  作用：将Endpoint实例配置为仅接收模式。在这个模式下，Endpoint不会发送本地媒体流到远端，而是监听并接收来自远端的媒体流。

• start():
  作用：启动Endpoint实例，允许它发送和接收媒体流。此方法会根据配置决定是否开启摄像头和麦克风，并尝试与远端建立连接。

• sendMsg(data):
  作用：发送消息通过数据通道。如果数据通道已打开，此方法将指定的数据发送给远端。

• closeDataChannel():
  作用：关闭数据通道（如果已打开）。此方法会尝试关闭与远端的数据通道连接，并清理相关资源。

• close():
  作用：关闭Endpoint实例。此方法会关闭WebRTC连接（如果已建立）、关闭数据通道（如果已打开），并清理所有相关资源。

• _onIceCandidate(event):
  作用：内部方法，用于处理ICE候选者信息的接收。ICE（Interactive Connectivity Establishment）是WebRTC用于NAT和防火墙穿越的技术。此方法会将ICE候选者信息记录并可能发送给远端（未在代码片段中直接展示发送逻辑）。

• _onTrack(event):
  作用：内部方法，用于处理接收到的媒体轨道（如音频或视频轨道）。当从远端接收到新的媒体轨道时，此方法会被触发，并将媒体轨道添加到本地渲染的媒体流中。

• _onIceCandidateError(event):
  作用：内部方法，用于处理ICE候选者错误。当ICE候选者收集过程中发生错误时，此方法会被触发，并可能记录错误信息或执行其他错误处理逻辑。

• _onconnectionstatechange(event):
  作用：内部方法，用于处理连接状态的变化。当WebRTC连接的状态发生变化时（如连接建立、断开等），此方法会被触发，并可以据此更新UI或执行其他逻辑。

• _onDataChannelOpen(event):
  作用：内部方法，用于处理数据通道打开的事件。当使用数据通道时，一旦数据通道成功打开，此方法会被触发。

• _onDataChannelMsg(event):
  作用：内部方法，用于处理通过数据通道接收到的消息。当数据通道接收到新消息时，此方法会被触发，并处理接收到的消息。

• _onDataChannelErr(event):
  作用：内部方法，用于处理数据通道错误。当数据通道发生错误时，此方法会被触发，并可能记录错误信息或执行其他错误处理逻辑。

• _onDataChannelClose(event):
  作用：内部方法，用于处理数据通道关闭的事件。当数据通道被关闭时，此方法会被触发，并可以据此清理相关资源。

用法

首先需要在html中引入文件

<!--  index.html--><script type="text/javascript" src="http://my.zsyou.top/2024/ZLMRTCClient.js"></script>

<!--  app.vue-->
<template><div class="app-container"><InputSearchv-model:value="videoUrl"placeholder="input search text"size="large"@search="onSearch"><template #enterButton><Button @click="btnPlay()">播放</Button></template></InputSearch><div id="rtcPlayer"><video id='webRtcPlayerBox' autoplay controls style="text-align:left;">Your browser is too old which doesn't support HTML5 video.</video></div></div>
</template><script setup>
import {nextTick, onUnmounted, ref} from 'vue'
import {Button, InputSearch, message} from 'ant-design-vue'const videoUrl = ref('')
let webrtcPlayer = nullfunction btnPlay() {nextTick(() => {if (typeof (videoUrl.value) == "undefined" || videoUrl.value === '') {return message.error('请填写视频地址')}play(videoUrl.value)})
}let timer = nullfunction play(url) {webrtcPlayer = new ZLMRTCClient.Endpoint({element: document.getElementById('webRtcPlayerBox'),// TML视频元素的ID或引用，用于显示接收到的远程媒体流。通常是一个<video>元素debug: true,// 指定是否启用调试模式。如果启用，则会输出调试日志，有助于问题的排查和调试。zlmsdpUrl: url,//这是一个URL，指向用于SDP（会话描述协议）消息交换的服务器。在WebRTC通信中，SDP消息用于协商媒体流的参数，如编解码器、IP地址和端口等。simulecast: false,//指定是否启用多路复用（Simulcast）。多路复用允许同时发送多个分辨率和比特率的视频流，以便客户端可以根据其网络条件和能力选择合适的流。useCamera: false,//指定是否使用摄像头作为视频源。如果为false，可能需要使用屏幕共享或其他视频源。audioEnable: true,//指定是否启用音频流。videoEnable: true,//指定是否启用视频流。recvOnly: true,//指定是否仅接收媒体流（即作为接收端）。如果为true，则不会发送本地媒体流到远端。usedatachannel: false,//指定是否使用数据通道（DataChannel）。数据通道允许在WebRTC连接上直接发送和接收任意数据。//resolution: // 一个对象，指定期望的视频分辨率。包含w（宽度）和h（高度）属性。如果这两个值非零，则用于设置视频流的分辨率。})webrtcPlayer.on(ZLMRTCClient.Events.WEBRTC_ICE_CANDIDATE_ERROR, (e) => {// ICE 协商出错console.error('ICE 协商出错')eventcallbacK("ICE ERROR", "ICE 协商出错")});webrtcPlayer.on(ZLMRTCClient.Events.WEBRTC_ON_REMOTE_STREAMS, (e) => {//获取到了远端流，可以播放console.log('播放成功', e.streams)eventcallbacK("playing", "播放成功")});webrtcPlayer.on(ZLMRTCClient.Events.WEBRTC_OFFER_ANWSER_EXCHANGE_FAILED, (e) => {// offer anwser 交换失败console.error('offer anwser 交换失败', e)eventcallbacK("OFFER ANSWER ERROR ", "offer anwser 交换失败")if (e.code == -400 && e.msg == "流不存在") {console.log("流不存在")timer = setTimeout(() => {webrtcPlayer.close();play(url)}, 100)}});webrtcPlayer.on(ZLMRTCClient.Events.WEBRTC_ON_LOCAL_STREAM, (s) => {// 获取到了本地流// document.getElementById('selfVideo').srcObject=s;eventcallbacK("LOCAL STREAM", "获取到了本地流")});}/*** 停止播放*/
function pause() {if (webrtcPlayer != null) {webrtcPlayer.close();webrtcPlayer = null;}}function eventcallbacK(type, message) {console.log("player 事件回调", type, message)
}onUnmounted(() => {clearTimeout(timer)
})</script><style>
.app-container {min-width: 50vw;
}#rtcPlayer {width: 100%;background: #c1c1c1;
}#webRtcPlayerBox {width: 100%;max-height: 56vh;background-color: #000;
}
</style>