iOS 播放 Opus 音頻格式方案：opus.swift / AVFoundation 實現文件與流媒體播放

iOS 系統原生不支持 Opus 格式（.opus / .ogg 容器），需引入第三方解碼庫。主流方案有兩種。

方案一：opus.swift（純 Swift 移植，輕量、無依賴）

GitHub：https://github.com/your-repo/opus.swift (搜索 "opus.swift iOS")

// 1. Swift Package Manager 安裝
.package(url: "https://github.com/...opus.swift.git", from: "1.0.0")

// 2. 文件播放
import Opus
import AVFoundation

let opusData = try Data(contentsOf: fileURL)
let decoder = OpusDecoder(sampleRate: 48000, channels: 2)
let pcmBuffer = decoder.decode(opusData) // 返回 AVAudioPCMBuffer

// 3. 播放
let player = AVAudioPlayerNode()
let engine = AVAudioEngine()
engine.attach(player)
engine.connect(player, to: engine.mainMixerNode, format: pcmBuffer.format)
player.scheduleBuffer(pcmBuffer, at: nil, options: .loops, completionHandler: nil)
try engine.start()
player.play()

方案二：FFmpeg + MobileVLCKit / ijkplayer（功能全、支持流媒體）

若需支持 HLS/DASH/RTMP 流媒體播放 Opus，建議用成熟播放器框架：

MobileVLCKit（VLC 官方 iOS 封裝）

// Podfile
pod 'MobileVLCKit', '~> 3.5'

// 播放
import MobileVLCKit
let player = VLCMediaPlayer()
player.media = VLCMedia(url: URL(string: "https://example.com/stream.opus")!)
player.play()

• 支持所有 FFmpeg 解碼器（Opus、AV1、HEVC 等）
• 支持網絡流、本地文件、字幕、多音軌
• 體積較大 (~50MB)

ijkplayer (Bilibili 開源，FFmpeg 輕量裁剪)

// Podfile
pod 'IJKMediaFramework', '~> 1.0'

// 播放
import IJKMediaFramework
let player = IJKFFMovieController(contentURL: url, with: nil)
player.prepareToPlay()
player.play()

• 可裁剪只保留 Opus 解碼器，體積 ~10MB
• API 簡單，性能優秀

方案三：AudioToolbox 低層解碼（極簡、無 UI 依賴）

// 使用 opus.framework (C 靜態庫) + AudioQueue / AudioUnit
// 適合：VoIP、即時通訊、極低延遲場景
// 參考：https://github.com/xiph/opus/tree/master/ios

選型建議

關鍵提示

• Opus 採樣率固定 48kHz，解碼時必須指定 48000
• 聲道數通常 1 (單聲道) 或 2 (立體聲)，根據文件元數據決定
• 流媒體播放需處理緩衝策略、網絡錯誤重連、音視頻同步
• App Store 審核：使用 FFmpeg 衍生庫需注意 LGPL/GPL 合規，動態鏈接並提供源碼鏈接

已解決：項目最終選用 ijkplayer，體積可控且完美支持 Opus 流媒體播放。