Swift/macOS：如何强制音频通过扬声器播放并设置最大音量？

Absolutely! While macOS doesn’t have the exact AVAudioSession setup you’re familiar with from iOS, you can still force audio through the built-in speaker and set maximum volume using either AVFoundation (simpler for basic use cases) or lower-level CoreAudio APIs (for advanced control). Here’s how to do both:

Method 1: Using AVFoundation (Clean & Straightforward) #

macOS does include AVAudioSession (with minor differences from iOS), and you can use it to target the built-in speaker directly. This is the best option for most standard playback scenarios.

Swift Code Example: #

import AVFoundation

func forceAudioToSpeakerAndMaximizeVolume() {
    do {
        let audioSession = AVAudioSession.sharedInstance()
        
        // Set playback category to ensure audio plays even if system is muted
        try audioSession.setCategory(.playback, mode: .default)
        
        // Locate the built-in speaker device
        guard let builtInSpeaker = audioSession.availableOutputDevices.first(where: { device in
            device.portType == .builtInSpeaker
        }) else {
            print("Built-in speaker not available on this device")
            return
        }
        
        // Force audio output to the built-in speaker
        try audioSession.setPreferredOutputDevice(builtInSpeaker)
        
        // Set volume to maximum (range: 0.0 to 1.0)
        try audioSession.setOutputVolume(1.0)
        
        print("Successfully forced audio to speaker and set max volume!")
    } catch {
        print("Failed to configure audio: \(error.localizedDescription)")
    }
}

Key Notes: #

• The .playback category ensures your audio plays regardless of the system’s mute state.
• setPreferredOutputDevice temporarily overrides the user’s default audio output selection.
• setOutputVolume adjusts the system-wide output volume. If you only want to maximize your app’s audio (without changing system settings), set the volume property of your player (e.g., AVAudioPlayer.volume = 1.0) instead.

Method 2: Using CoreAudio (Advanced Control) #

If you need more granular control over audio devices (e.g., handling edge cases with external audio gear), use CoreAudio’s low-level APIs. This approach gives you direct access to system audio hardware.

Swift Code Example: #

import CoreAudio

func forceAudioToSpeakerWithCoreAudio() {
    var outputDeviceID: AudioDeviceID = 0
    var propertyAddress = AudioObjectPropertyAddress(
        mSelector: kAudioHardwarePropertyDefaultOutputDevice,
        mScope: kAudioObjectPropertyScopeGlobal,
        mElement: kAudioObjectPropertyElementMaster
    )
    
    // Get list of all audio devices
    var deviceCount: UInt32 = 0
    propertyAddress.mSelector = kAudioHardwarePropertyDevices
    var size = UInt32(MemoryLayout<UInt32>.size)
    AudioObjectGetPropertyData(AudioObjectID(kAudioObjectSystemObject), &propertyAddress, 0, nil, &size, &deviceCount)
    
    var devices = [AudioDeviceID](repeating: 0, count: Int(deviceCount))
    size = UInt32(MemoryLayout<AudioDeviceID>.size * deviceCount)
    AudioObjectGetPropertyData(AudioObjectID(kAudioObjectSystemObject), &propertyAddress, 0, nil, &size, &devices)
    
    // Find the built-in speaker device
    guard let speakerDeviceID = devices.first(where: { device in
        var nameBuffer = [UInt8](repeating: 0, count: 256)
        var nameSize = UInt32(nameBuffer.count)
        let nameAddress = AudioObjectPropertyAddress(
            mSelector: kAudioDevicePropertyDeviceNameCFString,
            mScope: kAudioObjectPropertyScopeGlobal,
            mElement: kAudioObjectPropertyElementMaster
        )
        
        guard AudioObjectGetPropertyData(device, &nameAddress, 0, nil, &nameSize, &nameBuffer) == noErr else {
            return false
        }
        
        let deviceName = String(cString: nameBuffer)
        return deviceName.contains("Built-in Speaker")
    }) else {
        print("Built-in speaker not found")
        return
    }
    
    // Set default output device to built-in speaker
    propertyAddress.mSelector = kAudioHardwarePropertyDefaultOutputDevice
    size = UInt32(MemoryLayout<AudioDeviceID>.size)
    let setDeviceStatus = AudioObjectSetPropertyData(AudioObjectID(kAudioObjectSystemObject), &propertyAddress, 0, nil, size, &speakerDeviceID)
    guard setDeviceStatus == noErr else {
        print("Failed to set output device: \(setDeviceStatus)")
        return
    }
    
    // Set maximum volume (range: 0.0 to 1.0)
    var maxVolume: Float32 = 1.0
    let volumeAddress = AudioObjectPropertyAddress(
        mSelector: kAudioDevicePropertyVolumeScalar,
        mScope: kAudioObjectPropertyScopeOutput,
        mElement: kAudioObjectPropertyElementMaster
    )
    size = UInt32(MemoryLayout<Float32>.size)
    let setVolumeStatus = AudioObjectSetPropertyData(speakerDeviceID, &volumeAddress, 0, nil, size, &maxVolume)
    
    if setVolumeStatus == noErr {
        print("Successfully configured audio via CoreAudio!")
    } else {
        print("Failed to set volume: \(setVolumeStatus)")
    }
}

Key Notes: #

• CoreAudio requires manual device scanning, making it more flexible but also more verbose.
• This method adjusts system-wide audio settings, just like the AVFoundation approach.
• On macOS 10.14+, you may need to request "Audio Input/Output" access if your app handles recording, but pure playback usually works without extra permissions.

Bonus: App-Only Volume Control #

If you don’t want to modify the system’s global volume, just set the volume property of your audio player to 1.0 when initiating playback:

if let audioURL = Bundle.main.url(forResource: "your-audio-file", withExtension: "mp3") {
    do {
        let player = try AVAudioPlayer(contentsOf: audioURL)
        player.volume = 1.0 // Maximize app-specific volume
        forceAudioToSpeakerAndMaximizeVolume() // Force output to speaker
        player.play()
    } catch {
        print("Failed to initialize player: \(error)")
    }
}

内容的提问来源于stack exchange，提问作者io̍k-úi TiuN