GiphySwift 1.0.1
- 由
- Matias Seijas
- mseijas_
GiphySwift
GiphySwift 允许您在 iOS 上与 Giphy API 交互
使用方法
配置
您需要将 GiphySwift 配置为使用您的 Giphy API 密钥。为了将应用程序发布到生产环境，您需要从 Giphy 获取生产密钥。有关如何获取的信息，请参阅此处。
开发
开发目的您可以使用 Giphy 的公共测试版密钥
Giphy.configure(with: .publicKey)生产
生产目的您需要指定您的私有访问密钥
Giphy.configure(with: .private(key: "dc6zaTOxFJmzC"))请求 Gifs
您可以通过五个不同的端点来请求 Gifs
关于 Giphy 的端点的更多信息，请参阅这里。
请求结果
所有 GiphySwift 请求都返回一个 GiphyResult 枚举，它将指示请求是否成功，封装响应数据或抛出的任何错误
public enum GiphyResult<T> {
case success(result: T, properties: GiphyResultProperties?)
case error(_: Error)
}趋势
使用以下命令检索趋势 Gifs
Giphy.Gif.request(.trending) { result in
switch result {
case .success(result: let gifs, properties: let paginationProperties):
// DO SOMETHING WITH RESULTS
displayTableView(with: gifs)
case .error(let error):
print(error)
}
}搜索
使用以下命令搜索 Gifs
Giphy.Gif.request(.search("cats")) { result in
switch result {
case .success(result: let gifs, properties: _):
// DO SOMETHING WITH RESULTS
displayTableView(with: gifs)
case .error(let error):
print(error)
}
}翻译
使用以下命令将文本转换为 Gifs
Giphy.Gif.request(.translate("hello")) { result in
switch result {
case .success(result: let gifs, properties: _):
// DO SOMETHING WITH RESULTS
displayTableView(with: gifs)
case .error(let error):
print(error)
}
}按 ID
您可以通过传递单个 Gif ID 作为 String 或传递 ID 数组来检索 Gifs。
Giphy.Gif.request(.withId("3o7qDPfGhunRMZikI8")) { result in
switch result {
case .success(result: let gifs, properties: _):
// DO SOMETHING WITH RESULTS
displayTableView(with: gifs)
case .error(let error):
print(error)
}
}随机
使用以下命令请求随机Gif。您可以可选地提交一个标签作为搜索字符串，限制您的随机结果为特定的查询。
Giphy.Gif.request(.random(tag: "superstar")) { result in
switch result {
case .success(result: let gifs, properties: _):
// DO SOMETHING WITH RESULTS
displayTableView(with: gifs)
case .error(let error):
print(error)
}
}请求表情符号
通过以下四个不同的端点可以请求表情符号
- 趋势
- 搜索
- 翻译
- 随机
关于 Giphy 的端点的更多信息，请参阅这里。
要请求表情符号，使用与请求Gif相同的命令，但是指定Sticker端点。
例如
Giphy.Sticker.request(.trending) { result in
switch result {
case .success(result: let gifs, properties: let paginationProperties):
// DO SOMETHING WITH RESULTS
displayTableView(with: gifs)
case .error(let error):
print(error)
}
}作者
Matias Seijas
邮箱: [email protected]
网站: mseijas.com
Twitter: @mseijas_
许可证
GiphySwift在MIT许可证下可用。查看LICENSE文件以获取更多信息。