原文使用 win32 2.0.5,发布于 2021 年;PlaySound 属于历史音频 API。
windows_soundplay 是原作者在 2021 年记录的 Flutter Windows 声音播放尝试,使用 win32: ^2.0.5 调用 PlaySound。本文保留它的资源定位和原生调用思路,不把旧版包接口作为新项目的兼容承诺。
声音文件位于哪里
旧项目把声音文件作为 Flutter assets 打包,并按以下相对路径寻找:
data\flutter_assets\assets\
这个路径来自当时工程的打包结构。资源路径还取决于 pubspec 中的声明与最终产物,文件名应包含扩展名。
原文使用当前工作目录拼接路径。应用从快捷方式、终端或其他进程启动时,当前工作目录不一定是可执行文件目录;定位可执行文件本身可以使用:
import 'dart:io';
import 'package:path/path.dart' as p;
final executableDirectory = File(Platform.resolvedExecutable).parent.path;
final audioPath = p.join(
executableDirectory,
'data',
'flutter_assets',
'assets',
'notice.wav',
);
这段路径示例只适用于资源确实放在上述位置的 Windows 打包程序。开发态运行和发布态资源位置应分别处理。
PlaySound 的参数含义
原包的调用核心是:
final result = PlaySound(
TEXT(audioPath),
NULL,
SND_FILENAME | SND_ASYNC,
);
这是 win32 2.0.5 背景下的接口片段。SND_FILENAME 把第一个参数解释为文件路径;SND_ASYNC 让播放异步返回。返回成功表示 API 接受了播放请求,不等于声音已经完整播放结束。
FFI 绑定中的字符串转换会涉及原生内存,完整封装需要按所用版本的分配方式管理生命周期。异步播放时还要遵循 API 对传入缓冲区的生命周期要求,不能仅把核心调用复制进循环。
对外封装的边界
插件接口可以接受受限的资源文件名,在 Windows 实现内解析出绝对路径;读取前处理文件不存在或路径越界的情况。跨平台应用应在平台实现层分流,避免在其他系统调用 Windows API。
微软将 PlaySound 所属的 Waveform Audio 标为历史接口,新音频功能应结合 WASAPI 或 Audio Graphs 的能力与项目需求选型。


