以 .m3u8 播放列表格式为特征的 HTTP 实时流(HLS),已经成为网络视频分发的事实标准。但从网页浏览器转向原生移动应用时,开发者面对的播放架构截然不同。iOS 与 Android 在操作系统层面对 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 文件基本相同。操作系统会自动识别播放列表、解析分片并管理网络缓冲区。
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(服务器播放上下文),并把 CKC(内容密钥上下文)返回给播放器。
Android 实现:ExoPlayer / Media3
过去,Android 原生 MediaPlayer 对 HLS 的支持以错误多且表现不一致著称,在自适应码率切换、特定音频编解码器和直播流边界方面都存在困难。
如今,Android 视频播放的公认行业标准是 ExoPlayer,它现已正式成为 Jetpack Media3 套件的一部分。ExoPlayer 是应用层媒体播放器,提供可高度定制的 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:Android 与 iOS 不同,使用 Widevine。通过指定许可证服务器 URL,可以把 DRM 配置直接附加到
MediaItem.Builder。
跨平台框架(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)会阻止播放。原生移动应用不强制执行 CORS。如果视频流在原生应用中正常、却在浏览器(或移动 WebView)中失败,问题就在 CORS。反之,如果原生应用播放失败而网页正常,应检查 DRM 或编解码器,而不是 CORS。
2. ATS 与明文流量(HTTP 和 HTTPS)
iOS 和 Android 默认都会严格强制使用安全连接。
- iOS:应用传输安全(ATS)会阻止所有以
http://开头的 M3U8 URL 或分片 URL。必须添加NSAppTransportSecurity例外,并将其写入Info.plist,才能允许不安全的加载。 - Android:Android 9 及更高版本会阻止明文流量。必须添加
android:usesCleartextTraffic="true",并将其写入AndroidManifest.xml;也可以配置网络安全配置,以允许特定 HTTP 域名。
重要提示:一种常见故障是主播放列表使用 HTTPS,但内部的分片路径返回绝对 HTTP URL。操作系统可以成功解析清单,却会在不提示错误的情况下无法下载分片。
3. 编解码器兼容性
移动设备的硬件解码器对格式有严格要求。现代设备支持 H.264、H.265(HEVC)和 AAC,但旧款 Android 设备可能难以处理某些 H.264 配置文件,例如 High Profile。务必确保 M3U8 主播放列表准确定义 CODECS 属性,使原生播放器能够快速判断硬件兼容性。
总结
要构建可靠的移动流媒体体验,需要充分利用操作系统专用工具:iOS 上使用 AVPlayer,Android 上使用 ExoPlayer。工程师只要理解这些引擎解析 M3U8 清单的方式,并遵循各平台针对 HTTP 流量和 DRM 的安全策略,就能在整个移动生态中提供流畅的 HLS 视频播放。