tencent cloud

云点播

动态与公告
产品动态
公告
产品简介
产品概述
产品特性
产品功能
产品优势
应用场景
解决方案
专业版
云点播专业版简介
快速入门
控制台指南
开发指南
购买指南
计费概述
计费方式
购买指引
账单查询
续费说明
欠费说明
退费说明
快速入门
控制台指南
控制台介绍
服务概览
应用管理
媒体管理
资源包管理
License 管理
实时日志分析
实践教程
媒体上传
如何将点播的媒体文件进行智能降冷
媒体处理
分发播放
如何接收事件通知
如何进行源站迁移
直播录制
如何进行自定义源站回源
直播精彩剪辑固化至云点播 VOD 指引
如何使用 EdgeOne 分发云点播内容
开发指南
媒体上传
媒体加工处理
媒体 AI
事件通知
媒体分发播放
媒体加密与版权保护
播放频道
访问管理
下载媒体文件
应用体系
错误码
播放器 SDK 文档
概述
基本概念
产品功能
Demo 体验
免费测试
购买指南
SDK 下载
License 指引
播放器教程
含 UI 集成方案
无 UI 集成方案
高级功能
API 文档
第三方播放器插件
Player SDK Policy
服务端 API 文档
History
Introduction
API Category
Other APIs
Media Processing APIs
Task Management APIs
Media Upload APIs
Media Management APIs
Event Notification Relevant API
Media Categorization APIs
Domain Name Management APIs
Distribution APIs
AI-based Sample Management APIs
Region Management APIs
Data Statistics APIs
Carousel-Related APIs
Just In Time Transcode APIs
No longer recommended APIs
Making API Requests
AI-based image processing APIs
Parameter Template APIs
Task Flow APIs
Data Types
Error Codes
Video on Demand API 2024-07-18
常见问题
移动端播放问题
费用相关问题
视频上传问题
视频发布问题
视频播放问题
Web 端播放问题
全屏播放问题
数据统计问题
访问管理相关问题
媒资降冷问题
相关协议
Service Level Agreement
VOD 政策
隐私政策
数据处理和安全协议
联系我们
词汇表

TXSubtitleRenderModel

PDF
聚焦模式
字号
最后更新时间: 2025-09-19 10:14:42

TXSubtitleRenderModel 简介

点播播放器播放字幕样式渲染参数。

字段详情

fontColor

字体颜色,ARGB 格式 如果不设置,默认为白色不透明(0xFFFFFFFF)。
public int fontColor

fontSize

字体大小。如果设置了 fontSize,则必须设置 canvasWidth 和 canvasHeight,否则内部不知道以什么大小为参考来渲染字体, 如果不设置 fontSize,内部会使用默认的字体大小。
public float fontSize

fontScale

字体缩放比例, VTT 专用。设置 fontScale 后,最终字体大小会乘以 fontScale 再适应视频宽,fontScale 默认1.0。
public float fontScale;

familyName

Font family name,Android 默认为"Roboto",字符串不为空则认为已设置,为空则认为未设置。
public String familyName

canvasWidth

canvasWidth 和 canvasHeight 是字幕渲染画布的大小, canvasWidth 和 canvasHeight 的比例必须和视频的宽高比一致,否则渲染出的字体会变形。 如果不设置,播放器会取当前视频的大小作为渲染画布的大小。
public int canvasWidth

canvasHeight

canvasWidth 和 canvasHeight 是字幕渲染画布的大小, canvasWidth 和 canvasHeight 的比例必须和视频的宽高比一致,否则渲染出的字体会变形。 如果不设置,播放器会取当前视频的大小作为渲染画布的大小。
public int canvasHeight

isBondFontStyle

是否是粗体,默认值为正常字体。
public boolean isBondFontStyle

outlineWidth

描边宽度,如果不设置,内部会使用默认的描边宽度。
public float outlineWidth

outlineColor

描边颜色,ARGB 格式 如果不设置,默认为黑色不透明(0xFF000000)。
public int outlineColor

lineSpace

行距,如果设置了 lineSpace,则必须设置 canvasWidth 和 canvasHeight;如果不设置,内部会使用默认的行距。
public float lineSpace

startMargin

以下 startMargin、endMargin 和 verticalMargin 定义字幕的绘制区域,如果不设置,则使用字幕文件中的设置,如果字幕文件也没有定义,则使用默认的。
注意:一旦设置了 startMargin、endMargin 和 yMargin,而字幕文件也定义了这几个参数的一个或多个,则会覆盖字幕文件中相应的参数。 下面示意图描绘了水平书写方向下这几个参数的意义,请借助每个参数的注释来理解。

沿着字幕文本方向的边距,根据不同的书写方向意义不同。 startMargin 是一个比例值,取值范围[0, 1],即相对于视频画面大小的比例。
对于水平书写方向,startMargin 表示字幕左边距离视频画面左边的距离,比如 startMargin=0.05 则边距为视频宽度的0.05倍(5%) 。
对于垂直书写方向(无论从右到左还是从左到右),startMargin 表示字幕顶部距离视频画面顶部的距离,比如 startMargin=0.05 则边距为视频高度的0.05倍(5%)
public float startMargin

endMargin

沿着字幕文本方向的边距。
public float endMargin

verticalMargin

垂直字幕文本方向的边距。
public float verticalMargin

帮助和支持

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

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

文档反馈