tencent cloud

文档反馈

概览

最后更新时间:2022-10-20 15:57:08

    V2TXLivePlayer

    视频播放器

    请参见 V2TXLivePlayer
    主要负责从指定的直播流地址拉取音视频数据,并进行解码和本地渲染播放。
    播放器包含如下能力:

    • 支持 RTMP、HTTP-FLV、TRTC 以及 WebRTC 协议。
    • 屏幕截图,可以截取当前直播流的视频画面。
    • 延时调节,可以设置播放器缓存自动调整的最小和最大时间。
    • 自定义的视频数据处理,您可以根据项目需要处理直播流中的视频数据后,再进行渲染以及播放。

    SDK 基础函数

    API 描述
    addListener 设置播放器回调。

    播放基础接口

    API 描述
    setRenderViewID 设置播放器的视频渲染 ViewID。
    startLivePlay 10.7 版本开始,startPlay 变更为 startLivePlay,需要通过 V2TXLivePremier#setLicence 设置 License 后方可成功播放,否则将播放失败(黑屏),全局仅设置一次即可。直播 License、短视频 License 和视频播放 License 均可使用,若您暂未获取上述 License ,可 快速免费申请测试版 License 以正常播放,正式版 License 需购买
    stopPlay 停止播放。
    isPlaying 是否正在播放。

    视频相关接口

    API 描述
    setRenderRotation 设置播放器画面的旋转角度。
    setRenderFillMode 设置画面的填充模式。
    pauseVideo 暂停播放器的视频流。
    resumeVideo 恢复播放器的视频流。
    snapshot 截取播放过程中的视频画面。

    音频相关接口

    API 描述
    pauseAudio 暂停播放器的音频流。
    resumeAudio 恢复播放器的音频流。
    setPlayoutVolume 设置音量。
    enableVolumeEvaluation 启用播放音量大小提示。

    更多实用接口

    API 描述
    setCacheParams 设置播放器缓存自动调整的最小和最大时间 ( 单位:秒 )。
    showDebugView 是否显示播放器状态信息的调试浮层。

    V2TXLivePlayerObserver

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

    SDK 基础回调

    API 描述
    onError 直播播放器错误通知,播放器出现错误时,会回调该通知。
    onWarning 直播播放器警告通知。
    onConnected 已经成功连接到服务器通知。

    视频相关回调

    API 描述
    onVideoPlaying 视频播放事件通知。
    onVideoLoading 视频加载事件通知。
    onVideoResolutionChanged 直播播放器分辨率变化通知。
    onSnapshotComplete 截图回调。
    onRenderVideoFrame 自定义视频渲染回调。

    音频相关回调

    API 描述
    onAudioPlaying 音频播放事件通知。
    onAudioLoading 音频加载事件通知。
    onPlayoutVolumeUpdate 播放器音量大小回调。

    统计回调

    API 描述
    onStatisticsUpdate 直播播放器统计数据回调。

    V2TXLivePusher

    直播推流类

    请参见 V2TXLivePusher

    主要负责将本地的音频和视频画面进行编码,并推送到指定的推流地址,支持任意的推流服务端。
    推流器包含如下能力:

    • 自定义的视频采集,让您可以根据项目需要定制自己的音视频数据源。
    • 美颜、滤镜、贴纸,包含多套美颜磨皮算法(自然&光滑)和多款色彩空间滤镜(支持自定义滤镜)。
    • Qos 流量控制技术,具备上行网络自适应能力,可以根据主播端网络的具体情况实时调节音视频数据量。
    • 脸形调整、动效挂件,支持基于优图 AI 人脸识别技术的大眼、瘦脸、隆鼻等脸形微调以及动效挂件效果,只需要购买 优图 License 就可以轻松实现丰富的直播效果。

    SDK 基础函数

    API 描述
    addListener 设置推流器回调。

    推流基础接口

    API 描述
    setRenderViewID 设置本地摄像头预览 View。
    startPush 开始音视频数据推流。
    stopPush 停止推送音视频数据。
    isPushing 当前推流器是否正在推流中。

    视频相关接口

    API 描述
    setVideoQuality 设置推流视频编码参数。
    setRenderRotation 设置本地摄像头预览画面的旋转角度。
    setRenderMirror 设置本地摄像头预览镜像。
    startCamera 打开本地摄像头。
    stopCamera 关闭本地摄像头。
    startVirtualCamera 开启图片推流。
    stopVirtualCamera 关闭图片推流。
    startScreenCapture 开启屏幕采集。
    stopScreenCapture 关闭屏幕采集。
    snapshot 截取推流过程中的本地画面。
    setWatermark 设置推流器水印。默认情况下,水印不开启。
    setEncoderMirror 设置视频编码镜像。
    enableCustomVideoCapture 开启/关闭自定义视频采集。
    sendCustomVideoFrame 在自定义视频采集模式下,将采集的视频数据发送到 SDK。
    enableCustomVideoProcess 开启/关闭自定义视频处理。
    sendSeiMessage 发送 SEI 消息。

    美颜相关接口

    API 描述
    getBeautyManager,美颜的设置通过 TXBeautyManager 来设置。

    音频相关接口

    API 描述
    startMicrophone 打开麦克风。
    stopMicrophone 关闭麦克风。
    setAudioQuality 设置推流音频质量。
    enableVolumeEvaluation 启用采集音量大小提示。

    音效相关接口

    API 描述
    getAudioEffectManager 获取音效管理对象。

    设备管理相关接口

    API 描述
    getDeviceManager 获取设备管理对象。

    更多实用接口

    API 描述
    setProperty 调用 V2TXLivePusher 的高级 API 接口。
    setMixTranscodingConfig 设置云端的混流转码参数。
    showDebugView 显示仪表盘。

    V2TXLivePusherObserver

    SDK 基础回调

    API 描述
    onError 直播推流器错误通知,推流器出现错误时,会回调该通知。
    onWarning 直播推流器警告通知。

    视频相关回调

    API 描述
    onPushStatusUpdate 推流器连接状态回调通知。
    onSnapshotComplete 截图回调。
    onProcessVideoFrame 自定义视频处理。
    onGLContextDestroyed SDK 内部的 OpenGL 环境的销毁通知。
    onCaptureFirstVideoFrame 首帧视频采集完成的回调通知。

    音频相关回调

    API 描述
    onCaptureFirstAudioFrame 首帧音频采集完成的回调通知。
    onMicrophoneVolumeUpdate 麦克风采集音量值回调。

    混流回调

    API 描述
    onSetMixTranscodingConfig 设置云端的混流转码参数的回调。

    统计回调

    API 描述
    onStatisticsUpdate 直播推流器统计数据回调。