Estimote Mirror iOS SDK
此 SDK 允许您从 iOS 应用程序中控制大屏幕,使用 Estimote Mirror。.
主要特性
-
基于移动 SDK 构建Mirror 体验 - 您可以使用移动 Display SDK 开始您第一个 Mirror 应用的原型设计。无需预先上传任何代码或资源到 Mirror。
-
预定义视图 - 您无需设计第一个 Mirror 应用视图。iOS Mirror SDK 允许您根据预定义视图定义自定义屏幕;您所需的所有内容是声明基本样式和数据。
-
Mirror 屏幕到移动的反馈 - 一旦触发任何显示操作,您的手机应用就会收到通知。您可以在手机应用程序内处理成功的屏幕更改并执行进一步的操作。
请查看 README 中的其余部分以获取更多详细信息。
我们非常感谢您 对 SDK 的反馈,谢谢!
目录
安装
前提条件
- 1 Estimote Mirror 升级到 1.0.15+ 固件版本。
- 在Estimote Cloud中有一个账户。
- 支持低功耗蓝牙的iOS设备。我们建议使用iOS 10.0+(iPhone 5s或更新的版本)。
Pod
通过CocoaPods安装
$ pod init
在项目根目录下执行- 编辑你的Podfile,将以下仓库添加到你的项目目标下
pod 'EstimoteMirror'
pod 'EstimoteBluetoothScanning'
pod 'EstimoteProximitySDK'
$ pod install
从Estimote Cloud获取应用凭据
为了获取移动应用程序的Estimote Cloud凭据
- 登录到你的Estimote Cloud账户。
- 转到“应用”部分,点击“添加新应用”选项。
- 选择“您的应用”选项。
- 保存您的《应用ID/应用令牌》凭据。
快速入门
以下是一个简单的示例,演示当用户出现在Mirror附近范围内时,如何在屏幕上显示海报视图。
// Declare mirrorClient and proximityObserver as class properties
let mirrorClient = MirrorClient(appID: "", appToken: "")
var proximityObserver: EPXProximityObserver!
// Inside you class implementation
// Prepare your customized Poster View
let sneakersBanner = Poster() { p in
p.header = "Exceptional traction\nfrom your first to final mile"
p.body = "Now 20% off!"
p.image = .preloaded(path: "shoe_big.jpg")
p.style = PosterStyle() { ps in
ps.imagePosition = Position(horizontal: .center, vertical: .top(offset: 80))
ps.textPosition = Position(horizontal: .center, vertical: .bottom(offset: 80))
ps.textAlign = .center
ps.headerFontSize = .percent(130)
}
}
// Initialize your Estimote Cloud credentials
let credentials = CloudCredentials(appID: "", appToken: "")
// Build ProximityObserver with Cloud credentials
self.proximityObserver = ProximityObserver(credentials: credentials, onError: { error in
print("\(error)")
})
// Define near proximity zone
let mirrorZone = ProximityZone(tag: "mirror", range: ProximityRange.near)
mirrorZone.onEnter = { zoneContext in
print("Enter mirror")
self.mirrorClient.display(sneakersBanner, onMirror: zoneContext.deviceIdentifier)
}
mirrorZone.onExit = { zoneContext in
print("Exit mirror")
}
// Start proximity observation
self.proximityObserver.startObserving([mirrorZone])
区域监控基于最可靠的信号处理技术Estimote Proximity SDK。
要获取更多详细信息,您可以查看iOS-Proximity-SDK的README。
您的反馈与问题
在Estimote,我们相信开放反馈!以下是您与我们分享想法的一些常见方式
- 在我们的问题页面上发布问题/疑问/增强功能。
- 在我们的Estimote SDK for Android 论坛上询问社区管理员。
变更日志
要查看我们SDK最近版本中的更改,请访问我们的发布页面。