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);
}
審核編輯 黃宇
-
Android
+關注
關注
12文章
3923瀏覽量
127129 -
橋接
+關注
關注
0文章
26瀏覽量
11207 -
鴻蒙
+關注
關注
57文章
2307瀏覽量
42737
發布評論請先 登錄
相關推薦
評論