这是 Meta Wearables Device Access Toolkit(DAT)Android 版的入门指南,目标是在 Android 应用中完成该工具包的初始接入与首次连接 Meta 眼镜。以下按用途与要点分段说明。
用途:在 Android 应用中集成 Meta Wearables DAT SDK,完成 SDK 初始化、设备注册、会话创建和基础相机串流的接入流程。
前提条件:Android Studio Flamingo 或更新版本;Android 10+ 测试设备,且已安装 Meta AI 应用;支持 Meta 眼镜,或使用 MockDeviceKit 进行本地测试;开发构建需在 Meta AI 应用中开启开发者模式。SDK 发布在 Maven Central 的 com.meta.wearable 组下,settings.gradle.kts 中已声明的 mavenCentral() 仓库即可满足要求,无需访问令牌。
主要配置步骤:
- 声明依赖:在 libs.versions.toml 中定义版本 mwdat = "1.0.1",并声明 mwdat-core、mwdat-camera、mwdat-display、mwdat-mockdevice 四个库;在 app/build.gradle.kts 的 defaultConfig 中设置 manifestPlaceholders 的 mwdat_application_id 与 mwdat_client_token,并在 dependencies 中引入对应实现。
- 配置 AndroidManifest.xml:声明 BLUETOOTH、BLUETOOTH_CONNECT、INTERNET 权限;添加 com.meta.wearable.mwdat.APPLICATION_ID 与 com.meta.wearable.mwdat.CLIENT_TOKEN 两个 meta-data;为主 Activity 配置 URL scheme 的 intent-filter(示例使用 myexampleapp,需替换为应用自身 scheme)。APPLICATION_ID 与 CLIENT_TOKEN 用于应用认证,可在 Wearables Developer Center 获取;开发者模式下不使用认证,两个占位符均可为 0;生产环境需替换为对应凭据。
- 初始化 SDK:在 Application 的 onCreate 中调用 Wearables.initialize(this),并处理失败回调记录日志。
- 注册并创建会话:注册必须先完成才能启动会话,需观察 Wearables.registrationState 并等待 RegistrationState.REGISTERED;通过 Wearables.startRegistration(activity) 发起注册;使用 AutoDeviceSelector 调用 Wearables.createSession 创建会话,监听 session.errors 与 session.state,在状态为 DeviceSessionState.STARTED 时添加相机功能;随后调用 session.start()(该调用为 fire-and-forget,返回 Unit,失败通过 session.errors 报告)。同时可观察 Wearables.registrationState 与 Wearables.devices 更新界面。
- 添加相机串流:仅在会话报告 DeviceSessionState.STARTED 后调用,提前添加会返回 DeviceSessionError.SESSION_IDLE;通过 session.addCamera(StreamConfiguration(videoQuality = VideoQuality.MEDIUM, frameRate = 24)) 添加相机并在成功后调用 camera.stream.start()。相机访问还需要 DAT 相机权限,参见 permissions-registration 相关内容。
后续主题:指南列出 camera-streaming(串流能力、视频帧、拍照)、mockdevice-testing(无硬件测试)、session-lifecycle(会话与流状态变化处理)、permissions-registration(注册与权限流程)、display-access(在 Meta Ray-Ban Display 眼镜上渲染内容)以及完整 Android API 参考。
限制与未提供信息:资料未说明 SDK 的收费、价格、性能指标或具体支持的眼镜型号清单;部分能力(如显示访问、拍照细节)仅以后续主题链接形式提及,本文档未展开其具体用法。