用途:在 iOS 应用中接入 Meta Wearables Device Access Toolkit(DAT),完成 SDK 安装、配置并与 Meta 眼镜建立首次连接。
前置条件:Xcode 26.4+、Swift 6.3+、iOS 17.2+ 部署目标;测试设备安装 Meta AI 配套应用;Ray-Ban Meta 眼镜或 Meta Ray-Ban Display 眼镜(开发时可用 MockDeviceKit);在 Meta AI 应用(设置 > 你的眼镜 > 开发者模式)中启用开发者模式。
主要步骤:
- 通过 Swift Package Manager 添加 SDK:在 Xcode 中选择 File > Add Package Dependencies...,输入 https://github.com/facebook/meta-wearables-dat-ios,选择版本,将 MWDATCore 和 MWDATCamera 添加到目标。
- 配置 Info.plist:添加 CFBundleURLTypes(URL scheme 用于 Meta AI 回调)、MWDAT 字典(AppLinkURLScheme、MetaAppID、ClientToken、TeamID)、UIBackgroundModes(processing、bluetooth-central、bluetooth-peripheral、external-accessory)、UISupportedExternalAccessoryProtocols(com.meta.ar.wearable)、NSBluetoothAlwaysUsageDescription、NSLocalNetworkUsageDescription、NSBonjourServices(_bonjour._tcp)。需将示例中的 myexampleapp 替换为应用自身的 URL scheme,并保持 MWDAT > AppLinkURLScheme 同步。开发者模式下 MetaAppID 可留空、设为 0 或保留占位符;生产环境需在 Wearables Developer Center 设置 MetaAppID 与 ClientToken,并将 TeamID 设为 Apple 开发者团队 ID。SDK 会使用多种链路,需按表声明对应条目:蓝牙 LE 需 bluetooth-central/peripheral 后台模式与 NSBluetoothAlwaysUsageDescription;蓝牙经典(相机串流使用)需 external-accessory 后台模式与 com.meta.ar.wearable;Wi-Fi 需非空 NSLocalNetworkUsageDescription 与 _bonjour._tcp。仅在录制眼镜麦克风音频时添加音频后台模式与 NSMicrophoneUsageDescription。
- 初始化:在应用启动时调用一次 Wearables.configure()。
- 处理 URL 回调:过滤 metaWearablesAction 查询项后调用 Wearables.shared.handleUrl(url)。
- 注册:调用 Wearables.shared.startRegistration(),并通过 registrationStateStream() 观察状态。
- 开始串流:创建 DeviceSession(如 AutoDeviceSelector),等待状态为 started,使用 StreamConfiguration 配置视频编解码、分辨率与帧率,通过 addCamera 获取相机并监听视频帧,最后调用 stream.start()。
后续主题包括相机串流、MockDevice 测试、会话生命周期与权限。限制:资料未提供收费、价格或效果信息。