Flutter中如何配置闹钟铃声音频会话以适配全Android版本？

要让你的闹钟应用在所有Android版本上统一使用闹钟音量，并在免打扰模式下正常播放，需要针对旧版本系统的兼容性问题调整音频会话配置，并确保初始化顺序正确：

1. 完善音频会话配置（兼容旧Android版本） #

旧版本Android（如6、8）对AudioAttributes的映射逻辑与新版本不同，需要显式指定遗留流类型来强制关联闹钟音量通道，同时补充contentType参数强化音频类型识别：

final session = await AudioSession.instance;
// 配置音频会话，优先确保闹钟类型的兼容性
await session.configure(AudioSessionConfiguration(
  androidAudioAttributes: const AndroidAudioAttributes(
    flags: AndroidAudioFlags.audibilityEnforced, // 强制免打扰下可播放
    usage: AndroidAudioUsage.alarm, // 标记为闹钟音频
    contentType: AndroidAudioContentType.sonification, // 明确为提示音类型
    legacyStreamType: AndroidAudioLegacyStreamType.alarm, // 针对旧版本指定流类型
  ),
  // iOS端跨平台配置（按需保留）
  iosAudioSessionCategory: AVAudioSessionCategory.playback,
  iosAudioSessionCategoryOptions: AVAudioSessionCategoryOptions.interruptSpokenAudioAndMixWithOthers,
));

// 显式激活音频会话，确保配置生效
await session.setActive(true);

2. 调整播放器初始化顺序 #

必须先完成音频会话配置并激活，再初始化AudioPlayer，避免just_audio自动创建默认的媒体类型会话：

// 先配置并激活会话，再初始化播放器
player = AudioPlayer();
await player.setAudioSource(AudioSource.uri(ringtoneUri));
await player.setLoopMode(loopMode);
player.play();

3. 添加必要权限（免打扰与音量控制） #

在AndroidManifest.xml中添加权限，确保应用能访问通知策略（免打扰下播放）：

<uses-permission android:name="android.permission.ACCESS_NOTIFICATION_POLICY" />
<uses-permission android:name="android.permission.WAKE_LOCK" /> <!-- 可选，若需要唤醒锁屏设备 -->

针对Android 6及以上版本，需动态申请通知策略访问权限：

import 'package:permission_handler/permission_handler.dart';

// 在配置会话前请求权限
if (Platform.isAndroid) {
  final permissionStatus = await Permission.notificationPolicyAccess.request();
  if (!permissionStatus.isGranted) {
    // 提示用户授予权限，否则免打扰下无法播放
  }
}

关键说明 #

• legacyStreamType: AndroidAudioLegacyStreamType.alarm是解决旧版本音量通道错误的核心，它直接关联系统闹钟音量流，避免被映射到铃声音量。
• AndroidAudioFlags.audibilityEnforced确保音频在免打扰模式下仍能播放，但需要配合ACCESS_NOTIFICATION_POLICY权限。
• 始终确保音频会话配置在播放器初始化前完成，否则just_audio会使用默认媒体会话覆盖你的配置。

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