要下载 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 文件。