最近在做 iPhone 上的流媒體播放,需要能把音訊串流放出去。參考了不少文章與論壇討論,最後總算把這個相對棘手的問題搞定,於是整理出來分享。
這一篇聚焦在「播放音訊檔案」。至於如何用 AudioQueue 播放 raw PCM data,我會另開一篇寫——那大概是多數 iOS 開發者更需要、也更難的部分。一個人的力量有限,能少走一點彎路就少走一點吧。
//
// playAudio.h
//
// Created by infomedia xuanyuanchen on 12-3-26.
// Copyright (c) 2012年 xuanyuanchen. All rights reserved.
//
#import <Foundation/Foundation.h>
#import <AudioToolbox/AudioToolbox.h>
#import <AudioToolbox/AudioFile.h>
#define NUM_BUFFERS 3
@interface playAudio : NSObject {
AudioFileID audioFile; // 音訊檔 ID
AudioStreamBasicDescription dataFormat; // 音訊流格式描述
AudioQueueRef queue; // 音訊佇列
SInt64 packetIndex;
UInt32 numPacketsToRead;
UInt32 bufferByteSize;
AudioStreamPacketDescription *packetDescs;
AudioQueueBufferRef buffers[NUM_BUFFERS];
}
@property AudioQueueRef queue;
- (id)initWithAudio:(NSString *)path;
// 緩衝區讀取
- (void)audioQueueOutputWithQueue:(AudioQueueRef)audioQueue
queueBuffer:(AudioQueueBufferRef)audioQueueBuffer;
- (UInt32)readPacketsIntoBuffer:(AudioQueueBufferRef)buffer;
// 回呼函式
static void BufferCallback(void *inUserData, AudioQueueRef inAQ,
AudioQueueBufferRef buffer);
@end
#import "playAudio.h"
// 實測發現 0x10000 對壓縮格式(mp3/aac)沒有問題,
// 但若輸入是 wav,會出現播放幾秒就暫停的現象。
// 手機不可能申請更大的記憶體去處理整份 wav,這點還請先進指教。
static UInt32 gBufferSizeBytes = 0x10000; // 必須是 2 的次方
@implementation playAudio
@synthesize queue;
// 回呼函式
static void BufferCallback(void *inUserData, AudioQueueRef inAQ,
AudioQueueBufferRef buffer) {
playAudio *player = (__bridge playAudio *)inUserData;
[player audioQueueOutputWithQueue:inAQ queueBuffer:buffer];
}
// 緩衝區讀取
- (void)audioQueueOutputWithQueue:(AudioQueueRef)audioQueue
queueBuffer:(AudioQueueBufferRef)audioQueueBuffer {
OSStatus status;
UInt32 numBytes;
UInt32 numPackets = numPacketsToRead;
status = AudioFileReadPackets(audioFile, NO, &numBytes, packetDescs,
packetIndex, &numPackets,
audioQueueBuffer->mAudioData);
if (numPackets > 0) {
audioQueueBuffer->mAudioDataByteSize = numBytes;
status = AudioQueueEnqueueBuffer(audioQueue, audioQueueBuffer,
numPackets, packetDescs);
packetIndex += numPackets;
}
}
// 初始化並開始播放
// 用法:
// self.audio = [[playAudio alloc] initWithAudio:@"/path/to/daolang.mp3"];
- (id)initWithAudio:(NSString *)path {
if (!(self = [super init])) return nil;
UInt32 size, maxPacketSize;
char *cookie;
int i;
OSStatus status;
// 開啟音訊檔
status = AudioFileOpenURL((CFURLRef)[NSURL fileURLWithPath:path],
kAudioFileReadPermission, 0, &audioFile);
if (status != noErr) {
NSLog(@"*** Error *** could not open audio file. Path: %@", path);
return nil;
}
// 取得音訊格式
size = sizeof(dataFormat);
AudioFileGetProperty(audioFile, kAudioFilePropertyDataFormat,
&size, &dataFormat);
// 建立播放用佇列
AudioQueueNewOutput(&dataFormat, BufferCallback, self,
nil, nil, 0, &queue);
for (int i = 0; i < NUM_BUFFERS; i++) {
AudioQueueEnqueueBuffer(queue, buffers[i], 0, nil);
}
// 計算每次要讀多少個 packet
if (dataFormat.mBytesPerPacket == 0 || dataFormat.mFramesPerPacket == 0) {
size = sizeof(maxPacketSize);
AudioFileGetProperty(audioFile, kAudioFilePropertyPacketSizeUpperBound,
&size, &maxPacketSize);
if (maxPacketSize > gBufferSizeBytes) {
maxPacketSize = gBufferSizeBytes;
}
numPacketsToRead = gBufferSizeBytes / maxPacketSize;
packetDescs = malloc(sizeof(AudioStreamPacketDescription)
* numPacketsToRead);
} else {
numPacketsToRead = gBufferSizeBytes / dataFormat.mBytesPerPacket;
packetDescs = nil;
}
// 設定 Magic Cookie
AudioFileGetProperty(audioFile, kAudioFilePropertyMagicCookieData,
&size, nil);
if (size > 0) {
cookie = malloc(sizeof(char) * size);
AudioFileGetProperty(audioFile, kAudioFilePropertyMagicCookieData,
&size, cookie);
AudioQueueSetProperty(queue, kAudioQueueProperty_MagicCookie,
cookie, size);
}
// 建立並配置緩衝區
packetIndex = 0;
for (i = 0; i < NUM_BUFFERS; i++) {
AudioQueueAllocateBuffer(queue, gBufferSizeBytes, &buffers[i]);
if ([self readPacketsIntoBuffer:buffers[i]] == 1) {
break;
}
}
Float32 gain = 1.0;
AudioQueueSetParameter(queue, kAudioQueueParam_Volume, gain);
// 啟動佇列,此後系統會自動呼叫回呼
AudioQueueStart(queue, nil);
return self;
}
- (UInt32)readPacketsIntoBuffer:(AudioQueueBufferRef)buffer {
UInt32 numBytes, numPackets;
numPackets = numPacketsToRead;
AudioFileReadPackets(audioFile, NO, &numBytes, packetDescs,
packetIndex, &numPackets, buffer->mAudioData);
if (numPackets > 0) {
buffer->mAudioDataByteSize = numBytes;
AudioQueueEnqueueBuffer(queue, buffer,
(packetDescs ? numPackets : 0), packetDescs);
packetIndex += numPackets;
}
else {
return 1; // 沒有讀到任何 packet
}
return 0; // 0 代表正常結束
}
@end
整段程式可以拆成四個階段理解:開檔(AudioFileOpenURL)→ 取格式並建佇列(AudioFileGetProperty 搭配 AudioQueueNewOutput)→ 配置緩衝區並預先填入資料(AudioQueueAllocateBuffer 與 readPacketsIntoBuffer:)→ 啟動(AudioQueueStart)。啟動之後就不用再主動餵資料,AudioQueue 會在該補充時呼叫回呼,由回呼再讀檔、再 enqueue,形成一個自走的循環。
這裡有個順序上很關鍵的細節:必須先呼叫 AudioQueueNewOutput 建立 queue,之後 AudioQueueEnqueueBuffer 才有意義。本文初稿曾把排入空緩衝區的迴圈放在建立佇列之前,實際上會失效,上面已調整為正確順序。
Magic Cookie 那一段則是給需要額外設定資訊的格式使用,並非每個檔案都有;size > 0 的判斷就是為了跳過不需要的情況。
以上只是最樸素的「用 AudioQueue 播放音訊檔」示範,程式寫得精簡,應該不難理解。如果有朋友需要完整專案,我可以把原始碼整理後放上來。這個工程本身並不複雜,動手做一遍印象會深很多。
原始碼下載:https://up.2cto.com/2012/0406/20120406032317286.zip
摘自 xuanyuanchen