SoundcloudSDK

SoundcloudSDK是使用Swift编写的在Soundcloud API之上的框架。

安装

Swift 3.0

• CocoaPods: pod 'Soundcloud'
• Carthage: github "delannoyk/SoundcloudSDK"

Swift 2.3

• CocoaPods: pod 'Soundcloud', '~> 0.9.2'
• Carthage: github "delannoyk/SoundcloudSDK" == 0.9.2

配置

使用SDK的第一步是配置它以使用您的应用程序凭据

Soundcloud.clientIdentifier = "YOUR_CLIENT_IDENTIFIER"
Soundcloud.clientSecret  = "YOUR_CLIENT_SECRET"
Soundcloud.redirectURI = "YOUR_REDIRECT_URI"

之后，您就可以开始了。

使用方法

有关完整的使用方法，请参阅文档。

示例

您可以像这样搜索歌曲

let queries: [SearchQueryOptions] = [
    .QueryString("The text to search"),
    .Tags(["list", "of", "tags", "to", "search", "for"]),
    .Genres(["punk", "rock", "..."]),
    .Types([TrackType.Live, TrackType.Demo])
]
Track.search(queries, completion: PaginatedAPIResponse<Track> -> Void)

如果您的客户端已登录，您可以帮助他们收藏其中的歌曲，如下所示

let track: Track
track.favorite(userIdentifier: Int, completion: SimpleAPIResponse<Bool> -> Void)

示例应用

示例应用程序包含在source/SoundcloudAppTest中。请确保在AppDelegate中设置自己的SoundCloud应用值。

下一步

• 添加单元测试
• 分析是否需要降低播放文件的难度（集成音频播放器/依赖项？）

贡献

1. 分支它！
2. 创建您的功能分支：git checkout -b my-new-feature
3. 提交您的更改：git commit -am 'Add some feature'
4. 推送到分支：git push origin my-new-feature
5. 提交拉取请求 :D

许可协议

MIT许可协议 (MIT)

版权© 2015 Kevin Delannoy

本协议无偿授予任何获得本软件及其相关文档副本（以下简称“软件”）的个人以使用、复制、修改、合并、发布、分发、授权和/或销售软件副本的权利，并允许软件的受供人员从事上述行为，但必须遵守以下条件：

上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。

软件按“现状”提供，不提供任何类型的保证，无论是明示的还是暗示的，包括但不限于适销性、适用于特定目的和非侵权性。在任何情况下，作者或版权所有者不对任何索赔、损害或其他责任负责，无论这些索赔是基于合同、侵权或任何其他原因，是否由于软件或软件的使用或以任何其他方式产生。