Inputs(iOS)是 Meta Wearables DAT iOS 中的实验性能力,用于让 iOS 应用接收来自已连接眼镜的语义交互事件。
用途与前提:应用需先在 Wearables Developer Center 中为自身启用 Inputs。该能力没有可在运行时请求的 Permission 值,因此不通过请求权限的方式开启。
使用方式:必须在 DeviceSession 已处于 .started 状态后调用 addInputs(configuration:)。若会话未启动,该方法返回 nil;添加该能力会自动启动会话,没有公开的 start() 方法。示例中创建 InputsConfiguration(consumeBack: true),再通过 session.addInputs(configuration:) 获取 inputs,并订阅 inputs.events 异步事件流。
主要能力:事件包括 .nav(方向)、.select、.back、.button、.capture(按压类型)以及 .drag(动作、x、y、dx、dy)。每个事件包含来源和设备时间戳(毫秒)。建议 switch 保持穷尽,以便新增行为时被显式处理。事件流缓冲最新 64 条事件,消费落后时丢弃最旧事件,所以处理逻辑应保持轻量。
配置与状态:默认配置启用所有已知来源并消费 Back。若希望由系统而非应用处理 Back,可将 consumeBack 设为 false。界面需要激活状态时可观察 statePublisher,激活、可用性、连接与通信失败可观察 errorPublisher。附加 Inputs 期间应保留事件任务。
错误与清理:InputsError.permissionDenied 表示该能力未获应用批准,不能通过 requestPermission 修复。终止性错误会结束事件流,但能力仍保持附加。再次添加 Inputs 能力前,应先取消事件任务和监听令牌,再调用 session.removeInputs()。
测试:应用附加 Inputs 后,可通过已配对的模拟眼镜注入事件,例如调用 glasses.services.input.navDown()。该服务也提供 Select、Back、Button、Capture 与 Drag 注入。在 Inputs 激活前发出的调用,或来自配置排除来源的调用,会被丢弃。
可用性限制:Inputs 目前为实验性能力,可用于开发与 Beta 测试,但尚不能发布到生产发布渠道。