7digital SDK for iOS

简介

7digital iOS SDK帮助您将音乐功能添加到您的应用程序。通过集成SDK，您可以在自己的应用程序中下载和流式传输7digital音乐。

要求

7digital SDK要求iOS 7.0或更高版本，并且需要libxml2库来运行。

入门

1. SevenDigital可通过CocoaPods获得，要安装它，请只需将以下行添加到您的Podfile中

   pod "SevenDigital"

2. 在https://api-signup.7digital.com注册为开发者以获取密钥和秘密

   克隆包含示例应用程序的仓库

3. 要运行示例项目，克隆仓库，然后从示例目录运行pod install。

4. 将[您的消费者密钥]和[您的秘密]替换为您自己的密钥和秘密。

其他集成

1. 将文件添加到您的项目中

   1. 下载所有项目文件
   2. 将Classes/文件夹中的文件拖到您的项目中
   3. 将libSevenDigital.a文件拖到您的项目中

2. 验证libSevenDigital.a是否已添加到您的目标的"Link Binary with Libraries"构建阶段

   1. 转到您的项目->目标->构建阶段->链接二进制库
   2. 如果它不在列表中，按"+"符号添加新的框架
   3. 找到libSevenDigital.a并点击'添加'

3. 使用与步骤2相同的步骤将libxml2.dylib添加到您的"Link Binaries With Libraries"构建阶段

4. 在您的项目目标的构建设置中，向其他链接器标志添加-ObjC

5. 在https://api-signup.7digital.com获取您的应用凭据

6. 在您的应用程序代理中

   1. 导入SevenDigital

      #import "SevenDigital.h"
      

   2. 在您的应用程序中：didFinishLaunchingWithOptions: 调用中使用您的应用程序凭据启动SevenDigital库

      [SevenDigital initializeWithConsumerKey:@"[Your Consumer Key]" andSecret:@"[Your Secret]"];
      

7. 许多7digital API方法需要用户登录。在www.7digital.com创建您自己的7digital帐户

登录用户

1. 使用webView登录用户

   [[SevenDigital sharedInstance] presentLoginWebViewFromView:self];
   

编写通用请求

示例应用程序展示了您如何使用一些封装类来查询locker API。对于对7digital API的任何其他调用，您可以遵循以下模式：

1. 创建一个请求对象

   SDAPIRequest *chartRequest = [[SDAPIRequest alloc] initWithPath:@"/release/chart" 
                                                                 method:SDHTTPMethodGet 
                                                                 params:@{@"country":@"GB"}];
   

2. 调用performRequest:onSuccess:onFailure方法

   [[SevenDigital sharedInstance] performRequest:chartRequest onSuccess:^(SDAPIResponse *apiResponse) {
       NSDictionary *responseDictionary = apiResponse.responseItem;
       NSLog(@"successful call %@", responseDictionary);
   } onFailure:^(NSError *error) {
       NSLog(@"failure %@", error);
   }];
   

请求预览音轨

1. 为了请求预览音轨，您可能需要类似以下的代码：

   SDTrack *track = [self.sdRelease.tracks objectAtIndex:indexPath.row];
   NSURL *preview = [SDMedia previewURLForTrack:track];
   // play the track
   [self playURL:preview];
   
   - (void)playURL:(NSURL *)url {
       AVPlayer *player = [[AVPlayer alloc] initWithURL:url];
       self.songPlayer = player;
       [[NSNotificationCenter defaultCenter] addObserver:self
                                                selector:@selector(playerItemDidReachEnd:)
                                                    name:AVPlayerItemDidPlayToEndTimeNotification
                                                  object:[self.songPlayer currentItem]];
       [self.songPlayer addObserver:self forKeyPath:@"status" options:0 context:nil];
   };
   

要了解更多有关可用调用和所需参数的信息，您可以在以下位置找到文档：http://developer.7digital.com/resources/api-docs/introduction

这些调用的文档可在XCode 5的快速帮助中找到

关于7digital API

7digital API为开发者提供访问超过2500万首授权音乐的7digital服务和目录的权限，从而可以创建了从简单的音乐发现网站到完全集成的下载商店或完整长度流媒体服务的各种新音乐应用。

7digital API的大部分内容对所有人开放，并免费供非商业使用（有使用限制）。API的商业/业务使用需要与7digital签订合同。

更多信息请查看：http://developer.7digital.com/resources/api-docs/introduction

关于7digital

7digital是世界上领先的开放音乐平台，并为最广泛授权的、高质量数字音乐目录提供开放访问。我们为全球的消费者、开发商和广泛的合作伙伴提供全面的数字音乐服务。关于7digital的更多信息

支持

访问7digital API Google群组，获取其他开发者的技巧、问题和评论。

许可

7digital在Apache许可证下可用。有关更多信息，请参阅LICENSE文件。