跳到主要内容
HLS 指南

如何在 iOS 和 Android 原生播放器中播放 M3U8 流

在 iOS 上使用 AVFoundation、在 Android 上使用 Media3 ExoPlayer 实现可靠的 M3U8 播放,掌握原生 HLS 视频分发。

以 .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 视频播放。