用途:诊断 DAT SDK iOS 集成中的常见设置、注册与流媒体问题。若本地存在 DAT Inspector MCP 工具,建议先使用 live-debugging-mcp 技能,再改动应用代码;优先用 get_dat_readiness、get_companion_boundary_diagnosis、get_device_path 等只读证据区分应用缺陷与 Meta AI 应用/设备边界问题。
主要能力:提供快速诊断路径(设备未连接时依次检查开发者模式、设备注册、蓝牙与距离、应用注册状态 registrationStateStream()、流是否卡在 waitingForDevice);说明开发者模式必须开启第三方应用才能访问设备功能,并列出关闭时的症状(注册完成但设备不连接、流卡在 waitingForDevice、权限请求失败或不出现),以及固件更新后可能自动关闭、按设备单独开启等注意事项。
流状态:预期流程为 stopped → waitingForDevice → starting → streaming → stopped;卡在 waitingForDevice 多因设备不在范围、未上报可用性或 DeviceSelector 未匹配;意外停止可能因设备断开、通道关闭或帧处理错误。
版本兼容:需保证 SDK、Meta AI 应用与眼镜固件版本兼容,参见版本依赖矩阵。已知问题包括无网络导致注册失败、摘下眼镜启动的流在戴上后暂停(轻触镜腿恢复)、单次触摸板点击会暂停活动流(再次点击恢复,StreamState 为 .paused 时保留最后一帧)。
用法:可添加调试日志,如 private let logger = Logger(subsystem: "com.yourapp", category: "Wearables"),并记录状态与错误。使用 MCP 证据时,先 get_sdk_state 与 get_dat_readiness,再用 get_companion_boundary_diagnosis 排查权限、应用身份、设备能力、设备选择、deeplink 返回及 DAM/DWA 可见阻塞,用 get_device_path 追踪应用→DAT 注册→Meta AI 应用权限→设备选择/链接→会话→流;请开发者复现后用 wait_for_events 按最窄类别或来源等待事件,用 export_diagnostic_bundle 导出脱敏支持包。注意这不是对配套应用的内部探查,而是基于应用可见 DAT 调试事件的诊断。
检查清单:Meta AI 应用中开启开发者模式;应用与眼镜固件更新至兼容版本;注册需联网;手机蓝牙开启;Info.plist 配置正确 URL scheme 且 MWDAT > AppLinkURLScheme 匹配;URL 回调将 metaWearablesAction 链接转发给 Wearables.shared.handleUrl(_:);启用后台模式(processing、bluetooth-central、bluetooth-peripheral、external-accessory);UISupportedExternalAccessoryProtocols 含 com.meta.ar.wearable;提供 NSBluetoothAlwaysUsageDescription、NSLocalNetworkUsageDescription 与 NSBonjourServices。
限制:资料未提供具体版本号、价格、平台范围或效果数据;部分功能除开发者模式外还需额外权限。