内容审核场景实践
场景 1:社交应用中的聊天内容审核
通过融云的审核服务,您可以防止社交场景中的色情诱导、广告引流以及涉政涉暴内容,详见审核能力概述。
内容审核服务
开通位置
您可以通过融云控制台开通内容审核服务。

计费说明
开发环境:免费试用 30 天; 生产环境:首次开通可免费体验 7 天,免费额度用尽后服务将关停。如需再次开启需预存 600 元并开始计费。
每日结算前一天统计用量费用,月底按整体使用量核算月度费用,费用按最小条数计算,不足一分钱不计费。
详细计费规则请参考知识库:IM 审核计费说明
常规审核方案
融云内容审核产品中的 IM 审核服务,为 IM 内容提供全面保障与支持,支持审核文本、图片、语音片段和小视频,精准识别敏感信息。 使用该服务无需额外代码集成,只需开通服务即可实现消息自动审核。如需调整审核力度或有其他审核需求,可联系商务经理沟通。
自定义事件审核方案
在您的实际业务中,根据用户的级别、性别、地域等背景信息,可以执行不同的审核策略。
实现步骤
- 审核方根据客户的业务需求,分配不同的审核事件 ID(eventId)。例如:根据性别进行审核时,数美需要分别提供男性和女性的审核事件 ID(eventId)。在实际操作前,可联系商务经理创建审核群进行对接。
- 开通内容审核支持自定义事件审核功能。此功能暂不支持自助开通,请提交工单申请。
- 在通过融云 SDK 发送消息时,根据发送消息用户的不同,携带相应的事件 ID。融云服务端在送审时会将事件 ID 同步给数美,数美会根据传入的事件 ID 执行相应的审核策略。
计费说明
免费
客户端集成代码示例
- Android
- iOS
- Web
从 5.6.8 版本开始支持,发送消息时,设置消息对象中的 auditInfo
内容,如下:
MessageAuditInfo messageAuditInfo =
new MessageAuditInfo(
MessageAuditType.ALLOW,
"",
"strategy");
textMessage.setAuditInfo(messageAuditInfo);
Message message = Message.obtain("targetId", Conversation.ConversationType.PRIVATE, textMessage);
属性说明:
- auditType:审核类型,需要设置为审核
MessageAuditType.ALLOW
。 - strategy:对应为数美审核的事件 ID(
eventId
)。
注:使用默认审核逻辑时可不设置 auditInfo
从 5.6.8 版本开始支持,发送消息时,设置消息对象中的 auditInfo
内容,如下:
RCMessageAuditInfo *auditInfo = [[RCMessageAuditInfo alloc] init];
auditInfo.auditType = enableAudit ? RCMessageAuditTypeAllow : RCMessageAuditTypeDisallow;
auditInfo.project = auditProject;
auditInfo.strategy = auditStrategy;
messageContent.auditInfo = auditInfo;
auditType 类型说明:
typedef NS_ENUM(NSInteger, RCMessageAuditType) {
/// 不需要审核
RCMessageAuditTypeDisallow = 0,
/// 需要审核
RCMessageAuditTypeAllow = 1,
};
属性说明:
- auditType:审核类型,需设置为审核。
- strategy:对应数美审核的事件 ID(
eventId
)。 - project:无需设置。
注:使用默认审核逻辑时可不设置 auditInfo
。
从 5.9.3 版本开始支持,发送消息时,设置消息对象中的 auditInfo
内容,如下:
new RongIMLib.TextMessage({
content: '',
audit?: {
/**
* 发送方指定是否送审, 1:送审(默认值),0:不送审
*/
auditType?: MessageAuditType,
/**
* 项目名称, 默认为空字符串
*/
project?: string,
/**
* 策略映射字段
*/
strategy?: string,
}
})
属性说明:
- auditType:审核类型,需要设置为审核。
- strategy:对应为数美审核的事件 ID(
eventId
)。
如果使用默认审核逻辑,则无需设置 auditInfo
。
Server API 接口
通过 Server API 发送消息时,可以在消息体中添加 audit
属性内容来实现:
{
"content":"Hello world! 单聊消息 ",
.....
"audit":
{
"auditType" : 1,
"strategy" : "message_restrict", // 例子,实际与数美的事件值一致。
},
"extra":""
}
属性说明:
- auditType:审核类型,需要设置为 1(表示需要审核)。
- strategy:对应数美审核的事件 ID(
eventId
)。
如果使用默认审核逻辑,则无需设置 audit
。
自定义消息审核方案
融云支持自定义消息的审核功能,但目前暂不支持自助配置。您可以通过提交工单申请开通。在提交工单时,请提供以下信息:
- 应用的 App Key。
- 会话类型:需要审核的自定义消息所属的会话类型(如单聊、群聊、聊天室、超级群)。
- 自定义消息的消息类型(
ObjectName
),例如:融云内置消息类型RC:TxtMsg
。 - 自定义消息中 Content 的 JSON 结构内容。目前仅支持 JSON 结构。以下是文本消息的示例结构:
{
"content":"Hello world!",
"user":
{
"id":"4242",
"name":"Robin",
"portrait":"http://example.com/p1.png",
"extra":"extra"
},
"extra":""
}
- 需要审核的 JSON 结构中的属性名称,例如客户的自定义消息结构如下,需要审核
msg
的内容:
{
"msg":"需要审核的内容",
"user":
{
"id":"4242",
"name":"Robin",
"portrait":"http://example.com/p1.png"
}
}
计费说明
免费
获取 IM 审核结果
- 开通 IM 审核服务后,您可以在风控后台查询,具体操作请参考:风控后台常见功能操作文档。
- 通过审核结果回调,您可以实时接收审核结果详情,详见审核结果回调。
开通位置
登录融云控制台, 在 IM 与音视频审核页面中配置回调地址。请确保您提供的回调地址能够在公网正常访问。
计费说明
免费
服务端回调请求示例
POST review_result.php HTTP/1.1
Host: example.com
RC-App-Key: uwd1c0sxdlx2
RC-Timestamp: 1408710653491
RC-Nonce: 14314
RC-Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/json
{
"result":10000,
"content":“{****}”,//审核的消息结构 JSON
"serviceProvider":"ShuMei",
"msgUID":"596E-P5PG-4FS2-7OJK",
"resultDetail":"{****}";//审核结果详细 JSON 结构
}
- 只要返回 HTTP 200 OK 响应,服务端会认为状态已同步,无需返回任何参数。
- 如果响应超时超过 5 秒,服务端会重试推送 3 次;若仍然失败,即时通讯服务将默认下发该消息。
- 如果短时间内出现大面积超时,服务端会暂时停止请求您的服务器,并在 90 秒后重新尝试发送回调请求。
消息回调服务
消息回调服务会根据您在控制台配置的路由规则拦截发送中的消息。被拦截的消息副本会先行发送至您指定的应用服务器(App 后端), 然后即时通讯服务端会根据 App 后端返回的响应结果,决定是否将消息下发、是否替换消息中的内容,以及如何进行内容替换。 详见消息回调 。
开通位置
登陆 融云控制台,参考截图位置开通审核服务并配置路由规则:
计费说明
开发环境免费使用;生产环境功能使用费 1000 元/月。
服务端回调请求和回调响应示例
POST /receive_message.php?timestamp=1408710653491&nonce=14314&signature=45beb7cc7307889a8e711219a47b7cf6a5b000e8 HTTP/1.1
Host: example.com
Content-Type: application/x-www-form-urlencoded
appKey=123&content={"content":"123"}&fromUserId=fid123&targetId=tid123&msgType=RC:TxtMsg&messageId=596E-P5PG-4FS2-7OJK&msgTimeStamp=1408710653491&channelType=ULTRAGROUP&os=Server&busChannel=basketball
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{ "pass": 1 }
替换消息提示
替换消息内容对发送端、接收端的本地与服务端的历史消息记录有不同的影响。请谨慎使用此功能。
- 单聊和群聊消息替换后,发送方的本地和服务端历史消息中存储的是替换前的内容,而接收方本地和服务端存储的是经过替换后的内容。
- 聊天室消息替换后,发送方本地是替换前的内容,接收方本地是经过替换后的内容;服务端存储的是替换后的内容。(退出聊天室重新进入后拉取消息时为替换后的内容)。
- 超级群消息替换后,发送方本地是替换前的内容,接收方本地是经过替换后的内容;服务端存储的是替换后的内容。(换端登录后拉取历史消息时为替换后的内容)。
常见问题
- 消息回调默认不会对 Server API 接口发送的消息生效。如需将 IM Server API 发送的消息按照您配置的路由规则过滤并发送到应用服务器,需要在控制台的免费基础功能页面开启 Server API 发送消息过滤敏感词功能。
- 如字段中数据大小超出限制、数据格式错误会导致消息下发失败。
- 如果应答超时 5 秒,服务端会再尝试推送 3 次,如果仍然失败,即时通讯服务默认将下发此条消息。如需希望不下发,请提交工单申请开通异常模板消息不下发功能。
- 如短时间内有大面积超时,将暂时停止请求您的服务器,90 秒后会继续发送回调请求。
- 非违规类消息为什么被拦截了?消息回调的审核结果完全由您服务端把控,可先排除下 2 和 3 的情况,然后看下是否是服务端返回了 pass:0。
融云内置敏感词服务
即时通讯(IM)服务已内置敏感词机制。注意,敏感词机制仅是一种基础保护机制,且仅限于文本内容。具体请参考文档说明:敏感词机制。
开通位置
登陆 融云控制台,参考截图位置配置过滤词或替换词。如需增加词量可设置敏感词上限数调整。
计费说明
默认支持 50 个免费词;增加词量计费标准为1000 词 / 600 元。
服务端添加敏感词请求示例
- Server SDK in Java
- Server SDK in PHP
- Server SDK in GO
RongCloud rongCloud = RongCloud.getInstance("AppKey", "AppSecret");
//自定义 Api 地址方式
//RongCloud rongCloud = RongCloud.getInstance(appKey, appSecret,api);
SensitiveWord sensitiveWord = rongCloud.sensitiveword;
SensitiveWordModel sentiveWord = new SensitiveWordModel()
.setType(0)
.setKeyword("黄赌毒")
.setReplace("***");
ResponseResult addesult = sensitiveWord.add(sentiveWord);
System.out.println("sentiveWord add: " + addesult.toString());
require "./../../RongCloud.php";
define("APPKEY", '');
define('APPSECRET', '');
use RongCloud\RongCloud;
use RongCloud\Lib\Utils;
/**
* Add sensitive words
*/
function add()
{
$RongSDK = new RongCloud(APPKEY, APPSECRET);
$sensitive = [
'replace' => '***',// Sensitive word replacement, maximum length not exceeding 32 characters, sensitive word filtering can be empty
'keyword' => "abc",// Sensitive word
'type' => 0// 0: Sensitive word substitution 1: Sensitive word filtering
];
$result = $RongSDK->getSensitive()->add($sensitive);
Utils::dump("Add sensitive words", $result);
}
func TestRongCloud_SensitiveBatchAdd(t *testing.T) {
rc := NewRongCloud(
os.Getenv("APP_KEY"),
os.Getenv("APP_SECRET"),
)
ret, err := rc.SensitiveBatchAdd(
[]SensitiveWord{
{
Type: "0",
Word: "replaceStr1",
ReplaceWord: "replace1",
},
{
Type: "1",
Word: "blockStr1",
ReplaceWord: "",
},
})
t.Log(err)
t.Log(ret)
}
常见问题
- 默认支持 50 个敏感词,如需增加个数请联系商务经理。
- 触发敏感词默认没有通知,如需给用户做提示语,需要在控制台的免费基础功能页面开启含敏感词消息屏蔽状态回调发送端功能。
- 如果已经设置完敏感词或替换词后发消息没生效,可确认是否没到 15 分钟的服务生效时间。
客户端如何知道消息是否被拦截
默认情况下,消息发送方无法感知消息是否已被融云审核服务拦截。如果 App 希望在消息因触发审核规则而无法下发时通知消息发送方,可开通含敏感词消息屏蔽状态回调发送端功能。
融云的内容审核服务(包括消息敏感词、IM 审核服务、消息回调服务),会在以下情况下拦截消息:
- 文本消息内容命中了您自定义的消息敏感词(屏蔽敏感词),导致消息不下发给接收方。
- 消息命中了IM 审核服务,导致消息不下发给接收方。
- 消息命中了消息回调服务设置的路由规则,导致消息不下发给接收方。
开通位置
登陆融云控制台,在免费基础功能页面开启含敏感词消息屏蔽状态回调发送端功能。
计费说明
免费
客户端敏感词拦截监听示例代码
- Android
- iOS
- Web
//设置敏感词拦截监听
RongCoreClient.getInstance().setMessageBlockListener(new IRongCoreListener.MessageBlockListener() {
@Override
public void onMessageBlock(BlockedMessageInfo info) {
RongCoreClient.getInstance().getMessageByUid(info.getBlockMsgUId(), new IRongCoreCallback.ResultCallback<Message>() {
@Override
public void onSuccess(Message message) {
//获取本地消息成功
message.setSentStatus(Message.SentStatus.FAILED);
//如果使用的是 IMKit ,需要调用 IMCenter 的 setMessageSentStatus 方法,会自动刷新 UI;
//如果是使用的 IMLib 则需要您自行处理 UI 刷新
RongCoreClient.getInstance().setMessageSentStatus(message, new IRongCoreCallback.ResultCallback<Boolean>() {
@Override
public void onSuccess(Boolean aBoolean) {
//调用设置消息发送状态方法成功
}
@Override
public void onError(IRongCoreEnum.CoreErrorCode e) {
//调用设置消息发送状态方法失败
}
});
}
@Override
public void onError(IRongCoreEnum.CoreErrorCode e) {
//获取本地消息失败
}
});
}
});
// 设置敏感词拦截代理
[RCCoreClient sharedCoreClient].messageBlockDelegate = self;
#pragma mark - RCMessageBlockDelegate
- (void)messageDidBlock:(RCBlockedMessageInfo *)blockedMessageInfo {
// 通过 messageUID 获取对应的 message 信息
RCMessage *blockMessage = [[RCCoreClient sharedCoreClient] getMessageByUId:blockedMessageInfo.blockedMsgUId];
// 调用 IMLibCore 接口修改消息的发送状态
[[RCCoreClient sharedCoreClient] setMessageSentStatus:blockMessage.messageId sentStatus:SentStatus_FAILED completion:^(BOOL ret) {
// 如果使用的是 IMKit ,需要延时发送刷新消息状态的通知; 如果是使用的 IMLib 则需要您自行处理 UI 刷新
RCMessageCellNotificationModel *notifyModel = [[RCMessageCellNotificationModel alloc] init];
notifyModel.actionName = CONVERSATION_CELL_STATUS_SEND_FAILED;
notifyModel.messageId = blockMessage.messageId;
dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.3 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
[[NSNotificationCenter defaultCenter]
postNotificationName:KNotificationMessageBaseCellUpdateSendingStatus
object:notifyModel];
});
}];
}
// 敏感词回调通知
const Events = RongIMLib.Events
RongIMLib.addEventListener(Events.MESSAGE_BLOCKED, (evt) => {
// evt 会返回被拦截的消息 ID (blockedMessageUId),业务层可按需给业务层 UI 提示
console.log(evt)
})
如何针对违规用户做处理
-
封禁用户:封禁后会即时断开该用户的 IM 连接,且封禁期内无法连接。 如需封禁后永久不许连接融云,可同时作废 Token。
-
针对群组会话处理方案 禁言指定群成员:只是让他无法发言,但是不会退出群聊,依然可以收消息。 退出群组:将用户从群中移除,但不影响客户的连接。
-
针对聊天室会话处理方案 禁言指定聊天室用户:被禁言用户可接收查看聊天室中其他用户聊天信息,但不能发送消息。 封禁聊天室用户:被封禁用户在封禁时间内不能加入此聊天室。但不影响用户的连接。
场景 2:音视频内容安全管控
通过此功能,您可以实时监控直播连麦、音视频通话中的违规行为,详见音视频内容审核概述。 注:融云只会将审核结果通过回调服务发往到您的应用服务器不会对用户执行任何操作。通过解析审核结果,业务侧可决策是否需要对 App 的用户执行封禁等操作。
配置音视频审核
指定音视频审核的启动方式:
- 自动启动:音视频会话开始就开始审核,不需要额外配置。
- 手动启动:由业务侧主动调用 API 启动审核任务。这种方式下同时支持通过 API 结束审核。详见审核任务管理配置代码。音视频会话结束时自动停止审核。
详见审核任务管理。
开通位置
登陆融云控制台,参考截图位置开通审核服务。 注:开通音视频审核的前提是必须开通音视频服务。
计费说明
开发环境,免费体验 7 天(含 21 万分钟音频流和 420 万张视频审核用量),免费额度用尽后,将关停服务;
生产环境,首次开通可免费体验 7 天(含 21 万分钟音频流和 420 万张视频审核用量),免费额度用尽后,将关停服务。再次开启需要预存 980 元开启并开始计费。
每日结算前 1 天用量费用,按时长计费内容精确到分钟,不足 1 分钟按 1 分钟计算。
具体计费明细请参考知识库:音视频审核服务计费说明
审核任务管理配置代码示例
POST /rtc/contentcensor/start.json HTTP/1.1
Host: api.rong-api.com
App-Key: XXX
Nonce: 1027489915
Timestamp: 1609754958
Signature: 357cef9b529edd1ed4f34bd8df52de00a909914b
Room-Id: 123
Session-Id: 456
Content-Type: application/json
{
"users": [{
"userId": "xxxxx",
"scene": "xxx",
"censorType": 0,
"streams": [{
"streamId": "xxxxx"
}]
},
{
"userId": "xxxx2x",
"scene": "xxx",
"censorType": 1,
"streams": [{
"streamId": "xxx3xx"
},
{
"streamId": "xx4xxx"
}
]
}
]
}
获取音视频审核结果
- 开通服务后,可在三方的控制台查询, 详见风控后台常见功能操作文档。
- 可使用审核结果回调,实时接收审核结果详情,详见音视频审核结果回调。
开通位置
登录融云控制台,在 IM & 音视频审核页面配置回调地址。请确保公网可访问您提供的回调接收地址。
计费说明
免费
处理违规用户
- 指定房间封禁用户:在指定的音视频房间内封禁用户。一旦封禁,用户在设置的封禁时间内无法加入该房间。
- 封禁用户:将指定用户封禁后,此用户在封禁时间内无法再加入任何房间。
- 踢出房间:被踢的用户可再次加入房间。如果不想让用户再次加入,请调用指定房间封禁用户接口或封禁用户接口。
场景 3:APP 登录鉴权
通过 APP 登录鉴权,禁止黑产用户连接融云。 根据应用包名分别开通 Android 和 iOS 的合法性校验。Android 通过应用签名判断,iOS 通过 Bundle Id 判断。不合法的应用将无法连接融云服务。
开通位置
无法自主开通,请提交工单申请开通防黑产配置。
在工单中,针对不同平台,您需要提供以下信息:
平台 | 提供的信息 |
---|---|
Android | App key、包名、应用签名 SHA1 值 |
iOS | App key、包名 |
Web | 安全域名 注:Web 没有防黑产配置,但可配置安全域名设置,除安全域名以外,其他域名对融云 IM 服务的调用都不会生效。 |
支持 SDK 版本
Android,IOS 端 SDK 在 4.0.1 及以上版本支持,Web 端不受版本限制。
注意事项
开启此功能后,⼩于 4.0.1 的旧版本,也⽆法连接融云 IM 服务,因为融云⽆法确认⿊产使⽤的是哪个旧版本的 SDK。
Android 获取应⽤签名⽅式:
利⽤ Android SDK ⾃带的⼯具 keytool 执⾏指令 keytool -list -v -keystore 应⽤签名路径获取到应⽤签名的 SHA1 值,例如:SHA1:53:FD:54:DC:19:0F:11:AC:B5:22:9E:F1:1A:68:88:1B:8B:E8:54:42
计费说明
免费
常见问题
- 融云国内数据中心的默认文件服务器是七牛,七牛有自己的消息审核机制,且融云无法干预,如果您遇到了多次被七牛拦截的情况建议开通内容审核服务,可以知道消息违规情况,或者自行搭建文件服务器来避免被七牛拦截。
- 为什么消息没过审:
- 可能是服务还未生效,可确认是否没到 15 分钟的服务生效时间。
- 如果已经到了生效时间可先自行检查下是否同时配置了消息回调或者敏感词,这三者有审核优先级的关系:
- 融云敏感词优先级最高且不支持调整优先级顺序;
- 内容审核和消息回调的优先级取决于开通顺序,先开通的优先级高于后开通的。
- 如果不确定当前审核的优先级可联系融云查看,若是要调整这两者的优先级请提交工单。
- 以上两点都排除后,请提交工单排查。
- 为什么发送方没有提示:消息被拦截的情况下发送方是无感知的,并且发送方也不会有任何展示,需要在控制台免费基础功能页面开启含敏感词消息屏蔽状态回调发送端功能。然后参考知识库做拦截提示:消息被拦截后,各平台客户端如何处理被拦截消息的状态。
- 默认审核机制仅对从客户端 SDK 发送的消息生效,如果 IM Server API 发送的消息也需要过敏感词机制,需要在控制台免费基础功能页面开启 Server API 发送消息过滤敏感词功能。
- 如何调整音视频的审核策略:需要联系商务经理找风控方,风控方统一控制,暂不支持自主修改。
- 如何实现审核或对接第三方审核服务:请提交工单申请调整音视频自定义审核,注意:要说明是音频还是视频。
- 如何针对违规的用户或房间进行封禁处理:融云只会将审核结果通过回调服务发到您配置的指定回调地址。您来通过解析审核结果,决策是否需要对 App 的用户执行封禁等操作。 App 的用户执行封禁等操作。
- 为什么有的音视频未过审:风控方限制通话 10s 以上的才会过审,您确认下是否通话时间不到 10s。
- 如何调整音视频审核截帧时长:联系商务经理沟通。