HarmonyOS 7 NearLink SSAP 实战：Client/Server 建链、服务发现与近场数据通信

原创于 2026-09-20 11:51:44 发布 · 150 阅读

2 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

两台设备离得再近，不知道对方是谁、能干嘛，也传不了数据。

文章封面

做近场投屏控制的时候，最开始以为就是"设备靠近了直接连"，结果实际做下来发现不是那么回事：先得发现附近有什么设备，然后得确认对方能提供什么服务，再建立连接，最后才能开始传数据。

这一套流程下来，才把手机往平板发实时控制指令的功能跑通。这篇就沿着"两台设备第一次见面"这个过程，把 NearLink SSAP 的建链、发现、通信、断开整个生命周期拆清楚。

一、SSAP 是什么角色

先把概念理清楚：

概念	作用
NearLink	近场通信技术底层
SSAP	上层的服务访问协议
Server	提供服务的设备
Client	连接服务的设备
Service	一组相关能力的集合
Characteristic	Service 里的具体数据点

可以把整个过程想成打电话：

Server 是总机，有若干条业务线（Service）；
Client 是打电话的人，先得知道总机号码（发现设备）；
然后要拨对应的业务线（连接 Service）；
最后才能在这条线上传数据（读写 Characteristic）。

二、设备发现和业务通信不是一回事

最容易犯的错就是把"设备发现"和"业务通信"混为一谈。

阶段	做什么	状态
发现	扫描附近有哪些设备	还没连上
建链	和目标设备建立连接	连接中
服务发现	查询对方有哪些 Service	已连接
数据通信	读写 Characteristic 传数据	通信中

发现设备只是知道"附近有这么个东西"，不代表你已经能和它传数据了。发现完了还要建链、还要查服务、还要确认特征值，这一套走完才能真正传数据。

三、Server 侧怎么启动服务

Server 侧要做的事：启动 NearLink、创建 Server、注册 Service 和 Characteristic、开始监听连接。

这段代码解决什么问题： 在 Server 侧注册近场服务和特征值。
文件： ssap/Server.ets
用途： 启动 SSAP 服务端
接入位置： 服务启动阶段

import nearLink from '@ohos.nearlink';

class ControlServer {
  private ssapServer: nearLink.ssap.SsapServer;

  async start() {
    // 创建 Server
    this.ssapServer = nearLink.ssap.createSsapServer('control_service_id');
    
    // 注册 Service 和 Characteristic
    this.ssapServer.addService({
      serviceId: '12345678-1234-1234-1234-1234567890ab',
      characteristics: [{
        characteristicId: '87654321-4321-4321-4321-ba0987654321',
        properties: ['read', 'write', 'notify']
      }]
    });
    
    // 开始监听
    this.ssapServer.startAdvertising();
  }
}

这里 Service 和 Characteristic 的 ID 要提前定义好，Client 侧也要用同样的 ID 才能找到对应的服务。

四、Client 侧怎么连接和读写

Client 侧的流程是：扫描设备 → 找到目标 → 建立连接 → 发现服务 → 找到特征值 → 读写数据。

这段代码解决什么问题： Client 连接 Server 并发送控制指令。
文件： ssap/Client.ets
用途： 近场客户端连接与数据发送
接入位置： 点击"连接设备"按钮

class ControlClient {
  private ssapClient: nearLink.ssap.SsapClient;

  async connect(deviceAddress: string) {
    this.ssapClient = nearLink.ssap.createSsapClient();
    
    // 建立连接
    await this.ssapClient.connect(deviceAddress);
    
    // 发现服务
    const services = await this.ssapClient.discoverServices();
    
    // 找到目标特征值
    const char = services[0].characteristics[0];
    
    // 写入数据
    await this.ssapClient.writeCharacteristic(char, new TextEncoder().encode('play_pause'));
  }
}