PWEngagement SDK for iOS

这是 Phunware 用于其多屏幕即服务平台的移动端活动 SDK。它提供基于位置和通知的能力。访问 https://maas.phunware.com 获取更多信息并注册。

要求

• PWCore 3.11.x
• iOS 13.0 或更高版本
• Xcode 12 或更高版本

安装

CocoaPods

要集成框架，需要使用1.10或更高版本的CocoaPods。只需将以下内容添加到您的Podfile中

pod 'PWEngagement'

要启用对Mist虚拟信标的支持，请添加MistBeaconProvider子规范

pod 'PWEngagement/MistBeaconProvider'

文档

框架文档以HTML和Docset格式包含在存储库的Documents文件夹中。

• API参考
• 文档可通过developer.phunware.com找到

重要提示：为了与最佳实践保持一致，PWEngagement不再提示通知或位置权限，将控制权交给应用程序开发者。为了使PWEngagement完全按预期运行，必须授予这两个权限。

• 通知权限：我们建议遵循Apple的最佳实践。如果未授权，则应用程序将不会接收到推送通知。

• 位置权限：为了正常运行， PWEngagement需要用户允许“始终允许”位置，以便在后台正确搜索地理围栏活动。我们建议在请求此权限时遵循Apple的最佳实践。如果选择了“仅在使用时”或“不允许”，则应用程序将不会在后台监视区域。因此，它将不会接收到地理围栏通知或背景中的信标范围。

  • 从PWEngagement 3.6.0开始，PWEngagement支持“仅在使用时”的有限功能。当应用程序具有“仅在使用时”权限并处于前台时，PWEngagement将按照预期传达地理围栏和信标活动。

• 后台模式：PWEngagement需要几个不同的后台功能，可以在项目的目标设置下的功能 > 后台模式中进行启用。

  • 位置更新：用于后台区域监视。
  • 使用蓝牙LE配件：用于接收信标活动。
  • 后台检索：用于适当响应后台位置更新。
  • 远程通知：用于后台接收APNs通知。

运行示例应用的步骤

1. 在MaaS门户中创建一个新的iOS互动应用。

2. 转到示例应用的目录，并执行pod install。

3. 将以下键值对添加到Info.plist：

• MaaSAppId：来自MaaS门户的应用ID。
• MaaSAccessKey：来自MaaS门户的访问密钥。

4. 配置应用以使用推送通知。

   • 转到developer.apple.com并创建推送通知证书（教程链接）。

   • 创建后，下载推送生产证书并将其添加到键链访问中。然后，从键链访问中导出证书和密钥（右键单击查看导出选项）作为.p12文件，并设置密码。

   • 现在，登录到MaaS Portal，转到为您的应用创建的应用，并更新以下内容。

     • 证书 (.p12)：单击灰色省略号按钮，上传您在developer.apple.com创建的生产推送证书。
     • 密码：您为推送证书设置的密码。
     • 环境：对于生产应用，请使用生产环境。

归属

PWEngagement使用以下第三方依赖项

隐私

您理解并同意Phunware的隐私策略，该策略位于www.phunware.com/privacy。如果您使用Phunware软件需要自己的隐私策略，您还同意在其隐私策略中包含Phunware隐私策略的条款，供您的最终用户。

条款

使用本软件需要审查和接受我们位于http://www.phunware.com/terms的针对开发者使用的条款和条件