Windows 声音播放:Flutter 与 Win32 的衔接

围绕 windows_soundplay 项目,说明资源路径、PlaySound 调用与播放状态的处理。

适用版本

原文使用 win32 2.0.5,发布于 2021 年;PlaySound 属于历史音频 API。

本文目录
  1. 声音文件位于哪里
  2. PlaySound 的参数含义
  3. 对外封装的边界
  4. 参考与源码

windows_soundplay 是原作者在 2021 年记录的 Flutter Windows 声音播放尝试,使用 win32: ^2.0.5 调用 PlaySound。本文保留它的资源定位和原生调用思路,不把旧版包接口作为新项目的兼容承诺。

声音文件位于哪里

旧项目把声音文件作为 Flutter assets 打包,并按以下相对路径寻找:

text
data\flutter_assets\assets\

这个路径来自当时工程的打包结构。资源路径还取决于 pubspec 中的声明与最终产物,文件名应包含扩展名。

原文使用当前工作目录拼接路径。应用从快捷方式、终端或其他进程启动时,当前工作目录不一定是可执行文件目录;定位可执行文件本身可以使用:

dart
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 的参数含义

原包的调用核心是:

dart
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 的能力与项目需求选型。

参考与源码

作者:NeverOuO。原载 NeverOuO 个人小站,现收录于云屿来文章与教程。

返回全部文章

把好用的工具分享给朋友

分享

发送链接,让朋友直接打开这个页面。

访问统计

我们统计页面浏览、渠道来源、产品入口点击与分享次数,用于了解产品如何被发现。这项统计不使用用户标识、Cookie 或跨站追踪,也不读取上传文件或表单内容。