2024/06/28 14:12:07
使用图普视频审核
本文介绍如何在你的项目中使用图普视频审核。
技术原理
云市场视频审核采用 SDK 截图 + 三方审核的模式。集成声网视频 SDK 后,你可以对声网频道内的视频流使用第三方视频审核服务。当频道内有用户发送视频流时,审核结果会由第三方服务器直接返回到你的服务器。具体流程如下:
- 声网 SDK 从频道内的视频流中截取内容,加密传输至声网服务器。
- 声网服务器对视频流信息进行封装,然后加密传输至第三方审核服务商。
- 第三方审核服务商将声网视频流信息和审核结果返回到你的回调服务器。
- 根据审核结果添加业务逻辑。
信息
你需要自行准备接收审核结果回调的业务服务器。
实现步骤
1. 集成 SDK
第三方视频审核服务需要使用特殊版本的声网视频 SDK。你可以根据需要选择 SDK 版本并参考对应的集成文档:
视频 SDK 版本 | 下载链接 | 参考文档 |
---|---|---|
4.2.3 或以上(推荐) | Android SDK 下载 | 实现视频通话 |
3.x 特殊版 | Android SDK 下载 | 实现视频通话 |
注意
实现视频通话时,请确保使用 AccessToken2 加入声网频道。详见使用 Token 鉴权。
2. 开始审核
本节介绍如何对单个频道内的视频流进行审核。
加入频道并发布视频流后,调用 enableContentInspect
方法开启视频审核。成功开启视频审核后,SDK 会按照设定的频率进行截图。截图将会由声网云端服务器加密传输到第三方审核服务商。
调用 enableContentInspect
方法时,你需要通过 ContentInspectConfig
的以下参数配置视频审核服务:
ContentInspectModule.type
:必须设为CONTENT_INSPECT_TYPE_IMAGE_MODERATION
。ContentInspectModule.interval
:从视频流中截图并送审的时间间隔。serverConfig
:(可选)用于接入多个云市场的视频审核服务并灵活切换。如果需要使用该功能,请联系技术支持。extraInfo
:(可选)附加信息,随审核结果回调一起发送给你的服务器。
示例代码如下:
Java
ContentInspectConfig config = new ContentInspectConfig();
config.extraInfo = "YourExtraInfo";
config.moduleCount = 1;
// 设置功能模块的类型为 SDK 端截图并且使用云市场视频审核服务对视频流审核
config.modules[0].type = ContentInspectConfig.CONTENT_INSPECT_TYPE_IMAGE_MODERATION;
// 设置本地截图上传的频率为 2 秒一次
config.modules[0].interval = 2;
mRtcEngine.enableContentInspect(true, config);
3. 接收审核结果
审核结果中的 tag 字段一定包含以下公共参数:
参数 | 类型 | 描述 |
---|---|---|
source | String | 固定为 "agora" ,代表审核内容是来自声网频道内的视频流。 |
cname | String | 审核结果对应的频道名。 |
uid | Int | 审核结果对应的用户 ID。 |
sid | String | 审核结果对应的用户会话。用户从加入到退出当前频道视为一次会话。 |
requestId | String | 请求 ID,用于标识声网向第三方服务商发送的审核请求。 |
timestamp | Int | 审核结果对应片段的起始时间点。格式为 UTC 时间,时区为 UTC+0,由年、月、日、小时、分钟、秒和毫秒组成。例如:20230110080616876 代表 2023 年 1 月 10 日 8 点 6 分 16 秒 876 毫秒。 |
其它参数解释详见图普异步图片识别的 4. 识别结果回调请求小节。
完整的回调示例如下:
JSON
{
"json": "{\"54bcfc6c329af61034f7c2fc\":{\"fileList\":[{\"label\":1,\"name\":\"http://cos.ap-guangzhou.myqcloud.com/7-1252177232//cloud-api/storage-0831/2023-01-10/18-1/1673346487085260/276271.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256\\u0026X-Amz-Credential=AKIDvc3E8l8D1g4AzXpqZ1TgcHfmcBSTDgso%2F20230110%2Fap-guangzhou%2Fs3%2Faws4_request\\u0026X-Amz-Date=20230110T102807Z\\u0026X-Amz-Expires=86400\\u0026X-Amz-SignedHeaders=host\\u0026X-Amz-Signature=70194025378b808e007b312d49e09f79aec724b6c75f66926c3899808310d2e0\",\"rate\":0.8984967729559958,\"review\":false,\"subLabel\":{\"label\":18,\"rate\":0.21453628821023063,\"review\":false},\"tag\":\"{\\\"callbackData\\\":\\\"test-callbackData\\\",\\\"cname\\\":\\\"test-tupu\\\",\\\"requestId\\\":\\\"B05EE55820AF449EBC007EB1E17A45QQ\\\",\\\"sid\\\":\\\"B05EE55820AF449EBC007EB1E17A4511\\\",\\\"source\\\":\\\"agora\\\",\\\"timestamp\\\":20230110102806386,\\\"uid\\\":123456}\"}],\"reviewCount\":0,\"statistic\":[0,1,0]},\"5b7be1f59b0c77a8c2afb351\":{\"fileList\":[{\"faceId\":\"非政治人物\",\"facePosition\":[[0.30214843,0.1875],[0.50045574,0.1875],[0.50045574,0.36953124],[0.30214843,0.36953124]],\"label\":2,\"name\":\"http://cos.ap-guangzhou.myqcloud.com/7-1252177232//cloud-api/storage-0831/2023-01-10/18-1/1673346487085260/276271.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256\\u0026X-Amz-Credential=AKIDvc3E8l8D1g4AzXpqZ1TgcHfmcBSTDgso%2F20230110%2Fap-guangzhou%2Fs3%2Faws4_request\\u0026X-Amz-Date=20230110T102807Z\\u0026X-Amz-Expires=86400\\u0026X-Amz-SignedHeaders=host\\u0026X-Amz-Signature=70194025378b808e007b312d49e09f79aec724b6c75f66926c3899808310d2e0\",\"objects\":[{\"faceId\":\"非政治人物\",\"facePosition\":[[0.30214843,0.1875],[0.50045574,0.1875],[0.50045574,0.36953124],[0.30214843,0.36953124]],\"faceUrl\":\"\",\"label\":2,\"review\":false,\"similarity\":0,\"typeName\":\"非政治人物\"}],\"review\":false,\"similarity\":0,\"tag\":\"{\\\"callbackData\\\":\\\"test-callbackData\\\",\\\"cname\\\":\\\"test-tupu\\\",\\\"requestId\\\":\\\"B05EE55820AF449EBC007EB1E17A45QQ\\\",\\\"sid\\\":\\\"B05EE55820AF449EBC007EB1E17A4511\\\",\\\"source\\\":\\\"agora\\\",\\\"timestamp\\\":20230110102806386,\\\"uid\\\":123456}\",\"typeName\":\"非政治人物\"}]},\"5e1d634d2809c24f6d909bd3\":{\"fileList\":[{\"label\":0,\"name\":\"http://cos.ap-guangzhou.myqcloud.com/7-1252177232//cloud-api/storage-0831/2023-01-10/18-1/1673346487085260/276271.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256\\u0026X-Amz-Credential=AKIDvc3E8l8D1g4AzXpqZ1TgcHfmcBSTDgso%2F20230110%2Fap-guangzhou%2Fs3%2Faws4_request\\u0026X-Amz-Date=20230110T102807Z\\u0026X-Amz-Expires=86400\\u0026X-Amz-SignedHeaders=host\\u0026X-Amz-Signature=70194025378b808e007b312d49e09f79aec724b6c75f66926c3899808310d2e0\",\"objects\":[],\"rate\":1,\"review\":false,\"tag\":\"{\\\"callbackData\\\":\\\"test-callbackData\\\",\\\"cname\\\":\\\"test-tupu\\\",\\\"requestId\\\":\\\"B05EE55820AF449EBC007EB1E17A45QQ\\\",\\\"sid\\\":\\\"B05EE55820AF449EBC007EB1E17A4511\\\",\\\"source\\\":\\\"agora\\\",\\\"timestamp\\\":20230110102806386,\\\"uid\\\":123456}\"}]},\"5e1d70adeec2874f7318dc52\":{\"fileList\":[{\"label\":0,\"labels\":[0,10,25,8,13],\"name\":\"http://cos.ap-guangzhou.myqcloud.com/7-1252177232//cloud-api/storage-0831/2023-01-10/18-1/1673346487085260/276271.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256\\u0026X-Amz-Credential=AKIDvc3E8l8D1g4AzXpqZ1TgcHfmcBSTDgso%2F20230110%2Fap-guangzhou%2Fs3%2Faws4_request\\u0026X-Amz-Date=20230110T102807Z\\u0026X-Amz-Expires=86400\\u0026X-Amz-SignedHeaders=host\\u0026X-Amz-Signature=70194025378b808e007b312d49e09f79aec724b6c75f66926c3899808310d2e0\",\"rate\":0.9991529339260514,\"rates\":[0.9991529339260514,0.00021821152005362592,0.00014480834910299872,0.00011480319755559418,0.00010425450257236194],\"review\":false,\"tag\":\"{\\\"callbackData\\\":\\\"test-callbackData\\\",\\\"cname\\\":\\\"test-tupu\\\",\\\"requestId\\\":\\\"B05EE55820AF449EBC007EB1E17A45QQ\\\",\\\"sid\\\":\\\"B05EE55820AF449EBC007EB1E17A4511\\\",\\\"source\\\":\\\"agora\\\",\\\"timestamp\\\":20230110102806386,\\\"uid\\\":123456}\"}],\"reviewCount\":0,\"topNStatistic\":[{\"count\":1,\"label\":0}]},\"code\":0,\"message\":\"success\",\"nonce\":0.265046801,\"requestId\":\"73346487-e19a-49ac-944c-cd50081a2e61\",\"summary\":[{\"code\":0,\"name\":\"http://cos.ap-guangzhou.myqcloud.com/7-1252177232//cloud-api/storage-0831/2023-01-10/18-1/1673346487085260/276271.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256\\u0026X-Amz-Credential=AKIDvc3E8l8D1g4AzXpqZ1TgcHfmcBSTDgso%2F20230110%2Fap-guangzhou%2Fs3%2Faws4_request\\u0026X-Amz-Date=20230110T102807Z\\u0026X-Amz-Expires=86400\\u0026X-Amz-SignedHeaders=host\\u0026X-Amz-Signature=70194025378b808e007b312d49e09f79aec724b6c75f66926c3899808310d2e0\",\"riskTask\":\"54bcfc6c329af61034f7c2fc\",\"riskType\":2,\"suggestion\":2,\"tag\":\"{\\\"callbackData\\\":\\\"test-callbackData\\\",\\\"cname\\\":\\\"test-tupu\\\",\\\"requestId\\\":\\\"B05EE55820AF449EBC007EB1E17A45QQ\\\",\\\"sid\\\":\\\"B05EE55820AF449EBC007EB1E17A4511\\\",\\\"source\\\":\\\"agora\\\",\\\"timestamp\\\":20230110102806386,\\\"uid\\\":123456}\"}],\"timestamp\":1673346488265}",
"signature": "r1xBiauHLkKdYu/7raB+lro7rlAOAEGYG2yLj/Tq2faGE7A++D1BYepUilknPAh0n8XrSfghS15tYSIdsaEsG8sOj5FQ2FrzbaK7zQmRyKuLDazSJTJdAacUvjIwqVULjEUHMIcGtdJhNeeLgxDovQ5mLG3+DQqxbitonDOnfVc="
}
API 参考
enableContentInspect常见问题
问题 1:为什么审核内容要先发送到服务端,审核结果也要先返回给服务端?
声网采用“服务端——服务端”的传输方案,主要有两个原因:
- 保障服务的安全性,客户端容易被监听。
- 方便自行控制业务逻辑。例如:你可以在业务服务器接收到内容违规的审核结果时,对客户端进行关闭频道、UI 提示、禁言、扣分等操作。
问题 2:从频道内截取的内容由谁存储?
第三方审核供应商会提供默认 7 天的 OSS 存储服务。