跳转至

Custom recorder

为满足客户动态指定房间进行录制及远程调用启动录制服务的需求,融云提供了 API 接口实现启动、停止录制操作。

采用自定义异步录制方式,需要修改底层录制服务程序的 global.conf 配置 recordType=2 为自定义异步录制,修改后重启服务。

异步开启录制

URL:/customrecord/start

HTTP 方法:POST

POST /customrecord/start
Host: 录制程序部署的 ip:port
Content-Type: application/json

{
    "userId": "57a53c03-a1ca-d4f6-1a25-18d8c26ea488",
    "channelId": "13322232"
}

表单参数

名称 类型 说明
userId String 房间内用户的 Id
channelId String 房间 Id

注:userid 和 channelId 至少需要传一个,服务会根据这两个参数之一来找到对应需要录制的房间

返回值

{
  "code":200,
  "msg":"OK"
}
名称 类型 说明
code Int 返回码,200 为正常。
msg String OK 为正常。
异步关闭录制

URL:/customrecord/stop

HTTP 方法:POST

POST /customrecord/stop HTTP/1.1
Host: 录制程序部署的 ip:port
Content-Type: application/json

{
    "userId": "57a53c03-a1ca-d4f6-1a25-18d8c26ea488",
    "channelId": "133222323llj"
}

表单参数

名称 类型 说明
userId String 房间内用户的 Id,(必传)
channelId String 房间 Id(必传)

注:userid 和 channelId 至少需要传一个,服务会根据这两个参数之一来找到对应需要录制的房间

返回值

{
  "code":200,
  "msg":"OK"
}
名称 类型 说明
code Int 返回码,200 为正常。
msg String OK 为正常。