iTunesSearchAPI

用 Swift 编写的简单包装器，用于访问iTunes 搜索 API。

使用方法

基础

要使用 iTunes 搜索 API 包装器，您需要一个 iTunes 客户端。

iTunes(session: URLSession = URLSession.shared, debug: Bool = false)

当启用 debug 模式时，您将获得有关将被请求的 URL 的信息。

搜索

对于最基本搜索，您只需要提供一个搜索词和一个完成处理程序。搜索结果将以包含成功解码的 JSON 或 SearchError 的 Result 对象的方式传递。

itunes.search(for: "Castle") { result in
  // handle the Result<Any, SearchError>
}

指定媒体类型

寻找特定内容时，您可以添加指定的媒体类型。

itunes.search(for: "Castle", ofType: .tvShow(.tvSeason)) { result in
  // handle the Result<Any, SearchError>
}

每种 Media 类型都可以接受一个额外的参数，参数类型为 Entity。该实体参数指定了返回类型。在上面的示例中，我们只寻找电视剧 Castle 的电视季度。

查找

类似于搜索，您可以使用查找函数。查找函数需要一个 LookupType 和一个完成处理程序。

itunes.lookup(by: .id("12345")) { result in
  // handle the Result<Any, SearchError>
}

选项

search() 和 lookup() 都可以接受一个额外的参数类型为 Option。在那里，您可以指定信息，如 限制、语言 或 国家。

需求

• Swift 4.0
• iOS 8.4
• watchOS 2
• tvOS 9.0
• OSX 10.10

安装

手动

您也可以将指定目标手动添加到项目。

作者

由 @svenbacia 创建和维护

许可证

iTunesSearchAPI 在 MIT 许可下提供。有关更多信息，请参阅LICENSE 文件。