README.md

English | 简体中文

WebRTC 插件

提供通过网页发布视频到monibuca，以及从monibuca拉流通过webrtc进行播放的功能，遵循WHIP规范

插件地址

https://github.com/Monibuca/plugin-webrtc

插件引入

    import (  _ "m7s.live/plugin/webrtc/v4" )

默认配置

webrtc:
  iceservers: []
  publicip: [] # 可以是数组也可以是字符串（内部自动转成数组）
  port: tcp:9000 # 可以是udp:8000-9000 范围端口，也可以udp:9000 单个端口
  pli: 2s # 2s

ICE服务器配置格式

webrtc:
  iceservers:
    - urls: 
        - stun:stun.l.google.com:19302
        - turn:turn.example.org
      username: user
      credential: pass

本地测试无需修改配置，如果远程访问，则需要配置publicip

基本原理

通过浏览器和monibuca交换sdp信息，然后读取rtp包或者发送rtp的方式进行

API

播放地址

/webrtc/play/[streamPath]

Body: SDP

Content-Type: application/sdp

Response Body: SDP

推流地址

/webrtc/push/[streamPath]

Body: SDP

Content-Type: application/sdp

Response Body: SDP

推流测试页面

/webrtc/test/publish

• 可增加参数?streamPath=xxx指定推流地址，默认为live/webrtc
• 可以增加其他推流参数

屏幕分享测试

/webrtc/test/screenshare

• 可增加参数?streamPath=xxx指定推流地址，默认为live/webrtc
• 可以增加其他推流参数

播放测试页面

/webrtc/test/subscribe

• 可增加参数?streamPath=xxx指定播放地址，默认为live/webrtc
• 可以增加其他播放参数

WHIP

WebRTC-HTTP ingestion protocol 用于WebRTC交换SDP信息的规范

WHIP ietf