ScrobbleKit

ScrobbleKit 是一个现代 Swift 库，旨在简化在 Apple 平台上与 Last.fm API 的交互。它为您的 Swift 应用程序提供了一个简洁的、基于 async/await 的接口，以实现无缝集成。

入门指南

要开始使用 ScrobbleKit，您需要通过提供您的 Last.fm 的 API 密钥和 Secret 密钥来创建 SBKManager 的实例。

import ScrobbleKit

let manager = SBKManager(apiKey: "YOUR_API_KEY", secret: "YOUR_SECRET_KEY")

用法

ScrobbleKit 为所有 API 方法支持 async/await。以下是如何获取专辑信息的示例

do {
    let album = try await manager.getInfo(forAlbum: .albumArtist(album: "Random Access Memories",
                                                                 artist: "Daft Punk"))
    print("Album name: \(album.name)")
    print("Artist: \(album.artist)")
    print("Tracks: \(album.tracklist.count)")
} catch {
    print("Error fetching album info: \(error)")
}

身份验证

对于需要身份验证的方法，您需要启动一个会话

do {
    let session = try await manager.startSession(username: "YOUR_USERNAME", password: "YOUR_PASSWORD")
    print("Authenticated as: \(session.name)")
} catch {
    print("Authentication failed: \(error)")
}

文档

有关所有可用 API 方法和模型的详细信息，请查看完整文档。

系统要求

iOS 13.0+
macOS 10.15+
watchOS 6.0+
tvOS 13.0+
Swift 5.5+

安装

Swift Package Manager

将以下内容添加到您的 Package.swift 文件中

dependencies: [
    .package(url: "https://github.com/tfmart/ScrobbleKit.git", from: "0.1.0")
]

或者在 Xcode 中使用“File” > “Add Packages” > “Search or Enter Package URL” 直接添加。

贡献

欢迎为 ScrobbleKit 做出贡献！请随时提交 Pull Request 或打开 Issue。

许可证

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