跳到主要内容

审核状态回调

融云音视频审核服务支持将审核任务命中的违规事件以及审核任务状态实时的通知到您的应用服务器。

开通服务

内容审核为付费增值服务。可登录控制台,在 IM & 音视频审核页面开通音视频审核服务。

在使用内容审核状态回调,请确认已在控制台开通音视频审核服务,并已完成相关配置。

注意

请确保您已经配置音视频审核结果的回调地址。配置完成后,您的 App 内所有房间的音视频审核有任何状态变更,均会通过 HTTP 请求,实时回调您的服务器。回调 URL 必须是公网可访问的 URL 地址。配置后 30 分钟内生效。

回调方法

POST<your-receiving-server-url>

数据格式application/json

回调地址 <your-receiving-server-url> 是您在控制台为当前 App Key 和服务所配置的回调接收地址。请务必配置可正常访问的回调接收地址。如果您的网络有 IP 访问限制,请务必配置 IP 白名单,否则无法正常接收服务端回调。

为了验证数据有效性并确保调用者为融云 Server,每个请求前添加数据签名。回调签名规则详见服务端回调

回调正文参数

该回调服务的 HTTP 请求正文数据格式为 application/json,包含具有以下结构的 JSON 对象:

字段名称类型是否必传说明
typeNumberY回调类型。1:审核开始;2:审核结束;3:审核状态异常;4:审核结果回调
codeNumberY审核任务的状态码
appKeyStringY审核任务所属的 AppKey
roomIdStringY当前审核任务对应的 房间 ID
userIdStringY当前音视频流 对应的用户 ID 
sceneStringN调用开始审核接口时传入的 scene 字段。如手动开始审核时没有传入该字段,回调中该字段为默认值(视频:VIDEO_LIVE, 音频:LIVE_ROOM)
sessionIdStringY当前音视频流 所属的会话 ID
dataObjectN审核任务给出业务相关参数;现在有 角色标识
contentObjectY审核事件详情。数据格式与 type 字段相关。详见下方审核事件详情(content)字段说明

审核事件详情(content)字段说明

  • 当 type = 1,2,3 ( 即 审核开始、审核结束 、审核状态异常 )

    字段名称类型说明
    timestampNumber发生时间戳
    streamIdString审核流ID
    mediaTypeNumber您开通审核时所选的 媒体类型 0:音频 ;1:视频
    errorMessageString审核任务出错时的错误信息
  • 当 type=4 ( 审核结果回调 或 命中审核策略后的反馈)

    字段名称类型说明
    streamId string审核出问题的流
    requestId string审核任务 ID
    contentType number审核任务媒体类型:1 图片 2 声音
    riskLevel number命中问题 的严重程度  1:PASS, 2: REVIEW,3: REJECT
    riskType number审核命中的违规策略类型。详见下方审核命中的违规类型
    riskTime long视频流截帧图片违规发生的时间(绝对时间)  或 音频违规内容开始时间(绝对时间)
    contentUrl string截图或声音片段地址 http/https
    desc string问题详细描述
    matchText string声音文本
    matchedItem string声音匹配的敏感词
    matchedList string声音匹配的敏感词列表
    • 审核命中的违规类型(riskType)说明

      riskType值说明
      0正常
      100涉政
      200色情
      210audio辱骂,image性感
      250audio娇喘
      300广告
      310image二维码
      320image水印
      400image暴恐
      500image违规
      510image不良场景
      700黑名单
      710image白名单
      800image高危账号
      900自定义

回调请求示例

回调请求正文 JSON 示例如下:

{
"type": 2,
"roomId": "112314",
"sessionId": "UkPy0sWFp57zX2KgSemAw9",
"userId": "6688_8889_and",
"appKey": "qf3d5gbjq962h",
"scene": "VIDEO_LIVE"
"code": 200,
"content": {
"errorMessage": "Success",
"mediaType": 1,
"pullURL": "rtmp://ccensor-rtmp.RongCloudRTC_video_622120743647",
"streamId": "6688_8889_and_RongCloudRTC",
"timestamp": 1606121033890
},
"data": {
"role": "RC_CALLInvitee"
}

}