1# ServiceExtensionAbility 2 3## 概述 4 5[ServiceExtensionAbility](../reference/apis/js-apis-app-ability-serviceExtensionAbility.md)是SERVICE类型的ExtensionAbility组件，提供后台服务能力，其内部持有了一个[ServiceExtensionContext](../reference/apis/js-apis-inner-application-serviceExtensionContext.md)，通过[ServiceExtensionContext](../reference/apis/js-apis-inner-application-serviceExtensionContext.md)提供了丰富的接口供外部使用。 6 7本文描述中称被启动的ServiceExtensionAbility为服务端，称启动ServiceExtensionAbility的组件为客户端。 8 9[ServiceExtensionAbility](../reference/apis/js-apis-app-ability-serviceExtensionAbility.md)可以被其他组件启动或连接，并根据调用者的请求信息在后台处理相关事务。[ServiceExtensionAbility](../reference/apis/js-apis-app-ability-serviceExtensionAbility.md)支持以启动和连接两种形式运行，系统应用可以调用[startServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartserviceextensionability)方法启动后台服务，也可以调用[connectServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextconnectserviceextensionability)方法连接后台服务，而三方应用只能调用[connectServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextconnectserviceextensionability)方法连接后台服务。启动和连接后台服务的差别： 10 11- **启动**：AbilityA启动ServiceB，启动后AbilityA和ServiceB为弱关联，AbilityA退出后，ServiceB可以继续存在。 12 13- **连接**：AbilityA连接ServiceB，连接后AbilityA和ServiceB为强关联，AbilityA退出后，ServiceB也一起退出。 14 15此处有如下细节需要注意： 16 17- 若Service只通过connect的方式被拉起，那么该Service的生命周期将受客户端控制，当客户端调用一次[connectServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextconnectserviceextensionability)方法，将建立一个连接，当客户端退出或者调用[disconnectServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextdisconnectserviceextensionability)方法，该连接将断开。当所有连接都断开后，Service将自动退出。 18 19- Service一旦通过start的方式被拉起，将不会自动退出，系统应用可以调用[stopServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstopserviceextensionability)方法将Service退出。 20 21> **说明：** 22> 23> 1. OpenHarmony当前不支持三方应用实现ServiceExtensionAbility。如果三方开发者想要实现后台处理相关事务的功能，可以使用后台任务，具体请参见[后台任务](../task-management/background-task-overview.md)。 24> 2. 三方应用的UIAbility组件可以通过Context连接系统提供的ServiceExtensionAbility。 25> 3. 三方应用需要在前台获焦的情况下才能连接系统提供的ServiceExtensionAbility。 26 27## 生命周期 28 29[ServiceExtensionAbility](../reference/apis/js-apis-app-ability-serviceExtensionAbility.md)提供了onCreate()、onRequest()、onConnect()、onDisconnect()和onDestory()生命周期回调，根据需要重写对应的回调方法。下图展示了ServiceExtensionAbility的生命周期。 30 31 **图1** ServiceExtensionAbility生命周期 32 33 34- **onCreate** 35 服务被首次创建时触发该回调，开发者可以在此进行一些初始化的操作，例如注册公共事件监听等。 36 37 > **说明：** 38 > 如果服务已创建，再次启动该ServiceExtensionAbility不会触发onCreate()回调。 39 40- **onRequest** 41 当另一个组件调用[startServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartserviceextensionability)方法启动该服务组件时，触发该回调。执行此方法后，服务会启动并在后台运行。每调用一次[startServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartserviceextensionability)方法均会触发该回调。 42 43- **onConnect** 44 当另一个组件调用[connectServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextconnectserviceextensionability)方法与该服务连接时，触发该回调。开发者在此方法中，返回一个远端代理对象（IRemoteObject），客户端拿到这个对象后可以通过这个对象与服务端进行RPC通信，同时系统侧也会将该远端代理对象（IRemoteObject）储存。后续若有组件再调用[connectServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextconnectserviceextensionability)方法，系统侧会直接将所保存的远端代理对象（IRemoteObject）返回，而不再触发该回调。 45 46- **onDisconnect** 47 当最后一个连接断开时，将触发该回调。客户端死亡或者调用[disconnectServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextdisconnectserviceextensionability)方法可以使连接断开。 48 49- **onDestroy** 50 当不再使用服务且准备将其销毁该实例时，触发该回调。开发者可以在该回调中清理资源，如注销监听等。 51 52## 实现一个后台服务（仅对系统应用开放） 53 54### 开发准备 55 56只有系统应用才允许实现ServiceExtensionAbility，因此开发者在开发之前需做如下准备： 57 58- **替换Full SDK**：ServiceExtensionAbility相关接口都被标记为System-API，默认对开发者隐藏，因此需要手动从镜像站点获取Full SDK，并在DevEco Studio中替换，具体操作可参考[替换指南](../quick-start/full-sdk-switch-guide.md)。 59 60- **申请AllowAppUsePrivilegeExtension特权**：只有具有AllowAppUsePrivilegeExtension特权的应用才允许开发ServiceExtensionAbility，具体申请方式可参考[应用特权配置指南](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。 61 62### 定义IDL接口 63 64ServiceExtensionAbility作为后台服务，需要向外部提供可调用的接口，开发者可将接口定义在idl文件中，并使用[IDL工具](../IDL/idl-guidelines.md)生成对应的proxy、stub文件。此处定义一个名为IIdlServiceExt.idl的文件作为示例： 65 66```cpp 67interface OHOS.IIdlServiceExt { 68 int ProcessData([in] int data); 69 void InsertDataToMap([in] String key, [in] int val); 70} 71``` 72 73在DevEco Studio工程Module对应的ets目录下手动新建名为IdlServiceExt的目录，将[IDL工具](../IDL/idl-guidelines.md)生成的文件复制到该目录下，并创建一个名为idl_service_ext_impl.ts的文件，作为idl接口的实现： 74 75``` 76├── ets 77│ ├── IdlServiceExt 78│ │ ├── i_idl_service_ext.ts # 生成文件 79│ │ ├── idl_service_ext_proxy.ts # 生成文件 80│ │ ├── idl_service_ext_stub.ts # 生成文件 81│ │ ├── idl_service_ext_impl.ts # 开发者自定义文件，对idl接口的具体实现 82│ └ 83└ 84``` 85 86idl_service_ext_impl.ts实现如下： 87 88```ts 89import {processDataCallback} from './i_idl_service_ext'; 90import {insertDataToMapCallback} from './i_idl_service_ext'; 91import IdlServiceExtStub from './idl_service_ext_stub'; 92 93const ERR_OK = 0; 94const TAG: string = "[IdlServiceExtImpl]"; 95 96// 开发者需要在这个类型里对接口进行实现 97export default class ServiceExtImpl extends IdlServiceExtStub { 98 processData(data: number, callback: processDataCallback): void { 99 // 开发者自行实现业务逻辑 100 console.info(TAG, `processData: ${data}`); 101 callback(ERR_OK, data + 1); 102 } 103 104 insertDataToMap(key: string, val: number, callback: insertDataToMapCallback): void { 105 // 开发者自行实现业务逻辑 106 console.info(TAG, `insertDataToMap, key: ${key} val: ${val}`); 107 callback(ERR_OK); 108 } 109} 110``` 111 112### 创建ServiceExtensionAbility 113 114在DevEco Studio工程中手动新建一个ServiceExtensionAbility，具体步骤如下： 115 1161. 在工程Module对应的ets目录下，右键选择“New > Directory”，新建一个目录并命名为ServiceExtAbility。 117 1182. 在ServiceExtAbility目录，右键选择“New > TypeScript File”，新建一个TypeScript文件并命名为ServiceExtAbility.ts。 119 120 ``` 121 ├── ets 122 │ ├── IdlServiceExt 123 │ │ ├── i_idl_service_ext.ts # 生成文件 124 │ │ ├── idl_service_ext_proxy.ts # 生成文件 125 │ │ ├── idl_service_ext_stub.ts # 生成文件 126 │ │ ├── idl_service_ext_impl.ts # 开发者自定义文件，对idl接口的具体实现 127 │ ├── ServiceExtAbility 128 │ │ ├── ServiceExtAbility.ts 129 └ 130 ``` 131 1323. 在ServiceExtAbility.ts文件中，增加导入ServiceExtensionAbility的依赖包，自定义类继承ServiceExtensionAbility并实现生命周期回调，在onConnect生命周期回调里，需要将之前定义的ServiceExtImpl对象返回。 133 134 ```ts 135 import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; 136 import ServiceExtImpl from '../IdlServiceExt/idl_service_ext_impl'; 137 138 const TAG: string = "[ServiceExtAbility]"; 139 140 export default class ServiceExtAbility extends ServiceExtensionAbility { 141 serviceExtImpl = new ServiceExtImpl("ExtImpl"); 142 143 onCreate(want) { 144 console.info(TAG, `onCreate, want: ${want.abilityName}`); 145 } 146 147 onRequest(want, startId) { 148 console.info(TAG, `onRequest, want: ${want.abilityName}`); 149 } 150 151 onConnect(want) { 152 console.info(TAG, `onConnect, want: ${want.abilityName}`); 153 // 返回ServiceExtImpl对象，客户端获取后便可以与ServiceExtensionAbility进行通信 154 return this.serviceExtImpl; 155 } 156 157 onDisconnect(want) { 158 console.info(TAG, `onDisconnect, want: ${want.abilityName}`); 159 } 160 161 onDestroy() { 162 console.info(TAG, `onDestroy`); 163 } 164 } 165 ``` 166 1674. 在工程Module对应的[module.json5配置文件](../quick-start/module-configuration-file.md)中注册ServiceExtensionAbility，type标签需要设置为“service”，srcEntry标签表示当前ExtensionAbility组件所对应的代码路径。 168 169 ```json 170 { 171 "module": { 172 ... 173 "extensionAbilities": [ 174 { 175 "name": "ServiceExtAbility", 176 "icon": "$media:icon", 177 "description": "service", 178 "type": "service", 179 "exported": true, 180 "srcEntry": "./ets/ServiceExtAbility/ServiceExtAbility.ts" 181 } 182 ] 183 } 184 } 185 ``` 186 187## 启动一个后台服务（仅对系统应用开放） 188 189系统应用通过[startServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextstartserviceextensionability)方法启动一个后台服务，服务的[onRequest()](../reference/apis/js-apis-app-ability-serviceExtensionAbility.md#serviceextensionabilityonrequest)回调就会被调用，并在该回调方法中接收到调用者传递过来的want对象。后台服务启动后，其生命周期独立于客户端，即使客户端已经销毁，该后台服务仍可继续运行。因此，后台服务需要在其工作完成时通过调用ServiceExtensionContext的[terminateSelf()](../reference/apis/js-apis-inner-application-serviceExtensionContext.md#serviceextensioncontextterminateself)来自行停止，或者由另一个组件调用[stopServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextstopserviceextensionability)来将其停止。 190 191> **说明：** 192> ServiceExtensionContext的[startServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextstartserviceextensionability)、[stopServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextstopserviceextensionability)和[terminateSelf()](../reference/apis/js-apis-inner-application-serviceExtensionContext.md#serviceextensioncontextterminateself)为系统接口，三方应用不支持调用。 193 1941. 在系统应用中启动一个新的ServiceExtensionAbility。示例中的context的获取方式请参见[获取UIAbility的上下文信息](uiability-usage.md#获取uiability的上下文信息)。 195 196 ```ts 197 let context = ...; // UIAbilityContext 198 let want = { 199 "deviceId": "", 200 "bundleName": "com.example.myapplication", 201 "abilityName": "ServiceExtAbility" 202 }; 203 context.startServiceExtensionAbility(want).then(() => { 204 console.info('Succeeded in starting ServiceExtensionAbility.'); 205 }).catch((err) => { 206 console.error(`Failed to start ServiceExtensionAbility. Code is ${err.code}, message is ${err.message}`); 207 }) 208 ``` 209 2102. 在系统应用中停止一个已启动的ServiceExtensionAbility。 211 212 ```ts 213 let context = ...; // UIAbilityContext 214 let want = { 215 "deviceId": "", 216 "bundleName": "com.example.myapplication", 217 "abilityName": "ServiceExtAbility" 218 }; 219 context.stopServiceExtensionAbility(want).then(() => { 220 console.info('Succeeded in stoping ServiceExtensionAbility.'); 221 }).catch((err) => { 222 console.error(`Failed to stop ServiceExtensionAbility. Code is ${err.code}, message is ${err.message}`); 223 }) 224 ``` 225 2263. 已启动的ServiceExtensionAbility停止自身。 227 228 ```ts 229 let context = ...; // ServiceExtensionContext 230 context.terminateSelf().then(() => { 231 console.info('Succeeded in terminating self.'); 232 }).catch((err) => { 233 console.error(`Failed to terminate self. Code is ${err.code}, message is ${err.message}`); 234 }) 235 ``` 236 237> **说明：** 238> 后台服务可以在后台长期运行，为了避免资源浪费，需要对后台服务的生命周期进行管理。即一个后台服务完成了请求方的任务，需要及时销毁。销毁已启动的后台服务有两种方式： 239> 240> - 后台服务自身调用[terminateSelf()](../reference/apis/js-apis-inner-application-serviceExtensionContext.md#serviceextensioncontextterminateself)方法来自行停止。 241> - 由其他组件调用[stopServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextstopserviceextensionability)方法来停止。 242> 调用[terminateSelf()](../reference/apis/js-apis-inner-application-serviceExtensionContext.md#serviceextensioncontextterminateself)或[stopServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextstopserviceextensionability)方法之后，系统将销毁后台服务。 243 244## 连接一个后台服务 245 246系统应用或者三方应用可以通过[connectServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextconnectserviceextensionability)连接一个服务（在Want对象中指定启动的目标服务），服务的[onConnect()](../reference/apis/js-apis-app-ability-serviceExtensionAbility.md#serviceextensionabilityonconnect)就会被调用，并在该回调方法中接收到调用者传递过来的Want对象，从而建立长连接。 247 248ServiceExtensionAbility服务组件在[onConnect()](../reference/apis/js-apis-app-ability-serviceExtensionAbility.md#serviceextensionabilityonconnect)中返回IRemoteObject对象，开发者通过该IRemoteObject定义通信接口，用于客户端与服务端进行RPC交互。多个客户端可以同时连接到同一个后台服务，客户端完成与服务的交互后，客户端需要通过调用[disconnectServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextdisconnectserviceextensionability)来断开连接。如果所有连接到某个后台服务的客户端均已断开连接，则系统会销毁该服务。 249 250- 使用connectServiceExtensionAbility()建立与后台服务的连接。示例中的context的获取方式请参见[获取UIAbility的上下文信息](uiability-usage.md#获取uiability的上下文信息)。 251 252 ```ts 253 let want = { 254 "deviceId": "", 255 "bundleName": "com.example.myapplication", 256 "abilityName": "ServiceExtAbility" 257 }; 258 let options = { 259 onConnect(elementName, remote) { 260 /* 此处的入参remote为ServiceExtensionAbility在onConnect生命周期回调中返回的对象, 261 * 开发者通过这个对象便可以与ServiceExtensionAbility进行通信，具体通信方式见下文 262 */ 263 console.info('onConnect callback'); 264 if (remote === null) { 265 console.info(`onConnect remote is null`); 266 return; 267 } 268 }, 269 onDisconnect(elementName) { 270 console.info('onDisconnect callback') 271 }, 272 onFailed(code) { 273 console.info('onFailed callback') 274 } 275 } 276 // 建立连接后返回的Id需要保存下来，在解绑服务时需要作为参数传入 277 let connectionId = this.context.connectServiceExtensionAbility(want, options); 278 ``` 279 280- 使用disconnectServiceExtensionAbility()断开与后台服务的连接。 281 282 ```ts 283 // connectionId为调用connectServiceExtensionAbility接口时的返回值，需开发者自行维护 284 this.context.disconnectServiceExtensionAbility(connectionId).then((data) => { 285 console.info('disconnectServiceExtensionAbility success'); 286 }).catch((error) => { 287 console.error('disconnectServiceExtensionAbility failed'); 288 }) 289 ``` 290 291## 客户端与服务端通信 292 293客户端在onConnect()中获取到[rpc.RemoteObject](../reference/apis/js-apis-rpc.md#iremoteobject)对象后便可与Service进行通信，有如下两种方式： 294 295- 使用服务端提供的IDL接口进行通信（推荐） 296 297 ```ts 298 // 客户端需要将服务端对外提供的idl_service_ext_proxy.ts导入到本地工程中 299 import IdlServiceExtProxy from '../IdlServiceExt/idl_service_ext_proxy'; 300 301 let options = { 302 onConnect(elementName, remote) { 303 console.info('onConnect callback'); 304 if (remote === null) { 305 console.info(`onConnect remote is null`); 306 return; 307 } 308 let serviceExtProxy = new IdlServiceExtProxy(remote); 309 // 通过接口调用的方式进行通信，屏蔽了RPC通信的细节，简洁明了 310 serviceExtProxy.processData(1, (errorCode, retVal) => { 311 console.info(`processData, errorCode: ${errorCode}, retVal: ${retVal}`); 312 }); 313 serviceExtProxy.insertDataToMap('theKey', 1, (errorCode) => { 314 console.info(`insertDataToMap, errorCode: ${errorCode}`); 315 }) 316 }, 317 onDisconnect(elementName) { 318 console.info('onDisconnect callback') 319 }, 320 onFailed(code) { 321 console.info('onFailed callback') 322 } 323 } 324 ``` 325 326- 直接使用[sendMessageRequest](../reference/apis/js-apis-rpc.md#sendmessagerequest9)接口向服务端发送消息（不推荐） 327 328 ```ts 329 import rpc from '@ohos.rpc'; 330 331 const REQUEST_CODE = 1; 332 let options = { 333 onConnect(elementName, remote) { 334 console.info('onConnect callback'); 335 if (remote === null) { 336 console.info(`onConnect remote is null`); 337 return; 338 } 339 // 直接调用rpc的接口向服务端发送消息，客户端需自行对入参进行序列化，对返回值进行反序列化，操作繁琐 340 let option = new rpc.MessageOption(); 341 let data = new rpc.MessageSequence(); 342 let reply = new rpc.MessageSequence(); 343 data.writeInt(100); 344 345 // @param code 表示客户端发送的服务请求代码。 346 // @param data 表示客户端发送的{@link MessageSequence}对象。 347 // @param reply 表示远程服务发送的响应消息对象。 348 // @param options 指示操作是同步的还是异步的。 349 // 350 // @return 如果操作成功返回{@code true}； 否则返回 {@code false}。 351 remote.sendMessageRequest(REQUEST_CODE, data, reply, option).then((ret) => { 352 let msg = reply.readInt(); 353 console.info(`sendMessageRequest ret:${ret} msg:${msg}`); 354 }).catch((error) => { 355 console.info('sendMessageRequest failed'); 356 }); 357 }, 358 onDisconnect(elementName) { 359 console.info('onDisconnect callback') 360 }, 361 onFailed(code) { 362 console.info('onFailed callback') 363 } 364 } 365 ``` 366 367## 服务端对客户端身份校验 368 369部分开发者需要使用ServiceExtension提供一些较为敏感的服务，因此需要对客户端身份进行校验，开发者可在IDL接口的stub端进行校验，IDL接口实现详见上文[定义IDL接口](#定义idl接口)，此处推荐两种校验方式： 370 371- **通过callerUid识别客户端应用** 372 373 通过调用[getCallingUid()](../reference/apis/js-apis-rpc.md#getcallinguid)接口获取客户端的uid，再调用[getBundleNameByUid()](../reference/apis/js-apis-bundleManager.md#bundlemanagergetbundlenamebyuid)接口获取uid对应的bundleName，从而识别客户端身份。此处需要注意的是[getBundleNameByUid()](../reference/apis/js-apis-bundleManager.md#bundlemanagergetbundlenamebyuid)是一个异步接口，因此服务端无法将校验结果返回给客户端，这种校验方式适合客户端向服务端发起执行异步任务请求的场景，示例代码如下： 374 375 ```ts 376 import rpc from '@ohos.rpc'; 377 import bundleManager from '@ohos.bundle.bundleManager'; 378 import { processDataCallback } from './i_idl_service_ext'; 379 import { insertDataToMapCallback } from './i_idl_service_ext'; 380 import IdlServiceExtStub from './idl_service_ext_stub'; 381 382 const ERR_OK = 0; 383 const ERR_DENY = -1; 384 const TAG: string = "[IdlServiceExtImpl]"; 385 386 export default class ServiceExtImpl extends IdlServiceExtStub { 387 processData(data: number, callback: processDataCallback): void { 388 console.info(TAG, `processData: ${data}`); 389 390 let callerUid = rpc.IPCSkeleton.getCallingUid(); 391 bundleManager.getBundleNameByUid(callerUid).then((callerBundleName) => { 392 console.info(TAG, 'getBundleNameByUid: ' + callerBundleName); 393 // 对客户端包名进行识别 394 if (callerBundleName != 'com.example.connectextapp') { // 识别不通过 395 console.info(TAG, 'The caller bundle is not in trustlist, reject'); 396 return; 397 } 398 // 识别通过，执行正常业务逻辑 399 }).catch(err => { 400 console.info(TAG, 'getBundleNameByUid failed: ' + err.message); 401 }); 402 } 403 404 insertDataToMap(key: string, val: number, callback: insertDataToMapCallback): void { 405 // 开发者自行实现业务逻辑 406 console.info(TAG, `insertDataToMap, key: ${key} val: ${val}`); 407 callback(ERR_OK); 408 } 409 } 410 ``` 411 412- **通过callerTokenId对客户端进行鉴权** 413 414 通过调用[getCallingTokenId()](../reference/apis/js-apis-rpc.md#getcallingtokenid)接口获取客户端的tokenID，再调用[verifyAccessTokenSync()](../reference/apis/js-apis-abilityAccessCtrl.md#verifyaccesstokensync)接口判断客户端是否有某个具体权限，由于OpenHarmony当前不支持自定义权限，因此只能校验当前[系统所定义的权限](../security/permission-list.md)。示例代码如下： 415 416 ```ts 417 import rpc from '@ohos.rpc'; 418 import abilityAccessCtrl from '@ohos.abilityAccessCtrl'; 419 import {processDataCallback} from './i_idl_service_ext'; 420 import {insertDataToMapCallback} from './i_idl_service_ext'; 421 import IdlServiceExtStub from './idl_service_ext_stub'; 422 423 const ERR_OK = 0; 424 const ERR_DENY = -1; 425 const TAG: string = "[IdlServiceExtImpl]"; 426 427 export default class ServiceExtImpl extends IdlServiceExtStub { 428 processData(data: number, callback: processDataCallback): void { 429 console.info(TAG, `processData: ${data}`); 430 431 let callerTokenId = rpc.IPCSkeleton.getCallingTokenId(); 432 let accessManger = abilityAccessCtrl.createAtManager(); 433 // 所校验的具体权限由开发者自行选择，此处ohos.permission.SET_WALLPAPER只作为示例 434 let grantStatus = 435 accessManger.verifyAccessTokenSync(callerTokenId, "ohos.permission.SET_WALLPAPER"); 436 if (grantStatus === abilityAccessCtrl.GrantStatus.PERMISSION_DENIED) { 437 console.info(TAG, `PERMISSION_DENIED`); 438 callback(ERR_DENY, data); // 鉴权失败，返回错误 439 return; 440 } 441 callback(ERR_OK, data + 1); // 鉴权通过，执行正常业务逻辑 442 } 443 444 insertDataToMap(key: string, val: number, callback: insertDataToMapCallback): void { 445 // 开发者自行实现业务逻辑 446 console.info(TAG, `insertDataToMap, key: ${key} val: ${val}`); 447 callback(ERR_OK); 448 } 449 } 450 ``` 451 452## 相关实例 453 454针对ServiceExtensionAbility开发，有以下相关实例可供参考： 455 456- [`AbilityConnectServiceExtension`：Ability与ServiceExtensionAbility通信（ArkTS）（API9）（Full SDK）](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/IDL/AbilityConnectServiceExtension) 457- [`StageModel`：Stage模型（ArkTS）（API9）（Full SDK）](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/ApplicationModels/StageModel) 458
