[文章]HarmonyOS/OpenHarmony应用开发-ArkTS语言FA模型WantAgent使用

场景简介

[]()WantAgent封装了一个行为意图信息，可以通过WantAgent.trigger接口主动触发，也可以通过与通知绑定被动触发。具体的行为包括：启动Ability和发布公共事件。

接口说明

开发步骤

[]()1.

[]()[]()导入WantAgent模块。

1. import wantAgent from '@ohos.wantAgent';

[]()[]()创建拉起Ability的WantAgentInfo信息，详细的WantAgentInfo信息数据类型及包含的参数请见WantAgentInfo文档介绍。

1. private wantAgentObj = null //用于保存创建成功的wantAgent对象，后续使用其完成触发的动作。
3. //wantAgentInfo
4. var wantAgentInfo = {

5. wants: [
       ```
   

6. {
       ```
   

7. deviceId: "",
       ```
   

8. bundleName: "com.example.test",
       ```
   

9. abilityName: "com.example.test.MainAbility",
       ```
   

action: "",

11. ```
entities: [],

uri: "",

13. ```
parameters: {}

}

15. ```
],

operationType: wantAgent.OperationType.START_ABILITY,

17. ```
requestCode: 0,

wantAgentFlags:[wantAgent.WantAgentFlags.CONSTANT_FLAG]

19. }
20. 

[]()[]()创建发布公共事件的WantAgentInfo信息

1. private wantAgentObj = null    //用于保存创建成功的WantAgent对象，后续使用其完成触发的动作。
2. 
3. //wantAgentInfo
4. var wantAgentInfo = {
5. ```
wants: [
    ```

6. {
       ```
   

7. action: "event_name", // 设置事件名
       ```
   

8. parameters: {}
       ```
   

9. }
       ```
   

],

11. ```
operationType: wantAgent.OperationType.SEND_COMMON_EVENT,

requestCode: 0,

13. ```
wantAgentFlags:[wantAgent.WantAgentFlags.CONSTANT_FLAG]

14. }

[]()[]()创建WantAgent，保存返回的WantAgent对象wantAgentObj，用于执行后续触发操作。

1. //创建WantAgent
2. wantAgent.getWantAgent(wantAgentInfo, (err, wantAgentObj) => {

3. if (err.code) {
       ```
   

4. console.error("[WantAgent]getWantAgent err=" + JSON.stringify(err))
       ```
   

5. } else {
       ```
   

6. console.log("[WantAgent]getWantAgent success")
       ```
   

7. this.wantAgentObj = wantAgentObj
       ```
   

8. }
       ```
   

9. })

[]()[]()触发WantAgent

1. //触发WantAgent
2. var triggerInfo = {

3. code:0
       ```
   

4. }
5. wantAgent.trigger(wantAgentObj, triggerInfo, (completeData) => {

6. console.log("[WantAgent]getWantAgent success, completeData: ",  + JSON.stringify(completeData))
       ```
   

7. })

本文章主要引用HarmonyOS官方文档材料。