全部产品

管理通话应用

在通话应用列表页面,您可以查看通话应用的详细信息,以及配置音视频通话等相关功能。

查看通话应用

在通话应用列表页面,您可以查看通话应用的名称、bizName、自动录制状态、创建时间以及密钥。其中:

  • 通话应用名称:创建应用时输入的名称,可编辑。
  • bizName:音视频通话场景码,应用创建后自动生成。使用同一个 bizName 的各个终端之间可以进行音视频通话。
  • 自动录制状态:自动录制是否开启。可点击 操作 列中的 功能配置 进行配置。
  • 创建时间:通话应用的创建时间。
  • 密钥:应用创建后自动生成,用于在服务端生成签名。点击 查看文档 可查看密钥使用说明。
    key

功能配置

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

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

录制信息回调接口

录制信息回调接口由业务自定义,在控制台配置时填入。

  • 回调请求方式:POST application/json
  • 请求数据字段如下表所示。
    字段 类型 是否必传 说明
    bizRequestId String 请求 ID
    bizName String 业务标识
    appId String mPaaS 应用的 ID
    workspaceId String 工作空间 ID
    roomId String 房间号 ID
    recordId String 录制 ID
    eventCode int 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 回调请求中的 bizRequestId
code int 状态码,成功为 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. }