harmony 鸿蒙@ohos.app.ability.UIServiceExtensionAbility (UIServiceExtensionAbility) (System API)

2025-06-12
浏览 (3)

@ohos.app.ability.UIServiceExtensionAbility (UIServiceExtensionAbility) (System API)

UIServiceExtensionAbility, inherited from ExtensionAbility, provides extension capabilities related to the floating window component. It is mainly used to provide services with UIs for third-party applications.

NOTE

The initial APIs of this module are supported since API version 14. Newly added APIs will be marked with a superscript to indicate their earliest API version.

The APIs of this module can be used only in the stage model.

The APIs of this module must be used in the main thread, but not in sub-threads such as Worker and TaskPool.

The APIs provided by this module are system APIs.

Modules to Import

import { UIServiceExtensionAbility } from '@kit.AbilityKit';

Properties

System capability: SystemCapability.Ability.AbilityRuntime.Core

System API: This is a system API.

Name	Type	Read Only	Optional	Description
context	UIServiceExtensionContext	Yes	No	Context environment for a UIServiceExtensionAbility.

UIServiceExtensionAbility.onCreate

onCreate(want: Want): void

Called to initialize the service logic.

System capability: SystemCapability.Ability.AbilityRuntime.Core

System API: This is a system API.

Parameters

Name	Type	Read Only	Optional	Description
want	Want	Yes	No	Want information about the UIServiceExtensionAbility, including the ability name and bundle name.

Example

import { UIServiceExtensionAbility, Want } from '@kit.AbilityKit';

class UIServiceExt extends UIServiceExtensionAbility {
  // Create a UIServiceExtensionAbility.
  onCreate(want: Want) {
    console.log(`onCreate, want: ${want.abilityName}`);
  }
}

UIServiceExtensionAbility.onRequest

onRequest(want: Want, startId: number): void

Called to request to start a UIServiceExtensionAbility. If the UIServiceExtensionAbility is started by calling startAbility or startUIServiceExtensionAbility, this callback will be invoked after onCreate. The value of startId is incremented for each UIServiceExtensionAbility that is started.

System capability: SystemCapability.Ability.AbilityRuntime.Core

System API: This is a system API.

Parameters

Name	Type	Read Only	Optional	Description
want	Want	Yes	No	Want information about the UIServiceExtensionAbility, including the ability name and bundle name.
startId	number	Yes	Number of UIServiceExtensionAbility start times. The initial value is 1, and the value is automatically incremented for each UIServiceExtensionAbility started.

Example

import { UIServiceExtensionAbility, Want} from '@kit.AbilityKit';

class UIServiceExt extends UIServiceExtensionAbility {
  onRequest(want: Want, startId: number) {
    console.log('onRequest, want:' + want.abilityName + ', startId:' + startId);
  }
}

UIServiceExtensionAbility.onConnect

onConnect(want: Want, proxy: UIServiceHostProxy): void

Called when the connection to a UIServiceExtensionAbility is established. If the UIServiceExtensionAbility is started by calling connectUIServiceExtensionAbility(), this callback will be invoked after onCreate(). This callback receives a UIServiceHostProxy object for communication between the client and server.

System capability: SystemCapability.Ability.AbilityRuntime.Core

System API: This is a system API.

Parameters

Name	Type	Read Only	Optional	Description
want	Want	Yes	No	Want information about the UIServiceExtensionAbility, including the ability name and bundle name.
proxy	UIServiceHostProxy	Yes	No	UIServiceHostProxy object, used for communication between the client and server.

Example

import { UIServiceExtensionAbility, Want, common} from '@kit.AbilityKit';

class UIServiceExt extends UIServiceExtensionAbility {
  onConnect(want: Want, proxy: common.UIServiceHostProxy){
    console.log('onConnect, want:' + want.abilityName + '');
  }
}

UIServiceExtensionAbility.onDisconnect

onDisconnect(want: Want, proxy: UIServiceHostProxy): void

Called when the connection to a UIServiceExtensionAbility is interrupted.

System capability: SystemCapability.Ability.AbilityRuntime.Core

System API: This is a system API.

Parameters

Name	Type	Read Only	Optional	Description
want	Want	Yes	No	Want information about the UIServiceExtensionAbility, including the ability name and bundle name.
proxy	UIServiceHostProxy	Yes	No	Proxy that sends data to the sender.

Example

import { UIServiceExtensionAbility, Want, common } from '@kit.AbilityKit';

class UIServiceExt extends UIServiceExtensionAbility {
  onDisconnect(want: Want, proxy: common.UIServiceHostProxy) {
    console.log('onDisconnect, want: ${want.abilityName}');
  }
}

UIServiceExtensionAbility.onWindowWillCreate

onWindowWillCreate(config: window.ExtensionWindowConfig): void

Called when a window will be created for the UIServiceExtensionAbility. Through window.ExtensionWindowConfig in the callback, the foreground application sends the parameters for creating the window to the UIServiceExtensionAbility.

System capability: SystemCapability.Ability.AbilityRuntime.Core

System API: This is a system API.

Parameters

Name	Type	Read Only	Optional	Description
config	window.ExtensionWindowConfig	Yes	No	Window configuration information.

Example

import { UIServiceExtensionAbility } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';

class UIServiceExt extends UIServiceExtensionAbility {
  onWindowWillCreate(config : window.ExtensionWindowConfig){
    console.log('onWindowWillCreate');
  }
}

UIServiceExtensionAbility.onWindowDidCreate

onWindowDidCreate(window: window.Window): void

Called when a window is created for the UIServiceExtensionAbility. Through this callback, the UIServiceExtensionAbility passes the created window object to the foreground application.

System capability: SystemCapability.Ability.AbilityRuntime.Core

System API: This is a system API.

Parameters

Name	Type	Read Only	Optional	Description
window	window.Window	Yes	No	Window object created.

Example

import { UIServiceExtensionAbility } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';

class ServiceExt extends UIServiceExtensionAbility {
  onWindowDidCreate(window : window.Window){
    console.log('onWindowDidCreate');
  }
}

UIServiceExtensionAbility.onData

onData(proxy: UIServiceHostProxy, data: Record<string, Object>): void

Callback invoked when data is received.

System capability: SystemCapability.Ability.AbilityRuntime.Core

System API: This is a system API.

Parameters

Name	Type	Read Only	Optional	Description
proxy	UIServiceHostProxy	Yes	No	Proxy that sends data to the client.
data	Record<string, Object>	Yes	No	Data received.

Example

import { UIServiceExtensionAbility, common} from '@kit.AbilityKit';

class ServiceExt extends UIServiceExtensionAbility {
  onData(proxy : common.UIServiceHostProxy, data : Record<string, Object> ){
    console.log('onData');
  }
}

UIServiceExtensionAbility.onDestroy

onDestroy(): void

Called to clear resources when this UIServiceExtensionAbility is destroyed.

System capability: SystemCapability.Ability.AbilityRuntime.Core

System API: This is a system API.

Example

import { UIServiceExtensionAbility } from '@kit.AbilityKit';

class ServiceExt extends UIServiceExtensionAbility {
  onDestroy() {
    console.log('onDestroy');
  }
}