WebRTC接口设计与CDN集成方案

webrtc.jpeg

编解码能力

WebRTC目前视频编解码支持VP8/VP9/H264, 音频默认支持OPUS。

考虑到跟RTMP互通, 视频编解码码限定支持H264, 音频编解码限定支持OPUS

其中H264不支持B帧。

WebRTC 拉流设计

在WebRTC拉流的时候, 上行有可能是RTMP/WebRTC或者其他的协议,此部分以上行为RTMP输入为准进行设计。

如果上行为WebRTC, 下文中的streamurl可以做响应的改动,比如webrtc://domain/app/stream

拉流

拉流URL

schema://domain:port/rtc/v1/play

schema: http或者https
method: POST
content-type: json

请求参数

{
  streamurl: 'webrtc://domain/app/stream',
  sdp: string,  // offer sdp
  clientip: string // 可选项, 在实际接入过程中,拉流请求有可能是服务端发起,为了更好的做就近调度,可以把客户端的ip地址当做参数,如果没有此clientip参数,CDN放可以用请求方的ip来做就近接入。
}

HTTP响应

{
  code: int,
  msg:  string,
  data: {
    sdp:string,   // answer sdp 
    sessionid:string // 该路下行的唯一id
  }
}

HTTP响应code码

200:  正常影响
400:  请求不正确,URL 或者 参数不正确
403:  鉴权失败
404:  该流不存在
500:  服务内部异常  

停止拉流

停止拉流URL

schema://domain:port/rtc/v1/unplay

schema: http或者https
method: POST
content-type: json

请求参数

{
  code:int,
  msg:string,
  data:{
    streamurl: 'webrtc://domain/app/stream',
    sessionid:string // 拉流时返回的唯一id
  }
}

HTTP响应code码

200:  正常影响
400:  请求不正确,URL 或者 参数不正确
403:  鉴权失败
404:  该流不存在
500:  服务内部异常  

WebRTC 推流设计

推流

推流URL

schema://domain:port/rtc/v1/publish

schema: http或者https
method: POST
content-type: json

请求参数

{
  streamurl: 'webrtc://domain/app/stream',
  sdp: string,  // offer sdp
  clientip: string // 可选项, 在实际接入过程中,该请求有可能是服务端发起,为了更好的做就近调度,可以把客户端的ip地址当做参数,如果没有此clientip参数,CDN放可以用请求方的ip来做就近接入。
}

HTTP响应

{
  code:int,
  msg:string,
  data:{
    sdp:string,   // answer sdp 
    sessionid:string // 该路推流的唯一id
  }
}

HTTP响应code 码

200:  正常影响
400:  请求不正确,URL 或者 参数不正确
403:  鉴权失败
409:  该流已经存在  

停止推流

停止推流URL

schema://domain:port/rtc/v1/unpublish

schema: http或者https
method: POST
content-type: json

请求参数

{
  streamurl: 'webrtc://domain/app/stream',
  sessionid:string // 推流时返回的唯一id
}

HTTP响应

{
  code:int,
  msg:string
}

HTTP响应code码

200:  正常影响
400:  请求不正确,URL 或者 参数不正确
403:  鉴权失败
404:  该流不存在
500:  服务内部异常  

鉴权设计

URL: schema://domain/v1/publish?token=xxxxxx

推拉流的URL应当支持token或者其他的query参数, WebRTC-CDN中可以根据请求的token或者query参数来做鉴权

状态上报设计

为了方便CDN调式定位流出现的问题,需要定时上报流的状态,状态上报设计为可选

状态上报URL

schema://domain:port/v1/stream

schema: http或者https
method: POST
content-type: json

请求参数

{
  stats:json   // stats from peerconnection.getStats
}

与RTMP的互通

在设计的WebRTC的时候要考虑到对接原有的RTMP系统, WebRTC-CDN URL Schema 设计为与RTMP一致。 如果想要WebRTC系统和RTMP系统进行互通,CDN需要做音频的转码重采样和协议的转封装。
在上行WebRTC下行RTMP的时候,CDN需要把opus编码的音频转码为aac, WebRTC的的opus默认为48k采样率,RTMP中的AAC大多是44.1k采样率,这里需要重采样。相反RTMP协议转封装为WebRTC的过程中,
需要把aac转码为opus, 并做重采样。

流的保活

WebRTC的流需要保活, WebRTC默认2.5s发送一次Stun Binding Request, 服务端可以监听此Bingding equest, 在5秒内没有收到此请求可以主动将流清理, 完成资源的释放。

Q.E.D.

知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议

Do what i love and just do it !