泛娱乐类音视频聊天场景中,充斥着各种不可控的风险因素,例如色情、暴恐和涉政信息等。随着国家监管的日趋严格,各平台需要对平台的音视频内容进行管控,自行处理音视频内容审核需要投入大量人力进行甄别。
融合通信云专家网易云信融合网易易盾的内容审核能力,为开发者提供实时音视频 「安全通」 (内容安全审核)服务,对音视频内容进行有效的判别和筛选,降低人力投入。
本次云信小课堂,我们为大家带来实时音视频「安全通」的快速接入指南。
功能解析
实时音视频「安全通」(内容安全审核)服务(以下简称「安全通」),是基于实时音视频通话的内容审核及处理功能。我们默认开发者已经实现了基础的音视频通话功能(如您还未开始集成,可参考往期《云信小课堂|如何实现音视频通话》)。
「安全通」的基础功能包含:
- 创建「安全通」审核任务
- 查询审核视频截图
- 查询审核音频断句
- 停止「安全通」审核任务
- 接收安全审核结果
- 处理安全审核结果
基于实时音视频通话内容,实现全流程的“审-查-禁”服务功能。
功能实现
以下内容为大家介绍如何基于网易云信音视频通话 2.0 SDK 及安全通 API 快速实现音视频通话安全检测功能,基本步骤如下:
Step 1 开始准备
1、登录云信控制台创建应用并申请开通音视频 2.0 及「安全通」相关服务。详细操作步骤可参考:
《音视频 2.0 接入流程》:
https://doc.yunxin.163.com/do...
《开通「安全通」服务》:
https://doc.yunxin.163.com/do...
2、准备接收消息抄送的服务器公网地址。审核结果会以消息抄送的方式发送至您预留的抄送地址,请在开通服务前准备抄送地址,并保证抄送地址长期有效。配置方式如下图所示:
3、准备音视频通话开发环境,安全通服务支持音视频 2.0 全终端接入检测,无论您使用的是什么平台,接入流程一致。
4、配置内容检测相关规则,在「安全通」功能页面,进入策略配置页面。在此您可以配置您希望的安全检测策略。
Step 2 创建音视频通话
创建房间(可选)
通过服务端 API 进行音视频通话房间创建
https://doc.yunxin.163.com/do...
传入指定的房间名及用户 id 。在此测试时,我们定义房间名为 neteasetest ,用户 id 为 12345 。
curl --location --request POST 'https://logic-dev.netease.im/v2/api/room'
--header 'AppKey: ***' \ //请使用您应用的appkey
--header 'Nonce: ***' \ //随机数,最大长度为 128 个字符。
--header 'CurTime: 1639555317' \ //当前 Unix 时间戳,即从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数。数据类型为 String。
--header 'CheckSum: ba193e4d4ba3991987eb72afe692095598552b79' \ //计算方式详见:https://doc.yunxin.163.com/docs/jcyOTA0ODM/TA5MjEzNTM?platformId=50326
--header 'Content-Type: application/json'
--data-raw '{
"channelName": "neteasetest",
"mode": 2,
"uid": 12345
}'
获取对应的请求返回结果:
{
"code": 200,
"errmsg": "reason code 200", //code 200即为创建成功,其他状态码请参考 https://doc.yunxin.163.com/docs/jcyOTA0ODM/DY2NDIwMTM?platformId=50326
"cid": 1344424603797473
}
注:“创建房间“为非必要操作,用户可以自主选择创建或不创建,云信音视频 2.0 通话亦支持未创建客户端直接加入音视频房间。
建立音视频通话
为了方便演示,我们使用 Web 端进行音视频通话(我们默认开发者已经实现了基础的音视频通话功能),传入与创建房间时相同的房间名,建立音视频通话。
this.client.join({
channelName: "neteasetest", //房间名
uid: 12345, //用户id
token: '' //鉴权token,详见:https://doc.yunxin.163.com/docs/jcyOTA0ODM/TQ0MTI2ODQ?platformId=50002
});
进入房间成功后,通话就正式开始咯。
Step 3 创建 「安全通」 审核任务
通话建立完成后,即可通过服务端 API 开启对应房间的审核任务:
https://doc.yunxin.163.com/do...
curl --location --request POST 'https://logic-dev.netease.im/livewallsolution/submit'
--header 'AppKey: ***' \ //请使用您应用的appkey
--header 'Nonce: ***' \ //随机数,最大长度为 128 个字符。
--header 'CurTime: 1639555317' \ //当前 Unix 时间戳,即从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数。数据类型为 String。
--header 'CheckSum: ba193e4d4ba3991987eb72afe692095598552b79' \ //计算方式详见:https://doc.yunxin.163.com/docs/jcyOTA0ODM/TA5MjEzNTM?platformId=50326--header 'Content-Type: application/json'
--data-raw '{
"monitorUid": 666666,
"channelName": "neteasetest",
"detectType": 0,
"scFrequency": 5,
"callbackUrl": "***" //接收审核任务的地址,详见2.1
}'
获取对应的返回结果:
{
"code": 200,
"result": {
"taskId": "***", //审核任务id,用于后续审核任务的详情查询
"status": true,
"dataId": "235979990138017090111639568801012" //网易云信为您自动生成的数据唯一标识。如果您对检测结果有任何疑问,请根据 dataId 咨询技术支持。
}
}
至此,您的音视频通话即正式进入审核阶段。
Step 4 接收安全审核结果
实现审核结果接收服务
在之前,我们已经配置了接收消息抄送的服务器公网地址,安全审核过程中,会将异常行为实时回调到您配置的地址中,您需要在该地址中实现对应审核消息的接收,我们提供了 PHP 解析抄送内容的相关示例:
https://faq.yunxin.163.com/#K...
在本次演示中,我们只进行最简单的抄送内容接收及打印。
public String robot(@RequestBody String msg) {
logger.info(msg);
System.out.println(msg);
return "robot";
}
正常情况,审核抄送不会触发,只有在有问题的情况下,会触发具体异常详情抄送,详见:
https://doc.yunxin.163.com/do...
触发违规内容
在进行通话之前,我们提前配置了部分敏感词作为审核过滤条件。
接下来,我们在视频通话中,模拟相关的视频内容:
审核结果接收
最终,您配置的接受抄送服务的地址,就能收到该次通话相关的审核结果了!这里只展示了视频相关的审核结果,音频也可以进行同步审核。审核结果字段释义详见:
https://doc.yunxin.163.com/do...
{
"data": {
"dataId": "235979990138017090111639568801012",
"callback": "",
"channelName": "neteasetest",
"evidences": {
"video": {
"evidence": {
"uid": 12345,
"beginTime": 1639569545356,
"endTime": 1639569545356,
"type": 1,
"url": "https://yidun-video.nos-eastchina1.126.net/ur9j7xwis91ejyprqsuilchg04009rez_12345_1639569545374.jpg?Signature=GR%2FQRk37f8k7ukRVLkeTtZiQWNfRMEx%2BL0uIeogAQ5M%3D&Expires=1642161545&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
},
"labels": [{
"subLabels": [{
"subLabel": 400017,
"rate": 1.0,
"details": {
"hitInfos": ["好好学习"],
"hitLocationInfos": [{
"y1": 0.33333334,
"x1": 0.20926562,
"y2": 0.56666666,
"x2": 0.7454219,
"hitInfo": "好好学习"
}],
"imageListInfos": [{
"type": 2,
"word": "好好学习"
}]
}
}],
"level": 2,
"rate": 1.0,
"label": 400
}]
}
},
"censorSource": 2,
"channelId": 1344424603797473,
"taskId": "ur9j7xwis91ejyprqsuilchg04009rez",
"status": 101
},
"eventType": 400
}
Step 5 处理安全审核结果
移出成员
发现通话存在违规只是安全审核的第一步,接下来需要处理安全审核的结果。在配置安全策略时,您可以根据您具体的业务情况,来辨别审核力度。
针对审核结果,每个业务会有不同的策略,或是在客户端弹出相关提示,或是直接结束该通通话。云信的音视频通话提供房间管理的相关服务端 API 接口,可以对房间内的成员进行移除,或是对整个房间进行关闭。以下以移除违规房间成员为例,服务端移出成员接口:
https://doc.yunxin.163.com/do...
curl --location --request POST 'https://logic-dev.netease.im/v3/api/kicklist/members?cname=neteasetest1&uid=12345'
--header 'AppKey: ***' \ //请使用您应用的appkey
--header 'Nonce: ***' \ //随机数,最大长度为 128 个字符。
--header 'CurTime: 1639555317' \ //当前 Unix 时间戳,即从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数。数据类型为 String。
--header 'CheckSum: ba193e4d4ba3991987eb72afe692095598552b79' \ //计算方式详见:https://doc.yunxin.163.com/docs/jcyOTA0ODM/TA5MjEzNTM?platformId=50326
--header 'Content-Type: application/json'
--data-raw ''
该请求无返回结果,HTTP 200 即请求成功。
客户端处理
之后客户端即会收到被移除房间的回调,以 Web 端为例:
this.client.on('client-banned', (event) => {
logger.log('peer-leave', event);
message.error('你已被踢出房间');
});
至此,音视频通话的安全审核即已完成”审-查-禁“的一体化操作。
Step 6 结束审核任务
最终我们需要结束该通话频道的审核任务
https://doc.yunxin.163.com/do...
curl --location --request POST 'https://logic-dev.netease.im/livewallsolution/feedback'
--header 'AppKey: ***' \ //请使用您应用的appkey
--header 'Nonce: ***' \ //随机数,最大长度为 128 个字符。
--header 'CurTime: 1639555317' \ //当前 Unix 时间戳,即从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数。数据类型为 String。
--header 'CheckSum: ba193e4d4ba3991987eb72afe692095598552b79' \ //计算方式详见:https://doc.yunxin.163.com/docs/jcyOTA0ODM/TA5MjEzNTM?platformId=50326
--header 'Content-Type: application/json'
--data-raw '{
"realTimeInfoList": [
{
"channelName": "neteasetest",
"status": 100
}
]
}'
并获取对应的返回结果:
{
"code": 200,
"result": [
{
"channelName": "neteasetest",
"result": 0,
"taskId": "ur9j7xwis91ejyprqsuilchg04009rez"
}
]
}
总 结
以上是网易云信实时音视频「安全通」的快速接入指南的详细解说,按照如上步骤就可以轻松完成。
音视频聊天场景的日益增加意味着各平台不仅要管控,还需要大量的人力成本去审核平台的音视频内容,而网易云信为开发者提供实时音视频「安全通」(内容安全审核)服务,对音视频内容进行有效的判别和筛选,降低人力投入。
云信小课堂推荐阅读
关于网易云信
网易云信是集网易 24 年 IM 以及音视频技术打造的融合通信云服务专家,稳定易用的通信与视频 PaaS 平台。
提供融合通信与视频的核心能力与组件,包含 IM 即时通讯、5G 消息平台、一键登录、信令、短信与号码隐私保护等通信服务,音视频通话、直播、点播、互动直播与互动白板等音视频服务,视频会议等组件服务。
网易云信服务于网易云音乐、好未来、新东方、科大讯飞、南京银行等各行各业客户,已有 100w+ 企业开发者接入云信服务。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。