Use GraceNote SDK in iOS（二）获取音乐的完整信息

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

在需求彻底明朗化，外加从MusicFans转到GraceNote，再从GraceNote的GNSDK转到iOS SDK后，最终完毕了在iOS上通过音乐的部分信息获取完整信息的功能了。（好吧，我承认是相对完整。。。）

首先介绍下在项目中配置GraceNote的iOS SDK。

SDK的下载地址：Mobile Client

注意要先登录才干见到文件的下载链接。另外官网还给出来一个SDK的配置文档，全然跟着走在Xcode 5是走不通的，只是也具有一定的指导作用，建议看一看。

下载解压后，新建一个project，加入GracenoteMusicID.framework到project中：

新建一个头文件GraceNote.h，导入该框架中的头文件（在本project中已经导入所有须要使用到的头文件了）：

#ifndef MFDemo_iOS_GraceNote_h
#define MFDemo_iOS_GraceNote_h#import <GracenoteMusicID/GNConfig.h>
#import <GracenoteMusicID/GNOperations.h>
#import <GracenoteMusicID/GNSearchResultReady.h>
#import <GracenoteMusicID/GNSearchResponse.h>
#import <GracenoteMusicID/GNSearchResult.h>
#import <GracenoteMusicID/GNImage.h>
#import <GracenoteMusicID/GNCoverArt.h>
#import <GracenoteMusicID/GNDescriptor.h>#endif

然后配置project环境，依次在Build Phases中增加下列系统库文件：

配置完毕。

事实上这个SDK的使用很的简单。

第一步，通过你的GraceNote帐号配置GNConfig类（我直接放在了AppDelegate中，这样能够配置能够全局使用）：

#import <UIKit/UIKit.h>
#import <GracenoteMusicID/GNConfig.h>@interface AppDelegate : UIResponder <UIApplicationDelegate>@property (strong, nonatomic) UIWindow *window;@property (retain, nonatomic) GNConfig *app_gnConfig;@end

#import "AppDelegate.h"static NSString * kClientID = @"4541440-79EFBF4E21724D084BA87FF9B242F0C9";
static NSString * kCoverArtProperty = @"content.coverArt";
static NSString * kCoverArtSizeProperty = @"content.coverArt.sizePreference";
static NSString * kYESBooleanString = @"1";
static NSString * kCoverArtSizeLarge = @"LARGE";
static NSString * kCoverArtSizeThumbnail = @"THUMBNAIL";
static NSString * kCoverArtSizeSmall = @"SMALL";@implementation AppDelegate
@synthesize app_gnConfig = _app_gnConfig;- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
self.app_gnConfig = [GNConfig init:kClientID]; // <Client ID>-<Client ID Tag>
[_app_gnConfig setProperty:kCoverArtProperty value:kYESBooleanString];
[_app_gnConfig setProperty:kCoverArtSizeProperty value:kCoverArtSizeThumbnail]; return YES;
}

client id就是申请应用时的ID，不清楚的能够參考Use GraceNote SDK in iOS（一）通过序列化的GDO查询专辑封面。然后设置content.coverArt属性打开，否则返回的数据中将不会有专辑封面。

第二步，通过以下的方法发起查询请求：

+ (void) searchByText:(id<GNSearchResultReady>)resultReady
config:(GNConfig*)config
artist:(NSString*)artist
albumTitle:(NSString*)albumTitle
trackTitle:(NSString*)trackTitle;

在Demo中，就是一个Button中的方法：

- (IBAction)check:(id)sender {
[_checking_activityIndicator startAnimating];
self.view.alpha = 0.75;
self.view.userInteractionEnabled = NO;
[GNOperations searchByText:self
config:((AppDelegate *)[[UIApplication sharedApplication] delegate]).app_gnConfig
artist:_artist_textField.text
albumTitle:_album_textField.text
trackTitle:_trackTitle_textField.text];
}

注意resultReady參数设置为一个遵守GNSearchResultReady协议的对象，也就是self。

config參数设置为全局的配置。

artist，albumTitle，trackTitle分别为艺术家，专辑名称，音乐名等，这些是搜索的Key，三个參数最多能够缺省两个。

第三步，在查询成功后，我们能够从GNResultReady:方法中获取server返回的数据，从中剥离出我们须要的信息。可是，很奇怪的是，对于返回结果中的每个GNSearchResponse对象，其AlbumCoverArt均为nil。例如以下图所看到的，注意是10个对象中的每个对象的m_coverArt的值都是nil。

替代的方法是，记录下GNSearchResponse对象的Id信息，然后通过AlbumId发起二次请求，从server中获取完整的专辑信息（这样做确实不好，可是眼下我仅仅找到这个解决方法）

#pragma mark - GNSearchResultReady Protocol- (void)GNResultReady:(GNSearchResult *)result
{
NSArray *responses = [result responses];
if (!responses || !responses.count) {
[[[UIAlertView alloc] initWithTitle:@"对不起" message:@"没有找到不论什么匹配结果" delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil, nil] show];
[_checking_activityIndicator stopAnimating];
self.view.userInteractionEnabled = YES;
self.view.alpha = 1.0;
_check_button.hidden = NO;
return;
} [_albumIDArray removeAllObjects]; int i = 0;
for (GNSearchResponse *resp in responses) {
if (i == 10) {
break;
} NSString *albumID = resp.albumId;
if (albumID) {
[_albumIDArray addObject:albumID];
i++;
}
} if (!_albumIDArray.count) {
[[[UIAlertView alloc] initWithTitle:@"对不起" message:@"没有找到不论什么匹配结果" delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil, nil] show];
return;
}
else {
[self performSegueWithIdentifier:@"check_segue" sender:self];
[_checking_activityIndicator stopAnimating];
self.view.userInteractionEnabled = YES;
self.view.alpha = 1.0;
_check_button.hidden = NO;
}
}

在下一个视图中通过AlbumID发起二次请求：

- (void)getAlbumLists {
[_albumInfo removeAllObjects]; for (NSString *album_id in _albumIDs) {
[GNOperations fetchByAlbumId:self
config:((AppDelegate *)[[UIApplication sharedApplication] delegate]).app_gnConfig
albumId:album_id];
}
}

上几张执行结果图：