APP能力开放

开始使用

千问AI硬件开放平台专业版 SDK 面向接入方 App 提供双端一致的设备接入能力，帮助业务 App 连接千问 AI 穿戴设备，并在业务页面中使用拍照、录像、实时视频流、媒体同步、麦克风录音、设备状态管理和后台连接增强等能力。

接入指南

从接入方视角看，SDK 位于业务 App 与千问 AI 穿戴设备、官方服务之间。业务 App 负责产品界面、系统权限、业务配置和页面生命周期；SDK 负责对外提供公开 API、异步结果、状态监听和错误信息；设备和官方服务负责承载硬件能力、账号授权、设备绑定和能力协同。开发者只需要围绕公开能力页接入对应 API，并按文档处理权限、生命周期和错误结果。

接入时可以按以下顺序理解 SDK 能力边界：

先完成账号授权、SDK 初始化、系统权限和设备连接。
再按业务页面接入设备管理、拍照、录像、实时视频流、媒体同步和麦克风录音等能力。
Android 如需增强后台连接稳定性，可按 APP 保活能力页接入应用拉活、应用保活相关 API。
各能力均以对应平台的能力接入文档为准，接口入参、返回值、数据模型和最佳实践在能力页展开说明。

类型	子功能	说明
账号	账号授权	建立接入方 App 与千问 AI 穿戴服务的用户授权关系。需要业务侧与官方客服获取 `accessKeyId`、`accessKeySecret` 等必要信息。
	授权状态判断	在进入依赖账号态的能力前判断本地授权状态，授权不可用时引导用户重新授权。
	授权事件处理	监听授权失效或需要重新授权的事件，并刷新业务 UI。Android 侧可在授权信息变化后刷新账号绑定状态。
连接	蓝牙扫描	发现附近可连接的千问 AI 穿戴设备。扫描结果可能重复，业务侧建议按设备地址去重。
	设备连接与断开	连接扫描到的设备，并在用户退出、切换设备或异常场景下断开连接。
	删除设备	删除已配对或已保存的设备记录，删除后刷新设备列表和当前选中设备状态。
设备	设备信息	读取当前设备信息或设备列表，用于设备首页、设备详情页和设备切换场景。
	状态读取与监听	读取并监听连接状态、电量、亮度、音量等状态，驱动设备首页和设置页展示。
	设备设置	读写屏幕亮度、音量、屏幕显示设置和音效设置。设置失败时业务侧需要回滚 UI。
相机	拍照并返回图片	触发设备拍照，并将图片数据返回给业务侧用于展示、保存或上传。
	设备端拍照	只向设备下发拍照指令，照片保存在设备端；如需取回文件，后续接入媒体同步能力。
	录像控制	控制设备开始和停止录像。停止成功不代表文件已在手机本地，最终文件需通过媒体同步取回。
	实时视频流	启动和停止设备画面传输。页面退出、用户停止预览或进入互斥能力前需要停止视频流。
媒体	未同步媒体概览	查询或监听设备端未同步媒体数量，用于媒体入口角标、同步按钮和空状态展示。
媒体	媒体文件同步	将设备端未同步照片和视频下载到业务指定的本地目录，并根据同步事件刷新进度和结果。
录音	录音前置检测	开始录音前检查当前设备和能力状态，避免在不可录音场景下直接触发录音。
	拾音方向	读取或设置设备拾音方向，用于录音页或音频设置页。
	音频数据接收	接收设备录音音频数据。文件写入、格式封装、上传和播放由业务侧处理。
APP 保活	应用拉活	使用眼镜时，如果 App 进程未启动，则拉起 App 进程（Android 支持机型详见能力接入章节）。
APP 保活	应用保活	提升后台连接稳定性，适用于需要增强后台连接的场景。Android 端需要对接少量 API 接口。

如果您对以上能力感兴趣，欢迎前往开放平台首页底部提交合作意向。我们的团队将在第一时间与您取得联系，共同探讨合作可能，携手将创新想法转化为落地产品。期待与您一同开启 AI 时代的无限可能。