不秃也能写代码
2026-11-17 13:32:22 发布分布式软总线是鸿蒙跨设备协同的底层通信基座,它屏蔽了 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 域日志,实时观察连接建立、消息发送和断连事件的时间线。
暂无评论数据
发布
相关推荐
sky_Qian
0
0
sky_Qian
0
0
sky_Qian
2
0
张妍希
0
0
不秃也能写代码
我还没有写个人简介......
帖子
提问
粉丝
华为余承东:正考虑逐步将鸿蒙推向全球市场
2026-10-08 17:40:02 发布全新体验:钉钉鸿蒙PC版不只变好看,更是让每个操作都“懂你”
2026-08-13 17:04:02 发布


京公网安备:11010502051901号