• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# InnerFullScreenLaunchComponent (系统接口)
2
3<!--Kit: ArkUI-->
4<!--Subsystem: ArkUI-->
5<!--Owner: @qq_36417014-->
6<!--Designer: @autojuan-->
7<!--Tester: @tinygreyy-->
8<!--Adviser: @zengyawen-->
9
10非显式全屏启动原子化服务组件,拉起方可以选择拉起原子化服务的时机。当被拉起方授权使用方可以嵌入式运行原子化服务时,使用方全屏嵌入式运行原子化服务;未授权时,使用方跳出式拉起原子化服务。
11
12> **说明:**
13>
14> 该组件从API Version 12开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
15>
16> 如果需要在该组件中实现一个可嵌入式运行的原子化服务时,必须继承自[EmbeddableUIAbility](../../apis-ability-kit/js-apis-app-ability-embeddableUIAbility.md)。若不继承自EmbeddableUIAbility,系统无法保证原子化服务功能正常。
17
18
19## 导入模块
20
21```ts
22import { InnerFullScreenLaunchComponent, LauncherController } from '@kit.ArkUI';
23```
24
25
26## 子组件
27
2829
30## 属性
31不支持[通用属性](ts-component-general-attributes.md)
32
33## InnerFullScreenLaunchComponent
34
35InnerFullScreenLaunchComponent({ content: Callback\<void>, controller: LaunchController })
36
37**装饰器类型:**\@Component
38
39**系统接口:** 此接口为系统接口。
40
41**系统能力:** SystemCapability.ArkUI.ArkUI.Full
42
43
44**参数:**
45
46
47| 名称 | 类型 | 必填 | 装饰器类型 | 说明 |
48| -------- | -------- | -------- | -------- | -------- |
49| content | Callback\<void> | 是 | \@BuilderParam | 组件显示内容。 |
50| controller | [LaunchController](#launchcontroller) | 是 | - | 拉起原子化服务控制器。 |
51| onReceive<sup>20+<sup> | [Callback](../../apis-basic-services-kit/js-apis-base.md#callback)\<Record<string, Object>> | 否 | - | 被拉起的嵌入式运行原子化服务通过[Window](../../../windowmanager/application-window-stage.md)调用API时,触发本回调。 |
52
53## LaunchController
54
55**系统接口:** 此接口为系统接口。
56
57**系统能力:** SystemCapability.ArkUI.ArkUI.Full
58
59| 名称 | 类型 | 必填 | 说明 |
60| ---- | ---------- | ------ |------ |
61|launchAtomicService | [LaunchAtomicServiceCallback](#launchatomicservicecallback) | 是 | 拉起原子化服务。 |
62
63## LaunchAtomicServiceCallback
64
65**系统接口:** 此接口为系统接口。
66
67**系统能力:** SystemCapability.ArkUI.ArkUI.Full
68
69| 名称 | 类型 | 必填 | 说明 |
70| --------------- | ------ |------ |------ |
71|appId | string |是| 原子化服务的appId。 |
72| options | [AtomicServiceOptions](../../apis-ability-kit/js-apis-app-ability-atomicServiceOptions.md) | 否 | 拉起原子化服务参数。 |
73
74## 事件
75不支持[通用事件](ts-component-general-events.md)
76
77## 示例
78
79```ts
80import { InnerFullScreenLaunchComponent, LaunchController } from '@kit.ArkUI';
81
82@Entry
83@Component
84struct Index {
85
86  @Builder
87  ColumChild() {
88    Column() {
89      Text('InnerFullScreenLaunchComponent').fontSize(16).margin({top: 100})
90      Button('start 日出日落')
91        .onClick(()=>{
92          let appId1: string = '576****************';
93          this.controller.launchAtomicService(appId1, {});
94        }).height(30).width('50%').margin({top: 50})
95      Button('start 充值')
96        .onClick(()=>{
97          let appId2: string = '576****************';
98          this.controller.launchAtomicService(appId2, {});
99        }).height(30).width('50%').margin({top: 50})
100    }.backgroundColor(Color.Pink).height('100%').width('100%')
101  }
102  controller: LaunchController = new LaunchController();
103
104  build() {
105    Column() {
106      InnerFullScreenLaunchComponent({
107          content: this.ColumChild,
108          controller: this.controller,
109          onReceive: (data) => {
110            console.info("onReceive, data: " + data['ohos.atomicService.window']);
111          }
112        })
113    }
114    .width('100%').height('100%')
115  }
116}
117
118```
119