鸿蒙开发接口Ability框架：【@ohos.wantAgent (WantAgent模块)】
电子说
1.3w人已加入
描述
WantAgent模块
WantAgent模块提供了触发、取消、比较WantAgent实例和获取bundle名称的能力，包括创建WantAgent实例、获取实例的用户ID、获取want信息等。
说明：
本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
导入模块
import WantAgent from '@ohos.wantAgent';
开发前请熟悉鸿蒙开发指导文档：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
WantAgent.getWantAgent
getWantAgent(info: WantAgentInfo, callback: AsyncCallback): void
创建WantAgent（callback形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| info | 是 | 否 | WantAgentInfo | 是 | WantAgent信息。 |
| callback | 是 | 否 | AsyncCallback | 是 | 创建WantAgent的回调方法。 |
示例：
import WantAgent from '@ohos.wantAgent';
//getWantAgent回调
function getWantAgentCallback(err, data) {
console.info("========================== >getWantAgentCallback======================= >");
}
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
WantAgent.getWantAgent
getWantAgent(info: WantAgentInfo): Promise
创建WantAgent（Promise形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| info | 是 | 否 | WantAgentInfo | 是 | WantAgent信息。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise | 以Promise形式返回WantAgent。 |
示例：
import WantAgent from '@ohos.wantAgent';
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo).then((data) = > {
console.info("========================== >getWantAgentCallback======================= >");
});
WantAgent.getBundleName
getBundleName(agent: WantAgent, callback: AsyncCallback): void
获取WantAgent实例的包名（callback形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback | 是 | 获取WantAgent实例的包名的回调方法。 |
示例：
import WantAgent from '@ohos.wantAgent';
//wantAgent对象
var wantAgent;
//getWantAgent回调
function getWantAgentCallback(err, data) {
console.info("========================== >getWantAgentCallback======================= >");
if (err.code == 0) {
wantAgent = data;
} else {
console.info('----getWantAgent failed!----');
}
}
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
//getBundleName回调
function getBundleNameCallback(err, data) {
console.info("========================== >getBundleNameCallback======================= >");
}
WantAgent.getBundleName(wantAgent, getBundleNameCallback)
WantAgent.getBundleName
getBundleName(agent: WantAgent): Promise
获取WantAgent实例的包名（Promise形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise | 以Promise形式返回获取WantAgent实例的包名。 |
示例：
import WantAgent from '@ohos.wantAgent';
//wantAgent对象
var wantAgent;
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo).then((data) = > {
console.info("========================== >getWantAgentCallback======================= >");
wantAgent = data;
});
WantAgent.getBundleName(wantAgent).then((data) = > {
console.info("========================== >getBundleNameCallback======================= >");
});
WantAgent.getUid
getUid(agent: WantAgent, callback: AsyncCallback): void
获取WantAgent实例的用户ID（callback形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback | 是 | 获取WantAgent实例的用户ID的回调方法。 |
示例：
import WantAgent from '@ohos.wantAgent';
//wantAgent对象
var wantAgent;
//getWantAgent回调
function getWantAgentCallback(err, data) {
console.info("========================== >getWantAgentCallback======================= >");
if (err.code == 0) {
wantAgent = data;
} else {
console.info('----getWantAgent failed!----');
}
}
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
//getUid回调
function getUidCallback(err, data) {
console.info("========================== >getUidCallback======================= >");
}
WantAgent.getUid(wantAgent, getUidCallback)
WantAgent.getUid
getUid(agent: WantAgent): Promise
获取WantAgent实例的用户ID（Promise形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise | 以Promise形式返回获取WantAgent实例的用户ID。 |
示例：
import WantAgent from '@ohos.wantAgent';
//wantAgent对象
var wantAgent;
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo).then((data) = > {
console.info("========================== >getWantAgentCallback======================= >");
wantAgent = data;
});
WantAgent.getUid(wantAgent).then((data) = > {
console.info("========================== >getUidCallback======================= >");
});
WantAgent.getWant
getWant(agent: WantAgent, callback: AsyncCallback): void
获取WantAgent对象的want（callback形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
系统API : 此接口为系统接口，三方应用不支持调用。
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback | 是 | 获取WantAgent对象want的回调方法。 |
示例：
import WantAgent from '@ohos.wantAgent';
//wantAgent对象
var wantAgent;
//getWantAgent回调
function getWantAgentCallback(err, data) {
console.info("========================== >getWantAgentCallback======================= >");
if (err.code == 0) {
wantAgent = data;
} else {
console.info('----getWantAgent failed!----');
}
}
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
//getWant回调
function getWantCallback(err, data) {
console.info("========================== >getWantCallback======================= >");
}
WantAgent.getWant(wantAgent, getWantCallback)
WantAgent.getWant
getWant(agent: WantAgent): Promise
获取WantAgent对象的want（Promise形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
系统API : 此接口为系统接口，三方应用不支持调用。
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise | 以Promise形式返回获取WantAgent对象的want。 |
示例：
import WantAgent from '@ohos.wantAgent';
//wantAgent对象
var wantAgent;
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo).then((data) = > {
console.info("========================== >getWantAgentCallback======================= >");
wantAgent = data;
});
WantAgent.getWant(wantAgent).then((data) = > {
console.info("========================== >getWantCallback======================= >");
});
WantAgent.cancel
cancel(agent: WantAgent, callback: AsyncCallback): void
取消WantAgent实例（callback形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback | 是 | 取消WantAgent实例的回调方法。 |
示例：
import WantAgent from '@ohos.wantAgent';
//wantAgent对象
var wantAgent;
//getWantAgent回调
function getWantAgentCallback(err, data) {
console.info("========================== >getWantAgentCallback======================= >");
if (err.code == 0) {
wantAgent = data;
} else {
console.info('----getWantAgent failed!----');
}
}
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
//cancel回调
function cancelCallback(err, data) {
console.info("========================== >cancelCallback======================= >");
}
WantAgent.cancel(wantAgent, cancelCallback)
WantAgent.cancel
cancel(agent: WantAgent): Promise
取消WantAgent实例（Promise形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise | 以Promise形式获取异步返回结果。 |
示例：
import WantAgent from '@ohos.wantAgent';
//wantAgent对象
var wantAgent;
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo).then((data) = > {
console.info("========================== >getWantAgentCallback======================= >");
wantAgent = data;
});
WantAgent.cancel(wantAgent).then((data) = > {
console.info("========================== >cancelCallback======================= >");
});
WantAgent.trigger
trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: Callback): void
主动激发WantAgent实例（callback形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| triggerInfo | 是 | 否 | TriggerInfo | 是 | TriggerInfo对象。 |
| callback | 是 | 否 | AsyncCallback | 是 | 主动激发WantAgent实例的回调方法。 |
示例：
import WantAgent from '@ohos.wantAgent';
//wantAgent对象
var wantAgent;
//getWantAgent回调
function getWantAgentCallback(err, data) {
console.info("========================== >getWantAgentCallback======================= >");
if (err.code == 0) {
wantAgent = data;
} else {
console.info('----getWantAgent failed!----');
}
}
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
//trigger回调
function triggerCallback(data) {
console.info("========================== >triggerCallback======================= >");
}
var triggerInfo = {
code:0
}
WantAgent.trigger(wantAgent, triggerInfo, triggerCallback)
WantAgent.equal
equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback): void
判断两个WantAgent实例是否相等（callback形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| otherAgent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback | 是 | 判断两个WantAgent实例是否相等的回调方法。 |
示例：
import WantAgent from '@ohos.wantAgent';
//wantAgent对象
var wantAgent1;
var wantAgent2;
//getWantAgent回调
function getWantAgentCallback(err, data) {
console.info("========================== >getWantAgentCallback======================= >");
if (err.code == 0) {
wantAgent1 = data;
wantAgent2 = data;
} else {
console.info('----getWantAgent failed!----');
}
}
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
//equal回调
function equalCallback(err, data) {
console.info("========================== >equalCallback======================= >");
}
WantAgent.equal(wantAgent1, wantAgent2, equalCallback)
WantAgent.equal
equal(agent: WantAgent, otherAgent: WantAgent): Promise
判断两个WantAgent实例是否相等（Promise形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| otherAgent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise | 以Promise形式返回获取判断两个WantAgent实例是否相等的结果。 |
示例：
import WantAgent from '@ohos.wantAgent';
//wantAgent对象
var wantAgent1;
var wantAgent2;
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo).then((data) = > {
console.info("========================== >getWantAgentCallback======================= >");
wantAgent1 = data;
wantAgent2 = data;
});
WantAgent.equal(wantAgent1, wantAgent2).then((data) = > {
console.info("========================== >equalCallback======================= >");
});
WantAgent.getOperationType9+
getOperationType(agent: WantAgent, callback: AsyncCallback): void;
获取一个WantAgent的OperationType信息（callback形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback | 是 | 获取一个WantAgent的OperationType信息的回调方法。 |
示例：
import WantAgent from '@ohos.wantAgent';
//wantAgent对象
var wantAgent;
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo).then((data) = > {
console.info("========================== >getWantAgentCallback======================= >");
wantAgent = data;
});
WantAgent.getOperationType(wantAgent, (OperationType) = > {
console.log('----------- getOperationType ----------, OperationType: ' + OperationType);
})
WantAgent.getOperationType9+
getOperationType(agent: WantAgent): Promise;
获取一个WantAgent的OperationType信息（Promise形式）。
系统能力 ：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise | 以Promise形式返回获取optionType的结果。 |
示例：
import WantAgent from '@ohos.wantAgent';
//wantAgent对象
var wantAgent;
//WantAgentInfo对象
var wantAgentInfo = {
wants: [
{
deviceId: "deviceId",
bundleName: "com.neu.setResultOnAbilityResultTest1",
abilityName: "com.example.test.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
}
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo).then((data) = > {
console.info("========================== >getWantAgentCallback======================= >");
wantAgent = data;
});
WantAgent.getOperationType(wantAgent).then((OperationType) = > {
console.log('getOperationType success, OperationType: ' + OperationType);
}).catch((err) = > {
console.log('getOperationType fail, err: ' + err);
})
WantAgentInfo
系统能力 ：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| wants | 是 | 是 | Array | 是 | 将被执行的动作列表。 |
| operationType | 是 | 是 | wantAgent.OperationType | 是 | 动作类型。 |
| requestCode | 是 | 是 | number | 是 | 使用者定义的一个私有值。 |
| wantAgentFlags | 是 | 是 | Array | 否 | 动作执行属性。 |
| extraInfo | 是 | 是 | {[key: string]: any} | 否 | 额外数据。 |
WantAgentFlags
系统能力 ：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 值 | 说明 |
|---|---|---|
| ONE_TIME_FLAG | WantAgentFlags | WantAgent仅能使用一次。 |
| NO_BUILD_FLAG | WantAgentFlags | 如果描述WantAgent对象不存在，则不创建它，直接返回null。 |
| CANCEL_PRESENT_FLAG | WantAgentFlags | 在生成一个新的WantAgent对象前取消已存在的一个WantAgent对象。 |
| UPDATE_PRESENT_FLAG | WantAgentFlags | 使用新的WantAgent的额外数据替换已存在的WantAgent中的额外数据。 |
| CONSTANT_FLAG | WantAgentFlags | WantAgent是不可变的。 |
| REPLACE_ELEMENT | WantAgentFlags | 当前Want中的element属性可被WantAgent.trigger()中Want的element属性取代 |
| REPLACE_ACTION | WantAgentFlags | 当前Want中的action属性可被WantAgent.trigger()中Want的action属性取代 |
| REPLACE_URI | WantAgentFlags | 当前Want中的uri属性可被WantAgent.trigger()中Want的uri属性取代 |
| REPLACE_ENTITIES | WantAgentFlags | 当前Want中的entities属性可被WantAgent.trigger()中Want的entities属性取代 |
| REPLACE_BUNDLE | WantAgentFlags | 当前Want中的bundleName属性可被WantAgent.trigger()中Want的bundleName属性取代 |
OperationType
系统能力 ：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 值 | 说明 |
|---|---|---|
| UNKNOWN_TYPE | OperationType | 不识别的类型。 |
| START_ABILITY | OperationType | 开启一个有页面的Ability。 |
| START_ABILITIES | OperationType | 开启多个有页面的Ability。 |
| START_SERVICE | OperationType | 开启一个无页面的ability。 |
| SEND_COMMON_EVENT | OperationType | 发送一个公共事件。 |
CompleteData
系统能力 ：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| info | 是 | 是 | WantAgent | 是 | 触发的wantAgent。 |
| want | 是 | 是 | Want | 是 | 存在的被触发的want。 |
| finalCode | 是 | 是 | number | 是 | 触发wantAgent的请求代码。 |
| finalData | 是 | 是 | string | 否 | 公共事件收集的最终数据。 |
| extraInfo | 是 | 是 | {[key: string]: any} | 否 | 额外数据。 |
HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿 |
TriggerInfo
系统能力 ：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| code | 是 | 是 | number | 是 | result code。 |
| want | 是 | 是 | Want | 否 | Want。 |
| permission | 是 | 是 | string | 否 | 权限定义。 |
| extraInfo | 是 | 是 | {[key: string]: any} | 否 | 额外数据。 |
审核编辑 黄宇
声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。
举报投诉
-
鸿蒙原生应用/元服务开发-通知添加行为意图2024-01-05 0
-
鸿蒙原生应用/元服务开发-长时任务2024-01-09 0
-
HarmonyOS/OpenHarmony应用开发-ArkTS语言FA模型WantAgent使用2023-01-17 0
-
HarmonyOS位置服务开发指南2023-11-27 0
-
鸿蒙之@ohos.app.ability.appRecovery (appRecovery)2024-02-20 463
-
鸿蒙开发接口Ability框架：【@ohos.application.Ability (Ability)】2024-04-30 2288
-
鸿蒙开发接口Ability框架：【@ohos.ability.featureAbility (FeatureAbility模块)】2024-05-06 1019
-
鸿蒙开发接口Ability框架：【@ohos.application.FormExtension (FormExtension)】2024-05-07 749
-
鸿蒙开发接口Ability框架：【@ohos.application.missionManager (missionManager)】2024-05-08 906
-
鸿蒙开发接口Ability框架：【@ohos.ability.particleAbility (particleAbility模块)】2024-05-09 729
-
鸿蒙开发接口Ability框架：【 (Context模块)】2024-05-13 729
-
鸿蒙开发接口Ability框架：【AbilityRunningInfo】2024-05-14 807
-
鸿蒙开发接口Ability框架：【AbilityDelegator】2024-05-16 946
-
鸿蒙Ability Kit（程序框架服务）【Ability与ServiceExtensionAbility通信】2024-06-05 504
全部0条评论
快来发表一下你的评论吧 !
