直播语音信息提交接口

2022.08.15 16:29:36

    接口地址

    https://as.dun.163.com/v3/liveaudio/check

    接口描述

    提交直播语音的URL进行语音内容检测。建议您使用POST请求, 且仅接受 application/x-www-form-urlencoded 编码格式。

    检测方式说明

    即构RTC提供了三种方案供易盾反垃圾接入检测

    监听方案(易盾机器人加入房间,自动获取房间内每一路说话人的信息,推荐使用此种方案)

    • 方案1:监听方案-1小时内房间,提交url参数:rtc://room.zego.im/<room_id>?identify_token=<...>
    • 方案2:监听方案-1小时以上房间(需自行按照易盾接口规范准备getToken接口,以便机器人在token失效时加入房间),提交url参数:rtc://room.zego.im/<room_id>?identify

    拉流方案

    • 方案2:拉流方案(指定拉房间混流)提交url参数:rtc://room.zego.im/<room_id>?identify_token=<...>&mix=true
    • 方案1:拉流方案(指定拉房间内某个说话人的单流)提交url参数:rtc://stream.zego.im/<stream_id>?identify_token=<...>

    请求参数

    公共参数已省略,详细见 请求公共参数,其他参数如下:

    参数名称 类型 是否必选 最大长度 描述
    version String Y 4 接口版本 v3.1
    url String Y 1024 即构RTC提供了三种方案供易盾反垃圾接入检测
    • 方案1:监听方案-1小时内房间(易盾机器人加入房间,自动获取房间内每一路说话人的信息,推荐使用此种方案),提交url参数:rtc://room.zego.im/<room_id>?identify_token=<...>
    • 方案2:监听方案-1小时以上房间(需自行按照易盾接口规范准备getToken接口,以便机器人在token失效时加入房间),提交url参数:rtc://room.zego.im/<room_id>?identify
    • 方案3:拉流方案(指定拉房间混流)提交url参数:rtc://room.zego.im/<room_id>?identify_token=<...>&mix=true
    • 方案4:拉流方案(指定拉房间内某个说话人的单流)提交url参数:rtc://stream.zego.im/<stream_id>?identify_token=<...> | | dataId | String | Y | 128 | 直播流唯一标识,直播ID | | title | String | N | 512 | 直播语音标题 | | ip | String | N | 128 | 用户IP地址 | | account | String | N | 128 | 用户唯一标识,如果无需登录则为空 | | roomNo | String | N | 20 | 主播房间号| | accountLevel | String | N | 10 | 账号级别/主播级别(大写A-Z) | | accountName | String | N | 30 | 账号名称/主播名称 | | deviceId | String | N | 128 |用户设备 id,与易盾设备画像库匹配,明文请转大写传入;MD5加密请明文转大写后MD5计算,再转大写传入,建议抄送| | deviceType |Number| N | 4 |用户设备id的类型,0:其他,10:IMEI,11:AndroidID,12:IDFA,13:IDFV,14:MAC ,20:IMEI_MD5,21:AndroidID_MD5,22:IDFA_MD5,23:IDFV_MD5,24:MAC_MD5| | callback | String | N | 1024 |数据回调参数,调用方根据业务情况自行设计,当调用文本离线结果获取接口时,该接口会原样返回该字段,详细见直播音频离线检测结果获取。作为数据处理标识,因此该字段应该设计为能唯一定位到该次请求的数据结构,如对用户的昵称进行检测,dataId可设为用户标识(用户ID),用户修改多次,每次请求数据的dataId可能一致,但是callback参数可以设计成定位该次请求的数据结构,比如callback字段设计成json,包含dataId和请求的时间戳等信息,当然如果不想做区分,也可以直接把callback设置成dataId的值。 | |callbackUrl | String |N |512 | 离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s,为了保证顺利接收数据,需保证接收接口性能稳定并且保证幂等性。 | | uniqueKey | String | N | 256 | 客户个性化直播流唯一性标识,传入后,将以此值作为重复检测依据,若不传,默认以URL作为查重依据 |

    响应结果

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

    result 数据结构

    参数名称 类型 描述
    taskId String 本次请求数据标识,可以根据该标识查询数据最新结果
    status Number 请求结果,0为成功,1为失败

    响应示例

    {
        "code": 200,
        "msg": "ok",
        "result": {
                "taskId": "*****",
                "status": 0
            }
    }
    
    Online Chat Tel:95163223