要下载 Billboard 排行榜,我们使用 BillboardManager 构造函数。
让我们获取当前的 Hot 100 排行榜,以及特定日期的排行榜。
别忘了在你的 info.plist 文件中的 App Transport Security Settings 下设置 Allow Arbitrary Loads 为 YES
import BillboardSwiftLibrary
let manager = BillboardManager()
manager.getChart(chartType: ChartType.hot100) { (entries, error) in
if error != nil{
print(error!.localizedDescription)
return
}
print(entries!) //Array of ChartEntry
}
//FOR A PARTICULAR DATE (always remember date is in the form YYYY-MM-DD)
manager.getChart(chartType: ChartType.hot100, date: "2018-11-18") { (entries, error) in
if error != nil{
print(error!.localizedDescription)
return
}
print(entries!) //Array of ChartEntry
}
//FOR A PARTICULAR DATE (with individual date components)
manager.getChart(chartType: ChartType.hot100, day: 18, month: 11, year: 2018) { (entries, error) in
if error != nil{
print(error!.localizedDescription)
return
}
print(entries!) //Array of ChartEntry
}
要运行示例项目,请克隆 repo,并首先从 Example 目录运行 pod install。
要安装,只需将以下行添加到您的 Podfile 中
pod 'BillboardSwiftLibrary'
将 BillboardSwiftLibrary 添加到您的 Package.swift 中
import PackageDescription
let package = Package(
dependencies: [
package(url: "https://github.com/FitzAfful/BillboardSwiftLibrary.git", "0.1.2")
])
一个排行榜条目(通常是一首歌曲)的类型是 ChartEntry。一个 ChartEntry 实例具有以下属性
title – 歌曲的标题。artist – 艺术家的名字,按照 Billboard.com 上的格式。peakPos – 歌曲在任何时间点(包括未来日期)在排行榜上的最高位置,以整数表示(如果排行榜不包含此信息,则为 None)。lastPos – 歌曲在前一周排行榜上的位置,以整数表示(如果排行榜不包含此信息,则为 None)。 如果歌曲不在前一周的排行榜上,则此值为 0。weeks – 歌曲在排行榜上的周数,包括未来日期(直到目前时间)。rank – 歌曲在排行榜上的当前位置。isNew – 歌曲是否是新上榜的。欢迎提交 Pull Request!
认为你找到了一个 Bug? 在 这里 创建一个 issue。
基于 Allen Guo 的 Billboard.py
Fitzafful, fitzafful@gmail.com
BillboardSwiftLibrary 在 MIT 许可下可用。 有关更多信息,请参见 LICENSE 文件。