用途:该技能页说明 iOS 应用如何通过 Meta Wearables DAT SDK 与 Meta AI 完成注册,并在注册后申请设备权限(示例为相机)。SDK 将“注册”和“设备权限”分为两个步骤:注册让应用成为被允许的集成;注册完成后才能请求具体设备权限。所有权限授权都通过 Meta AI 伴侣应用进行。
主要能力:
- 注册管理:调用 startRegistration() 打开 Meta AI 供用户批准,再通过 URL scheme 回调;提供 startUnregistration() 取消注册。
- 回调处理:在 onOpenURL 中按 metaWearablesAction 查询项过滤,避免无关深链进入 SDK,再调用 handleUrl(url)。
- 状态监听:通过 registrationStateStream() 观察 registered、unavailable、available、registering 四种状态。
- 相机权限:checkPermissionStatus(.camera) 查询状态,requestPermission(.camera) 发起授权,用户可选“仅一次”或“始终允许”。
- 多设备:权限在任一已连接设备上授予即生效,SDK 透明处理;所有设备断开后权限不可用。
- 类型化错误:注册、取消注册、URL 处理、权限检查与申请分别抛出 RegistrationError、UnregistrationError、WearablesHandleURLError、PermissionError 等,建议使用 error.description 或 localizedDescription。
- 更新流程:当 compatibility() == .deviceUpdateRequired 或出现 DeviceSessionError.datAppOnTheGlassesUpdateRequired 时,可分别调用 openFirmwareUpdate() 和 openDATGlassesAppUpdate(),两者都会打开 Meta AI。
使用方式:先调用 startRegistration(),在 onOpenURL 中过滤 metaWearablesAction 后交给 handleUrl;用 registrationStateStream 监听状态,registered 后即可申请相机权限。取消注册调用 startUnregistration()。
模式与前置条件:开发者模式下注册始终允许,MetaAppID 为空、0 或未展开占位符时跳过认证;生产模式需设置 MetaAppID、ClientToken、TeamID,且用户处于正确发布渠道,应用 ID 与客户端令牌来自 Wearables Developer Center。注册需要互联网连接和已安装的 Meta AI 伴侣应用;开发者模式需在 Meta AI 的设置中开启。