播放器组件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' |