zlmediakit webrtc重磅更新
夏楚 edited this page 2025-09-22 21:51:28 +08:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

一、摘要

在8月10号我们在github收到了一个来自 @baigao-X 同学的重磅pr(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流并代理

  • 使用MediaPlayer(c++)接口播放webrtc流:

用法请参考 https://github.com/ZLMediaKit/ZLMediaKit/blob/master/player/test_player.cpp

  • 使用mk_player(c sdk)接口播放webrtc流:

用法请参考 https://github.com/ZLMediaKit/ZLMediaKit/blob/master/api/tests/player_opencv.c

2.2、作为webrtc推流器

  • 使用addStreamPusherProxy主动推送webrtc流

  • 使用MediaPusher(c++)接口主动推送webrtc流

用法请参考:https://github.com/ZLMediaKit/ZLMediaKit/blob/master/tests/test_pusherMp4.cpp

  • 使用mk_pusher(c sdk)接口主动推送webrtc流

用法请参考: 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方式
#此镜像为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

四、友情提示

  • 关于稳定性: 在经过一个多月的审核、完善(共计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用户可以通过修改代码 兼容其他第三方webrtc服务器。

  • 缺陷 目前webrtc客户端相关功能还不支持webrtc over tcp模式只支持over udp模式。

五、致谢

在此,对 @baigao-X 同学的卓越贡献表示由衷的感谢他对zlmediakit以及zltoolkit做出许多重要的贡献包括zlmediakit中srt模块对客户端的完整支持以及zltoolkit中kcp协议的支持。同时也非常感谢 @mtdxc 同学大量参与本次代码审核工作以及长期以来对zlmediakit webrtc相关功能以及转码分支的贡献。 另外还非常感谢其他开发者对zlmediakit的厚爱和支持以及广大开发者对zlmediakit的信任和意见建议。