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
Parameter Template 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
Task Flow APIs
Data Types
Error Codes
Video on Demand API 2024-07-18
常见问题
移动端播放问题
费用相关问题
视频上传问题
视频发布问题
视频播放问题
Web 端播放问题
全屏播放问题
数据统计问题
访问管理相关问题
媒资降冷问题
相关协议
Service Level Agreement
VOD 政策
隐私政策
数据处理和安全协议
联系我们
词汇表

TXVodConstants

PDF
聚焦模式
字号
最后更新时间: 2025-05-30 14:15:38

TXVodConstants API 简介

点播播放器用到的常量类。

图像平铺模式

参数名
描述
0
RENDER_MODE_FULL_FILL_SCREEN
视频画面全屏铺满。
1
RENDER_MODE_ADJUST_RESOLUTION
视频画面自适应屏幕。

图像渲染角度

参数名
描述
0
RENDER_ROTATION_PORTRAIT
常规竖屏。
270
RENDER_ROTATION_LANDSCAPE
右旋90度。

播放事件列表

参数名
描述
2002
VOD_PLAY_EVT_HIT_CACHE
启播命中缓存。
2003
VOD_PLAY_EVT_RCV_FIRST_I_FRAME
网络接收到首个视频数据包(IDR)。
2004
VOD_PLAY_EVT_PLAY_BEGIN
视频播放开始。
2005
VOD_PLAY_EVT_PLAY_PROGRESS
视频播放进度。
2006
VOD_PLAY_EVT_PLAY_END
视频播放结束。
6001
VOD_PLAY_EVT_LOOP_ONCE_COMPLETE
循环一轮播放结束
2007
VOD_PLAY_EVT_PLAY_LOADING
视频播放 Loading。
2008
VOD_PLAY_EVT_START_VIDEO_DECODER
解码器启动。
2009
VOD_PLAY_EVT_CHANGE_RESOLUTION
视频分辨率改变。
2010
VOD_PLAY_EVT_GET_PLAYINFO_SUCC
获取点播文件信息成功。
2011
VOD_PLAY_EVT_CHANGE_ROTATION
视频旋转信息。
2013
VOD_PLAY_EVT_VOD_PLAY_PREPARED
视频加载完毕。
2014
VOD_PLAY_EVT_VOD_LOADING_END
loading 结束。
2017
VOD_PLAY_EVT_FIRST_VIDEO_PACKET
收到首帧数据(12.0 版本开始支持)。
2019
VOD_PLAY_EVT_SEEK_COMPLETE
Seek 完成(10.3版本开始支持)。
2020
VOD_PLAY_EVT_SELECT_TRACK_COMPLETE
切换轨道完成。
2026
VOD_PLAY_EVT_RCV_FIRST_AUDIO_FRAME
音频首次播放。
2103
VOD_PLAY_WARNING_RECONNECT
网络断连, 已启动自动重连。
2030
VOD_PLAY_EVT_VIDEO_SEI
视频 sei 信息事件。
2031
VOD_PLAY_EVT_HEVC_DOWNGRADE_PLAYBACK
HEVC 降级播放。
-2301
VOD_PLAY_ERR_NET_DISCONNECT
网络断连,且经多次重连抢救无效。
-2303
VOD_PLAY_ERR_FILE_NOT_FOUND
文件不存在。
-2304
VOD_PLAY_ERR_HEVC_DECODE_FAIL
HEVC 解码失败。
-2305
VOD_PLAY_ERR_HLS_KEY
HLS 解密 key 获取失败。
-2306
VOD_PLAY_ERR_GET_PLAYINFO_FAIL
获取点播文件信息失败。
2106
VOD_PLAY_WARNING_HW_ACCELERATION_FAIL
硬解启动失败,采用软解。
-5
VOD_PLAY_ERR_INVALID_LICENCE
license 不合法,播放失败。
注:在 startVodPlay 之前,需要通过 TXLiveBase#setLicence 设置 License 后方可成功播放,否则将播放失败(黑屏),全局仅设置一次即可。直播 License、短视频 License 和播放器 License 均可使用,若您暂未获取上述 License ,可单击 播放器 License 进行申请,正式版 License 需购买。
-6004
VOD_PLAY_ERR_SYSTEM_PLAY_FAIL
系统播放器播放错误。
-6006
VOD_PLAY_ERR_DECODE_VIDEO_FAIL
视频解码错误,视频格式不支持。
-6007
VOD_PLAY_ERR_DECODE_AUDIO_FAIL
音频解码错误,音频格式不支持。
-6008
VOD_PLAY_ERR_DECODE_SUBTITLE_FAIL
字幕解码错误。
-6009
VOD_PLAY_ERR_RENDER_FAIL
视频渲染错误。
-6010
VOD_PLAY_ERR_PROCESS_VIDEO_FAIL
视频后处理错误。
-6101
VOD_PLAY_ERR_DRM
DRM 播放失败

播放事件参数

参数名
描述
"CPU_USAGE"
NET_STATUS_CPU_USAGE
当前瞬时 CPU 使用率。
"VIDEO_WIDTH"
NET_STATUS_VIDEO_WIDTH
视频分辨率 - 宽。
"VIDEO_HEIGHT"
NET_STATUS_VIDEO_HEIGHT
视频分辨率 - 高。
"NET_SPEED"
NET_STATUS_NET_SPEED
当前的网络数据接收速度,单位:KBps。
"VIDEO_FPS"
NET_STATUS_VIDEO_FPS
当前流媒体的视频帧率。
"VIDEO_BITRATE"
NET_STATUS_VIDEO_BITRATE
当前流媒体的视频码率,单位 bps。
"AUDIO_BITRATE";
NET_STATUS_AUDIO_BITRATE
当前流媒体的音频码率,单位 bps。
"VIDEO_CACHE"
NET_STATUS_VIDEO_CACHE
缓冲区(jitterbuffer)大小,缓冲区当前长度为0,说明离卡顿就不远了,单位:KBps。
"SERVER_IP"
NET_STATUS_SERVER_IP
连接的服务器 IP。
"EVT_UTC_TIME"
EVT_UTC_TIME
UTC 时间。
"EVT_TIME"
EVT_TIME
事件发生时间。
"EVT_MSG"
EVT_DESCRIPTION
事件说明。
"EVT_PARAM1"
EVT_PARAM1
事件参数1。
"EVT_PARAM2"
EVT_PARAM2
事件参数2。
"EVT_PLAY_COVER_URL"
EVT_PLAY_COVER_URL
视频封面。
"EVT_PLAY_URL"
EVT_PLAY_URL
视频地址。
"EVT_PLAY_NAME"
EVT_PLAY_NAME
视频名称。
"EVT_PLAY_DESCRIPTION"
EVT_PLAY_DESCRIPTION
视频简介。
"EVT_PLAY_PROGRESS_MS"
EVT_PLAY_PROGRESS_MS
播放进度(毫秒)。
"EVT_PLAY_DURATION_MS"
EVT_PLAY_DURATION_MS
播放总长(毫秒)。
"EVT_PLAY_PROGRESS"
EVT_PLAY_PROGRESS
播放进度。
"EVT_PLAY_DURATION"
EVT_PLAY_DURATION
播放总长。
"EVT_PLAYABLE_DURATION_MS"
EVT_PLAYABLE_DURATION_MS
点播可播放时长(毫秒)。
"EVT_PLAYABLE_RATE"
EVT_PLAYABLE_RATE
播放速率。
"EVT_PLAYABLE_DURATION"
EVT_PLAYABLE_DURATION
点播可播放时长。
"EVT_IMAGESPRIT_WEBVTTURL"
EVT_IMAGESPRIT_WEBVTTURL
雪碧图 web vtt 描述文件下载 URL。
"EVT_IMAGESPRIT_IMAGEURL_LIST"
EVT_IMAGESPRIT_IMAGEURL_LIST
雪碧图图片下载 URL。
"EVT_DRM_TYPE"
EVT_DRM_TYPE
加密类型。
"EVT_CODEC_TYPE"
EVT_CODEC_TYPE
视频编码类型。
"EVT_KEY_FRAME_CONTENT_LIST"
EVT_KEY_FRAME_CONTENT_LIST
视频关键帧描述信息。
"EVT_KEY_FRAME_TIME_LIST"
EVT_KEY_FRAME_TIME_LIST
关键帧时间。
"EVT_PLAY_PDT_TIME_MS"
EVT_PLAY_PDT_TIME_MS
播放 PDT 时间(毫秒)。
"EVT_KEY_VIDEO_ROTATION"
EVT_KEY_VIDEO_ROTATION
MP4视频旋转角度。
"EVT_KEY_WATER_MARK_TEXT"
EVT_KEY_WATER_MARK_TEXT
幽灵水印文本(11.5版本开始支持)。

播放器媒资类型

参数名
描述
0
MEDIA_TYPE_AUTO
AUTO 类型。
1
MEDIA_TYPE_HLS_VOD
自适应码率播放 HLS 点播媒资。
2
MEDIA_TYPE_HLS_LIVE
自适应码率播放 HLS 直播媒资。
3
MEDIA_TYPE_FILE_VOD
MP4 等通用文件点播媒资。
4
MEDIA_TYPE_DASH_VOD
DASH 点播媒资。

MP4 加密等级

参数名
描述
0
MP4_ENCRYPTION_LEVEL_NONE
MP4 不加密播放。
2
MP4_ENCRYPTION_LEVEL_L2
L2, MP4 本地加密播放。

未分类变量

参数名
描述
0
PLAYER_SYSTEM_MEDIA_PLAYER
系统播放器。
1
PLAYER_THUMB_PLAYER
自研播放器,支持软解,兼容性更好。
-1
INDEX_AUTO
自适应码率 index 标识。
"450"
PLAYER_OPTION_KEY_SUBTITLE_OUTPUT_TYPE
外挂字幕输出类型配置 Key
"backup_url"
VOD_KEY_BACKUP_URL
降级播放备选 URL Key。
"mimetype"
VOD_KEY_MIMETYPE
播放资源的 Mimetype Key。
"text/x-subrip"
VOD_PLAY_MIMETYPE_TEXT_SRT
外挂字幕 SRT 格式。
"text/vtt"
VOD_PLAY_MIMETYPE_TEXT_VTT
外挂字幕 VTT 格式。
"EVT_KEY_WATER_MARK_TEXT"
EVT_KEY_WATER_MARK_TEXT
幽灵水印文本(11.5版本开始支持)。


帮助和支持

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

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

文档反馈