SCSDKProximityServiceKit 2.0.5

SCSDKProximityServiceKit 2.0.5

×

由 Alexis Barat 维护。

SCSDKProximityServiceKit 2.0.5

SweepinConnectLogo

Version License Platform

SweepinConnect 是一款适用于 iOS 的基于位置的营销工具。通过将我们的系统集成到您的应用程序中，您可以快速使用 iBeacon 技术，以及地理围栏系统。

我们的解决方案连接到一个直观的后台管理界面，Sweepin Connect。它可以让您迅速在线创建活动并传播给您的受众。查看我们的图表上的分析数据，并实时获取访客流量。

开始使用

要求

  • 要使用我们的近距离服务 SDK，设备必须安装至少 iOS 8.1

  • 我们正在使用 Realm 在我们的应用程序中创建本地数据库。

使用 Cocoapods 安装

CocoaPods 是 Objective-C 的依赖管理器，它可以自动化并简化在项目中使用第三方库（如 SweepinConnect）的过程。有关更多信息，请参阅“入门”指南。您可以使用以下命令安装它：

$ gem install cocoapods
  • 要构建 SweepinConnect 0.1.0，需要 CocoaPods 0.39.0+

Podfile

要将我们的ProximityService解决方案集成到使用CocoaPods的Xcode项目中，请在Podfile中指定它，只需添加以下包即可：

pod 'SCSDKCoreKit'
pod 'SCSDKProximityServiceKit'

手动安装

下载 SCSDKCoreKit.framework、SCSDKProximityServiceKit.framework 和 SCSDKResourcesForProximityServiceKit.bundle 文件。

集成仅需两个简单步骤：

  • 将 SCSDKCoreKit.framework 和 SCSDKProximityServiceKit.framework 文件拖到Xcode中框架项目的文件夹内。请勿选择“将项目复制到目标文件夹”选项，因为这可能导致您仅想使用引用。
  • 然后拖动 SCSDKResourcesForProximityServiceKit.bundle 到您的项目中。在项目目标设置中，打开构建阶段选项卡，并在“复制束资源”部分（在大多数情况下，bundle会自动添加）添加 SCSDKResourcesForProximityServiceKit.bundle 文件。此bundle包含nibs和图像。

您还需要手动安装Realm，请参阅他们的文档。

应用配置

Info.plist

打开您的Info.plist文件，然后添加以下三个新的字符串密钥： NSLocationAlwaysUsageDescription、NSLocationAlwaysAndWhenInUseUsageDescription 和 NSLocationWhenInUseUsageDescription。在值中，设置您要显示给用户以请求他们允许定位更新的消息。

<key>NSLocationAlwaysUsageDescription</key>
	<string>Your message goes here</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
	<string>Your message goes here</string>
<key>NSLocationWhenInUseUsageDescription</key>
	<string>Your message goes here</string>

对于正在运行iOS 9.0+的设备，您需要通过添加 NSAppTransportSecurity 键来描述您的应用程序预期使用的HTTP连接行为，包括Sweepin服务器。

由于我们的SDK可以集成指向我们的服务器之外的其他服务器的webview，因此每个http加载都应该获得授权。您可以通过将 NSAllowsArbitraryLoads 键设置为true来完成此操作。

<key>NSAppTransportSecurity</key>
<dict>
	<key>NSAllowsArbitraryLoads</key>
	<true/>
</dict>

使用

您现在只需再走两步就可以在您的应用中收到第一场活动。在此之前，让我简要介绍一下我们SDK的核心。让我为您介绍：

SCSDKProximityService SharedInstance

SweepinConnect SDK提供了一个独特的单例对象来访问所有方法。要使用它，你只需将SDK导入到你的控制器中。

@import SCSDKProximityServiceKit;

然后你可以调用它

[[SCSDKProximityService sharedInstance] anyMethod]

1/ 初始化SDK

要在我们的API中进行认证，请使用Sau tsting的singleton，在AppDelegate的didFinishLaunchingWithOptions方法中使用initWithAppId:andSecret:方法

[[SCSDKProximityService sharedInstance] initWithAppId:@"YOUR-APP-ID" andSecret:@"YOUR-APP-SECRET"];

如果你没有应用ID和密钥（由Sweepin注册过程提供）-请联系Sweepin团队。

注意：请务必保存好自己的应用密钥

2/ 订阅本地通知和活动显示

你只需在AppDelegate的didReceiveLocalNotification:方法中调用manageLocalNotificationForUserInfo:即可。

- (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification{
    [[SCSDKProximityService sharedInstance]manageLocalNotificationWithUserInfo:notification.userInfo];
}

3/ 启动服务

现在是时候启动所有服务了。只需调用

[[SCSDKProximityService sharedInstance]start];

恭喜，你的应用已经准备就绪！

转到 Sweepin Connect 接口 创建您的第一个活动！

更多选项，请参阅 SweepinConnect iOS：高级配置

提供多种方法来自定义我们的SDK以适应您的需求

  • 获取最新收到的活动
  • 在接收/显示/关闭时创建自定义操作
  • 在您的应用中集成QRCode扫描仪，并调用我们的API获取相关活动
  • 注册您用户的属性，以便向特定组发送分段活动
  • ...还有更多！

许可

SweepinConnect 在MIT许可下可用。有关更多信息，请参阅LICENSE文件。