HarmonyOS Sample 之 ServiceAbility 跨設備接口調用
作者：Buty9147
本示例演示了Service Ability的啟動、停止、連接、斷開連接等操作，支持對跨設備的Service Ability進行操作。
ServiceAbility 跨設備接口調用
介紹
本示例演示了Service Ability的啟動、停止、連接、斷開連接等操作，支持對跨設備的Service Ability進行操作。
你將學會以下三個知識點：
1.IDL的使用，以及IPC方法的調用
2.前臺Service的使用方法
3.EventHandle事件處理的使用方法
搭建環境
安裝DevEco Studio，詳情請參考DevEco Studio下載。
設置DevEco Studio開發環境，DevEco Studio開發環境需要依賴于網絡環境，需要連接上網絡才能確保工具的正常使用，可以根據如下兩種情況來配置開發環境：
- 如果可以直接訪問Internet，只需進行下載HarmonyOS SDK操作。
- 如果網絡不能直接訪問Internet，需要通過代理服務器才可以訪問，請參考配置開發環境。
代碼結構解讀
后臺邏輯
- │ config.json #全局配置文件
- │
- ├─idl
- │ └─ohos
- │ └─samples
- │ └─serviceability
- │ IRemoteAgent.idl #提供遠程接口idl文件
- │
- ├─java
- │ └─ohos
- │ └─samples
- │ └─serviceability
- │ │ ForegroundServiceAbility.java #前臺Service Ability
- │ │ LocalServiceAbility.java #模擬本地的Service Ability
- │ │ MainAbility.java
- │ │ RemoteAbility.java #模擬遠端的Service Ability
- │ │
- │ └─slice
- │ MainAbilitySlice.java #主能力頁
頁面布局文件只有一個 main_slice.xml
頁面布局
三個知識點
1.IDL的使用，以及IPC方法的調用
術語：
當客戶端和服務器通信時，需要定義雙方都認可的接口，以保障雙方可以成功通信，HarmonyOS IDL(HarmonyOS Interface Definition Language)則是一種定義此類接口的工具。
跨進程調用(IPC)inter-process communication 或 跨設備調用(RPC)remote procedure call
IDL接口使用規范：
https://developer.harmonyos.com/cn/docs/documentation/doc-references/idl-overview-0000001050762835
先聲明權限，同時敏感權限還需要請求用戶授權，前幾篇都有寫過這里就不寫了。
- "reqPermissions": [
- {
- "name": "ohos.permission.GET_DISTRIBUTED_DEVICE_INFO"
- },
- ...
- {
- "name": "ohos.permission.DISTRIBUTED_DATASYNC"
- }
- ]
a.創建.idl文件
IRemoteAgent.idl
- // Declare any non-default types here with sequenceable or interface statements
- interface ohos.samples.serviceability.IRemoteAgent {
- /*
- * Demo service method use some parameters
- */
- void setRemoteObject([in] String param);
- }
b.編譯idl文件，生成對應的接口類、樁類和代理類
c.服務端IDL的實現
- private static final String DESCRIPTOR = "ohos.samples.serviceability.RemoteAbility";
- //idl的服務端實現，
- RemoteAgentStub remoteAgentStub = new RemoteAgentStub(DESCRIPTOR) {
- @Override
- public void setRemoteObject(String param) {
- HiLog.info(LABEL_LOG, "%{public}s", "setRemoteObject："+param);
- //不能這樣，要用下面通知的方式
- //showTips(RemoteAbility.this, param);
- //賦值
- param_mess=param;
- //事件通知
- eventHandler.sendEvent(EVENT_ABILITY_MESS);
- }
- };
d.客戶端調用IPC方法
- //IDL代理類
- private RemoteAgentProxy remoteAgentProxy;
- /**
- * 連接 Service
- * @param isConnectRemote
- */
- private void connectService(boolean isConnectRemote) {
- //三元表達式，判斷連接本地還是遠端Service
- Intent intent = isConnectRemote
- ? getRemoteServiceIntent(REMOTE_BUNDLE, REMOTE_SERVICE)
- : getLocalServiceIntent(LOCAL_BUNDLE, NORMAL_SERVICE);
- //連接 Service
- boolean isConnect=connectAbility(intent,connection);
- if (isConnect && remoteAgentProxy!=null) {
- try {
- //調用服務端IPC方法
- remoteAgentProxy.setRemoteObject("This param from client");
- } catch (RemoteException e) {
- HiLog.error(LABEL_LOG, "%{public}s", "onAbilityConnectDone RemoteException");
- }
- }
- }
- //建立連接，實例化代理對象
- private IAbilityConnection connection = new IAbilityConnection() {
- @Override
- public void onAbilityConnectDone(ElementName elementName, IRemoteObject iRemoteObject, int resultCode) {
- //發個通知，Service 連接成功了
- eventHandler.sendEvent(EVENT_ABILITY_CONNECT_DONE);
- //實例化代理對象
- remoteAgentProxy = new RemoteAgentProxy(iRemoteObject);
- }
- @Override
- public void onAbilityDisconnectDone(ElementName elementName, int resultCode) {
- //發個通知，Service 斷開連接了，主動斷開不會執行，關閉服務端會執行
- eventHandler.sendEvent(EVENT_ABILITY_DISCONNECT_DONE);
- }
- };
2.前臺Service的使用方法
a.權限聲明：
- "reqPermissions": [
- {
- "name": "ohos.permission.KEEP_BACKGROUND_RUNNING"
- },
- ...
- ]
b.設置通知欄內容，然后，
- 在onStart方法調用keepBackgroundRunning方法在后臺保留此服務能力并顯示通知欄。
- 在onStop方法調用cancelBackgroundRunning()方法取消此功能的后臺運行以釋放系統內存。
- //通知ID
- private static final int NOTIFICATION_ID = 0XD0000002;
- @Override
- protected void onStart(Intent intent) {
- //調用方法
- startForeground();
- super.onStart(intent);
- }
- @Override
- protected void onStop() {
- super.onStop();
- //取消此功能的后臺運行以釋放系統內存。
- cancelBackgroundRunning();
- }
- /**
- * 在后臺保留此服務能力并顯示通知欄。
- */
- private void startForeground() {
- HiLog.info(LABEL_LOG, "startForeground");
- //任務欄顯示通知
- NotificationRequest request = new NotificationRequest(NOTIFICATION_ID).setTapDismissed(true);
- //
- NotificationRequest.NotificationNormalContent content = new NotificationRequest.NotificationNormalContent();
- content.setTitle("SD card存儲卡已意外移除").setText("請先卸載存儲卡，再將其移除，以防數據丟失");
- content.setAdditionalText("21分鐘前");
- //設置通知欄內容
- NotificationRequest.NotificationContent notificationContent = new NotificationRequest.NotificationContent(content);
- request.setContent(notificationContent);
- //在后臺保留此服務能力并顯示通知欄。
- keepBackgroundRunning(NOTIFICATION_ID, request);
- }
3.EventHandle事件處理的使用方法
EventHandler 將事件或 Runnable 任務傳遞到線程的事件隊列，并在事件或任務從事件隊列中出來時執行。
您可以使用 EventHandler 在不同線程之間調度和處理事件和 Runnable 對象，并在一定的時間間隔內安排要處理的事件或 Runnable 對象。您可以使用此類中提供的方法發送同步或異步事件、延遲事件處理以及設置事件優先級。
- //定義事件ID
- private static final int EVENT_ABILITY_CONNECT_DONE = 0x1000001;
- private static final int EVENT_ABILITY_DISCONNECT_DONE = 0x1000002;
- private EventHandler eventHandler = new EventHandler(EventRunner.current()) {
- @Override
- protected void processEvent(InnerEvent event) {
- switch (event.eventId) {
- case EVENT_ABILITY_CONNECT_DONE:
- showTips(MainAbilitySlice.this, "Service connect succeeded");
- break;
- case EVENT_ABILITY_DISCONNECT_DONE:
- showTips(MainAbilitySlice.this, "Service disconnect succeeded");
- break;
- default:
- break;
- }
- }
- };
- //發個通知，Service 連接成功了
- eventHandler.sendEvent(EVENT_ABILITY_CONNECT_DONE);
效果展示
前臺ServiceIPC/RPC調用
文章相關附件可以點擊下面的原文鏈接前往下載
原文鏈接：https://harmonyos.51cto.com/posts/4776
責任編輯：jianghua
來源：
鴻蒙社區
