最近更新时间：2024.05.16 14:24:26
首次发布时间：2022.08.30 14:30:09
在订阅 WTN 的媒体流资源之前，你应创建订阅资源。
关于订阅资源，参看 发布资源与订阅资源。
调用此接口，向 WTN 服务端发送 SDP Offer。如果调用成功，WTN 服务端会创建订阅资源，订阅客户端会收到来自 WTN 服务端的 SDP Answer。
是否订阅鉴权在创建发布资源时通过携带的 Token 设置。关于具体设置，参看 鉴权。
在 WTN 的机制下，在创建订阅资源前，你必须已成功创建对应的发布资源；否则会收到 404 的响应码。关于如何创建发布资源，参看 创建发布资源 。
连接订阅资源以后，并不一定能够收到音视频流。仅在发布客户端发布音视频流时，你才可以收到音视频流。
创建订阅资源，并开始订阅时，注意：
如果创建订阅资源后 15 秒未开始订阅，订阅资源会被删除，你必须重新创建订阅资源；
如果有多个订阅客户端同时订阅同一个发布资源下的音视频资源，你必须为这些订阅客户端分别创建各自的订阅资源。
请求方式：POST
请求地址：https://wtn.volcvideo.com/sub/<AppID>/<StreamID>
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| AppID | String | 是 | Your_AppId | 应用 ID。在 WTN 控制台上获取。 |
| StreamID | String | 是 | Stream123 | 流 ID。和创建发布资源时设置的值一致。 |
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Content-Type | String | 是 | application/sdp | 请求内容类型。固定值：application/sdp |
| Authorization | String | 是 | {TokenType} {Token} | 当开启了订阅鉴权时，必须传入此参数；未开启订阅鉴权时，不传入此参数。
|
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| SessionID | String | 否 | Session123 | 客户端生成的 ID，用于日志排查。 |
| MuteAudio | Bool | 否 | false | 是否订阅音频数据。
false 。 |
| MuteVideo | Bool | 否 | false | 是否订阅视频数据。
false 。 |
| ClientIP | String | 否 | 123.112.69.85 | 本地的公网 IP 地址（IPV4 或 IPV6）。 只有在订阅业务服务器时才需要设置此参数，WTN 会根据它为业务服务器配置最佳网络资源。 |
| RID | String | 否 | High | 使用 WebRTC 协议发布的 Simulcast 媒体流的 RTP Stream ID。 你可以通过此参数选择订阅多个 Simulcast 媒体流中的指定流。如果不填，那么默认订阅最高档位的 Simulcast 媒体流。
|
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| data-raw | String | 是 | <SDP Offer> | 向服务端发送 SDP Offer |
| 参数 | 类型 | 示例值 | 描述 | |
|---|---|---|---|---|
| Status | String | 201 Created | 接口请求成功 | |
| Header | Content-Type | String | application/sdp | 返回内容的类型 |
| Location | String | https://xxxx.com | 订阅资源 url | |
| Body | String | <SDP Answer> | 收到服务端的 SDP Answer | |
| 参数 | 类型 | 示例值 | 描述 | |
|---|---|---|---|---|
| Status | String | 400 Unknown Request | 未知请求异常 | |
| Header | Content-Type | String | text/plain | 返回内容的类型 |
| Body | String | Resource Not Exist | 资源不存在 | |
curl --location --request POST 'https://wtn.volcvideo.com/sub/<AppID>/<StreamID>' \ --header 'Authorization: Bearer <Token>' \ --header 'Content-Type: application/sdp' \ --data-raw '<SDP Offer>'
<SDP Answer>
您可访问状态码，获取更多状态码信息。