FORGE KUI / docs

音频、视频与 Lottie

audio/video 由 KUI 媒体适配层连接后端,kui_media_audio 与 kui_media_video 使用媒体协议,不注册新的 DOM 元素。

版本 3.61.7

接入方式

audio/video 由 KUI 媒体适配层连接后端,kui_media_audio 与 kui_media_video 使用媒体协议,不注册新的 DOM 元素。部署时核对解码后端、DLL 依赖、格式和平台范围,文件可解析不代表设备可以正常播放。

约束和排错

Lottie 渲染方向使用 Skia 的 Skottie 模块。媒体示例应检查加载、首播、暂停、结束、错误与资源释放,不只检查初始画面。静音无设备测试和实际音视频设备验收是不同证据。

音频与视频元素

audio 和 video 使用内置媒体元素;播放能力取决于已部署的后端、资源路径和解码依赖。controls 仅声明控件需求,自动播放、拖动进度和异常文件仍应在目标包上检查。

html
<audio src="media/notification.wav" controls></audio>
<video src="media/clip.mp4" controls
  style="width:100%;height:360px"></video>

后端与依赖

kui_media_audio 提供音频后端,kui_media_video 提供 FFmpeg 视频解码及音频放音。应用分发时要核对媒体 DLL、解码依赖及其许可。路径可访问和容器可识别并不保证所有编码都能播放。

从播放到交付

按下面的顺序验证一个最小场景,再接入完整应用。

  1. 用已知可播放的本地素材验证后端,再接网络地址。
  2. 确认编码、解码后端和音视频依赖,不以文件扩展名判断可播放。
  3. 检查开始、暂停、结束、加载失败和资源释放。
  4. 把素材授权与依赖许可纳入应用交付清单;Lottie 和视频是不同路径。

文档有误或遗漏?

反馈此页问题 →