ORPHE TRACKで発生していた問題

ORPHE TRACK で音声（効果音・TTS・動画音声など）を再生すると、

Spotify や Apple Music などの音楽アプリが停止してしまう問題がありました。

ランニングアプリでは

音楽はそのまま
フィードバック音声だけ重ねて再生

という UX が求められるため、
この現象は実用上大きな課題でした。

最初のアプローチ：audio_session を使って競合を制御した

まずは audio_session を使って、

OS の「音声セッション」そのものを適切に設定しようとしました。

audio_session は

音声ポリシー
他アプリとの優先度
再生の扱い

などを一元的に設定できる便利なライブラリです。

しかし実際には……

問題：audioplayers だけ競合を解消できなかった

audio_session の設定を適用しても、
audioplayers のみ他アプリの音楽を止めてしまう挙動が残りました。

競合の流れ（問題状況）

+---------------------------+
| 他アプリ：音楽再生中      |
+-------------+-------------+
              |
              v
+---------------------------+
| ORPHE TRACK：音声再生      |
+-------------+-------------+
              |
              v
+---------------------------+
| audio_session 設定を適用  |
| → video_player はOK       |
| → flutter_tts もOK        |
| → audioplayers がNG       |
|   （音楽アプリが停止）     |
+---------------------------+

最終アプローチ：各ライブラリに用意された「競合設定」を直接使う方針へ

試行錯誤した結果、

“audio_session だけに依存せず、ライブラリごとの競合設定を直接調整する”

という方式が最も安定しました。

Flutter の音声関連ライブラリは

OSレベルの音声セッション制御を、それぞれ独自にラップしているため、

まとめて統一制御する

よりも
各ライブラリの公式 API で明示的に設定する

ほうが確実に動作します。

具体的に適用した設定

video_player（mixWithOthers）

VideoPlayerController.asset(
  theme.asset.videos.logo.path,
  videoPlayerOptions: VideoPlayerOptions(mixWithOthers: true),
);

mixWithOthers: true

→ 他アプリの音声を止めず、自分の音声を重ねる

audioplayers（duckOthers）

await audioPlayer.play(
  AssetSource(theme.asset.sounds.countDownStart.path),
  volume: 1.0,
  ctx: AudioContext(
    iOS: AudioContextIOS(
      options: {AVAudioSessionOptions.duckOthers},
    ),
    android: AudioContextAndroid(
      audioFocus: AndroidAudioFocus.gainTransientMayDuck,
    ),
  ),
);

duckOthers

→ 他アプリの音楽の音量を一時的に下げる（ducking）

→ 完全停止はしない

flutter_tts（AudioSessionConfiguration.speech）

final session = await AudioSession.instance;
await session.configure(
  AudioSessionConfiguration.speech().copyWith(
    avAudioSessionCategoryOptions: AVAudioSessionCategoryOptions.duckOthers,
    androidAudioFocusGainType:
        AndroidAudioFocusGainType.gainTransientMayDuck,
    androidAudioAttributes: const AndroidAudioAttributes(
      contentType: AndroidAudioContentType.speech,
      usage: AndroidAudioUsage.assistanceAccessibility,
    ),
    androidWillPauseWhenDucked: false,
  ),
);

TTSは OS の音声セッション干渉が強いため、

speech() ベースで duckOthers に寄せるのが最も安定。

最終的な競合解消フロー

+-----------------------------------------+
|   ORPHE TRACK：音声再生要求             |
+-------------------------+---------------+
                          |
                          v
+-----------------------------------------+
| audio_session で基礎設定                |
| しかし一部ライブラリは制御しきれない    |
+-------------------------+---------------+
                          |
                          v
+-----------------------------------------+
| ライブラリごとに競合設定を適用          |
| - video_player: mixWithOthers           |
| - audioplayers: duckOthers              |
| - flutter_tts: speech() + duckOthers    |
+-------------------------+---------------+
                          |
                          v
+-----------------------------------------+
|   結果                                   |
| - 音楽アプリは停止しない                |
| - ORPHE TRACK の音声だけ重ねられる      |
+-----------------------------------------+

なぜこの構成に落ち着いたか

Flutterの音声ライブラリは “音声セッションの扱い” が個別に実装されている
そのため「完全統一」よりも、「ケースごとに最適化」のほうが安定
特に audioplayers は OS の音声フォーカス処理の影響を受けやすい

結果として、

ライブラリ別に公式APIで競合設定を明示することで、

最も期待通りの挙動になりました。

記事3のまとめ

ORPHE TRACK では音声再生時に音楽アプリが止まる問題が発生した
最初は audio_session による統合制御を試したが、

audioplayers だけ期待通りに競合を解消できなかった
最終的には、video_player / audioplayers / flutter_tts の

各ライブラリが持つ公式競合設定を直接使用する方針を採用
結果として、
- 音楽アプリを止めず
- ORPHE TRACK の音声だけを安全に重ねられる
  
  という動作が実現した