.NET MAUI中如何让TextToSpeech.SpeakAsync通过扬声器播放音频？

在三星Android设备上，TextToSpeech.SpeakAsync默认可能会使用听筒播放音频，要实现像Android Accessibility Suite那样的扬声器外放效果，需要通过Android原生API强制切换音频路由。以下是具体实现步骤：

1. 添加权限 #

在Android项目的AndroidManifest.xml中添加修改音频设置的权限：

<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

2. 编写平台特定的播放逻辑 #

利用条件编译，仅在Android平台下执行原生音频路由配置，播放完成后恢复系统原有设置避免副作用：

#if ANDROID
using Android.Content;
using Android.Media;
#endif

public async Task SpeakViaSpeakerAsync(string textToSpeak)
{
#if ANDROID
    var audioManager = (AudioManager)Android.App.Application.Context.GetSystemService(Context.AudioService);
    // 保存当前音频状态，用于后续恢复
    var originalAudioMode = audioManager.Mode;
    var originalSpeakerState = audioManager.IsSpeakerphoneOn;

    try
    {
        // 设置音频模式为正常模式，强制开启扬声器
        audioManager.Mode = Mode.Normal;
        audioManager.SetSpeakerphoneOn(true);
        // 将媒体音量调到最大（可选，根据需求调整）
        audioManager.SetStreamVolume(Stream.Music, audioManager.GetStreamMaxVolume(Stream.Music), 0);
        
        // 执行文本朗读
        await TextToSpeech.SpeakAsync(textToSpeak);
    }
    finally
    {
        // 恢复原有音频设置，避免影响其他应用
        audioManager.SetSpeakerphoneOn(originalSpeakerState);
        audioManager.Mode = originalAudioMode;
    }
#else
    // iOS、Windows等其他平台直接使用默认朗读逻辑
    await TextToSpeech.SpeakAsync(textToSpeak);
#endif
}

3. 调用方法 #

在你的业务逻辑中，直接调用SpeakViaSpeakerAsync方法即可实现扬声器外放：

await SpeakViaSpeakerAsync("需要外放的文本内容");

原理说明 #

Android Accessibility Suite之所以能强制外放，本质是通过修改系统音频路由，将音频输出切换到扬声器。上面的代码通过AudioManagerAPI手动控制扬声器状态和音频模式，确保TextToSpeech的音频流走扬声器通道，同时在操作完成后恢复原有设置，避免干扰其他应用的音频行为。

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