HarmonyOS 鸿蒙Next中关于API 18的NearLink Kit的疑问

HarmonyOS 鸿蒙Next中关于API 18的NearLink Kit的疑问

我是想实现手机与开发板ws63e之间的星闪通信，遇到了一些无法解决的问题

手机是：Pura80 Pro(出厂api 18)

  1. scan：

startScan里面有个参数是扫描过滤器，里面条件(scanfilters)有：address, deviceName, manufacturerId(厂商id)，manufacturerData(厂商数据)，manufacturerDataMask(厂商数据掩码)，文档里面也有提示：“不允许filters中的所有ScanFilters都配置为空过滤器，否则返回错误码401。”

但是，我们有一份代码（api 13），没有给任何数据，包括地址、名称等，手机（Client）能够扫到开发板（Server）的地址，也成功连接上，这份代码跑在PuraX（api 17）上没问题，但是跑在我的Pura80 Pro上就报错误码401

  1. ssap：

它的情况是手机星闪服务端，开发板是客户端；

问题是：我的手机能够接收到开发板的连接和配对请求，已经在手机上显示弹窗询问是否配对，可是一旦配对就会立马断连（连接上后就立马断连）

state：1为连接，3为已断连


更多关于HarmonyOS 鸿蒙Next中关于API 18的NearLink Kit的疑问的实战教程也可以访问 https://www.itying.com/category-93-b0.html

2 回复

在HarmonyOS Next中，NearLink Kit是基于华为自研的星闪技术（NearLink）实现的短距无线通信框架。API 18提供的NearLink Kit支持低功耗、高带宽、低时延的P2P连接，适用于设备间快速数据传输。其核心功能包括设备发现、安全配对、组网通信等，支持广播/单播模式。与蓝牙/WiFi相比，星闪协议（1.0版本）理论峰值速率达12Mbps（20米内），时延可低至20μs。开发时需在module.json5中声明ohos.permission.NEARLINK权限。当前API 18文档中NearLink Kit的接口集中于连接管理（如createNearLinkProfile）和数据通道（sendData接口）。

更多关于HarmonyOS 鸿蒙Next中关于API 18的NearLink Kit的疑问的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


关于您提到的HarmonyOS Next中NearLink Kit的两个问题：

  1. 扫描过滤器问题： 在API 18中，NearLink Kit确实加强了对ScanFilters的校验。根据错误码401提示，现在必须至少指定一个有效的过滤条件。建议您修改代码，至少添加以下任一条件：
  • 目标设备的MAC地址(address)
  • 设备名称(deviceName)
  • 厂商ID(manufacturerId)
  • 厂商数据(manufacturerData)
  1. 配对后立即断连问题： 从日志看连接状态快速从1(连接)变为3(断开)，可能原因包括：
  • 设备间协议版本不兼容
  • 认证参数不匹配
  • 设备距离超出有效范围 建议检查：
  • 确保两端使用相同的NearLink协议版本
  • 验证配对参数(如PIN码)是否正确
  • 确认设备物理距离在有效范围内

API 18相比之前版本在NearLink安全性和稳定性方面有增强，这可能导致旧代码需要相应调整。

回到顶部