程序包 ohos.aafwk.ability.continuation

接口 IContinuationRegisterManager

public interface IContinuationRegisterManager

Provides methods for interacting with the hop task management service, including methods for registering and unregistering the ability to hop, updating the device connection state, and showing the list of devices that can be selected for hopping.

从以下版本开始:

5

方法概要

限定符和类型	方法	说明
void	disconnect()	Disconnects from the hop task management service.
void	register(String bundleName, ExtraParams parameter, IContinuationDeviceCallback deviceCallback, RequestCallback requestCallback)	Registers an ability to be hopped with the hop task management service and obtains the registration token assigned to the ability.
void	showDeviceList(int token, ExtraParams parameter, RequestCallback requestCallback)	Shows the list of devices that can be selected for ability hopping on the distributed network.
void	unregister(int token, RequestCallback requestCallback)	Unregisters a specified ability from the hop task management service based on the token obtained during ability registration.
void	updateConnectStatus(int token, String deviceId, int status, RequestCallback requestCallback)	Updates the connection state of the device where the specified ability is successfully hopped.

方法详细资料

register

void register(String bundleName,
              ExtraParams parameter,
              IContinuationDeviceCallback deviceCallback,
              RequestCallback requestCallback)

Registers an ability to be hopped with the hop task management service and obtains the registration token assigned to the ability.

You can use IContinuationDeviceCallback to listen for the device connection state changes after the user selects a device for ability hopping and implement your own processing logic. When the device is connected, IContinuationDeviceCallback#onConnected is called to initiate the ability hopping process; when the device is disconnected, IContinuationDeviceCallback#onDisconnected is called to perform related operations, for example, notify the user of the disconnection. In addition, you can obtain the registration token via RequestCallback#onResult.

To use this method, you must dynamically request the ohos.permission.DISTRIBUTED_DATASYNC permission from the user. The ohos.permission.DISTRIBUTED_DATASYNC permission is of the user_grant level.

参数:

bundleName - Indicates the bundle name of the application whose ability is to be hopped.

parameter - Indicates the ExtraParams object containing the extra parameters used to filter the list of available devices. This parameter can be null.

deviceCallback - Indicates the callback to be invoked when the connection state of the selected device changes.

requestCallback - Indicates the callback to be invoked when the hop task management service is connected.

从以下版本开始:

5

unregister

void unregister(int token,
                RequestCallback requestCallback)

Unregisters a specified ability from the hop task management service based on the token obtained during ability registration.

参数:

token - Indicates the registration token of the ability.

requestCallback - Indicates the callback to be invoked when the hop task management service is connected. This parameter can be null.

从以下版本开始:

5

updateConnectStatus

void updateConnectStatus(int token,
                         String deviceId,
                         int status,
                         RequestCallback requestCallback)

Updates the connection state of the device where the specified ability is successfully hopped.

After the hopping is successful, you can call this method in the UI thread to update the connection state of the hopped ability and the device connection state on the screen showing available devices.

参数:

token - Indicates the registration token of the ability.

deviceId - Indicates the ID of the device whose connection state is to be updated.

status - Indicates the connection state to update, which can be DeviceConnectState#FAILURE, DeviceConnectState#IDLE, DeviceConnectState#CONNECTING, DeviceConnectState#CONNECTED, or DeviceConnectState#DIS_CONNECTING.

requestCallback - Indicates the callback to be invoked when the hop task management service is connected. This parameter can be null.

从以下版本开始:

5

showDeviceList

void showDeviceList(int token,
                    ExtraParams parameter,
                    RequestCallback requestCallback)

Shows the list of devices that can be selected for ability hopping on the distributed network.

参数:

token - Indicates the registration token of the ability.

parameter - Indicates the ExtraParams object containing the extra parameters used to filter the list of available devices. This parameter can be null.

requestCallback - Indicates the callback to be invoked when the hop task management service is connected. This parameter can be null.

从以下版本开始:

5

disconnect

void disconnect()

Disconnects from the hop task management service.

You can call this method when the application is exiting.

从以下版本开始:

5