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

在 iOS 中使用 MusicBrainz:從環境配置到第一個查詢 Demo

編輯:iOS 開發綜合

這陣子工作比較忙,很多想法都先記在筆記裡,遲遲沒有整理成文章。直到最近接到一個需求:在 iOS 中呼叫 MusicBrainz,取得歌曲、歌手與專輯等完整資訊。趁著把環境跑通,我把整個流程整理出來,希望讓大家少踩一點坑。

MusicBrainz 是什麼?

MusicBrainz 可以把它理解成音樂領域的開放百科資料庫。只要提供歌曲名、歌手、發行時間等片段線索,就有機會查到更完整的作品資料。對喜歡音樂、又希望把媒體資訊整理乾淨的人來說,是很實用的服務。

1. 從 GitHub 下載 MusicBrainz-objc

建議使用 git clone 下載 MusicBrainz-objc,而不是直接下載 ZIP。因為後續編譯會用到子模組與 shell script,若缺少 git 資訊,容易出現找不到 submodule 或腳本執行失敗的問題。

2. 編譯靜態庫與標頭檔

打開工程後,選擇 libmusicbrainz-iphoneos scheme 並執行 Build。若曾經用 ZIP 解壓而導致腳本出錯,可以先執行 Clean,再重新建置。

建置成功後,可以在 Products 中透過 Show in Finder 找到輸出的靜態庫與標頭檔。

3. 將庫加入新專案

建立 MusicBrainzDemo 專案,把 Debug-iphoneos 或 Debug-iphonesimulator 下的 .a 檔案與 Headers 複製到 MusicBrainzDemo/MusicBrainzDemo 目錄。若沒有放在預期路徑,就必須另行設定 Header Search Paths。

4. 設定 Build Settings

在 Build Settings 中搜尋 Header Search Paths,加入 $(SDKROOT)/usr/include/libxml2,讓編譯器能找到 libxml2 的標頭檔。

由於類庫中有自行定義的 Category,也需要在 Other Linker Flags 加入 -all_load,否則可能出現方法找不到的錯誤。

5. 加入所需的 Framework

最後在 Build Phases 中補上所需的函式庫與 framework。完成後,MusicBrainz 類庫就可以在專案中使用。

6. 撰寫測試程式

以下範例透過 MBID 查詢藝術家資料,並在成功回呼中印出名稱。

#import "ViewController.h"
#import "MB.h"

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    MBConnection *conn = [MBConnection connection];
    MBRequest *req = [MBRequest lookupWithEntity:MBEntityArtist
                                            mbid:@"86119d30-d930-4e65-a97a-e31e22388166"
                                    incParameters:(MBIncParameterArtistRels | MBIncParameterReleaseGroups)];

    void (^successBlock)(MBRequest *, MBMetadata *) = ^(MBRequest *request, MBMetadata *metadata) {
        NSLog(@"%@", metadata.Artist.Name);
    };

    void (^failureBlock)(MBRequest *, NSError *, NSData *) = ^(MBRequest *request, NSError *error, NSData *data) {
        NSLog(@"Error: %@", error);
    };

    [conn enqueueRequest:req onSuccess:successBlock onFailure:failureBlock];
}

@end

執行後,主控台會顯示請求流程與查詢結果。這個 Demo 雖然簡單,但已足以驗證網路請求、資料解析與回呼設計是否正確。

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