如何使用Qt MediaDevices切换AudioOutput音频输出设备

核心问题在于AudioOutput的device属性要求传入QAudioDevice对象，而非设备ID或描述字符串。直接从MediaDevices的audioOutputs列表中获取对应对象赋值即可完成切换，以下是具体实现方案：

实现步骤与代码示例 #

1. 直接通过设备列表对象赋值 #

遍历mediaDevices.audioOutputs列表，通过设备的id或description匹配目标设备，直接赋值给AudioOutput的device属性：

import QtMultimedia 6.4
import QtQuick.Controls 2.15

Column {
    spacing: 10

    AudioOutput {
        id: playerOutput
        device: mediaDevices.defaultAudioOutput
        onDeviceChanged: {
            console.log("输出设备已切换：" + device.description + " (ID: " + device.id + ")")
        }

        Component.onCompleted: {
            console.log("可用输出设备：", mediaDevices.audioOutputs)
        }
    }

    MediaDevices {
        id: mediaDevices
    }

    // 切换到听筒按钮
    Button {
        text: "切换到内置听筒"
        onClicked: {
            for (const dev of mediaDevices.audioOutputs) {
                // 通过ID匹配，案例中听筒ID为"2"
                if (dev.id === "2") {
                    playerOutput.device = dev
                    break
                }
                // 也可通过描述匹配
                // if (dev.description.includes("earpiece")) { ... }
            }
        }
    }

    // 切换到扬声器按钮
    Button {
        text: "切换到内置扬声器"
        onClicked: {
            for (const dev of mediaDevices.audioOutputs) {
                if (dev.id === "3") {
                    playerOutput.device = dev
                    break
                }
            }
        }
    }
}

2. 可选：使用setDevice方法 #

若倾向于调用方法而非直接赋值属性，同样需要传入QAudioDevice对象：

// 示例：切换到列表中第二个设备
playerOutput.setDevice(mediaDevices.audioOutputs[1])

关键注意事项 #

• mediaDevices.audioOutputs返回的是QAudioDevice对象数组，直接使用数组元素即可，无需类型转换。
• 若AudioOutput处于播放状态，建议先调用pause()切换设备后再调用play()，避免音频异常。
• 设备的id是唯一标识，比description更可靠（描述可能随系统语言变化）。

内容的提问来源于stack exchange，提问作者Paul