本文へスキップ
HLSガイド

iOSとAndroidのネイティブプレーヤーでM3U8を再生する方法

iOSのAVFoundationとAndroidのMedia3 ExoPlayerを使い、ネイティブアプリでM3U8を安定して再生する方法を学びます。

以.m3u8プレイリストを使うHTTP Live Streaming(HLS)は、ウェブ動画配信の標準的な方式です。しかし、ブラウザーからモバイルのネイティブアプリに移ると、再生の仕組みは大きく変わります。iOSとAndroidでは、OSレベルでのM3U8の解析、アダプティブビットレート(ABR)の切り替え、DRMの扱いが異なります。

このガイドでは、iOSとAndroidのネイティブプレーヤーでM3U8を安定して再生する方法を説明します。AppleのAVFoundation、GoogleのExoPlayer(現在はAndroidX Media3の一部)、バックグラウンド再生の設定、モバイル特有の再生エラーの調査を取り上げます。

iOSでの実装:AVPlayerとAVFoundation

HLSを開発したAppleのiOSには、M3U8ストリームを再生するネイティブ機能が標準で備わっています。iOSで効率的なアダプティブビットレート配信を行うために、サードパーティーのライブラリは必要ありません。

メディア再生の中心となるフレームワークはAVFoundationで、再生を制御する主なクラスはAVPlayerです。標準的な画面を使う場合はAVPlayerViewControllerで表示します。

Swiftでの基本実装

SwiftでM3U8のURLを読み込む操作は、通常のMP4ファイルとほぼ同じです。OSがプレイリストを自動検出し、セグメントを解析してネットワークバッファーを管理します。

import UIKit
import AVKit
import AVFoundation

class VideoPlayerViewController: UIViewController {
    var playerViewController = AVPlayerViewController()
    var playerView = AVPlayer()

    override func viewDidLoad() {
        super.viewDidLoad()
        
        guard let url = URL(string: "https://example.com/master.m3u8") else { return }
        
        // Initialize the player
        playerView = AVPlayer(url: url)
        playerViewController.player = playerView
        
        // Present the player
        self.present(playerViewController, animated: true) {
            self.playerViewController.player?.play()
        }
    }
}

AirPlayとピクチャ・イン・ピクチャ

AVPlayerViewControllerはネイティブのコンポーネントなので、アプリの音声セッションを適切に設定すれば、AirPlayとピクチャ・イン・ピクチャ(PiP)を利用できます。

FairPlay DRM

M3U8ストリームがApple FairPlayで保護されている場合は、AVAssetResourceLoaderDelegateを実装して鍵の要求を受け取り、SPC(Server Playback Context)を取得し、CKC(Content Key Context)をプレーヤーへ返す必要があります。

Androidでの実装:ExoPlayer / Media3

従来のAndroid標準MediaPlayerはHLSへの対応が不安定で、アダプティブビットレートの切り替え、特定の音声コーデック、ライブストリームの境界をうまく扱えないことがありました。

現在、Androidの動画再生で広く使われるのはExoPlayerで、正式にJetpack Media3の一部となっています。アプリ側で動作し、HLSの解析と描画を細かく設定できます。

Kotlinでの基本実装(Media3)

Media3でM3U8ストリームを再生するには、MediaItemを作成してExoPlayerのインスタンスへ渡します。

import androidx.media3.common.MediaItem
import androidx.media3.exoplayer.ExoPlayer
import androidx.media3.ui.PlayerView

class PlayerActivity : AppCompatActivity() {
    private var player: ExoPlayer? = null
    private lateinit var playerView: PlayerView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_player)
        playerView = findViewById(R.id.player_view)
        
        // Initialize ExoPlayer
        player = ExoPlayer.Builder(this).build()
        playerView.player = player
        
        // Build the MediaItem pointing to the M3U8
        val hlsUrl = "https://example.com/master.m3u8"
        val mediaItem = MediaItem.fromUri(hlsUrl)
        
        // Prepare and play
        player?.setMediaItem(mediaItem)
        player?.prepare()
        player?.playWhenReady = true
    }
    
    override fun onDestroy() {
        super.onDestroy()
        player?.release()
    }
}

Androidで高度なHLS機能を扱う

  • アダプティブビットレートの制御: ExoPlayerは帯域を監視するDefaultTrackSelectorを使用します。モバイルデータ通信中に最大ビットレートを制限するなどの設定ができます。
  • Widevine DRM: iOSとは異なり、AndroidではWidevineを使用します。ライセンスサーバーのURLを指定して、MediaItem.BuilderにDRM設定を追加できます。

クロスプラットフォームのフレームワーク(React NativeとFlutter)

クロスプラットフォームのフレームワークでアプリを作る場合は、SwiftとKotlinを直接書かなくても構いません。iOSではAVPlayer、AndroidではExoPlayerを内部で利用するライブラリがあります。

React Native

react-native-videoを使用し、M3U8のURLをsource={{ uri: '...' }}プロパティへ渡します。HLSをネイティブで扱い、バッファリング状態などのコールバックも提供します。

Flutter

公式のvideo_playerパッケージを使用し、VideoPlayerController.networkUrl()を初期化します。FlutterでDRMやHLSのトラック選択が必要な場合は、better_playerパッケージも選択肢になります。

モバイル再生のトラブルシューティング

M3U8がウェブでは再生できるのにネイティブアプリで失敗する場合、原因を別の場所に探してしまいがちです。次のプラットフォーム間の違いを確認してください。

1. ネイティブプレーヤーにはCORSが適用されない

ウェブでは、必要なヘッダーがないとCORS(Cross-Origin Resource Sharing)によって再生が遮断されます。ネイティブのモバイルアプリはCORSを強制しません。ネイティブでは再生できるのにブラウザーやWebViewで失敗するなら、CORSを調べます。逆の場合はDRMやコーデックを確認します。

2. ATSと平文通信(HTTPとHTTPS)

iOSとAndroidは、既定で安全な接続を要求します。

  • iOS: App Transport Security(ATS)はhttp://で始まるM3U8やセグメントのURLを遮断します。安全でない読み込みを許可するには、NSAppTransportSecurityの例外をInfo.plistに追加する必要があります。
  • Android: Android 9以降は平文通信を遮断します。許可するにはandroid:usesCleartextTraffic="true"をAndroidManifest.xmlに追加するか、Network Security Configで特定のHTTPドメインを許可します。
重要:マスタープレイリストがHTTPSでも、内部のセグメントURLが絶対形式のHTTPである場合によく失敗します。OSはマニフェストの解析に成功しても、セグメントのダウンロードに失敗することがあります。

3. コーデックの互換性

モバイル端末のハードウェアデコーダーには対応範囲があります。新しい端末はH.264、H.265(HEVC)、AACに対応していますが、古いAndroid端末ではH.264のHigh Profileなどで問題が生じる場合があります。ネイティブプレーヤーが互換性をすばやく判断できるよう、M3U8マスタープレイリストのCODECS属性を正確に指定してください。

まとめ

安定したモバイル配信には、iOSでAVPlayer、AndroidでExoPlayerを使うことが重要です。各エンジンのM3U8解析方法と、HTTP通信やDRMに関するプラットフォーム固有の方針を理解すれば、幅広い端末で滑らかなHLS再生を提供できます。