您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iPhone 用 AudioQueue 播放音檔(mp3、aac、caf、wav)

編輯:iOS 開發綜合

最近在做 iPhone 上的流媒體播放,需要能把音訊串流放出去。參考了不少文章與論壇討論,最後總算把這個相對棘手的問題搞定,於是整理出來分享。

這一篇聚焦在「播放音訊檔案」。至於如何用 AudioQueue 播放 raw PCM data,我會另開一篇寫——那大概是多數 iOS 開發者更需要、也更難的部分。一個人的力量有限,能少走一點彎路就少走一點吧。

一、playAudio.h:把狀態宣告清楚

//
//  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

二、playAudio.m:實作

#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

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved