william-weng/wwqoa
- [A Pure Swift implementation of the Quite OK Audio (QOA) codec, prioritizing simplicity, clarity, and zero dependencies. Well-suited for learning codec internals and integrating into Swift-based audio pipelines.](https://qoaformat.org/)
🎉 [相關說明](https://qoaformat.org/qoa-specification.pdf)
📷 [效果預覽](https://peterpanswift.github.io/iphone-bezels/)
https://github.com/user-attachments/assets/aaf1cd24-1881-431b-8f7a-0d9ae635e954
<div align="center">
⭐ 覺得好用就給個 Star 吧！
</div>
💿 [安裝方式](https://medium.com/彼得潘的-swift-ios-app-開發問題解答集/使用-spm-安裝第三方套件-xcode-11-新功能-2c4ffcf85b4b)
使用 Swift Package Manager (SPM)：
dependencies: [
.package(url: "https://github.com/William-Weng/WWQOA", .upToNextMinor(from: "1.1.0"))
]✨ 功能特色
- ✅ 純 Swift 實作（無 C / 無 FFmpeg）
- ✅ 支援 interleaved PCM 輸入
- ✅ PCM → QOA 編碼
- ✅ QOA → PCM 解碼
- ✅ 支援輸出 WAV 檔案
- ✅ 完全支援 Swift Package Manager
🍄 [壓縮率](https://qoaformat.org/samples/)
| 格式 | 檔案大小 | 比例 | | --- | --- | --- | | WAV (PCM16) | 100%|1.0x| | QOA | 約 35% – 45% | 約 2.2x – 2.8x|
🧲 內部參數
| 參數名稱 | 說明 | |-----------|------| | encodeFile(:) | 取得QOA編碼完成的結果。 | | encodeFile(:to:) | 將編碼完成的QOA檔存成檔案。 | | decodeFile(:) | 解碼完整的 QOA 檔案為 FileDecodeResult。 | | decodeFile(:to:) | 解碼 QOA 檔案並直接匯出為 WAV 檔案。 | | loadPCMInt16(from:) | 讀取 Apple 可解碼的音訊檔案，統一轉換為 Int16 交錯式 PCM。 |
🚀 使用範例
import UIKit
import WWQOA
final class ViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
do {
let qoaUrl = try encoding()
_ = try decoding(qoaUrl: qoaUrl)
} catch {
print("QOA file roundtrip failed:", error)
}
}
}
private extension ViewController {
func encoding() throws -> URL {
let m4aUrl = Bundle.main.url(forResource: "do-re-mi-re-do", withExtension: "m4a")!
let pcmInput = try WWQOA.shared.loadPCMInt16(from: m4aUrl)
let qoaUrl = FileManager.default.temporaryDirectory.appendingPathComponent("do-re-mi-re-do.qoa")
let result = try WWQOA.shared.encodeFile(pcmInput, to: qoaUrl)
print("QOA File:", qoaUrl.path)
print("PCM Size: \(pcmInput.interleavedSamples.count)")
print("QOA Size:", result.count)
print("Result:", result)
return qoaUrl
}
func decoding(qoaUrl: URL, filename: String = "do-re-mi-re-do.wav") throws -> URL {
let qoaData = try Data(contentsOf: qoaUrl)
let wavUrl = FileManager.default.temporaryDirectory.appendingPathComponent(filename)
let result = try WWQOA.shared.decodeFile(qoaData, to: wavUrl)
print("\n----- decodingData -----")
print("QOA Size: \(qoaData.count)")
print("WAV File:", wavUrl.path)
print("Result:", result)
return wavUrl
}
}Package Metadata
Repository: william-weng/wwqoa
Default branch: main
README: README.md