logo
积分中心
HarmonyOS 分布式软总线的 RPC 跨设备调用与连接生命周期管理 原创
头像 不秃也能写代码 2026-11-17 13:32:22    发布
0 浏览 0 收藏

分布式软总线是鸿蒙跨设备协同的底层通信基座,它屏蔽了 Wi-Fi、蓝牙等物理传输差异,向上层提供统一的设备发现、连接和 RPC 调用接口。与上篇讨论的 distributedDataObject 数据同步不同,RPC 调用适合“在 A 设备触发 B 设备上的方法并获取返回值”的场景,例如手机遥控平板上的播放器、或手表向手机请求一段配置数据。

设备发现与连接建立

使用 @ohos.distributedDeviceManager 发现周边设备是 RPC 调用的前置步骤。以下代码展示了发现平板设备并获取其 networkId 的流程:

typescript

import deviceManager from '@ohos.distributedDeviceManager';
import common from '@ohos.app.ability.common';

async function findTablet(context: common.UIAbilityContext): Promise<string | null> {
  const dm = deviceManager.createDeviceManager(context.applicationInfo.name, (err) => {
    if (err) {
      console.error(`createDeviceManager failed: ${err.code}`);
    }
  });

  return new Promise((resolve) => {
    dm.on('deviceStateChange', (data) => {
      // 设备状态变化时重新获取可用列表
    });

    dm.startDeviceDiscovery({
      discoverTargetType: deviceManager.DiscoverTargetType.DISCOVER_TYPE_ALL
    });

    // 轮询或等待回调中匹配平板设备
    const devices = dm.getAvailableDeviceListSync();
    const tablet = devices.find(d => d.deviceType === deviceManager.DeviceType.TAB);
    resolve(tablet?.networkId ?? null);
  });
}

拿到 networkId 之后,通过 rpc.RemoteObject 和 connectAbility 建立 RPC 连接。服务端需要在 onConnect 回调中返回一个 RemoteObject 实例,客户端在 onConnect 中获得该对象的代理。

RPC 调用的超时与重连

跨设备 RPC 调用与本地调用最大的区别在于网络不可靠性。软总线虽然会自动选择最佳传输路径,但设备休眠、Wi-Fi 切换或距离变化都可能导致连接短暂不可用。服务端在 onRemoteMessageRequest 中处理请求时,无法感知客户端是否已经超时放弃。

实践中建议在客户端侧为每次 RPC 调用设置独立的超时控制,而不是依赖软总线的默认行为:

typescript

import rpc from '@ohos.rpc';

async function callWithTimeout(
  proxy: rpc.IRemoteObject,
  code: number,
  data: rpc.MessageSequence,
  timeoutMs: number = 3000
): Promise<rpc.MessageSequence> {
  return new Promise((resolve, reject) => {
    const timer = setTimeout(() => {
      reject(new Error(`RPC call timeout after ${timeoutMs}ms`));
    }, timeoutMs);

    const reply = rpc.MessageSequence.create();
    const option = new rpc.MessageOption();

    proxy.sendMessageRequest(code, data, reply, option)
      .then(() => {
        clearTimeout(timer);
        resolve(reply);
      })
      .catch((err) => {
        clearTimeout(timer);
        reject(err);
      });
  });
}

超时后应主动调用 proxy.unregisterDeathRecipient 或关闭连接,避免残留的 RemoteObject 引用导致内存泄漏。重连逻辑建议以“连接断开事件”为触发点,而不是在每次 RPC 失败后都尝试重连,否则在设备离线场景下会产生大量无效重试。

连接状态的生命周期对齐

RPC 连接的生命周期应与页面的可见周期对齐。如果页面在 aboutToDisappear 中不释放连接,返回上一页再进入时会创建新的连接实例,旧连接可能因为 RemoteObject 未被回收而持续占用资源。建议在页面销毁时调用 disconnectAbility 并移除所有 deathRecipient 监听:

typescript

aboutToDisappear() {
  if (this.rpcProxy) {
    try {
      this.rpcProxy.unregisterDeathRecipient(this.deathRecipient);
    } catch (e) {
      // 连接可能已断开,忽略
    }
    this.rpcProxy = null;
  }
  if (this.connectionId) {
    this.context.disconnectAbility(this.connection);
    this.connectionId = undefined;
  }
}

分布式软总线的 RPC 能力在鸿蒙 6.0 中已较为稳定,但跨设备调用的调试成本高于本地代码。建议在开发阶段开启 hilog 的 RPC 域日志,实时观察连接建立、消息发送和断连事件的时间线。


©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255