HarmonyOS 鸿蒙Next中如何检测设备是否支持 UWB（超宽带）定位？

搜索整理了一下，还没有实测，可以参考一下：

queryPassDeviceInfo 接口是 HarmonyOS 5.0.0 (12)+ 专属 Wallet Kit API，它的核心价值不仅是检测 UWB 支持性，更能直接关联数字车钥匙的「云侧卡券开通 + 设备能力绑定」，比原生 uwb 模块 API 更贴合你的数字车钥匙开发需求，以下是完整落地方案：

一、该接口的核心优势（针对数字车钥匙）

1. 一站式检测：同时返回设备「UWB/NFC/BLE/SLE」能力，无需分别调用多个模块 API，数字车钥匙所需的无线能力可一次性确认；
2. 关联云侧安全：返回 passDeviceId（账号 / 设备联合标识符），可直接用于后续数字车钥匙的开卡和云侧绑定，提升安全性；
3. 贴合车钥匙流程：deviceCapabilities 直接返回标准化能力编码，无需额外解析，可直接对接车厂的设备兼容性校验逻辑；
4. 元服务兼容：从 API 12 开始支持元服务调用，数字车钥匙元服务可直接集成，无需单独开发应用。

二、前置准备（必须步骤，否则接口调用失败）

1. 申请 AGC Wallet Kit 服务号（passType 来源）

1. 登录 华为应用市场连接平台（AGC）；
2. 进入「Wallet Kit」→「服务管理」→「创建服务」，填写数字车钥匙相关信息，审核通过后获取 passType（服务号，字符串格式，如「hw_car_key_xxx」）；
3. 配置应用包名与签名，确保与鸿蒙项目的 bundleName 和签名一致。

2. 集成 Wallet Kit 依赖（鸿蒙项目）

在项目的 oh-package.json5 中添加 Wallet Kit 依赖：

{
  "dependencies": {
    "@ohos/wallet": "^5.0.0" // 适配 API 12（HarmonyOS 5.0.0(12)）
  }
}

执行安装命令：

ohpm install

3. 配置系统能力与权限（module.json5）

该接口依赖 SystemCapability.Payment.Wallet 系统能力，且需声明网络权限（用于云侧查询）：

{
  "module": {
    "name": "entry",
    "type": "entry",
    "requestPermissions": [
      {
        "name": "ohos.permission.INTERNET", // 云侧查询必需
        "usedScene": { "abilities": [".MainAbility"], "when": "always" }
      }
    ],
    "deviceCapability": [
      "SystemCapability.Payment.Wallet" // 声明 Wallet Kit 系统能力
    ]
  }
}

三、完整代码实现（ETS，适配 HarmonyOS 5.0.0 (12)+）

import wallet from '@ohos.wallet';
import promptAction from '@ohos.promptAction';
import { BusinessError } from '@ohos.base';

// 1. 配置核心参数（替换为你从 AGC 申请的 passType）
const AGC_PASS_TYPE = "hw_car_key_xxx"; // 你的 Wallet Kit 服务号
const TARGET_DEVICE_TYPE = "phone"; // 目标设备类型：phone/wear/all

// 2. 构造 passStr 参数（必须为 JSON String 格式）
function buildPassStr(): string {
  const passObj = {
    passType: AGC_PASS_TYPE,
    targetDeviceType: TARGET_DEVICE_TYPE
  };
  return JSON.stringify(passObj);
}

// 3. 调用 queryPassDeviceInfo 检测 UWB 及设备能力（数字车钥匙专用）
async function checkUwbForCarKeyByWalletKit() {
  try {
    const passStr = buildPassStr();
    // 调用 Wallet Kit 接口查询设备能力
    const resultStr = await wallet.queryPassDeviceInfo(passStr);
    // 解析返回结果（JSON String 转对象）
    const deviceResult = JSON.parse(resultStr);

    // 4. 提取核心信息，重点判断 UWB 支持性
    const {
      deviceType, // 设备类型：phone/wear
      passDeviceId, // 账号/设备联合标识符（后续车钥匙绑定用）
      deviceModel, // 设备名（如 Pura 70 Ultra）
      deviceCapabilities // 设备能力集（核心：判断 UWB）
    } = deviceResult;

    // 5. 解读 deviceCapabilities：判断是否支持 UWB
    const isUwbSupported = deviceCapabilities.includes("0202"); // UWB 对应编码：0202
    const isNfcSupported = deviceCapabilities.includes("0200"); // NFC 对应编码：0200
    const isBleSupported = deviceCapabilities.includes("0201"); // BLE 对应编码：0201

    // 6. 结果提示与后续处理（贴合数字车钥匙开发）
    if (isUwbSupported) {
      promptAction.showToast({ 
        message: `当前设备支持 UWB（数字车钥匙必备），设备标识：${passDeviceId.slice(0, 8)}...` 
      });
      console.log("数字车钥匙设备检测结果：", {
        deviceModel,
        isUwbSupported,
        isNfcSupported,
        isBleSupported,
        passDeviceId
      });
      // 后续：携带 passDeviceId 调用车厂接口，开通数字车钥匙
      this.openCarKeyWithDeviceId(passDeviceId);
    } else {
      promptAction.showToast({ message: "当前设备不支持 UWB，无法实现数字车钥匙无感解锁" });
      console.log("设备能力集：", deviceCapabilities, "不包含 UWB 编码 0202");
    }
  } catch (e) {
    const error = e as BusinessError;
    console.error("调用 queryPassDeviceInfo 失败：", error.code, error.message);
    promptAction.showToast({ message: "设备能力查询失败，请检查网络或 AGC 配置" });
  }
}

// 4. 后续：携带设备标识开通数字车钥匙（示例）
async function openCarKeyWithDeviceId(passDeviceId: string) {
  // 调用车厂/云侧接口，传入 passDeviceId 完成开卡
  console.log("开始开通数字车钥匙，设备标识：", passDeviceId);
  // 后续业务逻辑...
}

// 页面调用
@Entry
@Component
struct CarKeyUwbCheckPage {
  build() {
    Column() {
      Button("检测设备能力（数字车钥匙专用）")
        .backgroundColor("#007AFF")
        .fontColor(Color.White)
        .onClick(() => {
          checkUwbForCarKeyByWalletKit();
        })
    }
    .width('100%')
    .height('100%')
    .justifyContent(FlexAlign.Center)
  }
}

四、关键结果解读（重点关注 deviceCapabilities）

deviceCapabilities 是数组格式，返回设备支持的无线能力编码，对应关系如下（数字车钥匙核心关注）：

核心判断逻辑

• 若 deviceCapabilities 包含 0202：设备支持 UWB，可实现数字车钥匙的 UWB 无感解锁 / 定位功能；
• 若不包含 0202：设备无 UWB 硬件，仅能支持 NFC/BLE 版本的数字车钥匙，无法实现 UWB 相关功能。

五、与原生 uwb 模块 API 的选型对比（紧急调研参考）

六、紧急调研注意事项（避坑点）

1. passType 有效性：必须使用从 AGC 申请并审核通过的 passType，测试用的临时服务号可能无法返回 UWB 能力结果；
2. 网络要求：该接口需要设备联网（访问华为 Wallet 云服务），离线环境下调用会失败，调研时需确保设备网络通畅；
3. 系统版本严格匹配：仅支持 HarmonyOS 5.0.0 (12) 及以上版本（API 12），低版本设备调用会抛出「系统能力不支持」异常；
4. 签名一致性：鸿蒙项目的签名必须与 AGC 配置的应用签名一致，否则会返回「权限不足」错误，无法获取设备能力；
5. UWB 编码固定：UWB 对应的能力编码是 0202，无需额外解析，直接判断数组是否包含该值即可，无其他变体编码。

总结（紧急调研落地优先级）

1. 若你仅需快速确认设备是否支持 UWB：优先使用原生 uwb.isUwbSupported() API，无需复杂配置，本地离线即可获取结果；
2. 若你需调研数字车钥匙完整可行性：优先使用 queryPassDeviceInfo 接口，可同时确认 UWB/NFC/BLE 能力，且获取后续开发所需的设备安全标识，一步到位；
3. 批量设备调研：可先通过「系统设置」快速筛查（HarmonyOS 5.0+ 「更多连接」→「UWB」），再通过上述接口精准验证，提升调研效率。

通过该接口，你不仅能确认设备 UWB 支持性，还能为后续数字车钥匙的开卡、绑定流程做好准备，完美贴合你的开发需求，无需额外二次调研。

在HarmonyOS Next中，可以通过@ohos.connection模块下的uwb子模块来检测设备是否支持UWB功能。

核心方法是使用uwb.isUwbSupported()接口。该接口返回一个布尔值（boolean），true表示设备支持UWB，false则表示不支持。

基本使用步骤如下：

1. 导入模块：在代码文件顶部导入uwb模块。

   import { uwb } from '@ohos.connection';
   

2. 调用检测接口：在需要检测的地方（例如应用启动或功能入口）调用isUwbSupported()方法。

   let isSupported = uwb.isUwbSupported();
   console.log(`当前设备UWB支持状态: ${isSupported}`);
   

3. 根据结果执行逻辑：根据返回的结果决定是否启用或展示你的数字车钥匙相关功能。

   if (isSupported) {
       // 设备支持UWB，可以继续初始化UWB会话、测距等后续流程
       // 例如：开始扫描UWB标签或准备连接
   } else {
       // 设备不支持UWB，需要向用户提示或隐藏相关功能
       // 例如：显示“当前设备不支持UWB数字钥匙”的提示
   }
   

重要说明：

• 权限声明：使用UWB相关功能，需要在项目的module.json5配置文件中声明ohos.permission.UWB权限。

  "requestPermissions": [
    {
      "name": "ohos.permission.UWB"
    }
  ]
  

• 系统能力：此接口需要系统具备SystemCapability.Communication.Uwb.Core能力。
• 异步考虑：isUwbSupported()是同步接口。实际的UWB通信（如测距、数据传输）是异步操作，需要使用uwb.createUwbSession()等接口进行会话管理。

通过以上方法，你可以在代码中快速、准确地判断运行应用的设备是否具备UWB硬件能力，从而决定数字车钥匙功能的可用性。