From 0a1bafc6f510e020217492850f4d8b1a039c861d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=A4=8F=E6=A5=9A?= <771730766@qq.com> Date: Mon, 22 Sep 2025 21:51:28 +0800 Subject: [PATCH] =?UTF-8?q?Created=20zlmediakit=20webrtc=E9=87=8D=E7=A3=85?= =?UTF-8?q?=E6=9B=B4=E6=96=B0=20(markdown)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zlmediakit-webrtc重磅更新.md | 63 ++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 zlmediakit-webrtc重磅更新.md diff --git a/zlmediakit-webrtc重磅更新.md b/zlmediakit-webrtc重磅更新.md new file mode 100644 index 0000000..95595c6 --- /dev/null +++ b/zlmediakit-webrtc重磅更新.md @@ -0,0 +1,63 @@ +## 一、摘要 +在8月10号，我们在github收到了一个来自 @baigao-X 同学的[重磅pr](https://github.com/ZLMediaKit/ZLMediaKit/pull/4389)(pull request, 拉取合并请求)。简而言之，该pr实现了完整的webrtc ice-full功能，也就是说，zlmediakit在该分支可以实现完整的webrtc功能，不仅仅包括之前基于ice-lite实现的webrtc服务端，还能作为webrtc客户端在NAT内主动发起webrtc请求。基于该特性，zlmediakit可以作为webrtc播放器主动拉流，也可以作为webrtc推流器主动推流，还可以作为P2P客户端双向视频会话。 + +## 二、功能介绍 + +### 2.1、作为webrtc播放器 +- 使用addStreamProxy http api主动拉取webrtc流并代理： +![](https://github.com/user-attachments/assets/fe9b7be5-ab99-4873-a2a3-ad436bc525ce) +![](https://github.com/user-attachments/assets/fd666589-b7da-4a0e-9759-247e308cc898) + +- 使用MediaPlayer(c++)接口播放webrtc流: +![](https://github.com/user-attachments/assets/f619438f-ba95-4120-ba92-5991745d476d) +![](https://github.com/user-attachments/assets/33de1598-709b-47ba-b5b9-a1059abb3f0f) +> 用法请参考 https://github.com/ZLMediaKit/ZLMediaKit/blob/master/player/test_player.cpp + +- 使用mk_player(c sdk)接口播放webrtc流: +![](https://github.com/user-attachments/assets/2817e7c9-215c-4c1f-b406-baaa7078110c) +> 用法请参考 https://github.com/ZLMediaKit/ZLMediaKit/blob/master/api/tests/player_opencv.c + + +### 2.2、作为webrtc推流器 +- 使用addStreamPusherProxy主动推送webrtc流： +![](https://github.com/user-attachments/assets/58d36e90-ff78-42a1-89b3-9f1f789e9b2e) +![](https://github.com/user-attachments/assets/a04165c7-14d5-4068-8f4a-1767efe99b39) + + - 使用MediaPusher(c++)接口主动推送webrtc流： +![](https://github.com/user-attachments/assets/c633f10b-98c3-4d2e-8259-1eb88098a3b8) +![](https://github.com/user-attachments/assets/556c0b58-799b-4693-b417-847b2ab39d44) +> 用法请参考：https://github.com/ZLMediaKit/ZLMediaKit/blob/master/tests/test_pusherMp4.cpp + + - 使用mk_pusher(c sdk)接口主动推送webrtc流： +![](https://github.com/user-attachments/assets/c7efc5f7-49ee-4711-b6c1-a95e9498fdae) +![](https://github.com/user-attachments/assets/b16c3068-f603-4d5a-b41d-ffd0920df5c9) +> 用法请参考: https://github.com/ZLMediaKit/ZLMediaKit/blob/master/api/tests/h264_pusher.c + +### 2.3、更多用法介绍 +另外还支持p2p相关功能，详情请参考：https://github.com/ZLMediaKit/ZLMediaKit/blob/master/webrtc/USAGE.md + +## 三、快速尝鲜 +- 通过docker方式： +```bash +#此镜像为github action 持续集成自动编译推送，跟代码(master分支)保持最新状态 +docker run -id -p 1935:1935 -p 8080:80 -p 8443:443 -p 8554:554 -p 10000:10000 -p 10000:10000/udp -p 8000:8000/udp -p 9000:9000/udp zlmediakit/zlmediakit:master +``` + +- 通过二进制包： +用户可以在该issue下载zlmediakit最新代码自动发布的二进制包： +https://github.com/ZLMediaKit/ZLMediaKit/issues/483 + +## 四、友情提示 +- 关于稳定性： +在经过一个多月的审核、完善(共计70多个提交)、测试工作后，该pr目前已经合并进master主分支并升级为9.0版本，原稳定主分支存档为8.0分支。目前经过我们的测试，原有功能(作为webrtc服务端)基本可以保障稳定运行，其他非webrtc相关功能改动很小，大家可以放心使用。但是由于webrtc ice相关代码经过重构，变动极大，测试和审核并不能面面俱到，新增的webrtc客户端相关功能，可能还尚待稳定。 + +- 关于url格式： +目前zlmediakit的webrtc客户端url采用webrtc[s]://前缀私有格式，代码逻辑在发现为该前缀后会根据一定的规则解析并且生成zlmediakit特有的whip、whep url(http[s])。所以目前zlmediakit还不能支持其他服务器的whip、whep url，用户可以通过[修改代码](https://github.com/ZLMediaKit/ZLMediaKit/blob/c82dd750548e136d80b08e57febea15ed62bc130/webrtc/WebRtcClient.cpp#L93) 兼容其他第三方webrtc服务器。 + +- 缺陷 +目前webrtc客户端相关功能还不支持webrtc over tcp模式，只支持over udp模式。 + + +## 五、致谢 +在此，对 @baigao-X 同学的卓越贡献表示由衷的感谢！他对zlmediakit以及zltoolkit做出许多重要的贡献，包括zlmediakit中srt模块对客户端的完整支持，以及zltoolkit中kcp协议的支持。同时也非常感谢 @mtdxc 同学大量参与本次代码审核工作以及长期以来对zlmediakit webrtc相关功能以及转码分支的贡献。 +另外，还非常感谢其他开发者对zlmediakit的厚爱和支持，以及广大开发者对zlmediakit的信任和意见建议。 \ No newline at end of file