概览

最近更新时间:2025-12-04 11:24:41

我的收藏

TXLivePlayer

视频播放器

请参见 TXLivePlayer
主要负责将直播流的音视频画面进行解码和本地渲染,包含如下技术特点:
针对腾讯云的拉流地址,可使用低延时拉流,实现直播连麦等相关场景。
针对腾讯云的拉流地址,可使用直播时移功能,能够实现直播观看与时移观看的无缝切换。
支持自定义的音视频数据处理,让您可以根据项目需要处理直播流中的音视频数据后,进行渲染以及播放。

SDK 基础函数

API
描述
创建 TXLivePlayer 实例。
设置 TXLivePlayer 播放配置项。
设置推流回调接口。

播放基础接口

API
描述
设置播放器的视频渲染 View。
播放器开始播放。10.7 版本开始,startPlay 变更为 startLivePlay,需要通过 V2TXLivePremier#setLicence 或者 TXLiveBase#setLicence 设置 License 后方可成功播放,否则将播放失败(黑屏),全局仅设置一次即可。直播 License、短视频 License 和视频播放 License 均可使用,若您暂未获取上述 Licence,可 购买 Licence。
停止播放。
是否正在播放。
暂停播放。
恢复播放。
使用 Surface 模式用于本地渲染。
设置渲染 Surface 的大小。

播放配置接口

API
描述
设置播放渲染模式。
设置图像渲染角度。
开启硬件加速。
设置是否静音播放。
设置声音播放模式。
设置音量。
多清晰度切换。
设置音量大小回调接口。

本地录制和截图

API
描述
设置录制回调接口。
启动视频录制。
停止视频录制。
播放过程中本地截图。

自定义数据处理

API
描述
设置软解码数据载体 Buffer。
设置软解码视频数据回调。
设置音频数据回调。

直播时移接口

API
描述
直播时移准备。
seek
直播时移跳转。
恢复直播播放。

截图回调接口类

请参见 ITXSnapshotListener
API
描述
截图回调。

软解视频数据回调接口类

API
描述
软解码器解出一帧数据回调一次。

音频原始数据接口类

API
描述
音频播放数据回调,数据格式 :PCM。
音频播放信息回调。

播放器音量大小接口类

API
描述
播放器音量大小回调, 取值范围 [0,100]。

TXLivePlayConfig

腾讯云直播播放器的参数配置模块

请参见 TXLivePlayConfig
主要负责 TXLivePlayer 对应的参数设置,其中绝大多数设置项在播放开始之后再设置是无效的。

常用设置项

API
描述
设置是否自动调整缓存时间。
设置播放器缓存时间。
设置最大的缓存时间。
设置最小的缓存时间。
设置播放器视频卡顿报警阈值。
设置播放器重连次数。
设置播放器重连间隔。

专业设置项

API
描述
开启消息通道。
设置回声消除。

ITXLivePlayListener

腾讯云直播播放的回调通知

请参见 ITXLivePlayListener
API
描述
播放事件通知。
网络状态通知。

TXLivePusher

直播推流类

请参见 TXLivePusher
主要负责将本地的音视频画面进行编码和 RTMP 推送,包含如下技术特点:
针对腾讯云的推流地址,会采用 QUIC 协议进行加速,配合改进后的 BBR2 带宽测算方案,可以最大限度的利用主播的上行带宽,降低直播卡顿率。
内嵌套的 Qos 流量控制技术具备上行网络自适应能力,可以根据主播端网络的具体情况实时调节音视频数据量。
内嵌多套美颜磨皮算法(自然&光滑)和多款色彩空间滤镜(支持自定义滤镜),可以根据需要自行选择。
商业版包含了基于优图 AI 识别技术的大眼、瘦脸、隆鼻以及动效挂架,只需要购买优图 License 就可以零成本集成。
支持自定义的音视频采集和渲染,让您可以根据项目需要选择自己的音视频数据源。

SDK 基础函数

API
描述
创建 TXLivePusher 实例。
设置 TXLivePusher 推流配置项。
获取推流器配置信息。
设置推流回调接口。

推流基础接口

API
描述
启动摄像头预览。
停止摄像头预览。
启动 RTMP 推流。
停止 RTMP 推流。
启动录屏推流(基于 MediaProjection 技术实现)。
结束录屏推流。
暂停摄像头或屏幕采集并进入垫片推流状态。
恢复摄像头采集并结束垫片推流状态。
查询是否正在推流。

视频相关接口

API
描述
设置视频编码质量。
切换前后摄像头。
设置视频镜像效果。
设置本地摄像头预览画面的旋转方向。
打开后置摄像头旁边的闪光灯。
获取摄像头支持的焦距。
调整摄像头的焦距。
调整曝光比例。

美颜相关接口

API
描述
获取美颜管理对象 TXBeautyManager,美颜的设置通过 TXBeautyManager 来设置。

音频相关接口

API
描述
开启静音。
设置背景音乐的回调接口。
播放背景音乐。
停止播放背景音乐。
暂停播放背景音乐。
继续播放背音乐。
获取背景音乐文件的总时长,单位是毫秒。
设置混音时背景音乐的音量大小,仅在播放背景音乐混音时使用。
设置混音时麦克风音量大小,仅在播放背景音乐混音时使用。
调整背景音乐的音调高低。
设置混响效果。
设置变声类型。

本地录制接口

API
描述
设置录制回调接口。
开始录制短视频。
结束录制短视频,当停止推流后,如果视频还在录制中,SDK 内部会自动结束录制。
推流过程中本地截图。

自定义采集和处理

API
描述
自定义视频采集,向 SDK 发送自己采集的 texture 视频数据。
自定义视频采集,向 SDK 发送自己采集的 YUV 视频数据。
自定义音频采集,向 SDK 发送自己采集的音频 PCM 数据。
自定义视频处理回调。
自定义音频处理回调。
指定 SDK 渲染所使用的 Surface(仅供微信 App 使用)。
设置渲染 Surface 的大小(仅供微信 App 使用)。
在 Surface 模式下,设置摄像机的对焦位置。

更多实用接口

API
描述
发送 SEI 消息,播放端 TXLivePlayer 通过 onPlayEvent(EVT_PLAY_GET_MESSAGE) 来接收该消息。
-
输出自己的 log,保存到 SDK 内部的 xlog 文件中。

自定义视频处理回调类

API
描述
在 OpenGL 线程中回调,在这里可以进行采集图像的二次处理。
增值版回调人脸坐标。
在 OpenGL 线程中回调,可以在这里释放创建的 OpenGL 资源。

自定义音频处理回调类

API
描述
回调未经过任何处理的 SDK 录制音频 PCM 数据。
回调 SDK 录制音频 PCM 数据。

背景音乐回调类

请参见 OnBGMNotify
API
描述
音乐播放开始的回调通知。
音乐播放进度的回调通知。
音乐播放结束的回调通知。

截图回调类

请参见 ITXSnapshotListener
API
描述
-

TXLivePushConfig

腾讯云直播推流用 RTMP SDK 的参数配置模块

请参见 TXLivePushConfig
主要负责 TXLivePusher 对应的参数设置,其中绝大多数设置项在推流开始之后再设置是无效的。

常用设置项

API
描述
设置采集的视频的旋转角度。
设置是否开启手动对焦。
设置是否允许双指手势放大预览画面。
设置水印图片及水印图片位置。
设置水印图片及水印图片位置。
设置本地预览画面的镜像类型。
设置系统音量类型。

垫片推流

API
描述
设置垫片推流的图片素材。
设置垫片的帧率与最长持续时间。
设置后台推流的选项。

音视频编码参数

API
描述
设置采集的视频的分辨率。
设置视频帧率。
设置视频编码 GOP。
设置视频编码码率。
设置最大视频码率。
设置最小视频码率。
设置是否开启码率自适应。
设置动态调整码率的策略。
设置声音采样率。
设置声道数。
开启纯音频推流。
设置录屏推流时是否要根据情况自适应旋转(仅用于录屏推流)。
是否固定摄像头的采集分辨率为720p。
设置观众端水平镜像。

网络相关参数

API
描述
设置推流端重连次数。
设置推流端重连间隔。

自定义采集和处理

API
描述
自定义采集和自定义处理开关。

专业设置项

API
描述
设置回声消除。
设置自动增益。
设置噪声抑制。
设置硬件加速选项。
是否开启 MainProfile 硬编码模式。

ITXLivePushListener

腾讯云直播推流的回调通知

请参见 ITXLivePushListener
API
描述
推流事件通知。
网络状态通知。