1# HalfScreenLaunchComponent 2 3半屏嵌入式启动原子化服务组件，当被拉起方未授权嵌入式运行原子化服务时，宿主将使用跳出式拉起原子化服务。 4 5> **说明：** 6> 7> 该组件从API Version 18开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 8> 9> 如果需要在该组件中实现一个可嵌入式运行的原子化服务时，原子化服务必须继承自[EmbeddableUIAbility](../../apis-ability-kit/js-apis-app-ability-embeddableUIAbility.md)。若不继承自EmbeddableUIAbility，系统无法保证原子化服务功能正常。 10 11## 导入模块 12 13``` 14import { HalfScreenLaunchComponent } from '@kit.ArkUI'; 15``` 16 17## 子组件 18 19无 20 21## 属性 22不支持[通用属性](ts-component-general-attributes.md) 23 24## HalfScreenLaunchComponent 25 26HalfScreenLaunchComponent({ 27 content: Callback\<void>, 28 appId: string, 29 options?: AtomicServiceOptions, 30 onError?: ErrorCallback, 31 onTerminated?: Callback<TerminationInfo> 32 }) 33 34**装饰器类型：**\@Component 35 36**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 37 38**系统能力：** SystemCapability.ArkUI.ArkUI.Full 39 40**参数：** 41 42| 名称 | 类型 | 必填 | 装饰器类型 | 说明 | 43| -------- | -------- | -------- | -------- | -------- | 44| content | Callback\<void> | 是 | \@BuilderParam | 组件显示内容。 | 45| appId | string | 是 | - | 原子化服务appId。 | 46| options | [AtomicServiceOptions](../../apis-ability-kit/js-apis-app-ability-atomicServiceOptions.md) | 否 | - | 拉起原子化服务参数，默认为空。 | 47| onError |[ErrorCallback](../../apis-basic-services-kit/js-apis-base.md#errorcallback) | 否 | - | 被拉起的原子化服务扩展在运行过程中发生异常时触发本回调。 | 48| onTerminated | [Callback](../../apis-basic-services-kit/js-apis-base.md#callback)\<TerminationInfo> | 否 | - | 回调函数，入参用于接收原子化服务的返回结果，类型为TerminationInfo。 | 49 50## 示例 51 52该示例展示如何嵌入式拉起手机充值服务。 53 54```ts 55import { HalfScreenLaunchComponent } from '@kit.ArkUI'; 56 57@Entry 58@Component 59struct Index { 60 appId: string = "5765880207853275489"; //原子化服务appId 61 62 build() { 63 Column() { 64 HalfScreenLaunchComponent({ 65 appId: this.appId, 66 options: {}, 67 onTerminated: (info:TerminationInfo)=> { 68 console.info('onTerminated info = '+ info.want); 69 }, 70 onError: (err) => { 71 console.error(" onError code: " + err.code + ", message: ", err.message); 72 } 73 }) { 74 Column() { 75 Image($r('app.media.app_icon')) 76 Text('拉起手机充值') 77 }.width("80vp").height("80vp").margin({bottom:30}) 78 } // 通过尾随必包形式传入content 79 } 80 } 81 82} 83``` 84