最近更新时间:2023.05.12 11:04:39
首次发布时间:2022.08.30 14:30:09
在订阅 WTN 的媒体流资源之前,你应创建订阅资源。
关于订阅资源,参看 发布资源与订阅资源。
调用此接口,向 WTN 服务端发送 SDP Offer。如果调用成功,WTN 服务端会创建订阅资源,订阅客户端会收到来自 WTN 服务端的 SDP Answer。
创建订阅资源,并开始订阅时,注意:
在 WTN 的机制下,在创建订阅资源前,你必须已成功创建对应的发布资源;否则会收到 404
的响应码。关于如何创建发布资源,参看 创建发布资源。
连接订阅资源以后,并不一定能够收到音视频流。仅在发布客户端发布音视频流时,你才可以收到音视频流。
方法 | POST |
---|---|
接入域名 | https://wtn.volcvideo.com |
接入点 |
|
查询参数 |
|
请求头 |
|
请求体 | data-raw:<SDP Offer> |
是否订阅鉴权在创建发布资源时通过携带的 Token 设置。关于具体设置,参看 鉴权。
curl --location --request POST 'https://wtn.volcvideo.com/sub/<AppID>/<StreamID>' \ --header 'Authorization: Bearer <Token>' \ --header 'Content-Type: application/sdp' \ --data-raw '<SDP Offer>'
参数 | 响应示例 | |
---|---|---|
Status | 201 Created | |
Header | Content-Type | application/sdp |
Location | 订阅资源 url | |
Body | <SDP Answer> |
参数 | 响应示例 | |
---|---|---|
Status | 400 Unknown Request | |
Header | Content-Type | text/plain |
Body | Resource Not Exist |
关于其他的状态码,参考 状态码。