Go malgo 怎样枚举可用的音频播放设备

用 Go malgo 枚举可用的音频播放设备，关键是先创建音频上下文，再调用 ctx.Devices(malgo.Playback)。这个方法返回的是当前后端发现的播放设备基础信息，遍历结果即可读取设备名称、ID、默认标记和格式数量；如果返回空列表，应把它当作“当前没有可用播放设备”处理，而不是假设有一台默认设备。

官方文档：https://pkg.go.dev/github.com/gen2brain/malgo

枚举设备只需要拿到上下文和设备信息，不必先创建播放流。真正初始化播放设备时还要单独构造 DeviceConfig，并且不能把返回列表的第一项当成默认设备。

• 初始化：malgo.InitContext 成功后才可以调用 Devices。
• 筛选：用 malgo.Playback 请求播放设备，不要把录音设备混入列表。
• 字段：DeviceInfo.Name() 适合展示，ID.String() 适合保存或选择。
• 释放：上下文拥有原生资源，枚举结束后要调用 Free()。

先理解 malgo 的枚举边界

malgo 是 miniaudio 的 Go 绑定，官方包文档说明它需要 cgo，并通过平台后端访问音频设备。Windows、Linux、macOS 等平台可用的后端不同，因此“可用设备”是当前系统音频后端返回的结果，不应该在代码中写死设备名称。

Context.Devices(kind) 的参数是 DeviceType。当前文档列出的类型常量包括 Playback、Capture、Duplex 和 Loopback；本题只传入 malgo.Playback。返回值是 []malgo.DeviceInfo 与 error，它还没有启动任何播放流。

准备一个最小 Go 项目

malgo 官方安装方式是把包加入 Go 模块。由于它依赖 cgo，构建机还需要具备对应平台的 C 编译环境和音频后端；这属于运行环境前置条件，不是枚举函数本身的参数。

# 创建一个只负责枚举音频设备的示例模块
go mod init example.com/malgo-device-list

# 加入 malgo 依赖；版本由当前模块解析结果决定
go get github.com/gen2brain/malgo

如果构建时出现 cgo 或系统音频头文件相关错误，先按目标操作系统补齐编译工具链。不要在代码里伪造一组设备名称，因为不同机器的设备列表本来就可能不同。

用 malgo.Playback 获取播放设备

下面的函数把初始化、枚举、空列表处理和释放放在一个边界内。defer ctx.Free() 紧跟在错误判断后面，确保只有成功创建上下文时才注册释放动作。

package main

import (
	"fmt"

	malgo "github.com/gen2brain/malgo"
)

// listPlaybackDevices 返回当前后端发现的播放设备摘要。
func listPlaybackDevices() error {
	// InitContext 会创建并初始化 malgo 使用的原生上下文。
	ctx, err := malgo.InitContext(nil, malgo.ContextConfig{}, nil)
	if err != nil {
		return fmt.Errorf("初始化 malgo context: %w", err)
	}
	// 上下文不再使用后必须释放其原生资源。
	defer ctx.Free()

	// Playback 只请求播放设备，不会把 Capture 设备混入结果。
	devices, err := ctx.Devices(malgo.Playback)
	if err != nil {
		return fmt.Errorf("枚举播放设备: %w", err)
	}
	if len(devices) == 0 {
		fmt.Println("当前没有发现可用的播放设备")
		return nil
	}

	for i := range devices {
		device := &devices[i]
		// Name 用于展示，ID 用于后续选择，IsDefault 表示后端的默认标记。
		fmt.Printf("%d. %s (id=%s, default=%t, formats=%d)\n",
			i+1,
			device.Name(),
			device.ID.String(),
			device.IsDefault != 0,
			device.FormatCount,
		)
	}
	return nil
}

func main() {
	// 让 main 统一处理初始化或枚举阶段的错误。
	if err := listPlaybackDevices(); err != nil {
		fmt.Println(err)
	}
}

这里没有把任何一条设备当成默认设备。后续若要打开具体设备，应保存用户选择的 DeviceID，再把它放入播放侧配置；如果只是展示设备选择器，读到 DeviceInfo 后释放上下文即可。

怎样读取 DeviceInfo 的有用字段

DeviceInfo 可以提供设备 ID、默认标记、格式数量和格式切片，Name() 返回可读名称，String() 返回适合日志的字符串表示。展示层通常使用名称，持久化或二次选择应优先保留 ID，而不是依赖名称，因为名称可能重复或随系统配置变化。

如果只需要给用户列出名称，可以保留最小字段；如果要在枚举后建立播放配置，则把 ID 和格式信息一起带到选择层，避免再次用名称模糊匹配。

把资源释放和错误分支放在同一边界

枚举函数有三个互不相同的结果：上下文初始化失败、设备枚举失败、枚举成功但列表为空。前两种应返回错误，最后一种可以返回空切片或由调用方显示“没有发现播放设备”。把它们混成一个“没有设备”提示，会让用户无法区分系统后端故障和确实没有输出设备。

还要注意，Free() 只负责释放由 InitContext 创建的上下文资源；它不等于播放设备实例的 Uninit()。如果后续代码调用 InitDevice 创建了真正的流式设备，就要按那个对象的生命周期单独清理。

常见问题

为什么不能写成 malgo.DeviceTypePlayback？

当前 malgo 文档中的 DeviceType 常量名称是 Playback、Capture、Duplex 和 Loopback，因此调用应写成 ctx.Devices(malgo.Playback)。不要根据其他音频库的命名习惯自行拼接常量名。

Devices 返回空列表是错误吗？

不一定。只要 error 为空，空列表就表示当前后端没有返回活动的播放设备；可以让上层显示无设备状态，再引导用户检查系统输出设备和音频服务。

枚举设备后能直接播放声音吗？

不能把二者等同。Devices 返回的是基础信息；真正播放还需要配置 DeviceConfig、回调和设备生命周期，并在结束时调用设备的 Uninit()。

可以用设备名称作为唯一标识吗？

不建议。名称适合展示，设备 ID 更适合在当前上下文中做选择。名称可能重复，系统切换后端或设备连接状态变化时也可能改变。