建站
咨詢
售后
建站咨詢
新聞中心
這里有您想知道的互聯(lián)網(wǎng)營銷解決方案
創(chuàng)新互聯(lián)鴻蒙OS教程：鴻蒙OSJSFA如何調用PA
JS UI 框架提供了 JS FA（Feature Ability）調用 Java PA（Particle Ability）的機制，該機制提供了一種通道來傳遞方法調用、數(shù)據(jù)返回以及訂閱事件上報。
創(chuàng)新互聯(lián)2013年至今，先為賈汪等服務建站，賈汪等地企業(yè)，進行企業(yè)商務咨詢服務。為賈汪企業(yè)網(wǎng)站制作PC+手機+微官網(wǎng)三網(wǎng)同步一站式服務解決您的所有建站問題。
當前提供 Ability 和 Internal Ability 兩種調用方式，開發(fā)者可以根據(jù)業(yè)務場景選擇合適的調用方式進行開發(fā)。
- Ability：擁有獨立的 Ability 生命周期，F(xiàn)A 使用遠端進程通信拉起并請求 PA 服務，適用于基本服務供多 FA 調用或者服務在后臺獨立運行的場景。
- Internal Ability：與 FA 共進程，采用內部函數(shù)調用的方式和 FA 進行通信，適用于對服務響應時延要求較高的場景。該方式下 PA 不支持其他 FA 訪問調用。
JS 端與 Java 端通過 bundleName 和 abilityName 來進行關聯(lián)。在系統(tǒng)收到 JS 調用請求后，根據(jù)開發(fā)者在 JS 接口中設置的參數(shù)來選擇對應的處理方式。開發(fā)者在 onRemoteRequest() 中實現(xiàn) PA 提供的業(yè)務邏輯。詳細信息請參考 JS FA調用Java PA機制。
FA 調用 PA 接口
FA 端提供以下三個 JS 接口：
- FeatureAbility.callAbility(OBJECT)：調用 PA 能力。
- FeatureAbility.subscribeAbilityEvent(OBJECT, Function)：訂閱 PA 能力。
- FeatureAbility.unsubscribeAbilityEvent(OBJECT)：取消訂閱 PA 能力。
PA 端提供以下兩類接口：
- boolean IRemoteObject.onRemoteRequest(int code, MessageParcel data, MessageParcel reply, MessageOption option)：Ability 調用方式，F(xiàn)A 使用遠端進程通信拉起并請求PA服務。
- boolean AceInternalAbility.AceInternalAbilityHandler.onRemoteRequest(int code, MessageParcel data, MessageParcel reply, MessageOption option)：Internal Ability 調用方式，采用內部函數(shù)調用的方式和 FA 進行通信。
FA 調用 PA 常見問題
- callAbility返回報錯："Internal ability not register."
返回該錯誤說明 JS 接口調用請求未在系統(tǒng)中找到對應的 InternalAbilityHandler 進行處理，因此需要檢查以下幾點是否正確執(zhí)行：
- 在 AceAbility 繼承類中對 AceInternalAbility 繼承類執(zhí)行了 register 方法，具體注冊可參考 Internal Ability 的示例代碼。
- JS 側填寫的 bundleName 和 abilityName 與 AceInternalAbility 繼承類構造函數(shù)中填寫的名稱保持相同，大小寫敏感。
- 檢查 JS 端填寫的 abilityType（0：Ability; 1：Internal Ability），確保沒有將 Ability 誤填寫為 Internal Ability 方式。
Ability 和 Internal Ability 是兩種不同的 FA 調用 PA 的方式。 [表1]列舉了在開發(fā)時各方面的差異，供開發(fā)者參考，避免開發(fā)時將兩者混淆使用：
| 差異項 | Ability | InternalAbility |
|---|---|---|
| JS端（abilityType） | 0 | 1 |
| 是否需要在 config.json 的 abilities 中為 PA 添加聲明 | 需要（有獨立的生命周期） | 不需要（和FA共生命周期） |
| 是否需要在FA中注冊 | 不需要 | 需要 |
| 繼承的類 | ohos.aafwk.ability.Ability | ohos.ace.ability.AceInternalAbility |
| 是否允許被其他FA訪問調用 | 是 | 否 |
- FeatureAbility.callAbility中syncOption參數(shù)說明：
- 對于 JS FA 側，返回的結果都是 Promise 對象，因此無論該參數(shù)取何值，都采用異步方式等待 PA 側響應。
- 對于 JAVA PA 側，在 Internal Ability 方式下收到 FA 的請求后，根據(jù)該參數(shù)的取值來選擇：通過同步的方式獲取結果后返回；或者異步執(zhí)行 PA 邏輯，獲取結果后使用 remoteObject.sendRequest 的方式將結果返回 FA。
- 使用 await 方式調用時 IDE 編譯報錯，需引入 babel-runtime/regenerator，具體請參見接口通用規(guī)則。
示例參考
- FA JavaScript端
// abilityType: 0-Ability; 1-Internal Ability
const ABILITY_TYPE_EXTERNAL = 0;
const ABILITY_TYPE_INTERNAL = 1;
// syncOption(Optional, default sync): 0-Sync; 1-Async
const ACTION_SYNC = 0;
const ACTION_ASYNC = 1;
const ACTION_MESSAGE_CODE_PLUS = 1001;
export default {
plus: async function() {
var actionData = {};
actionData.firstNum = 1024;
actionData.secondNum = 2048;
var action = {};
action.bundleName = 'com.huawei.hiaceservice';
action.abilityName = 'CalcServiceAbility';
action.messageCode = ACTION_MESSAGE_CODE_PLUS;
action.data = actionData;
action.abilityType = ABILITY_TYPE_EXTERNAL;
action.syncOption = ACTION_SYNC;
var result = await FeatureAbility.callAbility(action);
var ret = JSON.parse(result);
if (ret.code && ret.code == 0) {
console.info('plus result is:' + JSON.stringify(ret.abilityResult));
} else {
if (ret.code) {
console.error('plus error code:' + JSON.stringify(ret.code));
} else {
console.error('plus error undefined.');
}
}
}
}- PA 端（Ability 方式）
功能代碼實現(xiàn)：
CalcServiceAbility.java
// ohos相關接口包
import ohos.aafwk.ability.Ability;
import ohos.aafwk.content.Intent;
import ohos.rpc.IRemoteBroker;
import ohos.rpc.IRemoteObject;
import ohos.rpc.RemoteObject;
import ohos.rpc.MessageParcel;
import ohos.rpc.MessageOption;
import ohos.utils.zson.ZSONObject;
import java.util.HashMap;
import java.util.Map;
public class CalcServiceAbility extends Ability {
private static final String TAG = "CalcServiceAbility";
private MyRemote remote = new MyRemote();
// FA在請求PA服務時會調用AbilityconnectAbility連接PA，連接成功后，需要在onConnect返回一個remote對象，供FA向PA發(fā)送消息
@Override
protected IRemoteObject onConnect(Intent intent) {
super.onConnect(intent);
return remote.asObject();
}
class MyRemote extends RemoteObject implements IRemoteBroker {
private static final int ERROR = -1;
private static final int SUCCESS = 0;
private static final int PLUS = 1001;
MyRemote() {
super("MyService_MyRemote");
}
@Override
public boolean onRemoteRequest(int code, MessageParcel data, MessageParcel reply, MessageOption option) {
switch (code) {
case PLUS: {
String zsonStr = data.readString();
RequestParam param = ZSONObject.stringToClass(zsonStr, RequestParam.class);
// 返回結果僅支持可序列化的Object類型
Map zsonResult = new HashMap();
zsonResult.put("code", SUCCESS);
zsonResult.put("abilityResult", param.getFirstNum() + param.getSecondNum());
reply.writeString(ZSONObject.toZSONString(zsonResult));
break;
}
default: {
Map zsonResult = new HashMap();
zsonResult.put("abilityError", ERROR);
reply.writeString(ZSONObject.toZSONString(zsonResult));
return false;
}
}
return true;
}
@Override
public IRemoteObject asObject() {
return this;
}
}
} 請求參數(shù)代碼：
RequestParam.java
public class RequestParam {
private int firstNum;
private int secondNum;
public int getFirstNum() {
return firstNum;
}
public void setFirstNum(int firstNum) {
this.firstNum = firstNum;
}
public int getSecondNum() {
return secondNum;
}
public void setSecondNum(int secondNum) {
this.secondNum = secondNum;
}
}- PA 端（Internal Ability方式）
功能代碼實現(xiàn)：
CalcInternalAbility.java
// ohos相關接口包
import ohos.ace.ability.AceInternalAbility;
import ohos.app.AbilityContext;
import ohos.rpc.IRemoteObject;
import ohos.rpc.MessageOption;
import ohos.rpc.MessageParcel;
import ohos.rpc.RemoteException;
import ohos.utils.zson.ZSONObject;
import java.util.HashMap;
import java.util.Map;
public class CalcInternalAbility extends AceInternalAbility {
private static final String TAG = CalcInternalAbility.class.getSimpleName();
private static final String BUNDLE_NAME = "com.huawei.hiaceservice";
private static final String ABILITY_NAME = "CalcInternalAbility";
private static final int ERROR = -1;
private static final int SUCCESS = 0;
private static final int PLUS = 1001;
private static CalcInternalAbility instance;
private AbilityContext abilityContext;
// 如果多個Ability實例都需要注冊當前InternalAbility實例，需要更改構造函數(shù)，設定自己的bundleName和abilityName
public CalcInternalAbility() {
super(BUNDLE_NAME, ABILITY_NAME);
}
public boolean onRemoteRequest(int code, MessageParcel data, MessageParcel reply, MessageOption option) {
switch (code) {
case PLUS: {
String zsonStr = data.readString();
RequestParam param = ZSONObject.stringToClass(zsonStr, RequestParam.class);
// 返回結果當前僅支持String，對于復雜結構可以序列化為ZSON字符串上報
Map zsonResult = new HashMap();
zsonResult.put("code", SUCCESS);
zsonResult.put("abilityResult", param.getFirstNum() + param.getSecondNum());
// SYNC
if (option.getFlags() == MessageOption.TF_SYNC) {
reply.writeString(ZSONObject.toZSONString(zsonResult));
} else {
// ASYNC
MessageParcel reponseData = MessageParcel.obtain();
reponseData.writeString(ZSONObject.toZSONString(zsonResult));
IRemoteObject remoteReply = reply.readRemoteObject();
try {
remoteReply.sendRequest(0, reponseData, MessageParcel.obtain(), new MessageOption());
reponseData.reclaim();
} catch (RemoteException exception) {
return false;
}
}
break;
}
default: {
Map zsonResult = new HashMap();
zsonResult.put("abilityError", ERROR);
reply.writeString(ZSONObject.toZSONString(zsonResult));
return false;
}
}
return true;
}
/**
* Internal ability registration.
*/
public static void register(AbilityContext abilityContext) {
instance = new CalcInternalAbility();
instance.onRegister(abilityContext);
}
private void onRegister(AbilityContext abilityContext) {
this.abilityContext = abilityContext;
this.setInternalAbilityHandler((code, data, reply, option) -> {
return this.onRemoteRequest(code, data, reply, option);
});
}
/**
* Internal ability deregistration.
*/
public static void deregister() {
instance.onDeregister();
}
private void onDeregister() {
abilityContext = null;
this.setInternalAbilityHandler(null);
}
} Internal Ability 注冊：修改繼承 AceAbility 工程中的代碼
public class HiAceInternalAbility extends AceAbility {
@Override
public void onStart(Intent intent) {
super.onStart(intent);
// 注冊
CalcInternalAbility.register(this);
...
}
@Override
public void onStop() {
// 去注冊
CalcInternalAbility.deregister();
super.onStop();
}
}分享文章：創(chuàng)新互聯(lián)鴻蒙OS教程：鴻蒙OSJSFA如何調用PA
文章鏈接：http://m.5511xx.com/article/dhepepg.html
