大网数据广告活动
OpenHarmony 设备与应用开发

OpenHarmony 中文参考:FullScreenLaunchComponent

· 52CE 我爱测

全屏启动原子化服务组件,当被拉起方授权使用方可以嵌入式运行原子化服务时,使用方全屏嵌入式运行原子化服务;未授权时,使用方跳出式拉起原子化服务。

FullScreenLaunchComponent

全屏启动原子化服务组件,当被拉起方授权使用方可以嵌入式运行原子化服务时,使用方全屏嵌入式运行原子化服务;未授权时,使用方跳出式拉起原子化服务。

说明:

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

该组件不支持在Wearable设备上使用。

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

导入模块

子组件

无

属性

不支持通用属性。

事件

不支持通用事件。

FullScreenLaunchComponent

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

装饰器类型:@Component

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

名称 类型 必填 装饰器类型 说明
content Callback<void> 是 @BuilderParam 可以使用组件组合来自定义拉起原子化服务前的占位图标,实现类似大桌面应用图标的效果。点击占位组件后,将拉起原子化服务。
原子化服务API: 从API version 12开始,该接口支持在原子化服务中使用。
appId string 是 - 需要拉起的原子化服务appId,appId是原子化服务的唯一标识。
原子化服务API: 从API version 12开始,该接口支持在原子化服务中使用。
options AtomicServiceOptions 否 - 拉起原子化服务参数。
原子化服务API: 从API version 12开始,该接口支持在原子化服务中使用。
onError18+ ErrorCallback 否 - 被拉起的嵌入式运行原子化服务在运行过程中发生异常时触发本回调。可通过回调参数中的code、name和message获取错误信息并做处理。
原子化服务API: 从API version 18开始,该接口支持在原子化服务中使用。
onTerminated18+ Callback<TerminationInfo> 否 - 被拉起的嵌入式运行原子化服务通过点击原子化服务退出按钮、手势侧滑、调用terminateSelfWithResult或者terminateSelf正常退出时,触发本回调函数。
原子化服务API: 从API version 18开始,该接口支持在原子化服务中使用。
onReceive20+ Callback<Record<string, Object>> 否 - 被拉起的嵌入式运行原子化服务通过Window调用API时,触发本回调。
原子化服务API: 从API version 20开始,该接口支持在原子化服务中使用。

说明:

  • 若原子化服务通过调用terminateSelfWithResult退出,其携带的信息会传给回调函数的入参;
  • 若原子化服务通过调用terminateSelf退出,上述回调函数的入参中,"code"取默认值"0","want"为"undefined";
  • 从API版本26.0.0开始,原子化服务通过手势侧滑退出触发onTerminated回调。

示例

本示例展示组件使用方法和扩展的原子化服务。实际运行时请使用开发者自己的原子化服务appId。

FullScreenLaunchComponent组件需要由使用方调用。在提供方完成本地的安装后,即可实现在使用方应用或者元服务中全屏嵌入式拉起提供方的效果。

使用方

// 使用方入口界面Index.ets内容如下:

@Entry
@Component
struct Index {
  @State appId: string = '6917573653426122083'; // 原子化服务appId

  build() {
    Row() {
      Column() {
        FullScreenLaunchComponent({
          content: ColumnChild,
          appId: this.appId,
          options: {},
          onTerminated: (info) => {
            console.info(`onTerminated code: ${info.code.toString()}`);
          },
          onError: (err) => {
            console.error(`onError code: ${err.code}, message: ${err.message}`);
          },
          onReceive: (data) => {
            console.info(`onReceive, data: ${JSON.stringify(data)}`);
          }
        }).width("80vp").height("80vp")
      }
      .width('100%')
    }
    .height('100%')
  }
}

@Builder
function ColumnChild() {
  Column() {
    Image($r('app.media.startIcon'))
    Text('test')
  }
}

组件提供方

原子化服务提供方需要修改两个文件:

  • 提供方入口文件:/src/main/ets/entryability/EntryAbility.ets。

const DOMAIN = 0x0000;
  storage = new LocalStorage();
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate');
  }

  onDestroy(): void {
    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onDestroy');
  }

  onWindowStageCreate(windowStage: window.WindowStage): void {
    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
    let mainWindow = windowStage.getMainWindowSync()
    this.storage.setOrCreate("window", mainWindow)
    this.storage.setOrCreate("windowStage", windowStage)
    windowStage.loadContent('pages/Index', this.storage);
  }

  onWindowStageDestroy(): void {
    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageDestroy');
  }

  onForeground(): void {
    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onForeground');
  }

  onBackground(): void {
    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onBackground');
  }
}
  • 提供方扩展Ability入口页面文件:/src/main/ets/pages/Index.ets。

const DOMAIN = 0x0000;

@Entry
@Component
struct Index {
  private storage: LocalStorage | undefined = this.getUIContext().getSharedLocalStorage();

  build() {
    Row() {
      Column() {
        GridRow({ columns: 2 }) {
          GridCol() {
            Button("setWindowSystemBar")
              .onClick(() => {
                this.testSetSystemBarEnable()
              }).width(120)
          }.height(60)

          GridCol() {
            Button("setGestureBack")
              .onClick(() => {
                this.testSetGestureBackEnable()
              }).width(120)
          }.height(60)

          GridCol() {
            Button("setImmersive")
              .onClick(() => {
                this.testSetImmersiveEnable()
              }).width(120)
          }.height(60)

          GridCol() {
            Button("setSpecificSystemBarEnabled")
              .onClick(() => {
                this.testSetSpecificSystemBarEnabled()
              }).width(120)
          }.height(60)
        }
      }
      .width('100%')
    }
    .height('100%')
  }

  testSetSystemBarEnable() {
    let window: window.Window | undefined = this.storage?.get("window");
    let p = window?.setWindowSystemBarEnable(["status"])
    p?.then(() => {
      console.info('setWindowSystemBarEnable success');
    }).catch((err: BusinessError) => {
      console.error(`setWindowSystemBarEnable failed, error = ${JSON.stringify(err)}`);
    })
  }

  testSetGestureBackEnable() {
    let window: window.Window | undefined = this.storage?.get("window");
    let p = window?.setGestureBackEnabled(true)
    p?.then(() => {
      console.info('setGestureBackEnabled success');
    }).catch((err: BusinessError) => {
      console.error(`setGestureBackEnabled failed, error = ${JSON.stringify(err)}`);
    })
  }

  testSetImmersiveEnable() {
    let window: window.Window | undefined = this.storage?.get("window");
    try {
      window?.setImmersiveModeEnabledState(true)
    } catch (err) {
      console.error(`setImmersiveModeEnabledState failed, error = ${JSON.stringify(err)}`);
    }
  }

  testSetSpecificSystemBarEnabled() {
    let window: window.Window | undefined = this.storage?.get("window");
    let p = window?.setSpecificSystemBarEnabled('navigationIndicator', false, false)
    p?.then(() => {
      console.info('setSpecificSystemBarEnabled success');
    }).catch((err: BusinessError) => {
      console.error(`setSpecificSystemBarEnabled failed, error = ${JSON.stringify(err)}`);
    })
  }
}

本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
OpenHarmony 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。