tencent cloud

云直播

动态与公告
公告
新手指南
产品简介
产品概述
子产品简介
基本概念
产品功能
应用场景
产品优势
使用限制
购买指南
计费概述
基础服务费
增值服务费
预付费资源包
购买流程
计费变更
退款说明
账单查询
续费说明
欠费停服说明
计费常见问题
标准直播
概述
应用场景
快速入门
SDK 接入说明
快直播(超低延时直播)
概述
快直播和标准直播区别
应用场景
快速入门
SDK 接入说明
云导播台
概述
应用场景
功能区介绍
云导播台管理
通用云导播
配置节目单和自动导播
控制台指南
控制台介绍
概览
域名管理
流管理
资源包管理
AI 智能
功能配置
拉流转推
计费用量
业务监控
常用工具
无忧直播
CAM 访问控制
功能实践
直播推流与播放
直播增值功能
典型场景实践
云端原生录制
直播安全
海外直播
回调事件消息通知
常见第三方工具指南
SDK 实践
0. SDK 接入引导
1. 推流
2. 播放
3. 高级功能
API 文档
History
Introduction
API Category
Making API Requests
Live Pad APIs
Live Stream Mix APIs
Time Shifting APIs
Monitoring Data Query APIs
Billing Data Query APIs
Live Transcoding APIs
Delayed Playback Management APIs
Domain Name Management APIs
Watermark Management APIs
Certificate Management APIs
Stream Pulling APIs
Recording Management APIs
Live Callback APIs
Screencapturing and Porn Detection APIs
Authentication Management APIs
Live Stream Management APIs
Data Types
Error Codes
运维指南
优化视频卡顿
推流失败问题排查
播放失败问题排查
CLS 协助直播问题排查
直播延迟问题排查
拉流视频质量不清晰问题排查
COS bucket 授权给直播实现截图存储
故障处理
直播混流报错:InvalidParameter.OtherError
常见问题
服务地区相关
直播基础相关
推流播放相关
直播计费相关
直播海外相关
直播录制相关
云端混流相关
域名配置相关
云导播台相关
适配苹果 ATS 相关
服务等级协议
云直播服务等级协议
CSS 政策
隐私协议
数据处理和安全协议
词汇表

ROI 智能识别

PDF
聚焦模式
字号
最后更新时间: 2025-12-03 17:56:25
ROI 智能识别技术可以实时识别视频中的人脸、游戏人物、主播等关键元素的坐标信息,并将感兴趣区域信息(ROI)随着视频编码传输到播放端。通过播放器结合 ROI 信息,可以实现智能弹幕防遮挡、背景模糊等功能。本文将向您介绍如何通过控制台创建、修改和删除 ROI 智能识别模板。

注意事项

模板创建成功后约5分钟-10分钟生效。
使用 ROI 智能识别功能需在推流地址中带推流参数 roirecognition=ROI 配置名称,播放器即可获取到直播流中的 ROI 信息并进行处理,就能实现比如:智能弹幕防遮挡、背景模糊等效果,ROI 功能的完整使用及播放器处理详见 ROI 智能识别功能实践。推流地址示例为:
rtmp://domain/AppName/StreamName?
txSecret=Md5(key+StreamName+hex(time))&txTime=hex(time)&roirecognition=模板名称
兴趣区域识别 (ROI)功能属于付费增值服务,使用该功能会产生直播转码费用及媒体处理的内容智能识别费用,具体的计费规则请参考计费文档。

使用前提

已开通腾讯云直播服务。

创建 ROI 配置模板

1. 登录 云直播控制台,选择 AI 智能 > ROI 智能识别

说明:
要使用直播实验室功能中的 ROI 智能识别,首次创建时需要您创建服务角色,并授权当前账号角色使用媒体处理产品服务,单击前往授权,进入 CAM 进行授权。
2. 请单击前往授权,进入 CAM 角色管理页面。


3. 在角色管理页面,单击同意授权,完成身份校验后即可完成媒体处理授权,正常使用媒体处理服务。



4. 授权成功后,勾选服务协议并单击开始使用,系统会自动开通媒体处理产品并打开流媒体智能处理管理页面。
5. 进入 ROI 智能识别管理页面,单击创建 ROI 配置模板

6. 进入兴趣区域识别(ROI)配置页,进行如下配置:

配置项
说明
名称
模板名称的前缀默认为 "roi"。模板名称可自定义,支持 1-10 个字符,(仅支持英文和数字的组合)。
描述
仅支持中文、英文、数字、空格、_-,不超过100个字符。
训练模型
默认通用。支持选择场景包括:王者荣耀游戏、NBA2K 游戏、秀场直播。
通用:可识别不同环境下常见人眼关注区域。
王者荣耀游戏:可识别王者荣耀游戏中不同环境下出现的英雄角色区域。
NBA2K 游戏:可识别 NBA2K 游戏中不同环境下的球员、篮球、比分牌等区域。
秀场直播:可识别主播人脸区域。
说明:
系统会识别视频中人脸、游戏人物等坐标信息,不同的训练模型对视频分类的准确率影响很大,选择合适场景的训练模型可提升 ROI 智能识别效果准确率。如有其它场景的识别需求可 提交工单 申请。
7. 填写完成后,单击确定即可。

修改模板

1. 登录 云直播控制台,选择 AI 智能 > ROI 智能识别
2. 选择您已创建成功的 ROI 配置模板,并单击右侧的编辑,即可进入修改模板信息。

3. 单击确定即可。

删除模板

1. 登录 云直播控制台,选择 AI 智能 > ROI 智能识别
2. 选择您已创建成功的 ROI 配置模板,单击上方的删除

3. 确认是否删除当前 ROI 配置模板,单击确定即可成功删除。




帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈