[Xcode/Swift] AVFoundation完全理解への道② (AVPlayer)

#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=800000
https://example.com/video/low.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=1600000
https://example.com/video/mid.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=3000000
https://example.com/video/high.m3u8

AVPlayerによるHLS再生の流れ
├─ 1. AVPlayerを初期化（m3u8のURLを渡す）
│   └─ 内部でAVURLAssetが生成される
│
├─ 2. AVURLAssetがm3u8を読み込む
│   ├─ プレイリスト(m3u8)を取得
│   ├─ #EXT-X-STREAM-INFの情報から適切なVariant Playlistを選択（ABR）
│   └─ 選ばれたVariantのm3u8を再度読み込む
│
├─ 3. メディアセグメント（.ts）の取得が始まる
│   ├─ Variant Playlistに定義された.tsファイルのURLを順次リクエスト
│   ├─ 一定数バッファリングされるまで再生開始されない（＝ReadyToPlay）
│   └─ バッファ監視 → ネットワーク状態で画質自動変更（ABR）
│
├─ 4. AVPlayerItemが.tsを順にデコードしてAVPlayerに供給
│   ├─ デコードされたフレームをAVPlayerLayerまたはVideoPlayerが表示
│   ├─ 音声データはAudioQueueに送られスピーカー再生
│   └─ シークや一時停止等の操作はAVPlayerItem経由で制御
│
└─ 5. 再生終了 or ユーザー操作でセッション終了
    ├─ AVPlayerItemのstatusが.didPlayToEndTimeに到達
    └─ 再生停止、リリース、または新しいAVPlayerItemで再開

import SwiftUI
import AVKit

struct VideoPlayerView: View {
    private let player = AVPlayer(url: URL(string: "https://example.com/stream.m3u8")!)

    var body: some View {
        VideoPlayer(player: player)
            .onAppear {
                player.play()
            }
            .onDisappear {
                player.pause()
            }
    }
}

import AVFoundation
import Combine

final class VideoPlayerObserver: NSObject {
    private var player: AVPlayer!
    private var playerItem: AVPlayerItem!
    private var observers = Set<NSKeyValueObservation>()
    private var cancellables = Set<AnyCancellable>()

    init(url: URL) {
        super.init()
        self.playerItem = AVPlayerItem(url: url)
        self.player = AVPlayer(playerItem: playerItem)
        observePlayer()
    }

    private func observePlayer() {
        // 再生準備
        observers.insert(
            playerItem.observe(\.status, options: [.new]) { item, _ in
                print("🔍 status:", item.status.rawValue)
            }
        )

        // バッファ状態
        observers.insert(
            playerItem.observe(\.isPlaybackBufferEmpty, options: [.new]) { item, _ in
                print("⚠️ Buffer Empty:", item.isPlaybackBufferEmpty)
            }
        )

        observers.insert(
            playerItem.observe(\.isPlaybackLikelyToKeepUp, options: [.new]) { item, _ in
                print("🚀 Likely To Keep Up:", item.isPlaybackLikelyToKeepUp)
            }
        )

        // 再生状態（rate）
        observers.insert(
            player.observe(\.rate, options: [.new]) { player, _ in
                print("🎮 Rate:", player.rate)
            }
        )

        // 再生完了通知
        NotificationCenter.default.publisher(for: .AVPlayerItemDidPlayToEndTime, object: playerItem)
            .sink { _ in
                print("🏁 再生終了！")
            }
            .store(in: &cancellables)
    }
}

player.seek(to: CMTime(seconds: 30, preferredTimescale: 600)) {
    finished in
    print("✅ Seek完了: \(finished)")
}

player.currentItem?.preferredPeakBitRate = 1_500_000 // 1.5 Mbps