跳转至

播放器组件MgtvComponent

自研播放器控件MgtvComponent

MgtvComponent是集成了播放器MgtvAvPlayer 和 渲染UI(Xcomponent)的多功能控件,上层开发者可通过配置MgtvComponent属性,实现不同业务场景。例如,播放音频不需要渲染页面时,设置isAudio为true,开启自动播放时设置isAutoPlay为true等。

属性名称 属性类型 含义 未设置取的默认值
videoUrl string
fileDescriptor RawFileDescriptor 本地播放文件fd
isLoop boolean 是否开启循环播放 false
isMute boolean 是否静音 false
isAudio boolean 是否是音频媒资 false
currentVideoScaleType VideoScaleType 画幅比例 VideoScaleType.VIDEO_SCALE_TYPE_FIT
businessType BusinessType 播放业务类型 BusinessType.BUSINESS_TYPE_SIMPLE
videoPlayerController MgVideoPlayerController 播放控制器
callback?: (event: string, mg: MgVideoPlayer) => void event 播放事件回调监听器

VideoScaleType
枚举,播放画幅比例。

名称 含义 枚举值 说明
VIDEO_SCALE_TYPE_FIT 适配父容器宽高比,无裁剪、可能产生拉伸 0
VIDEO_SCALE_TYPE_FIT_CROP 适配父容器宽高比,肯呢个产生裁剪,无拉伸 1
VIDEO_SCALE_TYPE_FILL 不适配父容器,无裁剪、无拉伸 2

BusinessType
枚举,播放业务类型。

名称 含义 枚举值 说明
BUSINESS_TYPE_SIMPLE 简单播放器
BUSINESS_TYPE_VOD 点播 当前点播业务默认启用自研播放内核
BUSINESS_TYPE_AD 广告 当前广告业务默认启用系统播放内核
BUSINESS_TYPE_LIVE 点播 /

PlayEvent
枚举,播放事件。

名称 含义 枚举值 说明
START_RENDER_FRAME 第一帧事件 'startRenderFrame'
VIDEOSIZE_CHANGE 视频宽高变动事件 'videoSizeChange'
STATE_IDLE 播放器状态idel事件 'state_idle'
STATE_INIT 播放器状态init事件 'state_initialized'
STATE_PREPARED 播放器状态prepared事件 'state_prepared'
STATE_PLAYING 播放器状态playing事件 'state_playing'
STATE_PUASED 播放器状态paused事件 'state_paused'
STATE_COMPLETED 播放器状态complate事件 'state_completed'
STATE_ERROR 播放器状态error事件 'state_error'
TIME_UPDATE 播放进度update事件 'timeUpdate'
AUDIO_INTERRUPT 音频焦点变化事件 'audioInterrupt'
SEEK_DONE seek完成事件 'seekDone'
VOLUMN_CHANGE 系统音量变化事件 'volumeChange'
SPEED_DONE 倍速播放完成事件 'speedDone'
BITRATE_DONE 码率切换完成事件 'bitrateDone'
BUFFER_START buffer开始事件 'bufferingStart'
BUFFER_END buffer完成事件 'bufferingEnd'
BUFFER_PERCENT buffer进度百分比更新事件 'bufferingPercent'
CACHED_DURATION buffer cache时长更新事件 'bufferingCache'

RenderComponentType
枚举,XComponent渲染类型。

名称 含义 枚举值 说明
SURFACE XComponent渲染类型为'surface' 'surface'
COMPONENT XComponent渲染类型为'component' 'component'