当前位置：首页 > web >正文

ArkUI-X与Android桥接通信之消息通信

web 2025/6/25 4:14:04

平台桥接用于客户端（ArkUI）和平台（Android或iOS）之间传递消息，即用于ArkUI与平台双向数据传递、ArkUI侧调用平台的方法、平台调用ArkUI侧的方法。本文主要介绍Android平台与ArkUI交互，ArkUI侧具体用法请参考Bridge API，Android侧参考BridgePlugin。

创建平台桥接

1.在ArkUI侧创建平台桥接。指定名称，该名称应与Android侧平台桥接的名称一致。通过创建的该对象即可调用平台桥接的方法。数据可以发送json格式或二进制格式。

// xxx.ets// 导入平台桥接模块
import bridge from '@arkui-x.bridge';// 创建平台桥接实例
const bridgeImpl = bridge.createBridge('Bridge');
// 创建平台桥接实例(二进制格式)
const bridgeImpl = bridge.createBridge('Bridge', BridgeType.BINARY_TYPE);

2.在Android侧创建BridgePlugin类。指定名称，该名称应与ArkUI侧平台桥接的名称一致。通过创建的该对象即可调用平台桥接的方法。

// xxx.javaBridge bridge = new Bridge(this, "Bridge", getBridgeManager());
Bridge bridge = new Bridge(this, "Bridge", getBridgeManager(), BridgePlugin.BridgeType.BINARY_TYPE);

ArkUI侧向Android侧传递数据

1.ArkUI侧向Android侧传递数据。

// xxx.etsprivate bridgeImpl = bridge.createBridge('Bridge');this.bridgeImpl.sendMessage('text').then((res)=>{// 监听Android侧的回执console.log('response: ' + res);
}).catch((err: Error) => {console.log('error: ' + JSON.stringify(err));
});

2.Android侧接收来自ArkUI侧的数据。

// xxx.java// 创建平台桥接实例(将在since 13废弃，推荐使用新构造方法)
public Bridge(Context context, String name, int id) {super(context, name, id);setMessageListener(this);
}// 创建平台桥接实例(新)
public Bridge(Context context, String name, BridgeManager bridgeManager) {super(context, name, bridgeManager);setMessageListener(this);
}// 注册回调，监听ArkUI侧的数据传递
@Override
public Object onMessage(Object data) {// 返回回执给ArkUI侧return "java onMessage success";
}

Android侧向ArkUI侧传递数据

1.Android侧向ArkUI侧发送数据。

// xxx.javaString[] data = { "message", "from", "android" };
bridge.sendMessage(data);

2.ArkUI侧设置回调，用于接收Android侧发送的数据。

// xxx.etsprivate bridgeImpl = bridge.createBridge('Bridge');this.bridgeImpl.setMessageListener((message) => {console.log('receive message: ' + message);// 收到消息后，向Android侧发送回执return "ArkUI receive message success";
});

3.Android侧注册回调，监听ArkUI侧收到数据后的回执。

// xxx.java// 创建平台桥接实例(将在since 13废弃，推荐使用新构造方法)
public Bridge(Context context, String name, int id) {super(context, name, id);setMessageListener(this);
}// 创建平台桥接实例(新)
public Bridge(Context context, String name, BridgeManager bridgeManager) {super(context, name, bridgeManager);setMessageListener(this);
}// 注册回调，监听ArkUI侧的回执
@Override
public void onMessageResponse(Object data) {}