human: 如何处理七牛云的直播云基础能力使用

gpt: [直播云](https://developer.qiniu.com/pili) > SDK 下载 > 播放端 >[QPlayer2 Harmony
端](https://developer.qiniu.com/pili/sdk/12702/qplayer2-harmony) > [基于 Core 的
QPlayer2 接入指南](https://developer.qiniu.com/pili/sdk/12704/based-on-
qplayer2-access-guide-to-the-core-harmony) > 基础能力使用

#  基础能力使用

最近更新时间: 2024-07-31 11:50:12

# 基础能力使用

在 [快速开始 __](https://developer.qiniu.io/pili/12705/qplayer2-core-harmony-quick-
start)中，我们完成了qplayer2播放器的创建\播放\销毁，本文介绍如何使用qplayer2的播放能力

# 播放

## 创建播放数据

    
    
    let builder : QMediaModelBuilder = new QMediaModelBuilder()
    builder.addStreamElement("",QPlayerUrlType.QAUDIO_AND_VIDEO,1080,"http://demo-videos.qnsdk.com/qiniu-2023-1080p.mp4",true,"","")
    let model : QMediaModel = builder.build(false)
    

addStreamElements 属性说明

属性名 | 属性说明  
---|---  
userType | 用户自定义Type，目前预留，可以填空字符串  
url | 资源地址  
urlType | 媒体的资源属性 只包含视频/只包含音频/同时有视频音频  
quality | 清晰度  
isSelected | 是否起播时播放该流  
backupUrl | 备用地址  
referer | http/https 协议的地址 支持该属性  
  
## 视频URL类型枚举

    
    
    export enum QPlayerUrlType {
      QAUDIO_AND_VIDEO = 0, //音视频
      QAUDIO = 1,  //纯音频
      QVIDEO = 2,  //纯视频
      NONE = 3,    //无
    }
    

## 播放媒体资源

    
    
    /*** 播放音视频资源
     * @param model 音视频资源
     */ 
    this.mPlayerContext.get_control_handler().playMediaModel(model,0)
    

## 播放错误监听

当视频起播时，如果遇到网络等问题原因，导致没有和服务器建立链接，那么会导致视频播放失败，总共会有3次重试机会，3次都失败的情况下会回调onOpenFailed方法。  
当视频已经起播后，在中途遇到网络等问题原因，进入buffer,
那么内核会一直重试，直到再次连接上服务端继续播放，或者用户通过接口停止播放该视频，在重试的过程中 onReconnectStart /
onReconnectEnd
会被回调，那么可以监控回调的次数来做业务层的结束播放的策略，当然在正常播放的情况下，这两个方法也是会被回调的，所以最好结合buffer的回调数据一起使用。

    
    
    private mMediaNetworkListener : QIPlayerMediaNetworkListener = {
    /***
     开始重连
     @param context 当前的播放器
     @param userType 重连url流的userType
     @param urlType 重连url流的urlType
     @param url 重连的url
     @param retryTime 已重试的次数
    */
        onReconnectStart:(context : QIPlayerContext , userType: string , urlType: QPlayerUrlType , url: string , retryTime: number ) => {
          
        },
    /***
     重连结束
     @param context 当前的播放器
     @param userType 重连url流的userType
     @param urlType 重连url流的urlType
     @param url 重连的url
     @param retryTime 已重试的次数
     @param error 错误码
    */
        onReconnectEnd:(context : QIPlayerContext , userType: string , urlType: QPlayerUrlType , url: string , retryTime: number , error: QPlayerOpenError ) => {
          
        },
    /***
     打开失败
     @param context 当前的播放器
     @param userType 重连url流的userType
     @param urlType 重连url流的urlType
     @param url 重连的url
     @param error 错误码
    */
        onOpenFailed:(context : QIPlayerContext , userType: string , urlType: QPlayerUrlType , url: string , error: QPlayerOpenError ) => {
          
        }
      }
    
    
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerMediaNetworkListener(this.mMediaNetworkListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerMediaNetworkListener(this.mMediaNetworkListener)
    //移除全部监听
    this.mPlayerContext.get_control_handler().removeAllPlayerMediaNetworkListener()
    

## 播放错误码枚举

    
    
    export enum QPlayerOpenError{
      UNKNOW = 10000,
      NONE = 0,
      IOERROR = -5,
      INTERRUPT = -1414092869,
      URL_INVALID = -875574520,
      FORMAT_INVALID = -1094995529
    }
    

## 暂停播放

    
    
    this.mPlayerContext.get_control_handler().pauseRender()
    

## 恢复播放

    
    
    this.mPlayerContext.get_control_handler().resumeRender()
    

## 停止当前视频播放

    
    
    this.mPlayerContext.get_control_handler().stop()
    

# 鉴权

鉴权功能介绍见 [鉴权相关文档 __](https://developer.qiniu.io/pili/12223/qplayer2-core-
authentication-related)

## 鉴权监听

    
    
    private mAuthenticationListener : QIPlayerAuthenticationListener = {
    /**
     @brief 鉴权失败回调
     @param context 当前播放器
     @param error 失败错误码
     */
        onAuthenticationFailed:(context: QIPlayerContext, error:QPlayerAuthenticationErrorType)=>{
          this.addToastView(`鉴权失败：${error.valueOf()}`)
        },
    
    /**
     @brief 鉴权成功回调
     @param context 当前播放器
     */
        onAuthenticationSuccess:(context: QIPlayerContext)=>{
          this.addToastView("鉴权成功")
        }
      }
    
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerAuthenticationListener(this.mAuthenticationListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerAuthenticationListener(this.mAuthenticationListener)
    //移除全部监听
    this.mPlayerContext.get_control_handler().removeAllPlayerAuthenticationListener()
    

## 鉴权错误码枚举

    
    
    /**
     鉴权不通过错误码
     */
    export enum QPlayerAuthenticationErrorType {
      NONE,             //鉴权出错
      NO_BASE_AUTH,     //缺少基础功能权限
      NO_VR_AUTH,       //缺少VR功能权限
      NO_BLIND_AUTH,    //缺少色盲功能权限
      NO_SEI_AUTH,      //缺少SEI功能权限
      NO_SRT_AUTH,      //缺少SRT功能权限
      NO_APM_AUTH       //缺少APM功能权限
    };
    

# 视频解码方式

目前支持的解码方式有:软解、硬解、自动，一般情况下，使用自动，内核会根据手机的硬件情况，要播放的视频资源编码格式等信息，挑选合适的解码方式进行解码，各个解码方式的优劣情况如下  
软解: 解码较慢，但是兼容性好，适用于所有手机  
硬解：解码性能高，但是有一定兼容性，比如某些视频资源的编码格式，硬解芯片不支持。并且相对于软解，首帧的速度慢。

## 设置优先选择哪种解码方式

设置完成后下一次播放生效.  
最终的解码方式可能不是设置的，在设置的解码方式不能正确解码时，内核会进行降级，选择其他能正确解码的方式

    
    
    this.mPlayerContext.get_control_handler().setDecoderType(QPlayerDecoderPriority.AUTO)
    

# 优先选择的解码方式枚举

该枚举主要用于设置解码方式

    
    
    typedef NS_ENUM(NSInteger, QPlayerDecoder) {
    export enum QPlayerDecoderPriority {
      AUTO = 0,  //自动
      HARDWARE_PRIORITY = 1,  //硬解优先
      SOFT_PRIORITY = 2,       //软解优先
    }
    };
    

## 播放器视频解码监听相关

    
    
    private mDecoderTypeListener : QIPlayerVideoDecodeListener = {
        
      /**
       当前视频用的是哪种解码方式
       @param context 当前的播放器
       @param type 解码方式
       */
      onVideoDecodeByType:(context : QIPlayerContext , type: QPlayerDecoderType) =>{
    }
    
      /**
       * 通知当前视频解码失败，
       * @param retry 底层是重试
       */
      onDecodeFailed:(context : QIPlayerContext , retry: boolean) => {
    }
    
      /**
       如果当前视频编码 所在设备或者sdk不支持 则回调该方法
       @param context 当前的播放器
       @param codecId 视频的编码id
       */
      onNotSupportCodecFormat:(context : QIPlayerContext , codec: number) => {
    }
    }
    
     //添加监听
    this.mPlayerContext.get_control_handler().addPlayerVideoDecodeTypeListener(this.mDecoderTypeListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayeVideoDecodeTypeListener(this.mDecoderTypeListener)
    //移除所有监听
    this.mPlayerContext.get_control_handler().removeAllPlayerVideoDecodeTypeListener()
    

## 解码方式枚举

该枚举主要用于监听返回的解码方式

    
    
    export enum QPlayerDecoderType{
      NONE = 0,          //无
      SOFTWARE = 1,          //软解
      HARDWARE = 30,          //硬解
    }
    

# 切换视频进度

参数为要定位的position 单位毫秒

    
    
    this.mPlayerContext.get_control_handler().seek(1000)
    

# 设置起播方式

下一次播放生效

    
    
    this.mPlayerContext.get_control_handler().setSeekMode(QPlayerSeek.NORMAL)
    

## seek方式枚举

    
    
    export enum QPlayerSeek {
      NORMAL = 0,   //关键帧
      ACCURATE = 1, //精准
    }
    

## seek 状态监听

一般情况下
seek都会成功，如果网络差的情况下，会无限loading（除非调用stop才会停止），直到seek到指定的位置为止。但是如果视频源本身是格式不正确的，比如pts错乱等问题，才会导致seek失败，所以在seek失败回调中，做好提示工作就好，不要尝试再次seek

    
    
    private mSeekListener : QIPlayerSeekListener = {
    /**
     seek成功回调
     @param context 当前的播放器
    */
        onSeekSuccess:(context : QIPlayerContext) => {
        },
    
    /**
     seek失败回调
     @param context 当前的播放器
    */
        onSeekFailed:(context : QIPlayerContext) => {
        }
      }
    
    
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerSeekListener(this.mSeekListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerSeekListener(this.mSeekListener)
    //移除全部监听
    this.mPlayerContext.get_control_handler().removeAllPlayerSeekListener()
    

## 获取当前播放状态

    
    
    this.mPlayerContext.get_control_handler().currentPlayerState
    

## 获取视频时长

    
    
    this.mPlayerContext.get_control_handler().duration
    

## 获取当前进度

    
    
    this.mPlayerContext.get_control_handler().currentPosition
    

## 获取当前下载速度

    
    
    this.mPlayerContext.get_control_handler().downloadSpeed
    

## 获取当前缓冲进度

    
    
    this.mPlayerContext.get_control_handler().bufferPostion
    

## 播放器状态

在整个播放器实例生命周期中，播放会在不同的状态中切换，用户可以通过监听播放器状态，实现上层业务逻辑，  
比如在视频播放完时，展示其他视频的推荐页，那么只需监听播放器状态回调，待回调的状态是COMPLETED，则展示推荐页

### 播放器状态枚举

    
    
    export enum QPlayerState {
      NONE = 0, //初始状态 0
      INIT = 1, //播放器开始创建各种对象 没有对应的state 创建完对象就上报这个状态 1
      PREPARE = 2, //开始拉视频数据解码变换等，重新换地址后，都走这个状态 2
      PLAYING = 4, //播放中 4
      PAUSED_RENDER = 6, //暂停渲染 6
      COMPLETED = 7, //播放完成 7
      SEEKING = 8, //SEEK 8
      STOPPED = 9, //停止当前播放的视频 9
      MISTAKE = 10, //播放出错 是否需要分 可恢复 和 不可恢复 10
      END = 11, //播放器释放各种对象完成 11
      MEDIA_ITEM_PREPARE = 12, //开始拉视频数据解码变换等，重新换地址后，都走这个状态 针对Media Item的play 方式 12
      RELEASE = 13 //播放器结束，且释放各类资源 13
    }
    

### 播放器状态变更监听相关

    
    
    private mStateChangeListener : QIPlayerStateChangeListener ={
    /**
     状态变更回调
     @param context 当前的播放器 
     @param state 播放器状态
     */
          onStateChange:(context : QIPlayerContext ,state: QPlayerState)=>{
          }
       }
    
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerStateListener(this.mStateChangeListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerStateListener(this.mStateChangeListener)
    //移除全部监听
    this.mPlayerContext.get_control_handler().removeAllPlayerStateListener()
    

# 播放速度

播放速度的调整范围建议在0.25-2.0之间，这样会有一个比较好的效果

## 设置播放速度

参数为倍速值

    
    
    this.mPlayerContext.get_control_handler().setSpeed(0.5)
    

## 获取当前播放速度

    
    
    this.mPlayerContext.get_control_handler().playerSpeed
    

## 速度变更监听相关

    
    
    private mPlaySpeed : QIPlayerSpeedListener = {
    /**
     倍速改变回调
     @param context 当前的播放器 
     @param speed 改变后的倍速
    */
        onSpeedChanged:(context : QIPlayerContext, speed:number)=>{
        }
    }
    
    
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerSpeedChangeListener(this.mPlaySpeed)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayeSpeedChangeListener(this.mPlaySpeed)
    //移除所有监听
    this.mPlayerContext.get_control_handler().removeAllPlayerSpeedChangeListener()
    

# 清晰度

QPlayer2提供的清晰度能力是无缝切换清晰度方案，在切换过程中，画面是连续的画面，不会出现类似跳帧的情况。  
使用无缝切换清晰度功能，必须在mediaModel中配置多路清晰度，如果使用非immediately方式(即异步方式)时，同时只能有一次切换会话存在，会话结束后，才能切下一次

## 切换视频清晰度

    
    
    //使用该方法时，mediaModel中需要存在多个StreamElement
    
    /**
      切换清晰度
      @param userType 切换清晰度的url流的userType
      @param urlType 切换清晰度的url流的 urlType
      @param quality 要切到哪路清晰度
      @param immediately true 立即切换 用于直播流，false 无缝切换，切换过程是一个异步过程，用于点播流
      @return true 调用成功， false 调用失败
    */
    this.mPlayerContext.get_control_handler().switchQuality("",QPlayerUrlType.QAUDIO_AND_VIDEO,1080,false)
    

## 获取当前的清晰度

    
    
    //使用该方法时，mediaModel中需要存在多个StreamElement，返回清晰度数值标记
    
    /**
     获取指定 userType urlType 的清晰度
      @param userType 切换清晰度的url流的userType
      @param urlType 切换清晰度的url流的 urlType
      @return true 调用成功， false 调用失败
    */
    this.mPlayerContext.get_control_handler().getCurrentQuality("",QPlayerUrlType.QAUDIO_AND_VIDEO)
    

## 获取当前正在切换的清晰度

    
    
    /**
     获取指定 userType urlType 流正在切换的清晰度（非immediately方式）
      @param userType 切换清晰度的url流的userType
      @param urlType 切换清晰度的url流的 urlType
      @return true 调用成功， false 调用失败
    */
    this.mPlayerContext.get_control_handler().getSwitchingQuality("",QPlayerUrlType.QAUDIO_AND_VIDEO)
    

## 播放器清晰度相关监听

    
    
    private mQualityListener: QIPlayerQualityListener = {
    /**
       开始清晰度切换
       @param context 当前的播放器
       @param usertype 开始切换清晰度的url流的userType
       @param urlType 开始切换清晰度的url流的
       @param oldQuality 切换前的清晰度
       @param newQuality 要切到哪路清晰度
       */
      onQualitySwitchStart:(context : QIPlayerContext , usertype: string , urlType: QPlayerUrlType , oldQuality: number , newQuality: number ) =>{
    }
    
      /**
       清晰度切换完成
       @param context 当前的播放器
       @param usertype 开始切换清晰度的url流的userType
       @param urlType 开始切换清晰度的url流的
       @param oldQuality 切换前的清晰度
       @param newQuality 要切到哪路清晰度
       */
      onQualitySwitchComplete:(context : QIPlayerContext , usertype: string , urlType: QPlayerUrlType , oldQuality: number , newQuality: number ) =>{
    }
    
      /**
       清晰度切换取消
       @param context 当前的播放器
       @param usertype 开始切换清晰度的url流的userType
       @param urlType 开始切换清晰度的url流的
       @param oldQuality 切换前的清晰度
       @param newQuality 要切到哪路清晰度
       */
      onQualitySwitchCanceled:(context : QIPlayerContext , usertype: string , urlType: QPlayerUrlType , oldQuality: number , newQuality: number ) =>{
    }
    
      /**
       清晰度切换失败
       @param context 当前的播放器
       @param usertype 开始切换清晰度的url流的userType
       @param urlType 开始切换清晰度的url流的
       @param oldQuality 切换前的清晰度
       @param newQuality 要切到哪路清晰度
       */
      onQualitySwitchFailed:(context : QIPlayerContext , usertype: string , urlType: QPlayerUrlType , oldQuality: number , newQuality: number ) =>{
    }
    
      /**
       目前仅支持同时有一个清晰度切换，如果前一个还未切换完，再次发起切换 会回调这个函数
       @param context 当前的播放器
       @param usertype 开始切换清晰度的url流的userType
       @param urlType 开始切换清晰度的url流的
       */
      onQualitySwitchRetryLater:(context : QIPlayerContext ,  usertype: string , urlType: QPlayerUrlType ) =>{
    }
    
    
      }
    
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerQualityListener(this.mQualityListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerQualityListener(this.mQualityListener)
    //移除所有监听
    this.mPlayerContext.get_control_handler().removeAllPlayerQualityListener()
    

## 直播支持多路清晰度切换

无缝切换清晰度方案需要配置以下三个条件

  1. 首先切换的模式要选择立即切换即：immediately=true
  2. 服务端配置PTS透传，
  3. 对应的清晰度要做主动转码设置

如果无法满足以上3个条件，那么建议用最基础的能力来实现清晰度切换，即每个清晰度都是一个media
model，切换时，调用playMediaModel来播放新的清晰度流。

# 视频宽高改变监听

在视频首帧渲染时，会调用该回调，告诉上层当前的视频宽高是多少，如果在这个这个视频播放的生命周期中，宽高改变，那么还会再次调用该回调.

    
    
    private mVideoFrameSizeChangedListener : QIPlayerVideoFrameSizeChangeListener ={
    
        /**
       推流端视频长宽变化回调
       @param context 当前的播放器
       @param width 视频宽度
       @param height 视频高度
       */
      onVideoFrameSizeChanged:(context : QIPlayerContext, width: number, height:number ) =>{
    }
    
    }
    
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerVideoFrameSizeChangeListener(this.mVideoFrameSizeChangedListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerVideoFrameSizeChangeListener(this.mVideoFrameSizeChangedListener)
    //移除所有监听
    this.mPlayerContext.get_control_handler().removeAllPlayerVideoFrameSizeChangeListener()
    

# 播放进度监听

只有在点播的时候 duration 和 progress 才有意义，直播的话这两个值没有参考意义

    
    
    private mProgressListener : QIPlayerProgressListener = {
    /***
     进度变更回调
     @param context 当前的播放器
     @param progress 当前进度 单位毫秒
     @param duration 当前视频总时长 单位毫秒
    */
        onProgressChanged:(context:QIPlayerContext,  progress:number, duration:number) => {
        }
      }
    
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerProgressChangeListener(this.mProgressListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerProgressChangeListener(this.mProgressListener)
    //移除全部监听
    this.mPlayerContext.get_control_handler().removeAllPlayerProgressChangeListener()
    

# 实时帧率

## 获取当前fps

    
    
    this.mPlayerContext.get_control_handler().fps
    

## 实时帧率监听

    
    
    private mFPSListener : QIPlayerFPSListener = {
    /**
     @brief fps 改变的回调
     @param context 当前的播放器
     @param fps 帧率
     */
          onFPSChanged:(context:QIPlayerContext, FPS:number)=>{
          }
       }
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerFPSChangeListener(this.mFPSListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerFPSChangeListener(this.mFPSListener)
    //移除全部监听
    this.mPlayerContext.get_control_handler().removeAllPlayerFPSChangeListener()
    

# 像素格式或者音频sample格式不支持的监听

    
    
    private mFormatListener : QIPlayerFormatListener = {
    /**
     @brief 当前有format 不支持，所以视频没法播放
     @param context 当前的播放器
     */
        onFormatNotSupport:(context:QIPlayerContext)=>{
        }
      }
    
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerFormatListener(this.mFormatListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerFormatListener(this.mFormatListener)
    //移除全部监听
    this.mPlayerContext.get_control_handler().removeAllPlayerFormatListener()
    

# 缓冲拉流监听

    
    
    private mDownloadListener : QIPlayerDownloadListener = {
    /**
     @brief 拉流速率改变
     @param context 当前的播放器
     @param downloadSpeed 速度 单位: b/s (比特每秒)
     @param bufferPos 缓冲的进度
     */
          onDownloadChanged:(context:QIPlayerContext, speed:number, bufferPos:number)=>{
          }
       }
    
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerDownloadChangeListener(this.mDownloadListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerDownloadChangeListener(this.mDownloadListener)
    //移除全部监听
    this.mPlayerContext.get_control_handler().removeAllPlayerDownloadChangeListener()
    

## 播放器操作不允许执行监听

在某些状态下，一些操作将不被执行，通过该监听回调上来通知

    
    
    private mCommandNotAllowListener : QIPlayerCommandNotAllowListener = {
    /**
     @brief 操作不被允许回调
     @param context 操作异常的播放器
     @param commandName 操作名称
     @param state 操作被检测时播放器的状态
     */
        onCommandNotAllow:(context:QIPlayerContext, commandName:string, state:QPlayerState)=>{}
      }
    
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerCommandNotAllowListener(this.mCommandNotAllowListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerCommandNotAllowListener(this.mCommandNotAllowListener)
    //移除全部监听
    this.mPlayerContext.get_control_handler().removeAllPlayerCommandNotAllowListener()
    

## buffering 监听

    
    
    private mBufferingListener : QIPlayerBufferingListener = {
    
    /**
     @brief 开始buffering
     @param context 当前播放器  
     */
        onBufferingStart:(context:QIPlayerContext)=>{
        },
    
    /**
     @brief 结束buffering
     @param context 当前播放器
     */
        onBufferingEnd:(context: QIPlayerContext)=>{}
      }
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerBufferingChangeListener(this.mBufferingListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerBufferingChangeListener(this.mBufferingListener)
    //移除全部监听
    this.mPlayerContext.get_control_handler().removeAllPlayerBufferingChangeListener()
    

# 截图

调用截图接口，就会回调截图时的video画面，并以jpeg的格式返回

    
    
    /**
     截图
     */
    this.mPlayerContext.get_control_handler().shootVideo()
    

## 截图图片类型枚举

    
    
    /**
     截图图片类型
     */
    export enum  QPlayerShootVideoType {
      NONE = 0,
      JPEG            //jpeg格式
    };
    

## 截图相关监听

    
    
    private mShootVideoListener : QIPlayerShootVideoListener = {
    /**
       截图成功回调
       @param context 当前的播放器
       @param imageData 图片的 NSData 数据
       @param width 图片的宽
       @param height 图片的高
       @param type 图片类型
       */
      onShootSuccessful:(context : QIPlayerContext, imageData:Uint8Array, width:number, height:number, type: QPlayerShootVideoType) =>{
    }
    
      /**
       截图失败回调
       @param context 当前的播放器
       */
      onShootFailed:(context : QIPlayerContext) =>{
    }
    }
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerShootVideoListener(this.mShootVideoListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerShootVideoListener(this.mShootVideoListener)
    //移除所有监听
    this.mPlayerContext.get_control_handler().removeAllPlayerShootVideoListener()
    

# 码率

## 获取当前码率

    
    
    this.mPlayerContext.get_control_handler().biteRate
    

## 实时码率监听

    
    
    private mBiteRateListener : QIPlayerBiteRateListener = {
    /**
     @brief 码率变换回调
     @param context 当前播放器 
     @param bitrate 比特率， 单位：bps
     */
        onBiteRateChanged:(context:QIPlayerContext, bitrate:number)=>{}
      }
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerBiteRateChangeListener(this.mBiteRateListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerBiteRateChangeListener(this.mBiteRateListener)
    //移除全部监听
    this.mPlayerContext.get_control_handler().removeAllPlayerBiteRateChangeListener()
    

# SEI 数据回调

用户自定义数据可以带在H264或者H265的编码帧里，用于实现一些基于时间轴的业务场景。  
开启该功能后，如果视频资源内带有SEI数据 会通过监听接口抛给业务层。  
该功能需要单独开通，具体可以联系技术支持咨询。

## 开启 SEI

    
    
    this.mPlayerContext.get_control_handler().setSEIEnable(true)
    

## SEI 数据监听

    
    
    private mSEIListener: QIPlayerSEIDataListener = {
    
      /**
       SEI 数据回调，且回调时机为SEI数据所在帧的时间
       @param context 当前的播放器
       @param data SEI 数据
       */
      onSEIData:(context:QIPlayerContext, data:Uint8Array)=>{
    }
    }
    
    //添加监听
    this.mPlayerContext.get_control_handler().addPlayerSEIDataListener(this.mSEIListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerSEIDataListener(this.mSEIListener)
    //移除所有监听
    this.mPlayerContext.get_control_handler().removeAllPlayerSEIDataListener()
    

# 渲染相关监听

    
    
    private mRenderListener : QIPlayerRenderListener = {
    /**
     首帧耗时回调
     @param context 当前的播放器
     @param elapsedTime 从play 开始到首帧渲染出来的总耗时 单位毫秒
    */
          onFirstFrameRendered:(context : QIPlayerContext, elapsedTime:number) => {
          }
       }
    
    //添加监听
    this.mPlayerContext.get_render_handler().addPlayerRenderListener(this.mRenderListener)
    //移除监听
    this.mPlayerContext.get_control_handler().removePlayerRenderListener(this.mRenderListener)
    //移除全部监听
    this.mPlayerContext.get_control_handler().removeAllPlayerRenderListener()
    

# 设置视频渲染比例

    
    
    this.mPlayerContext.get_render_handler().setRenderRatio(QRenderRatio.AUTO)
    

## 视频比例枚举

    
    
    export enum QRenderRatio {
      AUTO = 1,
      FULL_SCREEN,      //铺满
      STRETCH,          //拉伸
      Ratio_16_9,       //16:9
      Ratio_4_3,        //4:3
    }
    

# 设置色觉优化

    
    
    this.mPlayerContext.get_render_handler().setBlindType(QBlindType.NONE)
    

## 色觉优化枚举

    
    
    export enum QBlindType {
      NONE = 0, //无
      RED = 1, //红色盲
      GREEN = 2, //绿色盲
      BLUE = 3, //蓝色盲
    }
    

# 后台播放

后台播放除了 QPlayer2 设置以外，还需要申请鸿蒙的长时任务和音频后台播放。同时还在 module.json 中需要申请后台播放权限

## 设置是否支持后台播放

    
    
    /**
     *设置是否后台播放
     * @param enable yes后台播放，no后台播放暂停
     */
    this.mPlayerContext.get_control_handler().setBackgroundPlayEnable(true)
    

### 鸿蒙长时任务和音频后台播放

    
    
    async createSession() {
        let type: AVSessionManager.AVSessionType = 'audio';
        let session = await AVSessionManager.createAVSession(this.context,'SESSION_NAME', type);
    
        // 激活接口要在元数据、控制命令注册完成之后再执行
        await session.activate();
        console.info(`session create done : sessionId : ${session.sessionId}`);
      }
      onBackground() {
        // Ability has back to background
        hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onBackground');
        this.createSession()
        let wantAgentInfo : wantAgent.WantAgentInfo = {
          wants: [
            {
              bundleName: "com.qiniu.qplayer2demo",
              abilityName: "EntryAbility"
            }
          ],
          // 点击通知后，动作类型
          operationType: wantAgent.OperationType.START_ABILITY,
          requestCode: 0,
          // 点击通知后，动作执行属性
          wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
        };
    
        wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj : WantAgent) => {
          hilog.info(0x0000, 'testTag', '%{public}s', 'getWantAgent');
          backgroundTaskManager.startBackgroundRunning(this.context,
            backgroundTaskManager.BackgroundMode.AUDIO_PLAYBACK, wantAgentObj).then(() => {
            console.info("Operation startBackgroundRunning succeeded");
          }).catch((err: BusinessError) => {
            console.error("Operation startBackgroundRunning failed Cause: " + err);
          });
        });
      }
    

## 后台播放权限申请

    
    
     {
        "name": "ohos.permission.KEEP_BACKGROUND_RUNNING"
     }
    

以上内容是否对您有帮助？