Kukushka_iOSSDK
Kukushka SDK 可以轻松地给玩家分配后会获得奖励的调查任务。SDK 可以在几分钟内进行安装和设置。
本版本针对 Unity 游戏引擎设计。SDK 的其他版本可在以下找到
- Android SDK 即将推出!
- Unity SDK
用法
只需创建 SurveyMaster
let master = SurveyMaster(
userId: String,
gameKey: String,
debugMode: Bool
)
现在您可以调用 Kykyshka SDK 的两个主要方法,用于预载并显示用户调查
master.hasSurvey() // To Check and Preload Available Survey for this user
master.showSurvey() // To Show Survey for user
SDK 回调
Kukushka SDK 为您的游戏提供许多不同的回调。使用这些回调来检测调查完成或加载问题。
回调 | 参数 | 用法 |
---|---|---|
OnSurveyStart | - | 当用户开始进行调查时调用 |
OnSurveyAvailable | - | 在预载后如果调查可用则调用 |
OnSurveyUnavailable | - | 在预载后如果调查不可用则调用 |
OnSurveySuccess | Bool 或 nil | 当用户完成调查时调用。可能包含其他数据。 |
OnFail | Any 或 nil | 当用户在调查中获得错误时调用。可能包含其他数据。 |
OnLoadFail | - | 当调查加载出错时调用 |
OnError | - | 在 SDK 一般错误回调上 |
回调示例
// Add Survey Callbacks
master?.onSurveyStart = { _ in
print("[ViewController] onSurveyStart")
}
master?.onSurveySuccess = { [weak self] nq in
guard let nq, nq else {
self?.statusLabel.text = "Последний опрос пройден успешно"
return
}
self?.statusLabel.text = "Пользователь не подошёл под целевую группу последнего опроса"
}
master?.onFail = { [weak self] _ in
self?.statusLabel.text = "Последний опрос не пройден"
}
master?.onLoadFail = { [weak self] _ in
self?.statusLabel.text = "Ошибка загрузки"
}
// Add Preloading Callbacks
master?.onSurveyAvailable = { [weak self] data in
self?.statusLabel.text = "Подходящий опрос найден"
}
master?.onSurveyUnavailable = { [weak self] data in
self?.statusLabel.text = "Подходящий опрос не найден"
}
屏幕方向
请注意:目前 Kukushka SDK 支持仅横向方向,您的游戏方向将在调查打开时强制更改为横向,调查关闭后返回前一方向。
示例
要运行示例项目,请克隆存储库,然后首先从示例目录运行 pod install
。
要求
- iOS 13.0+
- Swift 5
安装
Kukushka_iOSSDK 通过 CocoaPods 提供。要安装它,只需将以下行添加到您的 Podfile 中
pod 'Kukushka_iOSSDK'
作者
姓名,联系方式
许可
Kukushka_iOSSDK 在 MIT 许可下提供。有关更多信息,请参阅 LICENSE 文件。