简介
音视频是指音频和视频的组合,包括声音和动态图像的数字化表达,如果需要以这种方式展示,可以使用该组件。
配置项
分类 | 配置 | 示例 | 说明 |
内容 | URL | 视频文件的 URL | |
封面 | 视频在加载或播放前显示的图像 | ||
交互 | 隐藏 | 隐藏,详情参见通用属性 | |
自动播放 | 加载完成后是否自动播放(因为浏览器限制,自动播放的视频将默认静音) | ||
循环播放 | 是否循环播放 | ||
音量设置 | 音视频音量设置 | ||
样式 | 外边距 | 外边距,详情参见通用属性 | |
高度 | 高度,详情参加通用属性 | ||
内容适配 | 高度为非自动模式可配置,属性 cover(覆盖)、contain(包含)、fill(拉伸) | ||
控制面板 | 音视频的控制面板 | ||
CSS样式 | 模糊效果 | 模糊效果,单位为 px,数字越大越模糊,默认为 0px | |
灰度 | 取值范围 0-1 ,默认为 0 | ||
亮度 | 通常取值范围为 0 到 100,默认为 1 | ||
对比度 | 通常取值范围为 0 到 100,默认为 1 | ||
饱和度 | 通常取值范围为 0 到 100,默认为 1 |
属性与方法
名称 | 类型 | 示例 | 说明 |
src | string |
| 视频文件的 URL |
poster | string |
| 视频在加载或播放前显示的图像 |
objectFit | string |
| 音视频内容适配模式 |
muted | boolean |
| 音视频静音状态 |
play | func |
| 播放音视频 |
pause | func |
| 暂停音视频 |
getProgress | func |
| 获取音视频进度数据,该 API 返回了一个对象, 类型为 { currentTime: number; duration: number; } |
setSrc | func |
| 设置视频文件的 URL |
setPoster | func |
| 设置视频在加载或播放前显示的图像 |
setObjectFit | func |
| 设置音视频内容适配模式 |
setMuted | func |
| 设置音视频静音状态,如果取消静音(false),当音量为 0 时,会自动把音量设置为 0.2 |
clearSrc | func |
| 清除音视频的源地址数据 |
clearPoster | func |
| 清除音视频的封面数据 |
clearObjectFit | func |
| 清除音视频的内容适配模式数据 |
clearMuted | func |
| 清除音视频的静音状态数据 |
事件回调
配置 | 说明 |
音视频开始播放后触发的事件 | |
音视频暂停播放后触发的事件 | |
音视频结束播放后触发的事件 | |
音视频播放错误后触发的事件 | |
音视频播放进度的回调事件 |
场景示例
播放视频时展示播放进度场景
如图所示,配置事件处理器,监听播放进度事件,通过获取进度 API 得到播放进度的数据,处理后通过 setText 赋值给文本组件。
在此配置下,视频播放过程中可显示播放进度