IT评测·应用市场-qidao123.com

标题: HarmonyOS NEXT应用开辟：Stage模型开辟-UIServiceExtension [打印本页]

---

作者: 火影    时间: 2025-3-12 00:41
标题: HarmonyOS NEXT应用开辟：Stage模型开辟-UIServiceExtension
 往期鸿蒙5.0全套实战文章必看：（文中附带全栈鸿蒙5.0学习资料）

• 鸿蒙开辟核心知识点，看这篇文章就够了
  
• 最新版！鸿蒙HarmonyOS Next应用开辟实战学习路线
  
• 鸿蒙HarmonyOS NEXT开辟技能最全学习路线指南
  
• 鸿蒙应用开辟实战项目，看这一篇文章就够了（部分项目附源码）
  

---

UIServiceExtension

概述

UIServiceExtension是UIService范例的ExtensionAbility浮窗类组件，提供UI界面（比方预览界面）和后台服务本领。组件内部持有了一个UIServiceExtensionContext，通过UIServiceExtensionContext提供了丰富的接供词外部使用。
本文描述中称被启动的UIServiceExtension为服务端，称启动UIServiceExtension的组件为客户端。
应用可以通过启动和毗连两种形式使用UIServiceExtension：

• 通过UIExtensionContext调用startUIServiceExtensionAbility()方法启动UIServiceExtension。
  
• 通过UIAbilityContext、UIExtensionContext调用connectUIServiceExtensionAbility()方法毗连UIServiceExtension。
  

   阐明
  

• 三方应用可以使用UIServiceExtension，不支持实现UIServiceExtension（需要系统权限）。
  
• 三方应用需要在前台获焦的情况下才能毗连系统提供的UIServiceExtension。
  
• UIServiceExtension的生命周期与绑定的窗口强关联，窗口销毁后UIServiceExtension也一起销毁。
  

  启动UIServiceExtension

应用通过startUIServiceExtensionAbility()方法启动一个UIServiceExtension。UIServiceExtension启动后，其生命周期独立于客户端，纵然客户端已经销毁，该后台服务仍可继续运行，窗口创建失败或销毁后该服务会被销毁。

1. import { common, Want } from '@kit.AbilityKit';
2. import { BusinessError } from '@kit.BasicServicesKit';
4. @Entry
5. @Component
6. struct Index {
7.   build() {
8.     Column() {
9.       Row() {
10.         // 创建启动按钮
11.         Button('start ability')
12.           .enabled(true)
13.           .onClick(() => {
14.             let context = getContext(this) as common.UIAbilityContext;
15.             let startWant: Want = {
16.               bundleName: 'com.acts.uiserviceextensionability',
17.               abilityName: 'UiServiceExtAbility',
18.             };
19.             try {
20.               // 启动UIServiceExtensionAbility
21.               context.startUIServiceExtensionAbility(startWant).then(() => {
22.                 console.log('startUIServiceExtensionAbility success');
23.               }).catch((error: BusinessError) => {
24.                 console.log('startUIServiceExtensionAbility error', JSON.stringify(error));
25.               })
26.             } catch (err) {
27.               console.log('startUIServiceExtensionAbility failed', JSON.stringify(err));
28.             }
29.           })
30.       }
31.     }
32.   }
33. }

复制代码

客户端毗连服务端

客户端通过connectUIServiceExtensionAbility()毗连服务端，获取并生存UIServiceProxy对象。通过该proxy对象的sendData()方法发送数据给服务端。服务端通过UIServiceExtensionAbility类onData()（系统接口）方法吸收客户端数据。

1. import { common, Want } from '@kit.AbilityKit';
2. import { BusinessError } from '@kit.BasicServicesKit';
4. @Entry
5. @Component
6. struct Index {
7.   comProxy: common.UIServiceProxy | null = null;
8.   connectCallback : common.UIServiceExtensionConnectCallback = {
9.     onData:(data: Record<string, Object>) => {
10.       console.log("received data", JSON.stringify(data));
11.     },
12.     onDisconnect:() => {
13.       console.log("onDisconnect ");
14.     }
15.   }
17.   build() {
18.     Column() {
19.       Row() {
20.         // 创建连接按钮
21.         Button("connect ability")
22.           .enabled(true)
23.           .onClick(() => {
24.             let context = getContext(this) as common.UIAbilityContext;
25.             let startWant:Want = {
26.               bundleName: 'com.acts.uiserviceextensionability',
27.               abilityName: 'UiServiceExtAbility',
28.             };
29.             try {
30.             // 连接UIServiceExtensionAbility
31.             context.connectUIServiceExtensionAbility(startWant, this.connectCallback).then((proxy: common.UIServiceProxy) => {
32.                 this.comProxy = proxy;
33.                 let formData: Record<string, string> = {
34.                   'test': 'test'
35.                 };
36.                 try {
37.                   this.comProxy.sendData(formData);
38.                 } catch (err) {
39.                   console.log('sendData failed', JSON.stringify(err));
40.                 };
41.               }).catch((err: BusinessError) => {
42.                 console.log("connectUIServiceExtensionAbility failed", JSON.stringify(err));
43.               });
44.             } catch(err) {
45.               console.log("connectUIServiceExtensionAbility failed", JSON.stringify(err));
46.             };
47.       })
48.       }
49.   }
50. }
51. }

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

---

欢迎光临 IT评测·应用市场-qidao123.com (https://dis.qidao123.com/)

Powered by Discuz! X3.4