跳到主要内容

开始播放

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

开通服务​

在使用云播放 API 之前，请确认已开通云播放服务：

  1. 首先在融云控制台 RTC 服务的服务购买页面开通云播放服务。
  2. 然后在 RTC 服务的功能配置页面的云播放中配置用户所在区域。

请求方法​

POST: https://数据中心域名/v2/rtc/cloudplayer/start

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

正文参数​

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

参数说明备注
user_idString用户 ID。如果用户当前正在当前房间内发流，则会替换该用户当前流。
user_nameString用户名。
media_typeNumber媒体类型。0 为音视频。1 为纯音频。2 为纯视频。
room_typeNumber房间类型。0 为普通音视频房间。2 为直播房间。
rtmp_urlString流媒体资源的公网地址。
callback_urlString状态回调地址。RTMP 的状态回调会发送到这个地址。
rtsp_transportStringRTSP 流 transport 格式。可选 tcp 或 udp。外网 RTSP 地址一般用 tcp。不传时默认 tcp。

请求示例​

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

{
    "user_id": "cloud_player_001",
    "user_name": "云播放器",
    "rtmp_url": "rtmp://live.example.com/live/stream",
    "media_type": 0,
    "room_type": 2,
    "callback_url": "https://your-server.com/callback"
}

返回结果​

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

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

返回结果示例​

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

{
    "code": 10000
}
最后于 更新