wingu-ios-sdk-essentials
Wingu SDK Essentials 是一款用于管理在 wingu 上配置的触发器的 iOS SDK。它可以扫描信标并找到已经附加了内容的地理围栏。
Wingu Essentials 以预编译形式 .framework
提供给您。它使用 Swift 4.2.1 编写。
目录
安装
CocoaPods
wingu-ios-sdk-essentials 通过 CocoaPods 提供。要安装它,请在您的 Podfile 中添加以下行
pod 'wingu-ios-sdk-essentials'
Carthage
Carthage是一个简单的、去中心化的用于Cocoa的依赖管理器。
可以使用Cartfile
中的binary
选项下载库的版本。请在Cartfile
中添加此行
binary "https://raw.githubusercontent.com/wingu-GmbH/wingu-ios-sdk-essentials/master/wingu-ios-sdk-essentials.json"
手动安装
将此存储库中的winguSDKEssential.framework
文件复制到您的项目。
要求
运行应用程序和处理wingu通道需要位置权限。将以下密钥添加到您的Info.plist
文件
NSLocationAlwaysAndWhenInUseUsageDescription
NSLocationWhenInUseUsageDescription
快速入门指南
本指南展示了如何使用默认配置获取触发回调。您可以在扫描器中始终添加一些自定义参数。有关所有可用配置,请参阅我们的完整文档。根据使用案例,您可能只需在单个模型或整个应用程序中添加winguLocations
。
我们建议仅创建一个winguLocations
的单实例
lazy var wingu: WinguLocations = {
let wingu: WinguLocations = WinguLocations(configuration: WinguConfiguration.defaultConfiguration)
wingu.delegate = self
return wingu
}()
您的类应遵守WinguLocationsDelegate
协议,并在该协议中您将从wingu触发收到所有代理回调
extension YourClass: WinguLocationsDelegate {
func winguChannels(_ channels: [Channel]) {
// your code here
}
}
WinguLocationsDelegate
要求仅实现一个方法以获取触发,但您可以通过完整文档。此必需回调为
Channel
是所有wingu触发的默认类。该方法将返回范围内可用的通道列表,每当某个触发器超出范围或扫描器发现一个新触发器时,该方法也将被调用。
您可以通过调用以下方法开始广播信标
wingu.start()
查看示例项目以了解更多信息。
开始使用的最快方法是使用上述代码。示例中的
apiKey
已存在。如果您想开始接收地理围栏,请从Xcode中预定义的位置选择San Francisco, CA, USA
,您将获得附带默认配置的内容。
文档
文档可在 此处 或通过您的集成开发环境获得。
许可协议
wingu-ios-sdk-essentials
以 Apache-2.0 许可协议提供。更多信息请参阅 LICENSE 文件。