在将本地音视频流发布到 WTN 和订阅 WTN 的媒体流资源之前，你应创建发布订阅资源。

关于发布订阅资源，参看发布资源和订阅资源。

使用说明

接口行为

调用此接口，向 WTN 服务端发送 SDP Offer。如果调用成功，WTN 服务端会在同一个连接上创建发布订阅资源，发布客户端会收到来自 WTN 服务端的 SDP Answer。

注意事项

后续操作

重复发布

如果创建发布订阅资源前，具有相同的 AppID、PubStreamID 和 SubStreamID 的发布订阅资源已创建，此前的发布订阅资源将被清理，客户端无法与此前的发布订阅资源建立连接，并且已建立的连接将会断开。

请求说明

请求地址：https://wtn.volcvideo.com/webrtc/pub-sub/<AppID>/<PubStreamID>/<SubStreamID>

请求参数

Path

参数	类型	是否必选	示例值	描述
Content-Type	String	是	application/sdp	请求内容类型。固定值：application/sdp。
Authorization	String	否	{TokenType} {Token}	当开启了推流鉴权或拉流鉴权时，必须传入此参数。 TokenType：固定值： Bearer。 Token：参见接口鉴权。
Feedback-Info	String	否	/	媒体服务器节点相关信息。如果创建的 PeerConnection 本次返回RTCPeerConnection.connectionState == failed即 ICE 建联失败，你可在此字段填入上次调用该接口响应 Header 头中 Feedback-Info 和 Query 中 ClientID 的值重新调用该接口创建发布订阅资源，服务端会自动切换媒体服务器节点。更多信息，请参见构建基础应用。 Tip 使用该参数时，你无需关注该字段中的内容，直接将上次请求返回的 Feedback-Info值传入即可。

Query

参数	类型	是否必选	示例值	描述
BusinessID	string	否	www.volc.com	业务 ID，用来唯一标识同一 AppId 下的不同业务。可在 WTN 控制台创建和获取。同一个 AppId 下业务 ID 不允许重复。长度不超过 64 个字符。取值范围为：数字、字母、_、-、@、.。
SessionID	String	否	Session123	客户端生成的 ID，用于日志排查。
ClientIP	String	否	123.XX.XX.85	客户端的公网 IP 地址（仅支持 IPV4）。WTN 服务端会根据它为客户端分配最佳媒体服务器节点，建议携带。默认值为发起 HTTP 请求的 IP。
ClientID	String	否	Client123	客户端 ID，用于标识一个用户。 Tip 建议在每次请求时都填入客户端 ID，用于日志排查。
PubMuteAudio	Bool	否	false	是否发布音频数据。 true ：不发送音频数据； false ：发送音频数据。默认值为 false 。
PubMuteVideo	Bool	否	false	是否发布视频数据。 true ：不发送视频数据； false ：发送视频数据。默认值为 false 。
SubMuteAudio	Bool	否	false	是否订阅音频数据。 true ：不订阅音频数据； false ：订阅音频数据。默认值为 false 。
SubMuteVideo	Bool	否	false	是否订阅视频数据。 true ：不订阅视频数据； false ：订阅视频数据。默认值为 false 。

Body

参数	类型	是否必选	示例值	描述
data-raw	String	是	<SDP Offer>	向服务端发送 SDP Offer

响应结果

成功响应示例

异常响应示例

请求示例

返回示例

状态码

您可访问状态码，获取更多状态码信息。