BillboardSwiftLibrary
基本用法
要下载 Billboard 排行榜首,我们使用 BillboardManager 构造函数。
让我们获取当前的热门 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
}
示例
要运行示例项目,请克隆仓库,然后首先从 Example 目录运行 pod install
。
系统要求
- iOS 9.0+ / OSX 10.10+
- Swift 4.0+
安装
Cocoa Pods
安装方法,只需将以下行添加到您的 Podfile
pod 'BillboardSwiftLibrary'
Swift Package Manager
在您的 Package.swift
中添加 BillboardSwiftLibrary
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
– 轨迹是否为图表中新加入的。
贡献
欢迎提出拉取请求!
认为找到了一个错误吗?在这里创建一个问题 这里。
基于 Allen Guo 开发的 Billboard.py
作者
Fitzafful, [email protected]
许可证
BillboardSwiftLibrary遵守MIT许可证。更多详情请参阅LICENSE文件。