程序包 ohos.ace.ability

接口 AceInternalAbility.AceInternalAbilityHandler

封闭类:

AceInternalAbility

public static interface AceInternalAbility.AceInternalAbilityHandler

Handles the requests from the local ability to call an internal ability.

从以下版本开始:

3

SystemCapability

SystemCapability.ACE.UIEngine

方法概要

限定符和类型	方法	说明
boolean	onRemoteRequest(int code, MessageParcel data, MessageParcel reply, MessageOption option)	Called when an internal ability request is received from the local ability.

方法详细资料

onRemoteRequest

boolean onRemoteRequest(int code,
                        MessageParcel data,
                        MessageParcel reply,
                        MessageOption option)
                 throws RemoteException

Called when an internal ability request is received from the local ability. You can implement this method to process the request, such as calling, subscribing, and unsubscribing the internal ability.

You need to specify the service code and request data of the internal ability. The request data structures vary depending on the request types.

• For a callAbility request, the data type is JSON object string. Call Parcel.readString() to read the string and parse the JSON object to obtain the data.
• For a subscribeAbilityEvent request, the data type is IRemoteObject. Call MessageParcel.readRemoteObject() to obtain the object, and call IRemoteObject.sendRequest(int, MessageParcel, MessageParcel, MessageOption) provided by the object to report events, which are distinguished by service codes. The request data needs to be serialized into a JSON object or JSON array string.
• For a unsubscribeAbilityEvent request, set the request data to null.

Before publishing your JavaScript APIs, ensure that the service codes and request data structures are forward-compatible.

参数:

code - Indicates the service code sent from the JavaScript side. Note that the service code must be forward-compatible.

data - Indicates the request data, which is a MessageParcel object sent from the JavaScript side. Note that the JSON string representation of the object must be forward-compatible.

reply - Indicates the response message, which is a MessageParcel object returned by the local service. Currently, the value can only be a string or null.

option - Indicates whether the operation is synchronous or asynchronous.

返回:

Returns true if the internal ability operation is successful; returns false otherwise.

抛出:

RemoteException - Throws this exception if an error occurs during remote processing.

从以下版本开始:

3