Nuimo SDK

Nuimo 控制器是您的计算机和连接的智能设备的一种直观控制器。本文档演示了如何使用 Nuimo SDK 将您的 iOS 和 MacOS 应用程序与 Nuimo 控制器集成。Nuimo SDK 支持用 Swift 和 Objective-C 编写的应用程序。

安装

Nuimo Swift SDK 通过 CocoaPods 提供，它是 Swift 和 Objective-C 应用程序的 очень خوب依存关系管理器。(如果您不想使用 CocoaPods，只需将文件夹 SDK 中的所有 .swift 文件复制到您的 Xcode 项目中，然后跳到下一步。)

向 NuimoSwift SDK 添加依赖项

编辑您的项目 Podfile 并添加以下行

pod 'NuimoSwift', '~> 0.5.0'

然后在您的项目根目录中的终端运行

pod install

这将安装 Nuimo Swift SDK 并将其添加到您的工作区。现在打开您的工作区项目并开始使用 Nuimo Swift SDK 进行测试。不要忘了在需要的地方导入模块 NuimoSwift。

使用

基本使用

Nuimo SDK 使您能够轻松地将 iOS 和 MacOS 应用程序与 Nuimo 控制器连接起来。只需要三个步骤和少量代码即可发现您的 Nuimo 并接收手势事件

1. 将一个代理分配给 NuimoDiscoveryManager 的一个实例，并调用 startDiscovery()。这将发现附近的 Nuimo 控制器。

2. 通过实现代理方法 nuimoDiscoveryManager:didDiscoverNuimoController: 接收已发现的控制器。在这里您可以

   1. 设置已发现控制器的代理
   2. 通过调用 connect() 初始化与已发现控制器的蓝牙连接

3. 实现代理方法 nuimoController:didReceiveGestureEvent: 来访问用 Nuimo 控制器执行的用户事件

以下代码示例演示了如何发现、连接并接收 Nuimo 的手势事件。如您所知，您可以在 iOS 系统上使用 UIViewController，或在 MacOS 系统上使用 NSViewController。

示例代码

import NuimoSwift

class ViewController : UIViewController|NSViewController, NuimoDiscoveryDelegate, NuimoControllerDelegate {
    let discovery = NuimoDiscoveryManager.sharedManager

    override func viewDidLoad() {
        super.viewDidLoad()
        discovery.delegate = self
        discovery.startDiscovery()
    }

    func nuimoDiscoveryManager(discovery: NuimoDiscoveryManager, didDiscoverNuimoController controller: NuimoController) {
        controller.delegate = self
        controller.connect()
    }

    func nuimoController(controller: NuimoController, didReceiveGestureEvent event: NuimoGestureEvent) {
        print("Received event: \(event.gesture.identifier), value: \(event.value)")
    }
}

可立即使用的MacOS演示应用程序

我们提供了一款可立即使用的应用程序，用于演示从您的Nuimo控制器中发现、连接和接收事件。只需克隆Nuimo MacOS演示仓库，打开包含的Xcode工作区，然后点击运行按钮执行应用程序。在此之前，请确保已选择正确的目标NuimoDemoOSX。

高级用法

NuimoSwift SDK远远不止以上提到的用法，更多信息即将在这里提供。

联系 & 支持

有任何疑问或建议？请给我们发邮件至[email protected]。我们很高兴听取您的意见。

许可证

NuimoSwift源代码可在MIT许可证下获取。