用途:在 Android 应用中接入 Meta Wearables Device Access Toolkit(DAT SDK),完成从环境准备到首次连接 Meta 眼镜的流程。
前提条件: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-core、mwdat-camera、mwdat-display、mwdat-mockdevice 依赖,并在 app/build.gradle.kts 中设置 manifestPlaceholders 的 mwdat_application_id 与 mwdat_client_token,添加对应 implementation 依赖。二、配置 AndroidManifest.xml,声明 BLUETOOTH、BLUETOOTH_CONNECT、INTERNET 权限,添加 APPLICATION_ID 与 CLIENT_TOKEN 的 meta-data,并为 Activity 配置 URL scheme 的 intent-filter。APPLICATION_ID 与 CLIENT_TOKEN 用于应用认证,可在 Wearables Developer Center 获取;开发者模式下不使用认证,两个占位符可均为 0,生产环境需替换为实际凭据,并将 myexampleapp 替换为应用自身的 URL scheme。三、在 Application 的 onCreate 中调用 Wearables.initialize(this)。四、注册必须先完成才能启动会话,观察 Wearables.registrationState 等待 RegistrationState.REGISTERED,通过 Wearables.startRegistration(activity) 发起注册,再用 Wearables.createSession(AutoDeviceSelector()) 创建会话,并收集 session.errors 与 session.state。五、仅在会话状态为 DeviceSessionState.STARTED 后调用 session.addCamera 添加摄像头串流,过早添加会返回 DeviceSessionError.SESSION_IDLE;摄像头访问还需 DAT 摄像头权限。
适用场景:为 Android 应用接入 Meta 眼镜的摄像头串流、显示等能力,并可在无硬件时用 MockDeviceKit 测试。
限制:资料未提供 SDK 版本以外的收费、价格或效果信息;具体权限流程、会话生命周期与显示能力需参考相关技能文档。