ios-sdk

此代码库包含 MixRadio iOS SDK。

版本

0.9.5

概述

MixRadio iOS SDK 允许您轻松地将您的 iOS 应用整合到 MixRadio 中。

SDK 允许您在应用程序中执行搜索，获取排行榜和推荐以及用户数据，如播放历史记录。您可以通过 MixRadio 应用链接到全部的收听体验。

安装

您需要两个东西开始使用 SDK

1. SDK 本身 - 您可以从 GitHub 克隆我们的源代码或使用 CocoaPods，一个自动化和简化在您的项目中使用第三方库的依赖项管理器。有关更多信息，请参阅 CocaPods 的 入门指南 和 使用指南。

   1.1 下载 CocoaPods

   CocoaPods 作为 ruby gem 分发，可以通过在终端运行以下命令安装：

   $ sudo gem install cocoapods
   $ pod setup
   

   1.2 创建 Podfile

   CocoaPods 管理的依赖项在名为 Podfile 的文件中指定。在您的 Xcode 项目文件（.xcodeproj）所在的目录中创建此文件。

   $ touch Podfile
   $ open -a Xcode Podfile
   

   复制并粘贴以下行：

   pod 'MixRadio'
   

   1.3 安装依赖项

   现在您可以安装项目中的依赖项了。

   $ pod install
   

   从现在开始，在构建项目时，请务必始终使用生成的 Xcode 工作空间（.xcworkspace）而不是项目文件。

2. 凭据 - 访问我们的 API 注册页面 并请求您的凭据。

快速入门

迫不及待要开始？请查看 快速入门指南。

源许可协议

MixRadio iOS SDK 源代码在 3-clause 许可协议（“新 BSD 许可协议”或“修改型 BSD 许可协议”）下发布 - 请参阅 https://raw.github.com/mixradio/ios-sdk/master/LICENSE.txt。

条款

SDK 的使用受以下条款约束： http://dev.mixrad.io/terms.html

版本发布

• 0.9.5 更正了 mixRadioId 类型，增强了 BandsAround 例子
• 0.9.4 修复了用户身份验证和 getUserPlayHistory 的实现
• 0.9.2 SDK 的初始发布

文档

本组件的文档位于 http://dev.mixrad.io/doc/iossdk

元数据方法

您可以在应用中获取的数据示例

• 搜索内容
• 获取顶级艺术家
• 获取排行榜
• 获取新发布
• 获取流派列表
• 获取艺术家旗下专辑和歌曲
• 获取艺术家推荐
• 获取可用混音列表

用户数据API方法

您可以访问的用户数据示例（前提是用户已授权您的应用！）

• 读取用户的播放历史
• 读取用户的最爱艺术家
• 读取用户的最近混音

贡献

如果您想为项目贡献力量，请查看问题标签。

您可以

• 提出一个问题
• 为应用建议一个特性

想要编写代码吗？为什么不更进一步呢

• 从仓库分叉
• 对代码库进行更改
• 满意后发送拉取请求

团队将对更改进行审查，讨论是否需要解决任何问题，并将您的更改集成到应用中。

反馈

如果您的建议，可以在我们的MixRadio API 用户之声告诉我们。