harmony 鸿蒙HalfScreenLaunchComponent

2025-06-12
浏览 (3)

HalfScreenLaunchComponent

HalfScreenLaunchComponent is a component designed for launching atomic services in half screen. If the invoked application (the one being launched) grants the invoker the authorization to run the atomic service in an embedded manner, the invoker can operate the atomic service in half-screen embedded mode. If authorization is not provided, the invoker will launch the atomic service in a pop-up manner.

NOTE

This component is supported since API version 18. Updates will be marked with a superscript to indicate their earliest API version.

To implement an embeddable atomic service, make sure it inherits from EmbeddableUIAbility. This ensures that it functions properly.

Modules to Import

import { HalfScreenLaunchComponent } from '@kit.ArkUI';

Child Components

Not supported

Attributes

The universal attributes are not supported.

HalfScreenLaunchComponent

HalfScreenLaunchComponent({
&emsp;content: Callback<void>,
&emsp;appId: string,
&emsp;options?: AtomicServiceOptions,
&emsp;onError?: ErrorCallback,
&emsp;onTerminated?: Callback<TerminationInfo>
})

Decorator: \@Component

Atomic service API: This API can be used in atomic services since API version 18.

System capability: SystemCapability.ArkUI.ArkUI.Full

Parameters

Name	Type	Mandatory	Decorator	Description
content	Callback<void>	Yes	\@BuilderParam	Content displayed in the component.
appId	string	Yes	-	Application ID for the atomic service.
options	AtomicServiceOptions	No	-	Parameters for starting the atomic service. The default value is empty.
onError	ErrorCallback	No	-	Invoked when an error occurs during the running of the atomic service.
onTerminated	Callback<TerminationInfo>	No	-	Callback used to return the result of the atomic service. The input parameter is of type TerminationInfo.

Example

This example demonstrates how to start a top-up service in embedded mode.

import { HalfScreenLaunchComponent } from '@kit.ArkUI';

@Entry
@Component
struct Index {
  appId: string = "5765880207853275489"; // Application ID of the top-up service

  build() {
    Column() {
      HalfScreenLaunchComponent({
        appId: this.appId,
        options: {},
        onTerminated:  (info:TerminationInfo)=> {
          console.log('onTerminated info = '+ info.want);
        },
        onError: (err) => {
          console.error(" onError code: " + err.code + ", message: ", err.message);
        }
      }) {
        Column() {
          Image($r('app.media.app_icon'))
          Text('Start top-up')
        }.width("80vp").height("80vp").margin({bottom:30})
      } // Content is passed as a trailing closure.
    }
  }

}