跳转到主要内容

媒体与二进制

二进制数据(图片、音频、视频)可以来自在线 Data、本地 Data、Resources 的 base64,或 FilePicker 选中的路径。

Media

AutoPlay 可能被浏览器策略阻止;需要用户交互后才能播放。

Image

二进制资源

Resources 的 Binary 是 base64 字面量:
绑定得到 { Url, Base64, Mime, Size }。Url 是运行时生成的 Blob URL,组件卸载时释放。

FilePicker

让用户选择本地文件,把路径写入 {Inputs.<Name>}:
  • Filter 是逗号分隔扩展名。
  • 选择结果不是二进制内容,只是路径;需要播放时用 Data Source="File" 读取,或由脚本处理。
  • 浏览器调试环境没有原生文件路径,可能需要 Tauri 桌面环境。

本地路径规则

  • 绝对路径原样;
  • 相对路径基于组件文件目录(本地导入)或启动器数据目录(URL 导入);
  • 二进制文件上限 8MB;
  • 编辑器信息面板显示解析后的绝对路径。

示例:本地音乐卡片

当前 Data 的 Path 是静态字符串,不能直接绑定 {Inputs.TrackPath};Media.Volume 也只在加载时读取,不支持双向绑定。需要“选文件后立即播放/调音量”时,请等待后续版本,或通过插件 API/命令动作实现。

限制

  • 静态图片/媒体域名也需要在编辑器中确认。
  • 在线二进制 8MB、本地二进制 8MB;超过会报错。
  • Blob URL 只在当前组件实例有效,不要写进持久化数据。