codecamp

触发、取消、比较WantAgent实例和获取bundle名称的能力

WantAgent模块提供了触发、取消、比较WantAgent实例和获取bundle名称的能力，包括创建WantAgent实例、获取实例的用户ID、获取want信息等。

说明

本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

  1. import WantAgent from '@ohos.app.ability.wantAgent';

WantAgent.getWantAgent

getWantAgent(info: WantAgentInfo, callback: AsyncCallback<WantAgent>): void

创建WantAgent（callback形式）。 创建失败返回的WantAgent为空值。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名

类型

必填

说明

info

WantAgentInfo

是

WantAgent信息。

callback

AsyncCallback<WantAgent>

是

创建WantAgent的回调方法。

示例：

  1. import WantAgent from '@ohos.app.ability.wantAgent';
  2. 

  3. //getWantAgent回调
  4. function getWantAgentCallback(err, data) {
  5.     console.info('==========================>getWantAgentCallback=======================>');
  6. }
  7. //WantAgentInfo对象
  8. let wantAgentInfo = {
  9.     wants: [
  10.         {
  11.             deviceId: 'deviceId',
  12.             bundleName: 'com.neu.setResultOnAbilityResultTest1',
  13.             abilityName: 'com.example.test.MainAbility',
  14.             action: 'action1',
  15.             entities: ['entity1'],
  16.             type: 'MIMETYPE',
  17.             uri: 'key={true,true,false}',
  18.             parameters:
  19.             {
  20.                 mykey0: 2222,
  21.                 mykey1: [1, 2, 3],
  22.                 mykey2: '[1, 2, 3]',
  23.                 mykey3: 'ssssssssssssssssssssssssss',
  24.                 mykey4: [false, true, false],
  25.                 mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
  26.                 mykey6: true,
  27.             }
  28.         }
  29.     ],
  30.     operationType: WantAgent.OperationType.START_ABILITIES,
  31.     requestCode: 0,
  32.     wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  33. };
  34. 

  35. try {
  36.     WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback);
  37. } catch (paramError) {
  38.     console.log('error: ' + paramError.code + ', ' + paramError.message);
  39. }

WantAgent.getWantAgent

getWantAgent(info: WantAgentInfo): Promise<WantAgent>

创建WantAgent（Promise形式）。 创建失败返回的WantAgent为空值。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名

类型

必填

说明

info

WantAgentInfo

是

WantAgent信息。

返回值：

类型

说明

Promise<WantAgent>

以Promise形式返回WantAgent。

示例：

  1. import WantAgent from '@ohos.app.ability.wantAgent';
  2. 

  3. 

  4. //WantAgentInfo对象
  5. let wantAgentInfo = {
  6.     wants: [
  7.         {
  8.             deviceId: 'deviceId',
  9.             bundleName: 'com.neu.setResultOnAbilityResultTest1',
  10.             abilityName: 'com.example.test.MainAbility',
  11.             action: 'action1',
  12.             entities: ['entity1'],
  13.             type: 'MIMETYPE',
  14.             uri: 'key={true,true,false}',
  15.             parameters:
  16.             {
  17.                 mykey0: 2222,
  18.                 mykey1: [1, 2, 3],
  19.                 mykey2: '[1, 2, 3]',
  20.                 mykey3: 'ssssssssssssssssssssssssss',
  21.                 mykey4: [false, true, false],
  22.                 mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
  23.                 mykey6: true,
  24.             }
  25.         }
  26.     ],
  27.     operationType: WantAgent.OperationType.START_ABILITIES,
  28.     requestCode: 0,
  29.     wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  30. };
  31. 

  32. try {
  33.     WantAgent.getWantAgent(wantAgentInfo).then((data) => {
  34.         console.info('==========================>getWantAgentCallback=======================>');
  35.     });
  36. } catch (paramError) {
  37.     console.log('error: ' + paramError.code + ', ' + paramError.message);
  38. }

WantAgent.getBundleName

getBundleName(agent: WantAgent, callback: AsyncCallback<string>): void

获取WantAgent实例的包名（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名

类型

必填

说明

agent

WantAgent

是

WantAgent对象。

callback

AsyncCallback<string>

是

获取WantAgent实例的包名的回调方法。

示例：

  1. import WantAgent from '@ohos.app.ability.wantAgent';
  2. 

  3. 

  4. //wantAgent对象
  5. let wantAgent;
  6. 

  7. //getWantAgent回调
  8. function getWantAgentCallback(err, data) {
  9.     console.info('==========================>getWantAgentCallback=======================>');
  10.     if (err.code == 0) {
  11.         wantAgent = data;
  12.     } else {
  13.         console.info('----getWantAgent failed!----');
  14.     }
  15. }
  16. //WantAgentInfo对象
  17. let wantAgentInfo = {
  18.     wants: [
  19.         {
  20.             deviceId: 'deviceId',
  21.             bundleName: 'com.neu.setResultOnAbilityResultTest1',
  22.             abilityName: 'com.example.test.MainAbility',
  23.             action: 'action1',
  24.             entities: ['entity1'],
  25.             type: 'MIMETYPE',
  26.             uri: 'key={true,true,false}',
  27.             parameters:
  28.             {
  29.                 mykey0: 2222,
  30.                 mykey1: [1, 2, 3],
  31.                 mykey2: '[1, 2, 3]',
  32.                 mykey3: 'ssssssssssssssssssssssssss',
  33.                 mykey4: [false, true, false],
  34.                 mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
  35.                 mykey6: true,
  36.             }
  37.         }
  38.     ],
  39.     operationType: WantAgent.OperationType.START_ABILITIES,
  40.     requestCode: 0,
  41.     wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  42. };
  43. 

  44. try {
  45.     WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback);
  46. 

  47.     //getBundleName回调
  48.     function getBundleNameCallback(err, data) {
  49.         console.info('==========================>getBundleNameCallback=======================>');
  50.     }
  51.     WantAgent.getBundleName(wantAgent, getBundleNameCallback);
  52. } catch (paramError) {
  53.     console.log('error: ' + paramError.code + ', ' + paramError.message);
  54. }

WantAgent.getBundleName

getBundleName(agent: WantAgent): Promise<string>

获取WantAgent实例的包名（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名

类型

必填

说明

agent

WantAgent

是

WantAgent对象。

返回值：

类型

说明

Promise<string>

以Promise形式返回获取WantAgent实例的包名。

示例：

  1. import WantAgent from '@ohos.app.ability.wantAgent';
  2. 

  3. 

  4. //wantAgent对象
  5. let wantAgent;
  6. 

  7. //WantAgentInfo对象
  8. let wantAgentInfo = {
  9.     wants: [
  10.         {
  11.             deviceId: 'deviceId',
  12.             bundleName: 'com.neu.setResultOnAbilityResultTest1',
  13.             abilityName: 'com.example.test.MainAbility',
  14.             action: 'action1',
  15.             entities: ['entity1'],
  16.             type: 'MIMETYPE',
  17.             uri: 'key={true,true,false}',
  18.             parameters:
  19.             {
  20.                 mykey0: 2222,
  21.                 mykey1: [1, 2, 3],
  22.                 mykey2: '[1, 2, 3]',
  23.                 mykey3: 'ssssssssssssssssssssssssss',
  24.                 mykey4: [false, true, false],
  25.                 mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
  26.                 mykey6: true,
  27.             }
  28.         }
  29.     ],
  30.     operationType: WantAgent.OperationType.START_ABILITIES,
  31.     requestCode: 0,
  32.     wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  33. };
  34. 

  35. try {
  36.     WantAgent.getWantAgent(wantAgentInfo).then((data) => {
  37.         console.info('==========================>getWantAgentCallback=======================>');
  38.         wantAgent = data;
  39.     });
  40. 

  41.     WantAgent.getBundleName(wantAgent).then((data) => {
  42.         console.info('==========================>getBundleNameCallback=======================>');
  43.     });
  44. } catch (paramError) {
  45.     console.log('error: ' + paramError.code + ', ' + paramError.message);
  46. }

WantAgent.getUid

getUid(agent: WantAgent, callback: AsyncCallback<number>): void

获取WantAgent实例的用户ID（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名

类型

必填

说明

agent

WantAgent

是

WantAgent对象。

callback

AsyncCallback<number>

是

获取WantAgent实例的用户ID的回调方法。

示例：

  1. import WantAgent from '@ohos.app.ability.wantAgent';
  2. 

  3. 

  4. //wantAgent对象
  5. let wantAgent;
  6. 

  7. //getWantAgent回调
  8. function getWantAgentCallback(err, data) {
  9.     console.info('==========================>getWantAgentCallback=======================>');
  10.     if (err.code == 0) {
  11.         wantAgent = data;
  12.     } else {
  13.         console.info('----getWantAgent failed!----');
  14.     }
  15. }
  16. //WantAgentInfo对象
  17. let wantAgentInfo = {
  18.     wants: [
  19.         {
  20.             deviceId: 'deviceId',
  21.             bundleName: 'com.neu.setResultOnAbilityResultTest1',
  22.             abilityName: 'com.example.test.MainAbility',
  23.             action: 'action1',
  24.             entities: ['entity1'],
  25.             type: 'MIMETYPE',
  26.             uri: 'key={true,true,false}',
  27.             parameters:
  28.             {
  29.                 mykey0: 2222,
  30.                 mykey1: [1, 2, 3],
  31.                 mykey2: '[1, 2, 3]',
  32.                 mykey3: 'ssssssssssssssssssssssssss',
  33.                 mykey4: [false, true, false],
  34.                 mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
  35.                 mykey6: true,
  36.             }
  37.         }
  38.     ],
  39.     operationType: WantAgent.OperationType.START_ABILITIES,
  40.     requestCode: 0,
  41.     wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  42. };
  43. 

  44. try {
  45.     WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback);
  46. 

  47.     //getUid回调
  48.     function getUidCallback(err, data) {
  49.         console.info('==========================>getUidCallback=======================>');
  50.     }
  51.     WantAgent.getUid(wantAgent, getUidCallback);
  52. } catch (paramError) {
  53.     console.log('error: ' + paramError.code + ', ' + paramError.message);
  54. }

WantAgent.getUid

getUid(agent: WantAgent): Promise<number>

获取WantAgent实例的用户ID（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名

类型

必填

说明

agent

WantAgent

是

WantAgent对象。

返回值：

类型

说明

Promise<number>

以Promise形式返回获取WantAgent实例的用户ID。

示例：

  1. import WantAgent from '@ohos.app.ability.wantAgent';
  2. 

  3. 

  4. //wantAgent对象
  5. let wantAgent;
  6. 

  7. //WantAgentInfo对象
  8. let wantAgentInfo = {
  9.     wants: [
  10.         {
  11.             deviceId: 'deviceId',
  12.             bundleName: 'com.neu.setResultOnAbilityResultTest1',
  13.             abilityName: 'com.example.test.MainAbility',
  14.             action: 'action1',
  15.             entities: ['entity1'],
  16.             type: 'MIMETYPE',
  17.             uri: 'key={true,true,false}',
  18.             parameters:
  19.             {
  20.                 mykey0: 2222,
  21.                 mykey1: [1, 2, 3],
  22.                 mykey2: '[1, 2, 3]',
  23.                 mykey3: 'ssssssssssssssssssssssssss',
  24.                 mykey4: [false, true, false],
  25.                 mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
  26.                 mykey6: true,
  27.             }
  28.         }
  29.     ],
  30.     operationType: WantAgent.OperationType.START_ABILITIES,
  31.     requestCode: 0,
  32.     wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  33. };
  34. 

  35. try {
  36.     WantAgent.getWantAgent(wantAgentInfo).then((data) => {
  37.         console.info('==========================>getWantAgentCallback=======================>');
  38.         wantAgent = data;
  39.     });
  40. 

  41.     WantAgent.getUid(wantAgent).then((data) => {
  42.         console.info('==========================>getUidCallback=======================>');
  43.     });
  44. } catch (paramError) {
  45.     console.log('error: ' + paramError.code + ', ' + paramError.message);
  46. }

WantAgent.cancel

cancel(agent: WantAgent, callback: AsyncCallback<void>): void

取消WantAgent实例（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名

类型

必填

说明

agent

WantAgent

是

WantAgent对象。

callback

AsyncCallback<void>

是

取消WantAgent实例的回调方法。

示例：

  1. import WantAgent from '@ohos.app.ability.wantAgent';
  2. 

  3. 

  4. //wantAgent对象
  5. let wantAgent;
  6. 

  7. //getWantAgent回调
  8. function getWantAgentCallback(err, data) {
  9.     console.info('==========================>getWantAgentCallback=======================>');
  10.     if (err.code == 0) {
  11.         wantAgent = data;
  12.     } else {
  13.         console.info('----getWantAgent failed!----');
  14.     }
  15. }
  16. //WantAgentInfo对象
  17. let wantAgentInfo = {
  18.     wants: [
  19.         {
  20.             deviceId: 'deviceId',
  21.             bundleName: 'com.neu.setResultOnAbilityResultTest1',
  22.             abilityName: 'com.example.test.MainAbility',
  23.             action: 'action1',
  24.             entities: ['entity1'],
  25.             type: 'MIMETYPE',
  26.             uri: 'key={true,true,false}',
  27.             parameters:
  28.             {
  29.                 mykey0: 2222,
  30.                 mykey1: [1, 2, 3],
  31.                 mykey2: '[1, 2, 3]',
  32.                 mykey3: 'ssssssssssssssssssssssssss',
  33.                 mykey4: [false, true, false],
  34.                 mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
  35.                 mykey6: true,
  36.             }
  37.         }
  38.     ],
  39.     operationType: WantAgent.OperationType.START_ABILITIES,
  40.     requestCode: 0,
  41.     wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  42. };
  43. 

  44. try {
  45.     WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback);
  46. 

  47.     //cancel回调
  48.     function cancelCallback(err, data) {
  49.         console.info('==========================>cancelCallback=======================>');
  50.     }
  51.     WantAgent.cancel(wantAgent, cancelCallback);
  52. } catch (paramError) {
  53.     console.log('error: ' + paramError.code + ', ' + paramError.message);
  54. }

WantAgent.cancel

cancel(agent: WantAgent): Promise<void>

取消WantAgent实例（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名

类型

必填

说明

agent

WantAgent

是

WantAgent对象。

返回值：

类型

说明

Promise<void>

以Promise形式获取异步返回结果。

示例：

  1. import WantAgent from '@ohos.app.ability.wantAgent';
  2. 

  3. 

  4. //wantAgent对象
  5. let wantAgent;
  6. 

  7. //WantAgentInfo对象
  8. let wantAgentInfo = {
  9.     wants: [
  10.         {
  11.             deviceId: 'deviceId',
  12.             bundleName: 'com.neu.setResultOnAbilityResultTest1',
  13.             abilityName: 'com.example.test.MainAbility',
  14.             action: 'action1',
  15.             entities: ['entity1'],
  16.             type: 'MIMETYPE',
  17.             uri: 'key={true,true,false}',
  18.             parameters:
  19.             {
  20.                 mykey0: 2222,
  21.                 mykey1: [1, 2, 3],
  22.                 mykey2: '[1, 2, 3]',
  23.                 mykey3: 'ssssssssssssssssssssssssss',
  24.                 mykey4: [false, true, false],
  25.                 mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
  26.                 mykey6: true,
  27.             }
  28.         }
  29.     ],
  30.     operationType: WantAgent.OperationType.START_ABILITIES,
  31.     requestCode: 0,
  32.     wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  33. };
  34. 

  35. try {
  36.     WantAgent.getWantAgent(wantAgentInfo).then((data) => {
  37.         console.info('==========================>getWantAgentCallback=======================>');
  38.         wantAgent = data;
  39.     });
  40. 

  41.     WantAgent.cancel(wantAgent).then((data) => {
  42.         console.info('==========================>cancelCallback=======================>');
  43.     });
  44. } catch (paramError) {
  45.     console.log('error: ' + paramError.code + ', ' + paramError.message);
  46. }

WantAgent.trigger

trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: AsyncCallback<CompleteData>): void

主动激发WantAgent实例（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名

类型

必填

说明

agent

WantAgent

是

WantAgent对象。

triggerInfo

TriggerInfo

是

TriggerInfo对象。

callback

AsyncCallback<CompleteData>

否

主动激发WantAgent实例的回调方法。

示例：

  1. import WantAgent from '@ohos.app.ability.wantAgent';
  2. 

  3. 

  4. //wantAgent对象
  5. let wantAgent;
  6. 

  7. //getWantAgent回调
  8. function getWantAgentCallback(err, data) {
  9.     console.info('==========================>getWantAgentCallback=======================>');
  10.     if (err.code == 0) {
  11.         wantAgent = data;
  12.     } else {
  13.         console.info('----getWantAgent failed!----');
  14.     }
  15. }
  16. //WantAgentInfo对象
  17. let wantAgentInfo = {
  18.     wants: [
  19.         {
  20.             deviceId: 'deviceId',
  21.             bundleName: 'com.neu.setResultOnAbilityResultTest1',
  22.             abilityName: 'com.example.test.MainAbility',
  23.             action: 'action1',
  24.             entities: ['entity1'],
  25.             type: 'MIMETYPE',
  26.             uri: 'key={true,true,false}',
  27.             parameters:
  28.             {
  29.                 mykey0: 2222,
  30.                 mykey1: [1, 2, 3],
  31.                 mykey2: '[1, 2, 3]',
  32.                 mykey3: 'ssssssssssssssssssssssssss',
  33.                 mykey4: [false, true, false],
  34.                 mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
  35.                 mykey6: true,
  36.             }
  37.         }
  38.     ],
  39.     operationType: WantAgent.OperationType.START_ABILITIES,
  40.     requestCode: 0,
  41.     wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  42. };
  43. 

  44. try {
  45.     WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback);
  46. 

  47.     //trigger回调
  48.     function triggerCallback(data) {
  49.         console.info('==========================>triggerCallback=======================>');
  50.     }
  51. 

  52. 

  53.     let triggerInfo = {
  54.         code:0
  55.     };
  56.     WantAgent.trigger(wantAgent, triggerInfo, triggerCallback);
  57. } catch (paramError) {
  58.     console.log('error: ' + paramError.code + ', ' + paramError.message);
  59. }

WantAgent.equal

equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback<boolean>): void

判断两个WantAgent实例是否相等（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名

类型

必填

说明

agent

WantAgent

是

WantAgent对象。

otherAgent

WantAgent

是

WantAgent对象。

callback

AsyncCallback<boolean>

是

判断两个WantAgent实例是否相等的回调方法。

示例：

  1. import WantAgent from '@ohos.app.ability.wantAgent';
  2. 

  3. 

  4. //wantAgent对象
  5. let wantAgent1;
  6. let wantAgent2;
  7. 

  8. //getWantAgent回调
  9. function getWantAgentCallback(err, data) {
  10.     console.info('==========================>getWantAgentCallback=======================>');
  11.     if (err.code == 0) {
  12.         wantAgent1 = data;
  13.         wantAgent2 = data;
  14.     } else {
  15.         console.info('----getWantAgent failed!----');
  16.     }
  17. }
  18. //WantAgentInfo对象
  19. let wantAgentInfo = {
  20.     wants: [
  21.         {
  22.             deviceId: 'deviceId',
  23.             bundleName: 'com.neu.setResultOnAbilityResultTest1',
  24.             abilityName: 'com.example.test.MainAbility',
  25.             action: 'action1',
  26.             entities: ['entity1'],
  27.             type: 'MIMETYPE',
  28.             uri: 'key={true,true,false}',
  29.             parameters:
  30.             {
  31.                 mykey0: 2222,
  32.                 mykey1: [1, 2, 3],
  33.                 mykey2: '[1, 2, 3]',
  34.                 mykey3: 'ssssssssssssssssssssssssss',
  35.                 mykey4: [false, true, false],
  36.                 mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
  37.                 mykey6: true,
  38.             }
  39.         }
  40.     ],
  41.     operationType: WantAgent.OperationType.START_ABILITIES,
  42.     requestCode: 0,
  43.     wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  44. };
  45. 

  46. try {
  47.     WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback);
  48. 

  49.     //equal回调
  50.     function equalCallback(err, data) {
  51.         console.info('==========================>equalCallback=======================>');
  52.     }
  53.     WantAgent.equal(wantAgent1, wantAgent2, equalCallback);
  54. } catch (paramError) {
  55.     console.log('error: ' + paramError.code + ', ' + paramError.message);
  56. }

WantAgent.equal

equal(agent: WantAgent, otherAgent: WantAgent): Promise<boolean>

判断两个WantAgent实例是否相等（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名

类型

必填

说明

agent

WantAgent

是

WantAgent对象。

otherAgent

WantAgent

是

WantAgent对象。

返回值：

类型

说明

Promise<boolean>

以Promise形式返回获取判断两个WantAgent实例是否相等的结果。

示例：

  1. import WantAgent from '@ohos.app.ability.wantAgent';
  2. 

  3. 

  4. //wantAgent对象
  5. let wantAgent1;
  6. let wantAgent2;
  7. 

  8. //WantAgentInfo对象
  9. let wantAgentInfo = {
  10.     wants: [
  11.         {
  12.             deviceId: 'deviceId',
  13.             bundleName: 'com.neu.setResultOnAbilityResultTest1',
  14.             abilityName: 'com.example.test.MainAbility',
  15.             action: 'action1',
  16.             entities: ['entity1'],
  17.             type: 'MIMETYPE',
  18.             uri: 'key={true,true,false}',
  19.             parameters:
  20.             {
  21.                 mykey0: 2222,
  22.                 mykey1: [1, 2, 3],
  23.                 mykey2: '[1, 2, 3]',
  24.                 mykey3: 'ssssssssssssssssssssssssss',
  25.                 mykey4: [false, true, false],
  26.                 mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
  27.                 mykey6: true,
  28.             }
  29.         }
  30.     ],
  31.     operationType: WantAgent.OperationType.START_ABILITIES,
  32.     requestCode: 0,
  33.     wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  34. };
  35. 

  36. try {
  37.     WantAgent.getWantAgent(wantAgentInfo).then((data) => {
  38.         console.info('==========================>getWantAgentCallback=======================>');
  39.         wantAgent1 = data;
  40.         wantAgent2 = data;
  41.     });
  42. 

  43.     WantAgent.equal(wantAgent1, wantAgent2).then((data) => {
  44.         console.info('==========================>equalCallback=======================>');
  45.     });
  46. } catch (paramError) {
  47.     console.log('error: ' + paramError.code + ', ' + paramError.message);
  48. }

WantAgent.getOperationType

getOperationType(agent: WantAgent, callback: AsyncCallback<number>): void;

获取一个WantAgent的OperationType信息（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名

类型

必填

说明

agent

WantAgent

是

WantAgent对象。

callback

AsyncCallback<number>

是

获取一个WantAgent的OperationType信息的回调方法。

示例：

  1. import WantAgent from '@ohos.app.ability.wantAgent';
  2. 

  3. //wantAgent对象
  4. let wantAgent;
  5. 

  6. //WantAgentInfo对象
  7. let wantAgentInfo = {
  8.     wants: [
  9.         {
  10.             deviceId: 'deviceId',
  11.             bundleName: 'com.neu.setResultOnAbilityResultTest1',
  12.             abilityName: 'com.example.test.MainAbility',
  13.             action: 'action1',
  14.             entities: ['entity1'],
  15.             type: 'MIMETYPE',
  16.             uri: 'key={true,true,false}',
  17.             parameters:
  18.             {
  19.                 mykey0: 2222,
  20.                 mykey1: [1, 2, 3],
  21.                 mykey2: '[1, 2, 3]',
  22.                 mykey3: 'ssssssssssssssssssssssssss',
  23.                 mykey4: [false, true, false],
  24.                 mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
  25.                 mykey6: true,
  26.             }
  27.         }
  28.     ],
  29.     operationType: WantAgent.OperationType.START_ABILITIES,
  30.     requestCode: 0,
  31.     wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  32. };
  33. 

  34. try {
  35.     WantAgent.getWantAgent(wantAgentInfo).then((data) => {
  36.         console.info('==========================>getWantAgentCallback=======================>');
  37.         wantAgent = data;
  38.     });
  39. 

  40.     WantAgent.getOperationType(wantAgent, (OperationType) => {
  41.         console.log('----------- getOperationType ----------, OperationType: ' + OperationType);
  42.     })
  43. } catch (paramError) {
  44.     console.log('error: ' + paramError.code + ', ' + paramError.message);
  45. }

WantAgent.getOperationType

getOperationType(agent: WantAgent): Promise<number>;

获取一个WantAgent的OperationType信息（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名

类型

必填

说明

agent

WantAgent

是

WantAgent对象。

返回值：

类型

说明

Promise<number>

以Promise形式返回获取operationType的结果。

示例：

  1. import WantAgent from '@ohos.app.ability.wantAgent';
  2. 

  3. //wantAgent对象
  4. let wantAgent;
  5. 

  6. //WantAgentInfo对象
  7. let wantAgentInfo = {
  8.     wants: [
  9.         {
  10.             deviceId: 'deviceId',
  11.             bundleName: 'com.neu.setResultOnAbilityResultTest1',
  12.             abilityName: 'com.example.test.MainAbility',
  13.             action: 'action1',
  14.             entities: ['entity1'],
  15.             type: 'MIMETYPE',
  16.             uri: 'key={true,true,false}',
  17.             parameters:
  18.             {
  19.                 mykey0: 2222,
  20.                 mykey1: [1, 2, 3],
  21.                 mykey2: '[1, 2, 3]',
  22.                 mykey3: 'ssssssssssssssssssssssssss',
  23.                 mykey4: [false, true, false],
  24.                 mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
  25.                 mykey6: true,
  26.             }
  27.         }
  28.     ],
  29.     operationType: WantAgent.OperationType.START_ABILITIES,
  30.     requestCode: 0,
  31.     wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  32. };
  33. 

  34. try {
  35.     WantAgent.getWantAgent(wantAgentInfo).then((data) => {
  36.         console.info('==========================>getWantAgentCallback=======================>');
  37.         wantAgent = data;
  38.     });
  39. 

  40.     WantAgent.getOperationType(wantAgent).then((OperationType) => {
  41.         console.log('getOperationType success, OperationType: ' + OperationType);
  42.     }).catch((err) => {
  43.         console.log('getOperationType fail, err: ' + err);
  44.     })
  45. } catch (paramError) {
  46.     console.log('error: ' + paramError.code + ', ' + paramError.message);
  47. }

WantAgentFlags

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

名称

值

说明

ONE_TIME_FLAG

0

WantAgent仅能使用一次。

NO_BUILD_FLAG

1

如果描述WantAgent对象不存在，则不创建它，直接返回null。

CANCEL_PRESENT_FLAG

2

在生成一个新的WantAgent对象前取消已存在的一个WantAgent对象。

UPDATE_PRESENT_FLAG

3

使用新的WantAgent的额外数据替换已存在的WantAgent中的额外数据。

CONSTANT_FLAG

4

WantAgent是不可变的。

REPLACE_ELEMENT

5

当前Want中的element属性可被WantAgent.trigger()中Want的element属性取代

REPLACE_ACTION

6

当前Want中的action属性可被WantAgent.trigger()中Want的action属性取代

REPLACE_URI

7

当前Want中的uri属性可被WantAgent.trigger()中Want的uri属性取代

REPLACE_ENTITIES

8

当前Want中的entities属性可被WantAgent.trigger()中Want的entities属性取代

REPLACE_BUNDLE

9

当前Want中的bundleName属性可被WantAgent.trigger()中Want的bundleName属性取代

OperationType

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

名称

值

说明

UNKNOWN_TYPE

0

不识别的类型。

START_ABILITY

1

开启一个有页面的Ability。

START_ABILITIES

2

开启多个有页面的Ability。

START_SERVICE

3

开启一个无页面的ability。

SEND_COMMON_EVENT

4

发送一个公共事件。

CompleteData

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

名称

类型

必填

说明

info

WantAgent

是

触发的wantAgent。

want

Want

是

存在的被触发的want。

finalCode

number

是

触发wantAgent的请求代码。

finalData

string

是

公共事件收集的最终数据。

extraInfo

{[key: string]: any}

否

额外数据。

应用组件间的信息传递
want中操作want常数和解释Flags说明的能力
温馨提示
下载编程狮App，免费阅读超1000+编程语言教程
取消
确定
目录

通用事件

通用属性

手势处理

基础组件

容器组件

媒体组件

绘制组件

画布组件

动画

弹窗

生命周期

状态管理

像素

枚举

类型

接口

错误码合集

关闭

 MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }