半屏嵌入式启动元服务组件，当被拉起方未授权嵌入式运行元服务时，宿主将使用跳出式拉起元服务。

说明

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

如果需要在该组件中实现一个可嵌入式运行的元服务时，元服务必须继承自[EmbeddableUIAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-embeddableuiability)。若不继承自EmbeddableUIAbility，系统无法确保元服务正常运行。

## 导入模块

PhonePC/2in1TabletTVWearable



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

## 子组件

PhonePC/2in1TabletTVWearable

无

## 属性

PhonePC/2in1TabletTVWearable

不支持[通用属性](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-component-general-attributes)

## HalfScreenLaunchComponent

PhonePC/2in1TabletTVWearable

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

**装饰器类型：**@Component

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

**参数：**

展开

| 名称 | 类型 | 必填 | 装饰器类型 | 说明 |
| --- | --- | --- | --- | --- |
| content | Callback<void> | 是 | @BuilderParam | 组件显示内容。  **元服务API：** 从API version 18开始，该接口支持在元服务中使用。 |
| appId | string | 是 | - | 元服务appId。  **元服务API：** 从API version 18开始，该接口支持在元服务中使用。 |
| options | [AtomicServiceOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-atomicserviceoptions) | 否 | - | 拉起元服务参数，默认为空。  **元服务API：** 从API version 18开始，该接口支持在元服务中使用。 |
| onError | [ErrorCallback](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-base#errorcallback) | 否 | - | 被拉起的元服务扩展在运行过程中发生异常时触发本回调。  **元服务API：** 从API version 18开始，该接口支持在元服务中使用。 |
| onTerminated | [Callback](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-base#callback)<[TerminationInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-embedded-component#terminationinfo)> | 否 | - | 回调函数，入参用于接收元服务的返回结果，类型为TerminationInfo。  **元服务API：** 从API version 18开始，该接口支持在元服务中使用。 |
| onReceive20+ | [Callback](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-base#callback)<Record<string, Object>> | 否 | - | 被拉起的嵌入式运行元服务通过[Window](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/application-window-stage)调用API时，触发本回调。  **元服务API：** 从API version 20开始，该接口支持在元服务中使用。 |

## 示例

PhonePC/2in1TabletTVWearable

该示例展示如何嵌入式拉起手机充值服务。



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

3. @Entry
4. @Component
5. struct Index {
6. appId: string = "576****************"; // 元服务appId。

8. build() {
9. Column() {
10. HalfScreenLaunchComponent({
11. appId: this.appId,
12. options: {},
13. onTerminated:  (info:TerminationInfo)=> {
14. console.info('onTerminated info = '+ info.want);
15. },
16. onError: (err) => {
17. console.error(" onError code: " + err.code + ", message: ", err.message);
18. },
19. onReceive: (data) => {
20. console.info("onReceive, data: " + data['ohos.atomicService.window']);
21. }
22. }) {
23. Column() {
24. Image($r('app.media.app_icon'))
25. Text('拉起手机充值')
26. }.width("80vp").height("80vp").margin({bottom:30})
27. } // 通过尾随闭包形式传入content。
28. }
29. }

31. }
```