IntentAgent封装了一个指定行为的 Intent,可以通过 triggerIntentAgent 接口主动触发,也可以与通知绑定被动触发。具体的行为包括:启动 Ability 和发送公共事件。例如:收到通知后,在点击通知后跳转到一个新的 Ability,不点击则不会触发。
IntentAgent 相关基础类包括 IntentAgentHelper、 IntentAgentInfo、 IntentAgentConstant 和 TriggerInfo,基础类之间的关系如下图所示:
图1 IntentAgent 基础类关系图
IntentAgentHelper封装了获取、激发、取消IntentAgent等静态方法。
接口名 | 描述 |
---|---|
getIntentAgent(Context context, IntentAgentInfo paramsInfo) | 获取一个 IntentAgent 实例。 |
triggerIntentAgent(Context context, IntentAgent agent, IntentAgent.Oncompleted onCompleted, EventHandler handler, TriggerInfo paramsInfo) | 主动激发一个 IntentAgent 实例。 |
cancel(IntentAgent agent) | 取消一个 IntentAgent 实例。 |
judgeEquality(IntentAgent agent, IntentAgent otherAgent) | 判断两个 IntentAgent 实例是否相等。 |
getHashCode(IntentAgent agent) | 获取一个 IntentAgent 实例的哈希码。 |
getBundleName(IntentAgent agent) | 获取一个 IntentAgent 实例的包名。 |
getUid(IntentAgent agent) | 获取一个 IntentAgent 实例的用户ID。 |
IntentAgentInfo 类封装了获取一个 IntentAgent 实例所需的数据。使用构造函数 IntentAgentInfo(int requestCode, OperationType operationType, List <Flags> flags, List <Intent> intents, IntentParams extraInfo) 获取 IntentAgentInfo 对象。
IntentAgentConstant 类中包含 OperationType 和 Flags 两个枚举类:
类名 | 枚举值 |
---|---|
IntentAgentConstant.OperationType | UNKNOWN_TYPE:不识别的类型。START_ABILITY:开启一个有页面的 Ability。START_ABILITIES:开启多个有页面的 Ability。START_SERVICE:开启一个无页面的 ability。SEND_COMMON_EVENT:发送一个公共事件。 |
IntentAgentConstant.Flags | ONE_TIME_FLAG:IntentAgent 仅能使用一次。只在 operationType 的值为 START_ABILITY,START_SERVICE 和 SEND_COMMON_EVENT 时有意义。NO_BUILD_FLAG:如果描述 IntentAgent 对象不存在,则不创建它,直接返回 null。只在 operationType 的值为 START_ABILITY, START_SERVICE 和 SEND_COMMON_EVENT 时有意义。CANCEL_PRESENT_FLAG:在生成一个新的IntentAgent 对象前取消已存在的一个 IntentAgent 对象。只在 operationType 的值为 START_ABILITY,START_SERVICE 和 SEND_COMMON_EVENT 时有意义。 UPDATE_PRESENT_FLAG:使用新的 IntentAgent 的额外数据替换已存在的 IntentAgent 中的额外数据。只在 operationType 的值为 START_ABILITY,START_SERVICE 和 SEND_COMMON_EVENT 时有意义。CONSTANT_FLAG:IntentAgent 是不可变的。 REPLACE_ELEMENT:当前I ntent 中的 element 属性可被 IntentAgentHelper.triggerIntentAgent() 中 Intent 的 element 属性取代。 REPLACE_ACTION: 当前 Intent 中的 action 属性可被 IntentAgentHelper.triggerIntentAgent()中 Intent 的 action 属性取代。 REPLACE_URI:当前 Intent 中的 uri 属性可被 IntentAgentHelper.triggerIntentAgent() 中 Intent 的 uri 属性取代。 REPLACE_ENTITIES:当前 Intent 中的 entities 属性可被 IntentAgentHelper.triggerIntentAgent() 中 Intent 的 entities 属性取代。 REPLACE_BUNDLE:当前 Intent 中的 bundleName 属性可被 IntentAgentHelper.triggerIntentAgent() 中 Intent 的 bundleName 属性取代。 |
TriggerInfo 类封装了主动激发一个 IntentAgent 实例所需的数据,使用构造函数TriggerInfo( String permission, IntentParams extraInfo, Intent intent, int code) 获取 TriggerInfo 对象。
获取 IntentAgent 的代码示例如下:
// 指定要启动的Ability的BundleName和AbilityName字段
// 将Operation对象设置到Intent中
Operation operation = new Intent.OperationBuilder()
.withDeviceId("")
.withBundleName("com.huawei.testintentagent")
.withAbilityName("com.huawei.testintentagent.entry.IntentAgentAbility")
.build();
intent.setOperation(operation);
List<Intent> intentList = new ArrayList<>();
intentList.add(intent);
// 定义请求码
int requestCode = 200;
// 设置flags
List<Flags> flags = new ArrayList<>();
flags.add(Flags.UPDATE_PRESENT_FLAG);
// 指定启动一个有页面的Ability
IntentAgentInfo paramsInfo = new IntentAgentInfo(requestCode, IntentAgentConstant.OperationType.START_ABILITY, flags, intentList, null);
// 获取IntentAgent实例
IntentAgent agent = IntentAgentHelper.getIntentAgent(this, paramsInfo);
通知中添加 IntentAgent 的代码示例如下:
int notificationId = 1;
NotificationRequest request = new NotificationRequest(notificationId);
String title = "title";
String text = "There is a normal notification content.";
NotificationNormalContent content = new NotificationNormalContent();
content.setTitle(title)
.setText(text);
NotificationContent notificationContent = new NotificationContent(content);
request.setContent(notificationContent); // 设置通知的内容
request.setIntentAgent(agent); // 设置通知的 IntentAgent
主动激发 IntentAgent 的代码示例如下:
int code = 100;
IntentAgentHelper.triggerIntentAgent(this, agent, null, null, new TriggerInfo(null, null, null, code ));