#audio
音频播放组件,提供不占用页面布局的音频播放与实例控制能力。
#扫码预览
#Props
| 属性名 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| attached | boolean | - | 否 | 是否按需加载播放器实例,用于性能优化,常用于列表场景,其他情况无需设置 |
| autoPlay | boolean | false | 否 | 流数据变化后自动播放。 |
| autoPrepare | boolean | true | 否 | 在资源准备完成后自动预渲染播放器(显示首帧) |
| initTime | number | false | 否 | 在资源准备完成后自动预渲染播放器(显示首帧) |
| loop | boolean | false | 否 | 循环播放。视频开始播放后,循环状态变化不会改变视频的当前播放/暂停状态。 |
| mute | boolean | false | 否 | 是否静音实时播放器。 |
| onEnded | () => void | undefined @eventProperty | 否 | 播放器播放结束。 |
| onError | (e: { errorCode: number; errorMsg: string }) => void | undefined @eventProperty | 否 | 播放器接收到错误信息。 |
| onPause | () => void | undefined @eventProperty | 否 | 播放器暂停。 |
| onPlay | () => void | undefined @eventProperty | 否 | 播放器开始播放。 |
| onPrepared | () => void | undefined @eventProperty | 否 | 播放器准备好播放。 |
| onRedirected | () => void | undefined @eventProperty | 否 | 如果访问 gecko 资源,加载是异步的 |
| onSeek | (willPlay: boolean) => void | undefined @eventProperty | 否 | 播放器搜索。 |
| onSrcChanged | () => void | undefined @eventProperty | 否 | 源文件发生变化 |
| onStop | () => void | undefined @eventProperty | 否 | 播放器停止。 |
| onTimeUpdate | (e: { detail: { current: number; total: number } }) => void | undefined @eventProperty | 否 | 播放器进度更新 |
| pauseOnHide | boolean | false | 否 | 指定当 LynxView 退出背景或移出屏幕后是否暂停视频,以防止声音泄漏 |
| playbackSpeed | number | 1.0 | 否 | 指定播放速度 |
| playUrl | string | undefined | 否 | 指定视频播放源,一旦设置 play-url,播放器将尝试异步加载资源。在绑定重定向之前,所有播放控制逻辑将无效。 |
| ref | ForwardedRef<VideoEngineRef> | - | 否 | - |
| videoEngineId | string | 'videoengine' | 否 | 用于选择 x-video-engine。请确保在整个页面中唯一。 |
| volume | number | 1.0 | 否 | 指定音量,范围:[0.0, 1.0] |