IRemoteObject

所有已知实现类:

InstallerCallback, LocalRemoteObject, NfcController.ReaderModeCallbackStub, OnPermissionChangedCallback, RemoteObject, RemoteProxy
```
public interface IRemoteObject
```
A remote object interface that must be implemented by service providers and users.
This interface can be used to query or obtain an interface descriptor, add or remove a death notification, dump object status to a specific file, and send messages.

从以下版本开始:

1

嵌套类概要

嵌套类
限定符和类型	接口	说明
`static interface`	`IRemoteObject.DeathRecipient`	Represents an inner class of `IRemoteObject` that subscribes to death notifications of a `RemoteObject`.

字段概要

字段
限定符和类型	字段	说明
`static int`	`DUMP_TRANSACTION`	Indicates the message code for a dump operation.
`static int`	`INTERFACE_TRANSACTION`	Indicates the message code for a transmission.
`static int`	`MAX_TRANSACTION_ID`	Indicates the maximum value of a valid message code.
`static int`	`MIN_TRANSACTION_ID`	Indicates the minimum value of a valid message code.
`static int`	`PING_TRANSACTION`	Indicates the message code for a Ping operation.

方法概要

所有方法实例方法抽象方法
限定符和类型	方法	说明
`boolean`	`addDeathRecipient(IRemoteObject.DeathRecipient recipient, int flags)`	Registers a callback used to receive notifications of the death of a remote object.
`void`	`dump(FileDescriptor fd, String[] args)`	Dumps object status to a specific file.
`String`	`getInterfaceDescriptor()`	Obtains the interface descriptor of an object.
`boolean`	`isObjectDead()`	Checks whether an object is dead.
`IRemoteBroker`	`queryLocalInterface(String descriptor)`	Queries the description of an interface.
`boolean`	`removeDeathRecipient(IRemoteObject.DeathRecipient recipient, int flags)`	Deregisters a callback used to receive notifications of the death of a remote object.
`boolean`	`sendRequest(int code, MessageParcel data, MessageParcel reply, MessageOption option)`	Sends a `MessageParcel` message to the peer process in synchronous or asynchronous mode.
`void`	`slowPathDump(FileDescriptor fd, String[] args)`	Asynchronously dumps data to a specified file.

- 字段详细资料
  - DUMP_TRANSACTION
```
static final int DUMP_TRANSACTION
```
    Indicates the message code for a dump operation.
    
    另请参阅:
    
    常量字段值
  - INTERFACE_TRANSACTION
```
static final int INTERFACE_TRANSACTION
```
    Indicates the message code for a transmission.
    
    另请参阅:
    
    常量字段值
  - MAX_TRANSACTION_ID
```
static final int MAX_TRANSACTION_ID
```
    Indicates the maximum value of a valid message code.
    This constant is used to check the validity of an operation.
    
    另请参阅:
    
    常量字段值
  - MIN_TRANSACTION_ID
```
static final int MIN_TRANSACTION_ID
```
    Indicates the minimum value of a valid message code.
    This constant is used to check the validity of an operation.
    
    另请参阅:
    
    常量字段值
  - PING_TRANSACTION
```
static final int PING_TRANSACTION
```
    Indicates the message code for a Ping operation.
    
    另请参阅:
    
    常量字段值
- 方法详细资料
  - queryLocalInterface
```
IRemoteBroker queryLocalInterface(String descriptor)
```
    Queries the description of an interface.
    A valid IRemoteBroker object is returned for an interface used by the service provider; null is returned for an interface used by the service user, indicating that the interface is not a local one.
    
    参数:
    
    descriptor - Indicates a string of the interface descriptor.
    
    返回:
    
    Returns the IRemoteBroker object bound to the specified interface descriptor.
    
    从以下版本开始:
    
    1
  - sendRequest
```
boolean sendRequest(int code,
                    MessageParcel data,
                    MessageParcel reply,
                    MessageOption option)
             throws RemoteException
```
    Sends a MessageParcel message to the peer process in synchronous or asynchronous mode.
    If asynchronous mode is set for option, a response is returned immediately. If synchronous mode is set for option, the interface will wait for a response from the peer process until the request times out. The user must prepare reply for receiving the execution result given by the peer process.
    
    参数:
    
    code - Indicates the message code, which is determined by both sides of the communication. If the interface is generated by the IDL tool, the message code is automatically generated by IDL.
    
    data - Indicates the MessageParcel object sent to the peer process.
    
    reply - Indicates the MessageParcel object returned by the peer process.
    
    option - Indicates the synchronous or asynchronous mode to send messages.
    
    返回:
    
    Returns true if the method is called successfully; returns false otherwise.
    
    抛出:
    
    RemoteException - Throws this exception if the method fails to be called.
    
    从以下版本开始:
    
    1
  - addDeathRecipient
```
boolean addDeathRecipient(IRemoteObject.DeathRecipient recipient,
                          int flags)
```
    Registers a callback used to receive notifications of the death of a remote object.
    This method is called if the remote object process matching the RemoteProxy object dies.
    
    参数:
    
    recipient - Indicates the callback to be registered.
    
    flags - Indicates the flag of the death notification.
    
    返回:
    
    Returns true if the callback is registered successfully; returns false otherwise.
    
    从以下版本开始:
    
    1
  - removeDeathRecipient
```
boolean removeDeathRecipient(IRemoteObject.DeathRecipient recipient,
                             int flags)
```
    Deregisters a callback used to receive notifications of the death of a remote object.
    
    参数:
    
    recipient - Indicates the callback to be deregistered.
    
    flags - Indicates the flag of the death notification.
    
    返回:
    
    Returns true if the callback is deregistered successfully; returns false otherwise.
    
    从以下版本开始:
    
    1
  - getInterfaceDescriptor
```
String getInterfaceDescriptor()
```
    Obtains the interface descriptor of an object.
    The interface descriptor is a character string.
    
    返回:
    
    Returns the interface descriptor.
    
    从以下版本开始:
    
    1
  - dump
```
void dump(FileDescriptor fd,
          String[] args)
   throws RemoteException
```
    Dumps object status to a specific file.
    
    参数:
    
    fd - Indicates the descriptor of the target file.
    
    args - Indicates parameters of this method in character string format.
    
    抛出:
    
    RemoteException - Throws this exception if the dump fails.
    
    从以下版本开始:
    
    1
  - slowPathDump
```
void slowPathDump(FileDescriptor fd,
                  String[] args)
           throws RemoteException
```
    Asynchronously dumps data to a specified file.
    This method applies only to data dump on the same device.
    
    参数:
    
    fd - Indicates the file descriptor of the target file.
    
    args - Indicates the arguments (an array of strings) to dump.
    
    抛出:
    
    RemoteException - Throws this exception if the dump command fails to be sent or an error occurs during the dump.
    
    从以下版本开始:
    
    5
  - isObjectDead
```
boolean isObjectDead()
```
    Checks whether an object is dead.
    
    返回:
    
    Returns true if the object is dead; returns false otherwise.
    
    从以下版本开始:
    
    1

接口 IRemoteObject

嵌套类概要

字段概要

方法概要

字段详细资料

DUMP_TRANSACTION

INTERFACE_TRANSACTION

MAX_TRANSACTION_ID

MIN_TRANSACTION_ID

PING_TRANSACTION

方法详细资料

queryLocalInterface

sendRequest

addDeathRecipient

removeDeathRecipient

getInterfaceDescriptor

dump

slowPathDump

isObjectDead