觸發(fā)、取消、比較WantAgent實(shí)例和獲取bundle名稱的能力

2024-01-23 12:51 更新

WantAgent模塊提供了觸發(fā)、取消、比較WantAgent實(shí)例和獲取bundle名稱的能力，包括創(chuàng)建WantAgent實(shí)例、獲取實(shí)例的用戶ID、獲取want信息等。

說明

本模塊首批接口從API version 9開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

導(dǎo)入模塊

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

WantAgent.getWantAgent

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

創(chuàng)建WantAgent（callback形式）。 創(chuàng)建失敗返回的WantAgent為空值。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

參數(shù)名

類型

必填

說明

info

WantAgentInfo

是

WantAgent信息。

callback

AsyncCallback<WantAgent>

是

創(chuàng)建WantAgent的回調(diào)方法。

示例：

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

  3. //getWantAgent回調(diào)
  4. function getWantAgentCallback(err, data) {
  5.     console.info('==========================>getWantAgentCallback=======================>');
  6. }
  7. //WantAgentInfo對(duì)象
  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>

創(chuàng)建WantAgent（Promise形式）。 創(chuàng)建失敗返回的WantAgent為空值。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

參數(shù)名

類型

必填

說明

info

WantAgentInfo

是

WantAgent信息。

返回值：

類型

說明

Promise<WantAgent>

以Promise形式返回WantAgent。

示例：

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

  3. 

  4. //WantAgentInfo對(duì)象
  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實(shí)例的包名（callback形式）。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

參數(shù)名

類型

必填

說明

agent

WantAgent

是

WantAgent對(duì)象。

callback

AsyncCallback<string>

是

獲取WantAgent實(shí)例的包名的回調(diào)方法。

示例：

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

  3. 

  4. //wantAgent對(duì)象
  5. let wantAgent;
  6. 

  7. //getWantAgent回調(diào)
  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對(duì)象
  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回調(diào)
  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實(shí)例的包名（Promise形式）。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

參數(shù)名

類型

必填

說明

agent

WantAgent

是

WantAgent對(duì)象。

返回值：

類型

說明

Promise<string>

以Promise形式返回獲取WantAgent實(shí)例的包名。

示例：

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

  3. 

  4. //wantAgent對(duì)象
  5. let wantAgent;
  6. 

  7. //WantAgentInfo對(duì)象
  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實(shí)例的用戶ID（callback形式）。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

參數(shù)名

類型

必填

說明

agent

WantAgent

是

WantAgent對(duì)象。

callback

AsyncCallback<number>

是

獲取WantAgent實(shí)例的用戶ID的回調(diào)方法。

示例：

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

  3. 

  4. //wantAgent對(duì)象
  5. let wantAgent;
  6. 

  7. //getWantAgent回調(diào)
  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對(duì)象
  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回調(diào)
  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實(shí)例的用戶ID（Promise形式）。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

參數(shù)名

類型

必填

說明

agent

WantAgent

是

WantAgent對(duì)象。

返回值：

類型

說明

Promise<number>

以Promise形式返回獲取WantAgent實(shí)例的用戶ID。

示例：

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

  3. 

  4. //wantAgent對(duì)象
  5. let wantAgent;
  6. 

  7. //WantAgentInfo對(duì)象
  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實(shí)例（callback形式）。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

參數(shù)名

類型

必填

說明

agent

WantAgent

是

WantAgent對(duì)象。

callback

AsyncCallback<void>

是

取消WantAgent實(shí)例的回調(diào)方法。

示例：

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

  3. 

  4. //wantAgent對(duì)象
  5. let wantAgent;
  6. 

  7. //getWantAgent回調(diào)
  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對(duì)象
  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回調(diào)
  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實(shí)例（Promise形式）。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

參數(shù)名

類型

必填

說明

agent

WantAgent

是

WantAgent對(duì)象。

返回值：

類型

說明

Promise<void>

以Promise形式獲取異步返回結(jié)果。

示例：

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

  3. 

  4. //wantAgent對(duì)象
  5. let wantAgent;
  6. 

  7. //WantAgentInfo對(duì)象
  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

主動(dòng)激發(fā)WantAgent實(shí)例（callback形式）。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

參數(shù)名

類型

必填

說明

agent

WantAgent

是

WantAgent對(duì)象。

triggerInfo

TriggerInfo

是

TriggerInfo對(duì)象。

callback

AsyncCallback<CompleteData>

否

主動(dòng)激發(fā)WantAgent實(shí)例的回調(diào)方法。

示例：

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

  3. 

  4. //wantAgent對(duì)象
  5. let wantAgent;
  6. 

  7. //getWantAgent回調(diào)
  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對(duì)象
  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回調(diào)
  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

判斷兩個(gè)WantAgent實(shí)例是否相等（callback形式）。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

參數(shù)名

類型

必填

說明

agent

WantAgent

是

WantAgent對(duì)象。

otherAgent

WantAgent

是

WantAgent對(duì)象。

callback

AsyncCallback<boolean>

是

判斷兩個(gè)WantAgent實(shí)例是否相等的回調(diào)方法。

示例：

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

  3. 

  4. //wantAgent對(duì)象
  5. let wantAgent1;
  6. let wantAgent2;
  7. 

  8. //getWantAgent回調(diào)
  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對(duì)象
  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回調(diào)
  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>

判斷兩個(gè)WantAgent實(shí)例是否相等（Promise形式）。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

參數(shù)名

類型

必填

說明

agent

WantAgent

是

WantAgent對(duì)象。

otherAgent

WantAgent

是

WantAgent對(duì)象。

返回值：

類型

說明

Promise<boolean>

以Promise形式返回獲取判斷兩個(gè)WantAgent實(shí)例是否相等的結(jié)果。

示例：

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

  3. 

  4. //wantAgent對(duì)象
  5. let wantAgent1;
  6. let wantAgent2;
  7. 

  8. //WantAgentInfo對(duì)象
  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;

獲取一個(gè)WantAgent的OperationType信息（callback形式）。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

參數(shù)名

類型

必填

說明

agent

WantAgent

是

WantAgent對(duì)象。

callback

AsyncCallback<number>

是

獲取一個(gè)WantAgent的OperationType信息的回調(diào)方法。

示例：

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

  3. //wantAgent對(duì)象
  4. let wantAgent;
  5. 

  6. //WantAgentInfo對(duì)象
  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>;

獲取一個(gè)WantAgent的OperationType信息（Promise形式）。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

參數(shù)名

類型

必填

說明

agent

WantAgent

是

WantAgent對(duì)象。

返回值：

類型

說明

Promise<number>

以Promise形式返回獲取operationType的結(jié)果。

示例：

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

  3. //wantAgent對(duì)象
  4. let wantAgent;
  5. 

  6. //WantAgentInfo對(duì)象
  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

系統(tǒng)能力：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Ability.AbilityRuntime.Core

名稱

值

說明

ONE_TIME_FLAG

0

WantAgent僅能使用一次。

NO_BUILD_FLAG

1

如果描述WantAgent對(duì)象不存在，則不創(chuàng)建它，直接返回null。

CANCEL_PRESENT_FLAG

2

在生成一個(gè)新的WantAgent對(duì)象前取消已存在的一個(gè)WantAgent對(duì)象。

UPDATE_PRESENT_FLAG

3

使用新的WantAgent的額外數(shù)據(jù)替換已存在的WantAgent中的額外數(shù)據(jù)。

CONSTANT_FLAG

4

WantAgent是不可變的。

REPLACE_ELEMENT

5

當(dāng)前Want中的element屬性可被WantAgent.trigger()中Want的element屬性取代

REPLACE_ACTION

6

當(dāng)前Want中的action屬性可被WantAgent.trigger()中Want的action屬性取代

REPLACE_URI

7

當(dāng)前Want中的uri屬性可被WantAgent.trigger()中Want的uri屬性取代

REPLACE_ENTITIES

8

當(dāng)前Want中的entities屬性可被WantAgent.trigger()中Want的entities屬性取代

REPLACE_BUNDLE

9

當(dāng)前Want中的bundleName屬性可被WantAgent.trigger()中Want的bundleName屬性取代

OperationType

系統(tǒng)能力：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Ability.AbilityRuntime.Core

名稱

值

說明

UNKNOWN_TYPE

0

不識(shí)別的類型。

START_ABILITY

1

開啟一個(gè)有頁面的Ability。

START_ABILITIES

2

開啟多個(gè)有頁面的Ability。

START_SERVICE

3

開啟一個(gè)無頁面的ability。

SEND_COMMON_EVENT

4

發(fā)送一個(gè)公共事件。

CompleteData

系統(tǒng)能力：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Ability.AbilityRuntime.Core

名稱

類型

必填

說明

info

WantAgent

是

觸發(fā)的wantAgent。

want

Want

是

存在的被觸發(fā)的want。

finalCode

number

是

觸發(fā)wantAgent的請(qǐng)求代碼。

finalData

string

是

公共事件收集的最終數(shù)據(jù)。

extraInfo

{[key: string]: any}

否

額外數(shù)據(jù)。

以上內(nèi)容是否對(duì)您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)