审核状态回调
融云音视频审核服务支持将审核任务命中的违规事件以及审核任务状态实时的通知到您的应用服务器。
开通服务
内容审核为付费增值服务。可登录控制台,在 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 对象:
字段名称 | 类型 | 是否必传 | 说明 |
---|---|---|---|
type | Number | Y | 回调类型。1 :审核开始;2 :审核结束;3 :审核状态异常;4 :审核结果回调 |
code | Number | Y | 审核任务的状态码 |
appKey | String | Y | 审核任务所属的 AppKey |
roomId | String | Y | 当前审核任务对应的 房间 ID |
userId | String | Y | 当前音视频流 对应的用户 ID |
scene | String | N | 调用开始审核接口时传入的 scene 字段。如手动开始审核时没有传入该字段,回调中该字段为默认值(视频:VIDEO_LIVE, 音频:LIVE_ROOM) |
sessionId | String | Y | 当前音视频流 所属的会话 ID |
data | Object | N | 审核任务给出业务相关参数;现在有 角色标识 |
content | Object | Y | 审核事件详 情。数据格式与 type 字段相关。详见下方审核事件详情(content )字段说明。 |
审核事件详情(content
)字段说明
-
当 type = 1,2,3 ( 即 审核开始、审核结束 、审核状态异常 )
字段名称 类型 说明 timestamp Number 发生时间戳 streamId String 审核流ID mediaType Number 您开通审核时所选的 媒体类型 0:音频 ;1:视频 errorMessage String 审核任务出错时的错误信息 -
当 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 色情 210 audio辱骂,image性感 250 audio娇喘 300 广告 310 image二维码 320 image水印 400 image暴恐 500 image违规 510 image不良场景 700 黑名单 710 image白名单 800 image高危账号 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"
}
}