SweepinConnect 是 iOS 上的基于位置的营销工具。通过将我们的系统整合到您的应用中，您可以快速利用 Proximity SDK 技术和地理围栏系统 来启动。

我们的解决方案连接到一个直观的后台管理界面 Sweepin Manager。这将允许您在线快速创建您的活动并将其广播给您的受众。在我们的图表上查看分析数据，实时获取访客流量。

##使用 CocoaPods 进行安装

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

$ gem install cocoapods

• 需要 CocoaPods 0.39.0+ 才能构建 SweepinConnect 0.1.0

###Podfile

pod "SweepinConnect"

要使用 CocoaPods 将 SweepinConnect 集成到您的 Xcode 项目中，只需在 Podfile 中指定它，添加以下行：

##手动安装

下载 ProximitiesSDK.framework 和 ProximitiesSDK.bundle 文件。

• 只需两步即可集成
• 将 ProximitiesSDK.framework 文件拖到 XCode 中的 Frameworks 项目的文件夹中。不要选择“将项目复制到目标组文件夹”选项，因为您可能只想使用引用。

然后，将 ProximitiesSDK.bundle 拖入您的项目。在项目目标设置中，打开构建阶段选项卡，并在“复制包资源”部分添加 ProximitiesSDK.bundle 文件（在大多数情况下，包将会自动添加）。此包包含 nibs 和图像。

要求

• 要与信标技术兼容，设备必须支持蓝牙 LE 4.0
• iPhones 4S 及以上。
• iPads 3 及以上。

iPod 5 及以上。

iPhone 4 仅与地理围栏技术兼容。

最后，设备必须至少安装了 iOS 7.0。

##APP 配置

如果您使用的是 strong>Cocoapods，这些框架将自动包含在内。

如果您不使用它，则需要手动在目标中的“链接的框架和库”部分添加它们。

###SweepinConnect SDK需求

• CoreBluetooth.framework
• CoreLocation.framework
• SystemConfiguration.framework
• UIKit.framework
• Foundation.framework
• AVKit.framework
• CoreMedia.framework
• AVFoundation.framework
• libsqlite3.0.tbd

###您的App-Info.plist

自iOS 8 SDK以来，要在应用程序中使用本地化，则需要使用key NSLocationAlwaysUsageDescription

打开Info.plist文件，然后添加一个新字符串键 NSLocationAlwaysUsageDescription。在值中，设置您想显示给用户的消息，请求他们允许在后台更新本地化。

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

并且自iOS 9 SDK以来，您需要描述您的应用程序打算使用的HTTP连接行为，包括Sweepin服务器。

由于我们的SDK可以集成指向我们服务器的WebView，因此每个http加载都需要授权。

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

您现在只需两步即可在应用程序中收到您的第一个动画。但在那之前，让我简单介绍一下我们SDK的核心。让我向您介绍：###PRX单例

SweepinConnect SDK提供了一个独特的单例以便访问所有方法。

您只需要导入PRX.h头文件。

#import <ProximitiesSDK/PRX.h>

然后您可以调用单例。

[[PRX singleton] anySDKMethod]

###1/初始化SDK

为了在我们API中进行身份验证，请在AppDelegate的didFinishLaunchingWithOptions方法中使用PRX单例的initWithAppId:andSecret:方法。

[[PRX singleton] initWithAppId:@"YOUR-APP-ID" andSecret:@"YOUR-APP-SECRET"];

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

#####/!\ 请务必将您的应用程序密钥保存在自己手中。

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

您只需在AppDelegate的didReceiveLocalNotification:方法上调用manageLocalNotificationForUserInfo:

- (void)application:(UIApplication *)application didReceiveLocalNotification:( UILocalNotification *)notification{
	[[PRX singleton] manageLocalNotificationForUserInfo:notification.userInfo];
}

###恭喜，您的应用程序现在已准备好使用！#####转到Sweepin Manager界面创建您的第一个动画！

###了解更多选项，请参阅SweepinConnect iOS：高级配置 有许多方法可以自定义我们的SDK以适应您的需求：

• 在UITableView / UICollectionView中显示动画
• 接收时创建自定义操作
• 在应用程序中集成QRCode扫描仪
• 将您用户的属性注册到发送特定组分段动画
• ...还有很多！