@flow-player/software-decoder-ffmpeg

@flow-player/browser-runtime 的 FFmpeg（ffdecoder，FFmpeg→WASM 自研构建）软解后端。HEVC/H.265 在 WebCodecs 不可用时的降级解码方案。

包内包含预构建的软解 adapter（glue 内联）、software-decode-worker 与 ffdecoder-simd.wasm 独立资产——wasm 由入口的 new URL 字面量交给 consumer bundler 产出/重写，运行时经 softwareDecoderWasmUrl fetch（instantiateStreaming，边下载边编译）。consumer 不需要任何构建脚本或自托管文件。

接入

import { FlowPlayerRuntime } from "@flow-player/browser-runtime";
import { ffmpegSoftwareDecoderOptions } from "@flow-player/software-decoder-ffmpeg";

const player = new FlowPlayerRuntime({
  decodeMode: "software",
  ...ffmpegSoftwareDecoderOptions(),
});

导出的 softwareDecoderUrl / softwareDecoderWorkerUrl / softwareDecoderWasmUrl 也可以单独展开进既有配置。

注意

• 本包只提供 HEVC（h265）软解；H.264 请走 WebCodecs 硬解路径。
• 解码在独立 worker 线程执行（software-decode-worker），不阻塞渲染循环。
• 与 @flow-player/browser-runtime 版本对齐发布（protocol 耦合）。

License

本包代码 MIT。运行时产物内含 ffdecoder（基于 FFmpeg 9.0.1 的 WASM 构建，部门自研），FFmpeg 遵循 LGPL v2.1+——分发含本包的产物时请自行确认 LGPL 合规义务（提供对应源代码/重新链接机制）。