For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt, and this page is available as Markdown at /apps-plugin/docs/components/media/audio.md.

audio

音频播放组件,提供不占用页面布局的音频播放与实例控制能力。

扫码预览

扫码预览 audio

Props

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