游戏多媒体引擎 GME3.0 语音内容安全使用指南

一、场景说明

在游戏场景中，需要对音频进行切片送审。

二、计费说明

语音内容安全计费，按照时长计费，详情见：语音内容安全服务计费。

三、功能说明

开通 GME3.0内容安全功能，可对通过 GME 产生的音频内容进行内容安全处理。

四、开通方法

步骤1：进入到 腾讯云游戏多媒体引擎控制台，左侧导航栏选择语音内容安全管理。

步骤2：开通实时语音场景审核和语音消息场景审核。

五、配置审核结果回调 url 和验签 key

可以配置你的业务服务端接收审核结果的回调 url，审核结果可以及时触达到此链接。

六、验签说明

验签说明包含 实时语音审核验签说明 和 语音消息审核验签说明。

七、实时语音审核验签说明

回调密钥和验签：

我们会在回调结果的 header 里，添加 sign 字段，你可以根据签名文档进行合法性校验

签名文档和代码示例见：签名校验示例

八、音频切片文件投递

你需要绑定一个存储桶，我们会按15秒一个切片，投递到你的存储桶里，后台会将需要转存的命中文件上传到你指定的云存储平台（对象存储 COS，AWS S3 或者 阿里云 OSS）

九、访问密钥与密钥

腾讯云 COS

查询入口：

1. 登录 腾讯云控制台。

2. 点击右上角头像，选择访问管理 CAM。

3. 左侧导航栏，选择访问密钥下的 API 密钥管理。

4. 点击新建密钥，短信验证后，生成：

·SecretId（访问密钥）

·SecretKey（密钥）

阿里云 OSS

查询入口：

1. 登录阿里云控制台。

2. 点击右上角头像，选择 AccessKey 管理。

3. 选择 继续使用 AccessKey（或通过 RAM 访问控制创建子账号密钥）。

4. 点击 创建 AccessKey。

5. 完成安全验证后，页面会显示 AccessKey ID 和 AccessKey Secret。

6. 点击 下载 CSV 或直接复制保存，文件包含：

·AccessKey ID（访问密钥）

·AccessKey Secret（密钥）

AWS S3

查询入口：

1. 登录 AWS 控制台，进入 IAM。

2. 选择 Users，选择你的用户下的 Security credentials。

3. 选择 Access keys，点击 Create access key。

4. 生成后下载 CSV，里面包含：

·Access Key ID（访问密钥）

·Secret Access Key（密钥）

十、音频切片文件路径

音频切片默认命名为：

{你的桶名称}/{taskId}/{userId}/audios/{sdkappid}_{roomId}_{userid}_{UTC 时间}.ogg

字段含义说明：

十二、审核策略

你可以编辑需要识别的策略配置。

十三、自定义词

你可以添加自定义词库，添加需要命中的关键词，精确匹配。

十四、审核回调

包含 实时语音审核回调 和 语音消息审核回调。

十五、实时语音审核回调

你可以提供一个接收回调的 HTTP/HTTPS 服务网关来订阅回调消息。当相关事件发生时，审核系统会回调事件通知到你的消息接收服务器。

事件回调消息格式：HTTP/HTTPS POST 请求发送给你的服务器，其中：

字符编码格式：UTF-8。

请求：body 格式为 JSON。

应答：HTTP status code = 200，服务端忽略应答包具体内容

为了协议友好，建议你的应答内容携带 JSON： {"code":0}。

十六、审核回调字段

事件回调消息的 body 中包含以下字段：

十七、审核回调类型

事件类型说明：

事件信息说明：

十九、事件类型为1101 ，审核任务启动：

EVENT_TYPE_CLOUD_Moderation_START 时 Payload 的定义：

{ "EventGroupId": 11, "EventType": 1101, "CallbackTs": 1726125338219, "EventInfo": { "RoomId": "960025", "EventTs": 1726125338, "EventMsTs": 1726125338219, "UserId": "inspect", "TaskId": "npVqpdU7sBobiK1iskE3BwlLIebCMrbKUbnL4KrO+8oZWQndib9uvO4Deq9P1NasXGNGNuAE", "Payload": { "Status": 0 } }}

20、事件类型为1102，审核任务结束

EVENT_TYPE_CLOUD_Moderation_STOP 时 Payload 的定义：

{ "EventGroupId": 11, "EventType": 1102, "CallbackTs": 1729601782073, "EventInfo": { "RoomId": "975626", "EventTs": "1729601782", "EventMsTs": 1729601782073, "UserId": "SliceTaskDuration1-partner-robot", "TaskId": "nHRjqhU7gTG0UIL-MquzG8D0Q+wehTbVTeeIIK-rO+8oZWQndibtueIpQ8A0F3n9PEVRk0rngE", "Payload": { "LeaveCode": 99 } }}

21、事件类型为1103，开始送审文件

EVENT_TYPE_CLOUD_Moderation_SEND_START 时 Payload 的定义：

{ "EventGroupId": 11, "EventType": 1103, "CallbackTs": 1726750023538, "EventInfo": { "RoomId": "295210", "EventTs": 1726750023, "EventMsTs": 1726750023538, "UserId": "inspect", "TaskId": "nHwXIdU7mJvL22pFsXZ-v7OgEzq1OzbNXe9L4K-4pycoZWQndib3ZfzqN7Wq+AdiPLMBLxd0gE", "Payload": { "Status": 0 } }}

22、事件类型为1104，审核结果回调

EVENT_TYPE_CLOUD_Moderation_FILE_INFO 时 Payload 的定义：

23、CheckDetail 的定义

音频审核结果示例

{ "EventGroupId": 11, "EventType": 1104, "CallbackTs": 1726750309161, "EventInfo": { "RoomId": "963239", "EventTs": 1735872251, "EventMsTs": 1735872251524, "UserId": "TRTCModerationCase2-user0", "StreamerUserId": "SliceCustomUploadCase6-user0", "TaskId": "-m9lm+lU7tOlL2mFgsPuzHeyNThbhZzbJlKQI4K-raO8oZWQndibARGYcSDohF0Zfgo7RNCuGQE.", "Payload": { "DataId": "547512114953106866", "RequestId": "", "MediaType": 1, "Suggest": 2, "Label": "Polity", "Image": "", "Rate": 100, "Audio": "https://x.xx.com/-m9lm+lU7tOlL2mFgsPuzHeyNThbhZzbJlKQI4K-raO8oZWQndibARGYcSDohF0Zfgo7RNCuGQE./547512114835666354.ogg", "AudioText": "XXX认真听取讲解，观看反映延安时期重大战役运筹指挥情况的历史图表，感悟党中央和中央军委的领导智慧和艺术。", "CheckDetail": [ { "Label": "Polity", "Suggest": 2, "Keywords": [ "XXX" ], "Score": 100, "Desc": "", "AudioSegments": {}, "ImageLocation": {} } ] } }}

24、事件类型为1105，结束文件送审

EVENT_TYPE_CLOUD_Moderation_SEND_STOP 时 Payload 的定义：

{ "EventGroupId": 11, "EventType": 1105, "CallbackTs": 1726751347072, "EventInfo": { "RoomId": "295211", "EventTs": 1726751347, "EventMsTs": 1726751347072, "UserId": "inspect", "TaskId": "-nHwXIdU7jx6C00Nt8Vr+3h4GwYdP7zbeHi9L4K-4pycoZWQndibqFeEaV4LvjFqSuQvaAkrNQE.", "Payload": { "Status": 0 } }}

25、事件类型为1106，投递文件失败

EVENT_TYPE_CLOUD_Moderation_SEND_ERROR 时 Payload 的定义：

{ "EventGroupId": 11, "EventType": 1106, "CallbackTs": 1726751347072, "EventInfo": { "RoomId": "295211", "EventTs": 1726751347, "EventMsTs": 1726751347072, "UserId": "inspect", "TaskId": "-nHwXIdU7jx6C00Nt8Vr+3h4GwYdP7zbeHi9L4K-4pycoZWQndibqFeEaV4LvjFqSuQvaAkrNQE.", "Payload": { "Code": 10002, "Message": "BadRequest" } }}

26、语音消息

语音消息和实时语音是两个不同的功能，语音消息审核结果除了在语音消息接口里直接返回 audit_result 字段外，还会回调你配置的服务端回调 url

27、语音消息审核验签说明

审核回调结构体 sign 字段是待验签的字段

步骤1：组成待签名的字符串

//待签名字符串body： "biz_id=" +biz_id + "&audit_res=" +audit_res+ "&DataId=" + DataId + "&Label=" + Label

步骤2：使用 sha256签名算法签名

func createSignature(signKey string, body string) string { mac := hmac.New(sha256.New, []byte(signKey)) mac.Write([]byte(body)) sha := hex.EncodeToString(mac.Sum(nil)) return sha}

28、语音审核结果回调

字段定义：

29、ScanDetail 字段说明：

{ "user_id": 9920413420219, "player_uin": "9920413420219", "biz_id": 1400367018, "sign": "f7067c7020dc384879f273738f76319235d94aef60b7d83cec575a300e548199", "audit_res": 1, "DataId": "A1A3E84F-4C9A-4A51-B7EC-10DFBC49959F", "HitFlag": true, "Label": "porn", "AsrText": "怎么，还想你的奶了？", "ScanDetail": [ { "Label": "porn", "Rate": "72", "StartTime": 0, "EndTime": 0 } ], "RequestId": "a61df1f6-e0e2-4a5b-805c-e277463d7bc3"}