下图展示了从发起反垃圾请求到处理违规情况的整体方案架构图。其中，“你的业务逻辑”展示了针对审核结果的示例处理策略。你也可以结合自己的业务场景，采取不同策略。

调用时序图

短期房间

长期房间

接入说明

准备工作

开通反垃圾功能

** 易盾控制台获取接入秘钥 **

准备监听uid/token

反垃圾SDK的uid号段预留

建议您预留uid号段提供给音频反垃圾SDK加入音视频房间进行反垃圾服务；

准备反垃圾SDK的uid授权进入房间的token

{
  "secretId": "your_secret_id",
  "businessId": "your_business_id",
  "signature": "signature",
  "url": "******"
}

{
    "code": 200,
    "msg": "ok",
    "result": {
        "token": "your_token",
        "uid": "your_uid"
    } 
}

准备反垃圾结果接收地址（callbackURL）

用于接收反垃圾异常检测结果，离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s，为了保证顺利接收数据，需保证接收接口性能稳定并且保证幂等性。

提交反垃圾检测

完成鉴权流程后，您需要将反垃圾SDK所需加入的频道名（channelName）、token以及反垃圾SDK对应的uid按如下格式生成http请求，并提交检测接口，不同场景的提交检测地址有所不同：

场景1：短期房间，准备允许短期周期内一直有效的监听token 提交URL：agora://uid:token@appid/channelName

场景2：长期房间，已提供获取最新有效token的api,供易盾token失效时重新加入房间 提交URL：agora://appid/channelName

场景3：公开房间，无需传入token 提交URL：agora://uid@appid/channelName

接口地址

http://as.dun.163.com/v2/livewallsolution/submit

接口描述

提交直播音视频的URL进行反垃圾内容检测

请求参数

公共参数已省略，详细见 请求公共参数

响应结果

响应字段如下，响应通用字段已省略，详细见响应通用字段：

result 数据结构

响应示例

{
    "code": 200,
    "msg": "ok",
    "result": {
            "taskId": "******",
            "status": "******"
        }
}

接收审核结果

• 主动接收结果（推荐，结果获取更实时）：

通过在提交检测接口提交callbackURL,主动获取检测结果，主动回调数据接口超时时间设置为2s，为了保证顺利接收数据，需保证接收接口性能稳定并且保证幂等性。

• 被动接收结果：

您也可以通过定时轮询结果获取接口（https://support.dun.163.com/documents/2018082201?docId=274670761104560128）的方式获得结果；

停止音视频反垃圾

房间开始反垃圾监听后，易盾不会主动停止检测，请在如下场景时调用停止检测接口：

1. 当房间结束时；
2. 某一时刻，当前音频房间内不再需要音频反垃圾检测服务时；

停止检测接口：

接口地址

https://as.dun.163.com/v1/livewallsolution/feedback

接口描述

实时更新视频直播流相关信息。建议您使用POST请求, 且仅接受 application/x-www-form-urlencoded 编码格式。

接口请求频率

小于10s/50次，请求频率过快服务器会拒绝处理。

请求参数

公共参数已省略，详细见 请求公共参数

realTimeInfoList数组结构

响应结果

result 数组结构

响应示例

{
    "code": 200,
    "msg": "ok",
    "result": [{
            "taskId": "****",
            "result": 0
        }]
}