以.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再生を提供できます。