已连接穿戴设备查询
=========

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8/v3/pGm4OchMSqqOdX3TXAC52w/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073450Z&HW-CC-Expire=86400&HW-CC-Sign=7063C983CCCD5E592E146C9C42820AD2C5ABF5D33D8DF1269C914450CCB5D9B9)

该接口的调用前，需要在开发者联盟申请设备基础信息权限（具体请参考[申请接入Wear Engine服务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/wearengine_apply)）。

Wear Engine提供查询用户已连接的穿戴设备列表（即支持Wear Engine能力且与手机侧运动健康App处于连接状态的穿戴设备）的接口。

建议开发者在使用Wear Engine其他API接口前先实现该接口功能。

1.  应用调用[wearEngine](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/wearengine_api)中的[getDeviceClient](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/wearengine_api#wearenginegetdeviceclient)方法，获取[DeviceClient](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/wearengine_api#deviceclient)对象。
    
2.  调用[getConnectedDevices](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/wearengine_api#getconnecteddevices)方法，查询用户已连接的穿戴设备列表。
    
    // 在使用Wear Engine服务前，请导入WearEngine与相关模块
    import { wearEngine } from '@kit.WearEngine';
    import { BusinessError } from '@kit.BasicServicesKit';
    
    // 步骤1：获取DeviceClient对象
    // this.getUIContext().getHostContext() 表示应用上下文Context对象
    let deviceClient: wearEngine.DeviceClient = wearEngine.getDeviceClient(this.getUIContext().getHostContext());
    // 创建一个设备列表用于存储返回的设备
    let deviceList: wearEngine.Device\[\] = \[\];
    
    // 步骤2：调用getConnectedDevices方法，查询用户是否有已连接的穿戴设备
    deviceClient.getConnectedDevices().then(devices => {
      // 处理返回的设备列表
      deviceList = devices;
      console.info(\`Succeeded in getting deviceList, deviceList number is ${deviceList.length}\`);
    }).catch((error: BusinessError) => {
      // 处理调用失败时捕获到的异常
      console.error(\`Failed to get deviceList. Code is ${error.code}, message is ${error.message}\`);
    });