Use GraceNote SDK in iOS(二)获取音乐的完整信息

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


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

SDK的下载地址:Mobile Client

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

下载解压后,新建一个工程,添加GracenoteMusicID.framework到工程中:Use GraceNote SDK in iOS(二)获取音乐的完整信息


新建一个头文件GraceNote.h,导入该框架中的头文件(在本工程中已经导入全部需要使用到的头文件了):

#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

然后配置工程环境,依次在Build Phases中加入下列系统库文件:

Use GraceNote SDK in iOS(二)获取音乐的完整信息


配置完成。


其实这个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:方法中获取服务器返回的数据,从中剥离出我们需要的信息。但是,非常奇怪的是,对于返回结果中的每一个GNSearchResponse对象,其AlbumCoverArt均为nil。如下图所示,注意是10个对象中的每一个对象的m_coverArt的值都是nil。Use GraceNote SDK in iOS(二)获取音乐的完整信息


替代的方法是,记录下GNSearchResponse对象的Id信息,然后通过AlbumId发起二次请求,从服务器中获取完整的专辑信息(这样做确实不好,但是目前我只找到这个解决方法)

#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];
    }
}


上几张运行结果图:

Use GraceNote SDK in iOS(二)获取音乐的完整信息Use GraceNote SDK in iOS(二)获取音乐的完整信息Use GraceNote SDK in iOS(二)获取音乐的完整信息


这个Demo通过音乐名/专辑名/艺术家获取到专辑封面,歌曲风格,完整的歌曲名,完整的艺术家列表,歌曲风格,发行信息等相对较为完整的信息,重点是拿到了专辑的封面。真机调试过,没什么问题,看来我可以交差了。


完整的代码我就不贴出来了,有兴趣的下载Demo看看。

说明:由于GraceNote的SDK有71M,在Demo中我将其移除,因此Demo是无法运行的。请自行到GraceNote网站中下载GraceNoteMusicID.framework并添加到工程中。




Use GraceNote SDK in iOS(二)获取音乐的完整信息,布布扣,bubuko.com

Use GraceNote SDK in iOS(二)获取音乐的完整信息

上一篇:Android APP打包错误,Could not resolve com.android.tools.lint:lint-gradle:26.1.2.


下一篇:Safe Area Layout Guide before iOS9.0