SimpleAudioPlayer 使用手册（二）：输出设备配置与高级控制

using var player = new AudioPlayer(); // 默认配置
using var player = new AudioPlayer(new AudioPlayerOptions { ... });

public class AudioPlayerOptions
{
    public SampleFormat SampleFormat { get; init; } = SampleFormat.F32;
    public uint Channels { get; init; } = 2;
    public uint SampleRate { get; init; } // 0 = 设备原生
    public AudioLatencyMode LatencyMode { get; init; } = AudioLatencyMode.Playback;
    public AudioPlaybackUsage Usage { get; init; } = AudioPlaybackUsage.Media;
    public AudioContentType ContentType { get; init; } = AudioContentType.Music;
    public AudioShareMode ShareMode { get; init; } = AudioShareMode.Shared;
    public uint PeriodSizeInMilliseconds { get; init; } // 0 = 自动
    public uint Periods { get; init; } // 0 = 自动
}

public enum AudioLatencyMode
{
    LowLatency = 0,
    Playback   = 1  // 默认
}

var player = new AudioPlayer(new AudioPlayerOptions {
    LatencyMode = AudioLatencyMode.LowLatency
});

public enum AudioPlaybackUsage
{
    Default = 0,
    Media = 1,            // 默认
    Game = 2,
    VoiceCommunication = 3,
    Notification = 4,
    Alarm = 5
}

// Windows: Game 禁用音频增强降延迟
// Android: 系统据此调整音频路由和策略
var player = new AudioPlayer(new AudioPlayerOptions {
    Usage = AudioPlaybackUsage.Game
});

public enum AudioContentType
{
    Default = 0,
    Music = 1,       // 默认
    Speech = 2,
    Movie = 3,
    Sonification = 4
}

public enum AudioShareMode
{
    Shared = 0,    // 默认
    Exclusive = 1
}

// 低延迟: 20ms × 2 = 40ms 总缓冲
new AudioPlayerOptions {
    PeriodSizeInMilliseconds = 20,
    Periods = 2
};
// 稳定: 80ms × 3 = 240ms 总缓冲
new AudioPlayerOptions {
    PeriodSizeInMilliseconds = 80,
    Periods = 3
};

player.Volume = 0.75;

new AudioPlayer(); // 默认值已是最佳配置

new AudioPlayer(new AudioPlayerOptions {
    LatencyMode = AudioLatencyMode.LowLatency, // Windows 有效
    Usage = AudioPlaybackUsage.Game,           // Windows/Android 有效
    PeriodSizeInMilliseconds = 30,
    Periods = 2
});

new AudioPlayer(new AudioPlayerOptions {
    LatencyMode = AudioLatencyMode.LowLatency,
    Usage = AudioPlaybackUsage.VoiceCommunication, // Android 有效
    SampleRate = 16000,
    PeriodSizeInMilliseconds = 20,
    Periods = 2
});

new AudioPlayer(new AudioPlayerOptions {
    ShareMode = AudioShareMode.Exclusive,
    SampleRate = 96000 // 设备必须支持
});