InnerFullScreenLaunchComponent (系统接口)

非显式全屏启动原子化服务组件，拉起方可以选择拉起原子化服务的时机。当被拉起方授权使用方可以嵌入式运行原子化服务时，使用方全屏嵌入式运行原子化服务；未授权时，使用方跳出式拉起原子化服务。

说明：

该组件从API version 12开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

如果需要在该组件中实现一个可嵌入式运行的原子化服务时，必须继承自EmbeddableUIAbility。若不继承自EmbeddableUIAbility，系统无法保证原子化服务功能正常。

导入模块

import { InnerFullScreenLaunchComponent, LaunchController } from '@kit.ArkUI';

子组件

无

属性

不支持通用属性

InnerFullScreenLaunchComponent

InnerFullScreenLaunchComponent({ content: Callback<void>, controller: LaunchController, onReceive?: Callback<Record<string, Object>>, onError?: ErrorCallback, onTerminated?: Callback<TerminationInfo> })

装饰器类型：@Component

系统接口： 此接口为系统接口。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

名称	类型	必填	装饰器类型	说明
content	Callback<void>	是	@BuilderParam	组件显示内容。
controller	LaunchController	是	-	拉起原子化服务控制器。
onReceive20+	Callback<Record<string, Object>>	否	-	被拉起的嵌入式运行原子化服务通过@ohos.window (窗口)调用API时，触发本回调。
onError23+	ErrorCallback	否	-	被拉起的嵌入式运行原子化服务在运行过程中发生异常时触发本回调。可通过回调参数中的code、name和message获取错误信息并做处理。
onTerminated23+	Callback<TerminationInfo>	否	-	被拉起的嵌入式运行原子化服务通过点击原子化服务退出按钮、手势侧滑、调用terminateSelfWithResult或者terminateSelf正常退出时，触发本回调函数。

说明：

从API版本26.0.0开始，原子化服务通过手势侧滑退出触发onTerminated回调。

LaunchController

系统接口： 此接口为系统接口。

系统能力： SystemCapability.ArkUI.ArkUI.Full

名称	类型	只读	可选	说明
launchAtomicService	LaunchAtomicServiceCallback	否	否	拉起原子化服务。

LaunchAtomicServiceCallback

type LaunchAtomicServiceCallback = (appId: string, options?: AtomicServiceOptions) => void

拉起原子化服务触发的回调。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
appId	string	是	原子化服务的appId。
options	AtomicServiceOptions	否	拉起原子化服务参数。

事件

不支持通用事件

示例

import { InnerFullScreenLaunchComponent, LaunchController } from '@kit.ArkUI';

@Entry
@Component
struct Index {

  @Builder
  ColumnChild() {
    Column() {
      Text('InnerFullScreenLaunchComponent').fontSize(16).margin({top: 100})
      Button('start 日出日落')
        .onClick(()=>{
          let appId1: string = '576****************';
          this.controller.launchAtomicService(appId1, {});
        }).height(30).width('50%').margin({top: 50})
      Button('start 充值')
        .onClick(()=>{
          let appId2: string = '576****************';
          this.controller.launchAtomicService(appId2, {});
        }).height(30).width('50%').margin({top: 50})
    }.backgroundColor(Color.Pink).height('100%').width('100%')
  }
  controller: LaunchController = new LaunchController();

  build() {
    Column() {
      InnerFullScreenLaunchComponent({
          content: this.ColumnChild,
          controller: this.controller,
          onReceive: (data) => {
            console.info("onReceive, data: " + data['ohos.atomicService.window']);
          },
          onError: (err: Error) => {
            console.error("onError, err: " + JSON.stringify(err));
          },
          onTerminated: (info: TerminationInfo) => {
            console.info("onTerminated, info: " + JSON.stringify(info));
          }
        })
    }
    .width('100%').height('100%')
  }
}