音视频

简介

音视频是指音频和视频的组合,包括声音和动态图像的数字化表达,如果需要以这种方式展示,可以使用该组件。

image

配置项

分类

配置

示例

说明

内容

URL

image

视频文件的 URL

封面

image

视频在加载或播放前显示的图像

交互

隐藏

image

隐藏,详情参见通用属性

自动播放

image

加载完成后是否自动播放(因为浏览器限制,自动播放的视频将默认静音)

循环播放

image

是否循环播放

音量设置

image

音视频音量设置

样式

外边距

image

外边距,详情参见通用属性

高度

image

高度,详情参加通用属性

内容适配

image

高度为非自动模式可配置,属性 cover(覆盖)、contain(包含)、fill(拉伸)

控制面板

image

音视频的控制面板

CSS样式

模糊效果

image

模糊效果,单位为 px,数字越大越模糊,默认为 0px

灰度

image

取值范围 0-1 ,默认为 0

亮度

image

通常取值范围为 0 到 100,默认为 1

对比度

image

通常取值范围为 0 到 100,默认为 1

饱和度

image

通常取值范围为 0 到 100,默认为 1

属性与方法

名称

类型

示例

说明

src

string

video.src

视频文件的 URL

poster

string

video.poster

视频在加载或播放前显示的图像

objectFit

string

video.objectFit

音视频内容适配模式

muted

boolean

video.muted

音视频静音状态

play

func

video.paly()

播放音视频

pause

func

video.pause()

暂停音视频

getProgress

func

video.getProgress()

获取音视频进度数据,该 API 返回了一个对象, 类型为 { currentTime: number; duration: number; }

setSrc

func

video.setSrc('')

设置视频文件的 URL

setPoster

func

video.setPoster('')

设置视频在加载或播放前显示的图像

setObjectFit

func

video.setObjectFit('cover')

设置音视频内容适配模式

setMuted

func

video.setMuted(false)

设置音视频静音状态,如果取消静音(false),当音量为 0 时,会自动把音量设置为 0.2

clearSrc

func

video.clearSrc()

清除音视频的源地址数据

clearPoster

func

video.clearPoster()

清除音视频的封面数据

clearObjectFit

func

video.clearObjectFit()

清除音视频的内容适配模式数据

clearMuted

func

video.clearMuted()

清除音视频的静音状态数据

事件回调

配置

说明

image

音视频开始播放后触发的事件

image

音视频暂停播放后触发的事件

image

音视频结束播放后触发的事件

image

音视频播放错误后触发的事件

image

音视频播放进度的回调事件

场景示例

  • 播放视频时展示播放进度场景

    • 如图所示,配置事件处理器,监听播放进度事件,通过获取进度 API 得到播放进度的数据,处理后通过 setText 赋值给文本组件。

    • 在此配置下,视频播放过程中可显示播放进度

      image