内容理解功能配置

最近更新时间:2026-06-11 09:16:30

我的收藏
功能配置是内容理解功能投入使用前的必要环节。本文档详细介绍内容理解各项功能配置的含义和使用方法。

配置入口

1. 登录腾讯云 实时音视频 TRTC 控制台
2. 在左侧导航栏选择应用管理,选择需要配置的应用,单击其右侧操作栏配置,进入该应用的配置页面。



3. 在功能配置页面的左侧导航栏,选择内容理解,点击开通内容理解功能,进入内容理解配置页



4. 请先确保您已 开启内容理解功能位开关 ,并打开内容理解配置开关。仅当内容理解功能位开关和内容理解配置开关同时打开时,内容理解功能为可用状态。




内容理解模式

内容理解模式决定了内容理解任务的触发方式:
模式
概况
手动提交处理(默认)
可以指定只处理一部分用户的音视频流,这需要您通过服务端的 Server API 进行控制,需要额外的开发工作量,可参考 接入指引及回调说明
全局自动处理
当前应用下每一个 TRTC 房间中的每个用户的音视频上行流都会按照您配置的内容理解策略自动识别,任务的启动和停止都是自动的,不需要额外开发。
说明:
仅开启手动提交处理模式时,不会自动拉取音频和视频。如需自动拉取音频和视频,请开启全局自动处理。

存储桶绑定

存储桶绑定功能用于保存音视频切片文件。绑定存储桶后,TRTC 录制产生的音视频切片文件将自动保存至所绑定的对象存储中,便于长期留存与后续调用。

存储桶配置

支持腾讯云 COS / AWS S3
地域、访问密钥、密钥、存储桶名称和文件名前缀均请参考 区域和可用区地域和访问域名



注意:
建议绑定 COS 存储桶以确保数据可追溯。若未绑定存储桶,TRTC 后台仅会临时缓存切片文件一段时间,请尽快通过回调中返回的文件链接进行下载存储,否则文件将会被清除。

访问密钥与密钥

COS 名称
又名
作用
可见性
SecretId
访问密钥
账号标识(用户名)
可公开
SecretKey
密钥
签名密码
仅创建时可见,必须保存
查询入口:
1. 登录 腾讯云控制台
2. 点击右上角头像,选择访问管理 CAM



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



4. 点击新建密钥,短信验证后,生成:
SecretId(访问密钥)
SecretKey(密钥)




AWS S3

S3名称
又名
作用
可见性
Access Key ID
访问密钥
账号标识(用户名)
可公开
Secret Access Key
密钥
签名密码
仅创建时可见,必须保存
查询入口:
1. 登录 AWS 控制台,进入 IAM
2. 选择 Users,选择你的用户下的 Security credentials
3. 选择 Access keys,点击 Create access key
4. 生成后下载 CSV,里面包含:
Access Key ID(访问密钥)
Secret Access Key(密钥)

文件保存规则配置

支持自定义音频切片及视频截帧文件存放规则,可选择不保存文件、保存所有文件或者仅保存命中违规标签的文件。

处理内容配置

根据业务场景选择需要内容理解的内容类型,不同选项对应不同的资源消耗和成本:
选项
说明
仅音频
仅对房间内音频流进行内容理解。
仅视频
仅对房间内视频画面进行内容理解。
音频及视频
同时对音频和视频画面进行内容理解。

回调规则配置

支持回调通知能力,通过配置您的回调域名,内容理解的事件状态会通知到您的回调服务器。
回调配置决定哪些内容理解结果会推送到您的业务系统,合理配置可以减少业务侧处理压力。
策略
说明
全量回调
推送所有内容理解结果,包括正常和违规。
违规回调
仅推送违规及疑似违规的内容理解结果。