BridgePlugin (平臺(tái)橋接)
本模塊提供ArkUI端和Android平臺(tái)端消息通信的功能,包括數(shù)據(jù)傳輸、方法調(diào)用和事件調(diào)用。需配套ArkUI端API使用,ArkUI側(cè)具體用法請(qǐng)參考[Bridge API]。
說明:
開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔:[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
本模塊首批接口從API version 10開始支持。后續(xù)版本的新增接口,采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。
import ohos.ace.adapter.capability.bridge.BridgePlugin;
BridgePlugin
BridgePlugin(Context context, String bridgeName, int instanceId);
創(chuàng)建BridgePlugin類。
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
context | Context | 是 | 應(yīng)用程序的上下文。 |
idgeName | string | 是 | 定義橋接名稱。 |
instanceId | int | 是 | 實(shí)例ID。 |
返回值:
類型 | 說明 |
---|---|
BridgePlugin | 橋接結(jié)果接口。 |
示例:
public class BridgeImpl extends BridgePlugin {
...
}
BridgeImpl bridgeImpl = new BridgeImpl(this, "Bridge", getInstanceId());
callMethod
public void callMethod(MethodData methodData);
調(diào)用ArkUI端的方法。
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
methodData | MethodData | 是 | 方法數(shù)據(jù)結(jié)構(gòu)。 |
MethodData結(jié)構(gòu)
名稱 | 類型 | 說明 |
---|---|---|
methodName | String | 方法名。 |
Parameters | Object[] | 方法參數(shù)。 |
返回值:
無
示例:
Object[] paramObject = { "param1", "param2" };
MethodData methodData = new MethodData("jsMethod", paramObject);
bridgeImpl.callMethod(methodData);
sendMessage
public void sendMessage(Object data);
向ArkUI端發(fā)送數(shù)據(jù)。
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
data | Object | 是 | 數(shù)據(jù)。 |
返回值: 無
示例:
String[] data = { "message1", "message2" };
bridgeImpl.sendMessage(data);
setMessageListener
public void setMessageListener(IMessageListener messageListener);
注冊(cè)消息監(jiān)聽。
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
messageListener | IMessageListener | 是 | 信息監(jiān)聽接口類。 |
IMessageListener
IMessageListener | 參數(shù) | 參數(shù)描述 | 返回值 | 說明 |
---|---|---|---|---|
onMessage | data: Object | 數(shù)據(jù)信息。 | Object | 等待ArkUI端發(fā)送信息。 |
onMessageResponse | data: Object | 數(shù)據(jù)信息。 | 無 | 等待ArkUI端發(fā)送信息應(yīng)答。 |
示例:
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);
注冊(cè)方法返回監(jiān)聽
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
methodResultListener | IMethodResult | 是 | 方法返回監(jiān)聽接口類。 |
IMethodResult
IMethodResult | 參數(shù) | 參數(shù)描述 | 返回值 | 說明 |
---|---|---|---|---|
onSuccess | resultValue:Object | 返回值信息。 | 無 | 調(diào)用方法返回成功。 |
onError | methodName : String errorCode : int errorMessage : string | 方法名。 錯(cuò)誤類型。 錯(cuò)誤信息。 | 無 | 調(diào)用方法返回失敗。 |
onMethodCancel | methodName : string | 方法名。 | 無HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿 | 監(jiān)聽取消方法注冊(cè)。 |
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
+關(guān)注
關(guān)注
12文章
3945瀏覽量
128003 -
橋接
+關(guān)注
關(guān)注
0文章
37瀏覽量
11283 -
鴻蒙
+關(guān)注
關(guān)注
57文章
2395瀏覽量
43085
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
評(píng)論