警告：这是 Spotify iOS SDK 的 beta 版本，任何时间都可能会停止工作。该 SDK 版本不适用于公开发布的应用程序。

Spotify iOS SDK 自述文件

欢迎使用 Spotify iOS SDK! 本自述文件是为那些希望开发包含 Spotify 相关功能（如音频流、播放列表操作、搜索等）的 iOS 应用程序的人编写的。

SDK 的使用受 Libspotify 使用条款 的约束。

beta 版本信息

我们提前发布此 SDK 以从开发者社区获取有关我们 iOS SDK 将来的反馈。请在我们的 问题跟踪器 中提交关于缺失问题或错误的反馈，确保查找现有的问题，并且为这些问题添加您的声音，而不是重复它们。

有关已知问题和发布说明，请参阅 CHANGELOG.md 文件。

重要：此 SDK 是预发布软件，不受支持，不得将其分发给最终用户。它 将 在未来停止工作。

OAuth/SPTAuth 凭据

对于 beta 版本，请使用以下 OAuth 凭据

• 客户端 ID：spotify-ios-sdk-beta
• 客户端回调 URL：spotify-ios-sdk-beta://callback、spotify-ios-sdk-beta-alternate://callback 或 spotify-ios-sdk-beta-alternate-2://callback
• 客户端密钥：ba95c775e4b39b8d60b27bcfced57ba473c10046

当 beta 期结束时，这些凭据将不再有效。届时，您将能够请求未来使用自己的个人凭据。

入门

将 Spotify iOS SDK 引入您的应用程序非常简单

1. 将 Spotify.framework 库添加到您的 Xcode 项目中。
2. 将 -ObjC 标志添加到项目的“其他链接器标志”构建设置中。
3. 将 AVFoundation.framework 添加到项目的“链接二进制与库”构建阶段中。
4. 在源文件中导入 #import <Spotify/Spotify.h> 并开始使用！

库的头文件有详细的文档，并提供了一个 Xcode 文档集，可以由 Xcode 本身以及其他的应用程序（如 Dash）索引。这，连同提供的示例项目，应该能为您提供开始所需的一切。可以帮助您开始的类包括：

• SPTAuth 包含用户认证的方法。请参阅“基本身份验证”示例项目以查看工作示例。

  注意：要进行音频播放，您必须在使用 SPTAuth 时请求 login 范围。为此，将包含字符串 @"login" 的数组传递到 -loginURLForClientId:declaredRedirectURL:scopes:。提供的示例项目已经这样做了。

• SPTRequest 包含了搜索、获取播放列表和进行元数据查找的方法。大多数元数据类（如 SPTTrack、SPTArtist、SPTAlbum 等）也包含便捷方法。

• SPTTrackPlayer 是一个用于播放曲目提供者的类（目前为 SPTAlbum 和 SPTPlaylist），并提供基本的播放控制。如果需要更直接的访问音频流，SPTAudioStreamingController 提供了这样的功能。

从 CocoaLibSpotify 迁移

CocoaLibSpotify 基于libspotify库，该库包含了大量遗留代码，是一个非常复杂的库。虽然这提供了大量的功能，但它也可能消耗大量的RAM和CPU资源，这对移动平台来说并不理想。

Spotify iOS SDK 基于全新的技术栈，旨在避免这些问题，同时仍然提供丰富的功能集。由于这种新架构，我们决定从零开始构建 Spotify iOS SDK 的 API，而不是试图将新技术塞入 CocoaLibSpotify 的 API。这使得库的易用性大大提高，与 CocoaLibSpotify 相比，CPU和RAM的使用量也大幅度减少。

Spotify iOS API 与 CocoaLibSpotify 并不完全一致。它包含了一些 CocoaLibSpotify 没有的功能，而 CocoaLibSpotify 也有一些 Spotify iOS SDK 没有的功能。我们正努力缩小这个差距，如果您在 Spotify iOS SDK 中发现缺少的某些功能对您非常重要，请与我们联系，以便我们正确地优先考虑这些问题。

由于 CocoaLibSpotify 和 Spotify iOS SDK 在 API 和特性上的差异，我们理解迁移可能很难。因此，在 SDK 离开测试状态后，CocoaLibSpotify 将保留一段合理的时间。