全部产品

管理通话应用

更新时间:2021-03-18 16:15:09

在通话应用列表页面,您可查看通话应用的以下信息:

  • 通话应用名称:创建应用时输入的名称。
  • bizName:音视频通话场景码。使用同一个 bizName 的各个终端之间,可以相互进行音视频通话。
  • 自动录制状态:在 功能配置 中可选择是否开启自动录制。
  • 创建时间:当前通话应用的创建时间。
  • 密钥:当前通话应用的密钥,并查看使用文档。
    key

功能配置

在通话应用列表页,点击应用右侧 操作 列中的 功能配置,可打开当前应用的功能配置页面。

  • 云端自动录制
    开启该开关后,在音视频通话发起时服务端会自动对通话内容进行录制。通话结束时会同时结束录制,并生成录制文件。关闭该开关后,服务端不再自动录制。
    说明:云端录制的默认状态为 停用,需手动开启。
  • 设置录制回调地址
    录制回调地址为使用 HTTP 或 HTTPS 协议的 URL。在设置录制回调地址后,当开始录制、暂停录制、结束录制或录制文件出现异常时,服务端会将相关状态信息发送到该 URL。

录制信息回调

录制信息回调时请求数据字段如下:

字段 类型 必传 说明
bizRequestId String TRUE 请求id
bizName String TRUE 业务标识
appId String TRUE mPaaS 应用的 id
workspaceId String TRUE 工作空间 id
roomId String TRUE 房间号id
recordId String TRUE 录制id
eventCode int TRUE 0:录制某条流成功
10:初始化成功
11:录制结束
99:录制结果
50:录制警告
500301:流断开警告
500302:低帧率警告
1000xx:录制启动阶段失败
100001:连接room失败
100002:加入房间失败
100003:订阅流失败
100004:订阅路数缺失
100005:连接mcu失败
100006:视频长宽比异常
100007:实际自定义混流流数大于设置数目
1001xx:录制过程中失败
100101:录制文件创建失败
100102:录制文件格式转换失败
100103:文件保存失败
100104:音视频分离失败
100105:录制子进程崩溃
100106:磁盘满或者写文件失败
1002xx:录制结束阶段失败
100201:上传文件失败
recordResult json eventCode=99 json body 如下:
  • status:int,录制状态,必传。2:录制成功(持久化文件成功);3:录制失败。
  • fileType:int,文件类型,当 status=2 时传。1:local;2:OSS;3:AFTS;4:HDFS。
  • filePath:string,文件路径,当 status=2 时传。
  • recordStartTime:long,录制第一帧的绝对时间(服务器时间,ms),当 status=2 时传。
  • mediaType:int,录制文件的类型,当 status=2 时传。0:音视频;1:纯音频;2:纯视频。

业务服务器返回数据字段如下:

字段 类型 必传 备注
bizRequestId string TRUE 回调请求中 bizRequestId
code int TRUE 状态码,success=0

请求数据示例:

  1. 请求:
  2. {
  3. "bizRequestId":"123456789",
  4. "bizName":"bizName",
  5. "appId":"appId",
  6. "workspaceId":"workspaceId",
  7. "roomId":"xxxxxx",
  8. "recordId":"record_xxx",
  9. "eventCode":0,
  10. "recordResult": {
  11. "status":2,
  12. "fileType":2,
  13. "filePath":"https://xxxxxx",
  14. "recordStartTime":1592817186122,
  15. "mediaType":0
  16. }
  17. }
  18. 返回数据示例::
  19. {
  20. "bizRequestId":"123456789",
  21. "code":0
  22. }