跳到主要内容

开始播放(旧版)

注意

  • 从 2022.11.17 开始,废弃此接口。请使用新版云播放器(开始播放停止播放)接口。
  • 如果您的业务需要使用云端录制,请注意融云服务端不解析通过云播放器 API(旧版)输入房间的媒体流的分辨率,导致云端录制服务无法按流实际分辨率进行录制。如果希望按实际分辨率录制媒体流,建议使用新版云播放器接口。

向指定 RTC 房间输入在线媒体流时,调用时需要虚拟一组用户信息,并配置媒体流地址、资源类型、房间 ID 等信息。调用成功后,在房间中的其他人订阅该媒体流。订阅方式与订阅房间内其他用户发布的资源的方式一致。

开通服务

在使用云播放 API 之前,请确认已开通云播放服务。前往控制台云播放页面开通服务。

请求方法

注意

从 2022.11.17 开始,废弃此接口。

POST: http://api.rong-api.com/v2/rtc/cloudplayer/rtmp/start

签名规则: 所有请求融云服务端 API 接口的请求均需要进行规则校验,详见 API 请求签名

正文参数

HTTP 请求正文中包含具有以下结构的 JSON 对象:

参数说明备注
user_idString通话的用户 ID。
user_nameString用户名。
media_typeNumber媒体类型。0 为音视频。1 为纯音频。2 为纯视频。
room_typeNumber房间类型。0 为普通音视频房间。2 为直播房间。
rtmp_urlString流媒体资源的公网地址。
callback_urlString状态回调地址。RTMP 的状态回调会发送到这个地址。

请求示例

POST http://api.rong-api.com/v2/rtc/cloudplayer/rtmp/start HTTP/1.1
Host: api.rong-api.com
App-Key: XXX
RC-Nonce: 1027489915
RC-Timestamp: 1609754958
RC-Signature: 357cef9b529edd1ed4f34bd8df52de00a909914b
Room-Id: 123
Content-Type: application/json

{
"user_id": "xxx",
"user_name": "xxx",
"rtmp_url": "rtmp://xxx",
"media_type":0,
"room_type":2,
"callback_url":"http://xxx"
}

返回结果

HTTP 响应正文包含具有以下结构的 JSON 对象:

  • code:HTTP 响应正文中的业务码,10000 为处理成功。

返回结果示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
"code":10000
}