SuperAPI AI 工具集

inputs

智能体与模型

查看项目

更新于 10-22 21:59

技能介绍

Inputs(iOS)是 Meta Wearables DAT iOS SDK 提供的实验性输入能力,用于从已配对的智能眼镜接收语义化交互事件,让应用响应用户在眼镜上的操作。

用途:接收导航、选择、返回、按钮、拍摄和拖拽等输入事件,用于控制应用界面或触发相应功能。

主要能力:

  • 事件类型涵盖 nav(方向导航)、select(选择)、back(返回)、button(按钮)、capture(拍摄按键,含按压类型)和 drag(拖拽,含动作、坐标、位移等数据)。
  • 每个事件包含来源和设备时间戳(毫秒)。
  • 提供 statePublisher 供界面观察激活状态,errorPublisher 报告激活、可用性、连接和通信错误。
  • 事件流缓冲最新 64 个事件,消费者落后时会丢弃最旧事件,因此需要保持处理逻辑轻量。

使用方式:

  1. 在 Wearables Developer Center 为应用启用 Inputs;该能力没有运行时 Permission 值可申请。
  2. 必须在 DeviceSession 已经处于 .started 状态后再调用 addInputs(configuration:),否则返回 nil;添加该能力会自动启动会话,没有公开的 start() 方法。
  3. 传入 InputsConfiguration,例如 consumeBack: true;默认配置启用所有已知来源并消费 Back,若希望由系统处理 Back 则设为 false。
  4. 通过 inputs.events 异步遍历事件流,使用 switch 穷举处理各类事件;在 Inputs 附加期间需保留事件任务。

错误与清理:InputsError.permissionDenied 表示应用未获该能力批准,不能通过 requestPermission 解决。终止性错误会结束事件流,但能力仍保持附加状态。再次添加 Inputs 前,应取消事件任务和监听令牌,并调用 session.removeInputs()。

测试:应用附加 Inputs 后,可通过已配对的 MockDeviceKit 模拟眼镜注入事件,例如 glasses.services.input.navDown(),服务还提供 Select、Back、Button、Capture 和 Drag 注入。在 Inputs 激活前或来自配置排除来源的调用会被丢弃。

适用场景:开发与 Beta 测试阶段,为 iOS 应用接入眼镜端交互控制。

限制:Inputs 为实验性能力,可用于开发和 Beta 测试,但尚不能发布到生产发布渠道。