React Nativeでバックグラウンド再生と
PiPを両立させる設計

// フォアグラウンド再生開始時
const startForegroundPlayback = async () => {
  // 1. TrackPlayer にメタデータをセット（ポスター画像、タイトル等）
  await TrackPlayer.add({
    id: trackId,
    url: videoUri,          // 動画と同じURLを渡す
    title: "講義タイトル",
    artist: "講師名",
    artwork: posterUri,
    duration: videoDuration,
  });

  // 2. 超極小音量で再生（0ではなく0.01）
  await TrackPlayer.play();
  await TrackPlayer.setVolume(0.01);

  // ↑ volume=0 にするとiOSがAudioSessionを非アクティブと判定し、
  //   Control Centerから表示が消えてしまう。0.01なら維持される。
};

// react-native-video の NowPlayingInfoCenterManager（修正前）
func invalidateCommandTargets() {
    let center = MPRemoteCommandCenter.shared()

    // nil を渡すとすべてのターゲットが削除される
    center.playCommand.removeTarget(nil)     // ← TrackPlayerのも消える
    center.pauseCommand.removeTarget(nil)    // ← TrackPlayerのも消える
    center.skipForwardCommand.removeTarget(nil)
    center.skipBackwardCommand.removeTarget(nil)
}

// react-native-video の NowPlayingInfoCenterManager（パッチ後）
func invalidateCommandTargets() {
    let center = MPRemoteCommandCenter.shared()

    // 自分が登録した参照のみを削除する
    if let target = playTarget {
        center.playCommand.removeTarget(target)
    }
    playTarget = nil

    if let target = pauseTarget {
        center.pauseCommand.removeTarget(target)
    }
    pauseTarget = nil

    // → TrackPlayerのハンドラーは残る
}

// 修正前: プレイヤーがnilになると常にNowPlayingInfoをクリア
guard let player = currentPlayer else {
    invalidateCommandTargets()
    MPNowPlayingInfoCenter.default().nowPlayingInfo = [:]  // ← 全消し
    return
}

// 修正後: リモートコントロールイベントを受信している場合のみクリア
if receivingRemoveControlEvents {
    invalidateCommandTargets()
    MPNowPlayingInfoCenter.default().nowPlayingInfo = [:]
}
// → TrackPlayerが管理するNowPlayingInfoは残る

{
  "ios": {
    "infoPlist": {
      "UIBackgroundModes": ["audio"]  // バックグラウンド音声再生を許可
    }
  }
}

await TrackPlayer.setupPlayer({
  iosCategory: "playback",           // バックグラウンド再生用カテゴリ
  iosCategoryMode: "default",        // 標準モード
  iosCategoryOptions: [
    "allowBluetooth",               // Bluetooth出力対応
    "allowBluetoothA2DP",           // 高音質Bluetooth
    "allowAirPlay",                 // AirPlay対応
    "defaultToSpeaker",             // デフォルトスピーカー
  ],
  autoUpdateMetadata: true,        // NowPlayingInfo自動更新
});

<Video
  playInBackground={true}
  playWhenInactive={true}
  ignoreSilentSwitch="ignore"
  audioCategory="playback"
  disableAudioSessionManagement={true}  // ← 重要
/>

const handleAppStateChange = async (nextState: AppStateStatus) => {
  if (appState.match(/active/) && nextState.match(/background|inactive/)) {
    // フォアグラウンド → バックグラウンド

    // TrackPlayerの位置をビデオに同期
    const currentPos = videoRef.current?.getCurrentPosition();
    await TrackPlayer.seekTo(currentPos);

    // TrackPlayerを通常音量に
    await TrackPlayer.setVolume(1.0);

    // ビデオプレイヤーの映像は自動的に停止される
    // （iOSがバックグラウンドのGPUレンダリングを停止）
  }

  if (appState.match(/background|inactive/) && nextState === "active") {
    // バックグラウンド → フォアグラウンド復帰

    // TrackPlayerの再生位置を取得
    const tpPosition = await TrackPlayer.getPosition();
    const tpState = await TrackPlayer.getPlaybackState();

    // ビデオプレイヤーをTrackPlayerの位置に同期
    videoRef.current?.seek(tpPosition);

    // TrackPlayerを再びSilent Syncに戻す
    await TrackPlayer.setVolume(0.01);

    // TrackPlayerが再生中ならビデオも再開
    if (tpState === State.Playing) {
      setIsPlaying(true);
    }
  }
};

<Video
  pictureInPicture={true}      // PiP 有効化
  onPictureInPictureStatusChanged={(e) => {
    if (e.isActive) {
      // PiP開始 → TrackPlayerのSilent Syncを停止
      // NowPlayingはreact-native-videoが管理
      TrackPlayer.pause();
    } else {
      // PiP終了 → バックグラウンド音声にフォールバック
      const pos = videoRef.current?.getCurrentPosition();
      TrackPlayer.seekTo(pos);
      TrackPlayer.setVolume(1.0);
      TrackPlayer.play();
    }
  }}
/>

<!-- バックグラウンド再生に必要 -->
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />

<!-- appKilledPlaybackBehavior の設定 -->
<!-- "stop-playback-and-remove-notification": アプリ強制終了時は再生停止 -->
<!-- "continue-playback": アプリ終了後も再生継続（メモリ消費大） -->