整理自小米穿戴第三方APP能力开放接口文档
手环小程序开放接口文档
1.4版本更新日志
兼容Android R
1.3版本更新日志
兼容未来小米穿戴和小米健康合并项目，api无变化，直接替换sdk即可
1.2版本更新日志：
兼容jdk1.7版本，api没有变化
1.1版本更新日志：
修改状态订阅和状态查询相关接口返回值，详情请查看文档3.2和3.3部分
增加消息通知api，详情请看文档第 5 部分
1.查询已连接的可穿戴设备（不需要权限）12345678910111213141516171819// 获取 NodeApi 对象NodeApi api = Wearable.getNodeApi(context);// 调用 getConnectedNodes 方法来获取所有已连接的设备api.getConnectedNodes() .addOnSuccessListener(new OnSuccessListener>() { @Override public void onSuccess(List nodes) { // 处理已连接设备列表，注意：目前一次只能连接一个设备 // 可以在这里添加逻辑处理，例如遍历 nodes 列表 } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // 处理获取已连接设备失败的情况 // 通常这里可以记录错误日志或向用户提示错误信息 } });
2.权限查询与申请2.1查询授权状态第一次调用授权会默认授予Permission.DEVICE_MANAGER和Permission.Notify权限
12345678910111213141516171819202122232425262728293031323334353637383940414243// 获取 AuthApi 对象AuthApi authApi = Wearable.getAuthApi(context);// 调用 checkPermission 方法获取某个权限的授权状态authApi.checkPermission("nodeId", Permission.DEVICE_MANAGER) .addOnSuccessListener(new OnSuccessListener() { @Override public void onSuccess(Boolean result) { // 如果已授权，result 为 true；未授权，result 为 false // 可以在这里添加相应的逻辑处理 } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // 获取授权状态失败 // 通常这里可以记录错误日志或向用户提示错误信息 } });// 定义一组权限Permission[] permissions = new Permission[]{ Permission.DEVICE_MANAGER, Permission.NOTIFY};// 调用 checkPermissions 接口查询一组权限的授权状态authApi.checkPermissions("nodeId", permissions) .addOnSuccessListener(new OnSuccessListener() { @Override public void onSuccess(Boolean[] results) { // 如果已授权，results 中对应位置的值为 true；未授权，为 false // 按照请求顺序返回结果 // 可以在这里添加相应的逻辑处理 } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // 获取授权状态失败 // 通常这里可以记录错误日志或向用户提示错误信息 } });
2.2申请权限12345678910111213141516171819// 获取 AuthApi 对象AuthApi authApi = Wearable.getAuthApi(context);// 发起授权申请authApi.requestPermission("nodeId", Permission.DEVICE_MANAGER, Permission.NOTIFY) .addOnSuccessListener(new OnSuccessListener() { @Override public void onSuccess(Permission[] permissions) { // 申请权限成功，返回授权成功的权限 // 可以在这里添加相应的逻辑处理 } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // 申请权限失败 // 通常这里可以记录错误日志或向用户提示错误信息 } });
3.设备管理与状态订阅3.1支持查询与订阅的设备状态
设备管理与状态订阅
查询结果
订阅事件触发条件
订阅结果
连接状态
1.连接 2.未连接
1.手机与设备连接成功2.手机与设备断开连接
1.连接成功2.连接断开3.连接失败4.设备被删除
电量状态
电量值（0~100，比如 98 ）
N/A
N/A
充电状态
1.正在充电2.非充电状态
1.给设备充电2.充满电3.停止充电
1.开始充电2.充电完成3.停止充电
佩戴状态
1.佩戴中2.未佩戴
1.手表戴在手腕上2.摘下手表
1.佩戴2.未佩戴
睡眠状态
1.睡眠中2.清醒
1.佩戴手表入睡2.从入睡状态清醒过来
1.入睡2.出睡
3.2状态查询（需要申请Permission.DEVICE_MANAGER权限）1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556// 获取 NodeApi 对象NodeApi api = Wearable.getNodeApi(context);// 调用 query 方法，查询不同状态，nodeId 通过查询已连接设备得到的设备 ID// 目前支持查询（连接状态，电量状态，充电状态，佩戴状态，睡眠状态）api.query("nodeId", DataItem.ITEM_CONNECTION) .addOnSuccessListener(new OnSuccessListener() { @Override public void onSuccess(DataQueryResult result) { // 查询成功 boolean connectionStatus = result.isConnected(); // DataQueryResult 定义了各种状态的状态值，和 DataItem 一一对应 // 可以在这里添加相应的逻辑处理 } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // 查询失败 // 通常这里可以记录错误日志或向用户提示错误信息 } });// 查询对应的穿戴设备端应用是否安装api.isWearAppInstalled("nodeId") .addOnSuccessListener(new OnSuccessListener() { @Override public void onSuccess(Boolean result) { // 查询成功，应用已安装返回 true，未安装返回 false // 可以在这里添加相应的逻辑处理 } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // 查询失败 // 通常这里可以记录错误日志或向用户提示错误信息 } });// 打开设备端应用// uri 由各个应用自定义，用于打开手表端 app 的指定页面api.launchWearApp("nodeId", "uri") .addOnSuccessListener(new OnSuccessListener() { @Override public void onSuccess(Void aVoid) { // 打开穿戴设备端应用成功 // 可以在这里添加相应的逻辑处理 } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // 打开穿戴设备端应用失败 // 通常这里可以记录错误日志或向用户提示错误信息 } });
3.3状态订阅（需要申请Permission.DEVICE_MANAGER权限）1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253// 获取 NodeApi 对象NodeApi api = Wearable.getNodeApi(context);// 创建监听器OnDataChangedListener onDataChangedListener = new OnDataChangedListener() { @Override public void onDataChanged(@NonNull String nodeId, @NonNull DataItem dataItem, @NonNull DataSubscribeResult data) { // 收到订阅状态变更通知 // 不同的 DataItem 对应 DataSubscribeResult 中不同的 status，一一对应 if (dataItem.getType() == DataItem.ITEM_CONNECTION.getType()) { int connectionStatus = data.getConnectedStatus(); if (connectionStatus == DataSubscribeResult.RESULT_CONNECTION_CONNECTED) { // 设备连接状态变更为已连接状态 // 可以在这里添加相应的逻辑处理 } } }};// 调用 subscribe 方法，订阅不同状态，nodeId 是通过查询已连接设备得到的设备 ID// 目前支持订阅（连接状态变化，充电状态变化，佩戴状态变化，睡眠状态变化）api.subscribe("nodeId", DataItem.ITEM_CONNECTION, onDataChangedListener) .addOnSuccessListener(new OnSuccessListener() { @Override public void onSuccess(Void aVoid) { // 添加订阅成功 // 可以在这里添加相应的逻辑处理 } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // 添加订阅失败 // 通常这里可以记录错误日志或向用户提示错误信息 } });// 调用 unsubscribe 方法取消监听api.unsubscribe("nodeId", DataItem.ITEM_CONNECTION) .addOnSuccessListener(new OnSuccessListener() { @Override public void onSuccess(Void aVoid) { // 删除订阅成功 // 可以在这里添加相应的逻辑处理 } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // 删除订阅失败 // 通常这里可以记录错误日志或向用户提示错误信息 } });
4.应用间消息通信（需要申请Permission.DEVICE_MANAGER权限）1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465// 模拟数据，应用可以自定义发送数据byte[] messageBytes = new byte[1024];// 获取 MessageApi 对象MessageApi messageApi = Wearable.getMessageApi(context);// 调用 sendMessage 方法用来发送数据给穿戴设备端应用messageApi.sendMessage("nodeId", messageBytes) .addOnSuccessListener(new OnSuccessListener() { @Override public void onSuccess(Integer result) { // 发送数据成功 // 可以在这里添加相应的逻辑处理 } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // 发送数据失败 // 通常这里可以记录错误日志或向用户提示错误信息 } });// 创建监听器用于监听穿戴设备端发送来的消息OnMessageReceivedListener onMessageReceivedListener = new OnMessageReceivedListener() { @Override public void onMessageReceived(@NotNull String nodeId, @NotNull byte[] message) { // 收到手表端应用发来的消息 // 可以在这里添加相应的逻辑处理 }};// 监听穿戴设备端应用发来的消息messageApi.addListener("nodeId", onMessageReceivedListener) .addOnSuccessListener(new OnSuccessListener() { @Override public void onSuccess(Void aVoid) { // 添加消息监听成功 // 可以在这里添加相应的逻辑处理 } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // 添加消息监听失败 // 通常这里可以记录错误日志或向用户提示错误信息 } });// 取消监听messageApi.removeListener("nodeId", onMessageReceivedListener) .addOnSuccessListener(new OnSuccessListener() { @Override public void onSuccess(Void aVoid) { // 取消消息监听成功 // 可以在这里添加相应的逻辑处理 } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // 取消消息监听失败 // 通常这里可以记录错误日志或向用户提示错误信息 } });
5.消息通知（需要Permission.NOTIFY权限）123456789101112131415161718192021// 获取 NotifyApi 对象NotifyApi notifyApi = Wearable.getNotifyApi(context);// 发送消息通知，需要提前判断是否有 Permission.NOTIFY 权限notifyApi.sendNotify("nodeId", "title", "message") .addOnSuccessListener(new OnSuccessListener() { @Override public void onSuccess(Status status) { if (status.isSuccess()) { // 发送通知成功，手表上会看到消息通知内容，表端应用无感知 // 可以在这里添加相应的逻辑处理 } } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // 发送通知失败 // 通常这里可以记录错误日志或向用户提示错误信息 } });
6.管理服务连接状态（不需要权限）123456789101112131415161718//获取ServiceApiServiceApi serviceApi = Wearable.getServiceApi(context);//第三方应用与小米穿戴App连接状态可以通过这个监听器来监听OnServiceConnectionListener onServiceConnectionListener = newOnServiceConnectionListener() {@Overridepublic void onServiceConnected() {//服务连接成功}@Overridepublic void onServiceDisconnected() {//服务断开}};//注册监听器serviceApi.registerServiceConnectionListener(onServiceConnectionListener);//取消监听器serviceApi.unregisterServiceConnectionListener(onServiceConnectionListener);
