tencent cloud

文档反馈

接口说明

最后更新时间:2022-08-22 14:28:50

    TXVodPlayer

    点播播放器

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

    • 支持 FLV、MP4 及 HLS 多种播放格式,支持 基础播放(URL 播放) 和 点播播放(Fileid 播放)两种播放方式 。
    • 屏幕截图,可以截取当前播放流的视频画面。
    • 通过手势操作,调节亮度、声音、进度等。
    • 可以手动切换不同的清晰度,也可根据网络带宽自适应选择清晰度。
    • 可以指定不同倍速播放,并开启镜像和硬件加速。
    • 完整能力,请参见 点播超级播放器 - 能力清单

    播放器配置接口

    API 描述
    config 点播配置,配置信息请参见 TXVodPlayConfig
    isAutoPlay startPlay 后是否立即播放,默认 YES。
    token 加密 HLS 的 token。设置此值后,播放器自动在 URL 中的文件名之前增加 voddrm.token.TOKEN TextureView
    loop 是否循环播放 SurfaceView。
    enableHWAcceleration 视频渲染回调。(仅硬解支持)

    播放基础接口

    API 描述
    startPlay 播放 HTTP URL 形式地址。
    startPlayWithParams 以 fileId 形式播放。
    stopPlay 停止播放。
    isPlaying 是否正在播放。
    pause 暂停播放,停止获取流数据,保留最后一帧画面。
    resume 恢复播放,重新获取流数据。
    seek 跳转到视频流指定时间点,单位秒。
    currentPlaybackTime 获取当前播放位置,单位秒。
    duration 获取总时长,单位秒。
    playableDuration 获取可播放时长,单位秒。
    width 获取视频宽度。
    height 获取视频高度。
    setStartTime 设置播放开始时间。

    视频相关接口

    API 描述
    snapshot 获取当前视频帧图像。
    注意:由于获取当前帧图像是比较耗时的操作,所以截图会通过异步回调出来。
    setMirror 设置镜像。
    setRate 设置点播的播放速率,默认1.0。
    bitrateIndex 返回当前播放的码率索引。
    setBitrateIndex 设置当前正在播放的码率索引,无缝切换清晰度。
    清晰度切换可能需要等待一小段时间。
    setRenderMode 设置 图像平铺模式
    setRenderRotation 设置 图像渲染角度

    音频相关接口

    API 描述
    setMute 设置是否静音播放。
    setAudioPlayoutVolume 设置音量大小,范围:0 - 100。

    事件通知接口

    API 描述
    delegate 事件回调,建议使用 vodDelegate
    vodDelegate 设置播放器的回调。
    videoProcessDelegate 视频渲染回调(仅硬解支持)。

    TRTC 相关接口

    通过以下接口,可以把点播播放器的音视频流通过 TRTC 进行推送,更多 TRTC 服务请参见 TRTC 产品概述

    API 描述
    attachTRTC 点播绑定到 TRTC 服务。
    detachTRTC 点播解绑 TRTC 服务。
    publishVideo 开始推送视频流。
    unpublishVideo 取消推送视频流。
    publishAudio 开始推送音频流。
    unpublishAudio 取消推送音频流。

    TXVodPlayListener

    腾讯云点播回调通知。

    SDK 基础回调

    API 描述
    onPlayEvent 点播播放事件通知,请参见 播放事件列表事件参数
    onNetStatus 点播播放器 网络状态通知

    TXVodPlayConfig

    点播播放器配置类。

    基础配置接口

    API 描述
    connectRetryCount 设置播放器重连次数。
    connectRetryInterval 设置播放器重连间隔,单位秒。
    timeout 设置播放器连接超时时间,单位秒。
    cacheFolderPath 设置点播缓存目录,点播 MP4、HLS 有效。
    maxCacheItems 设置缓存文件个数。
    playerType 设置播放器类型。
    headers 设置自定义 HTTP headers。
    enableAccurateSeek 设置是否精确 seek,默认 true。
    autoRotate 播放 MP4 文件时,若设为 YES 则根据文件中的旋转角度自动旋转。
    旋转角度可在 PLAY_EVT_CHANGE_ROTATION 事件中获得。默认 YES。
    smoothSwitchBitrate 平滑切换多码率 HLS,默认 false。
    progressInterval 设置进度回调间隔,单位毫秒。
    maxBufferSize 最大预加载大小,单位 MB。

    错误码表

    常规事件

    code 事件定义 含义说明
    2004 PLAY_EVT_PLAY_BEGIN 视频播放开始(若有转菊花效果,此时将停止)。
    2005 PLAY_EVT_PLAY_PROGRESS 视频播放进度,会通知当前播放进度、加载进度和总体时长。
    2007 PLAY_EVT_PLAY_LOADING 视频播放 loading,如果能够恢复,之后会有 LOADING_END 事件。
    2014 PLAY_EVT_VOD_LOADING_END 视频播放 loading 结束,视频继续播放。
    2006 PLAY_EVT_PLAY_END 视频播放结束。
    2013 PLAY_EVT_VOD_PLAY_PREPARED 播放器已准备完成,可以播放。
    2003 PLAY_EVT_RCV_FIRST_I_FRAME 网络接收到首个可渲染的视频数据包(IDR)。
    2009 PLAY_EVT_CHANGE_RESOLUTION 视频分辨率改变。
    2011 PLAY_EVT_CHANGE_ROTATION MP4 视频旋转角度。

    警告事件

    code 事件定义 含义说明
    -2301 PLAY_ERR_NET_DISCONNECT 网络断连,且经多次重连亦不能恢复,更多重试请自行重启播放。
    -2305 PLAY_ERR_HLS_KEY HLS 解密 key 获取失败。
    2101 PLAY_WARNING_VIDEO_DECODE_FAIL 当前视频帧解码失败。
    2102 PLAY_WARNING_AUDIO_DECODE_FAIL 当前音频帧解码失败。
    2103 PLAY_WARNING_RECONNECT 网络断连, 已启动自动重连(重连超过三次就直接抛送 PLAY_ERR_NET_DISCONNECT)。
    2106 PLAY_WARNING_HW_ACCELERATION_FAIL 硬解启动失败,采用软解。
    -2304 PLAY_ERR_HEVC_DECODE_FAIL H265 解码失败。
    -2303 PLAY_ERR_FILE_NOT_FOUND 播放的文件不存在。
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持