用途 Inputs(Android)是 Meta Wearables DAT Android 库中的实验性能力,用于在 Android 应用中接收来自已连接眼镜的语义交互事件,让应用响应导航、选择、返回、按键、拍摄和拖拽等操作。
主要能力 可接收的事件类型包括:InputEvent.Nav(导航方向)、InputEvent.Select(选择)、InputEvent.Back(返回)、InputEvent.Button(按键)、InputEvent.Capture(拍摄按键及按下类型)和 InputEvent.Drag(拖拽动作及坐标、位移)。每个事件都包含来源(source)和设备时间戳(毫秒)。默认配置会启用除 UNKNOWN 之外的所有已知输入源,并消费返回键(consumeBack = true);若希望由系统处理返回,可将 consumeBack 设为 false。
使用方式 应用必须先在 Wearables Developer Center 中为该应用启用 Inputs;该能力没有可在运行时请求的 Permission 值。只有在会话进入 DeviceSessionState.STARTED 之后才能调用 session.addInputs;添加能力即自动启动,没有单独的公开启动调用。示例中通过 InputsConfiguration(consumeBack = true) 配置,并在 onSuccess 中启动协程收集 inputs.events,按事件类型分别处理。需在 Inputs 附加期间保留事件收集任务(job),并在 UI 需要激活状态时收集状态,同时处理激活、连接和通信失败的错误。代码中的 when 应保持穷尽,以便新增行为时是有意为之。
错误与清理 InputsError.PERMISSION_DENIED 表示该能力未获应用批准,不能通过 requestPermission 修复;其他错误涵盖激活、连接和通信失败。清理时应先取消收集任务,再调用 session.removeInputs() 并处理其 DatResult,之后才能添加另一个 Inputs 能力。
测试 应用附加 Inputs 后,可通过配对的模拟眼镜注入事件进行测试,例如调用 glasses.services.input.navDown();该服务也支持注入 Select、Back、Button、Capture 和 Drag。在 Inputs 激活之前发出的调用,或来自配置排除来源的调用会被丢弃。
适用场景与限制 适用于在 Android 上为已连接眼镜构建交互响应,例如焦点移动、激活当前项、关闭视图、处理按键与拍摄、更新拖拽。限制包括:Inputs 目前为实验性能力,可用于开发和 Beta 测试,但尚不能发布到生产发布渠道;必须先在 Wearables Developer Center 启用;没有运行时权限请求;必须在会话 STARTED 后附加;配置与来源过滤会影响事件是否被接收。