鸿蒙ArkUI-X跨语言调用说明：【平台桥接开发指南（Android）BridgePlugin】

jf_46214456 2024-05-22 1162

电子说

1.3w人已加入

描述

BridgePlugin (平台桥接)

本模块提供ArkUI端和Android平台端消息通信的功能，包括数据传输、方法调用和事件调用。需配套ArkUI端API使用，ArkUI侧具体用法请参考[Bridge API]。

说明：
开发前请熟悉鸿蒙开发指导文档：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

import ohos.ace.adapter.capability.bridge.BridgePlugin;

BridgePlugin

BridgePlugin(Context context, String bridgeName, int instanceId);

创建BridgePlugin类。

参数：

参数名	类型	必填	说明
context	Context	是	应用程序的上下文。
idgeName	string	是	定义桥接名称。
instanceId	int	是	实例ID。

返回值：

类型	说明
BridgePlugin	桥接结果接口。

示例：

public class BridgeImpl extends BridgePlugin {
  ...
}

BridgeImpl bridgeImpl = new BridgeImpl(this, "Bridge", getInstanceId());

callMethod

public void callMethod(MethodData methodData);

调用ArkUI端的方法。

参数：

参数名	类型	必填	说明
methodData	MethodData	是	方法数据结构。

MethodData结构

名称	类型	说明
methodName	String	方法名。
Parameters	Object[]	方法参数。

返回值：

无

示例：

Object[] paramObject = { "param1", "param2" };
MethodData methodData = new MethodData("jsMethod", paramObject);
bridgeImpl.callMethod(methodData);

sendMessage

public void sendMessage(Object data);

向ArkUI端发送数据。

参数：

参数名	类型	必填	说明
data	Object	是	数据。

返回值： 无

示例：

String[] data = { "message1", "message2" };
bridgeImpl.sendMessage(data);

setMessageListener

public void setMessageListener(IMessageListener messageListener);

注册消息监听。

参数：

参数名	类型	必填	说明
messageListener	IMessageListener	是	信息监听接口类。

IMessageListener

IMessageListener	参数	参数描述	返回值	说明
onMessage	data: Object	数据信息。	Object	等待ArkUI端发送信息。
onMessageResponse	data: Object	数据信息。	无	等待ArkUI端发送信息应答。

示例：

public BridgeImpl(Context context, String name, int id) {
    super(context, name, id);
    this.name = name;
    setMessageListener(this);
}

@Override
public Object onMessage(Object data) {
    ALog.i("onMessage data: ", data.toString());
    return jsonObject;
}

@Override
public void onMessageResponse(Object data) {
    ALog.i("onMessageResponse data: ", data.toString());
}

setMethodResultListener

public void setMethodResultListener(IMethodResult methodResultListener);

注册方法返回监听

参数：

参数名	类型	必填	说明
methodResultListener	IMethodResult	是	方法返回监听接口类。

IMethodResult

IMethodResult	参数	参数描述	返回值	说明
onSuccess	resultValue：Object	返回值信息。	无	调用方法返回成功。
onError	methodName : String errorCode : int errorMessage : string	方法名。错误类型。错误信息。	无	调用方法返回失败。
onMethodCancel	methodName : string	方法名。	无`HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿`	监听取消方法注册。

public BridgeImpl(Context context, String name, int id) {
    super(context, name, id);
    this.name = name;
    setMethodResultListener(this);
}

@Override
public void onSuccess(Object res) {
    ALog.i("onJsSendMethodResult result: ", res.toString());
}

@Override
public void onError(String name, int code, String message) {
    ALog.i("onError: ", message);
}

@Override
public void onMethodCancel(String name) {
    ALog.i("onCancel: ", name);
}

审核编辑黄宇

打开APP阅读更多精彩内容