用途:诊断 DAT SDK Android 集成中的常见安装、会话与流问题。
主要能力:提供快速诊断路径,检查是否调用 Wearables.initialize(context)、注册是否完成(Wearables.registrationState)、开发者模式是否启用、Wearables.devices 是否含已链接设备、createSession() 或 addCamera() 是否返回 DatResult 失败。支持会话未进入 STARTED、流未进入 STREAMING、拍照失败等问题的排查,并关注 SDK、Meta AI 应用与眼镜固件的版本兼容。
使用方式:在修改应用代码前,若本地有 DAT Inspector MCP 工具,先用 live-debugging-mcp 技能,优先使用 get_dat_readiness、get_companion_boundary_diagnosis 和 get_device_path,以只读 DAT 证据区分应用缺陷与 Meta AI 应用/设备边界问题。本地调试服务器连接时,从 get_sdk_state 和 get_dat_readiness 开始;用 get_companion_boundary_diagnosis 查看权限、应用身份、设备能力、设备选择、deeplink-return 及 DAM/DWA 可见阻塞项;用 get_device_path 追踪应用→DAT 注册→Meta AI 应用权限→设备选择/链接→会话→流。请开发者复现问题后,用 wait_for_events 选择最窄的类别或来源;用 export_diagnostic_bundle 做脱敏支持交接。
开发者模式:使用 mwdat_application_id = 0 和 mwdat_client_token = 0 的本地开发构建必须启用开发者模式。禁用时注册流程虽完成但设备永不可用、开发构建权限请求失败、createSession 因无可用设备失败。注意开发者模式可能在应用或固件更新后重置,且按已链接设备配置;生产构建使用真实 APPLICATION_ID、CLIENT_TOKEN 和发布渠道门控。
限制:这是从应用可见的 DAT 调试事件进行诊断,不是配套应用内省。日志建议记录类型化 DatResult 失败和状态转换,而非通用异常。版本兼容矩阵见版本依赖文档;已知问题、版本依赖和故障排除讨论见相关链接。