1createTask

Markdown
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
# Create Queue Task

## Method (Version: 1.0.138 and above)

## `createQueueTask(taskObj) -> {Promise.<any>}`

Create queue task

### Parameters

| Name         | Type    | Description     |
| ------------ | -------| -------- |
| `taskObj` | string |  Task object |

taskObj

| Name         | Type    | Description                                                                                                             |
| ------------ | -------|----------------------------------------------------------------------------------------------------------------|
| `name` | string | Task name (required)                                                                                                 |
| `businessId` | string | Business identifier, required for queue tasks; can be empty for normal tasks                                                                          |
| `robotId` | string | Robot identifier for task execution, required for normal tasks; can be empty for queue tasks, but ensure there are robots under the businessId                                         |
| `dispatchType` | integer | Task type  2 Queue task                                                                                             |
| `runNum` | integer | Execution count, default is 1, 0 means infinite loop                                                                                              |
| `taskType` | integer | Task type 0 Disinfection 1 Return to charging station 2 Restaurant 3 Hotel 4 Delivery (5-in-1) 5 Factory 6 Chassis mini program 7 Charging scheduling                                                       |
| `runType` | integer | Run type 0 Scheduled disinfection 1 Temporary disinfection 20 Quick delivery 21 Multi-point delivery 22 Direct 23 Cruise 24 Return 25 Charging station 26 Summon 27 Birthday mode 28 Guide 29 Lift 30 Lift cruise 31 Flexible transport 32 Roller 33 Full battery leave station |
| `routeMode` | integer | Driving mode, default is 1: 1 Flexible obstacle avoidance 2 Drive along track with small range obstacle avoidance 3 Drive along track without obstacle avoidance 4 Drive along track without rack docking point 5 Segmented routing                                                |
| `ignorePublicSite` | boolean | Whether to ignore public sites, default is not to ignore                                                                                                |
| `speed` | integer | Robot driving speed, unit: m/s, recommended speed 0.4~1.0                                                                                    |
| `sourceType` | integer | Task source type, must be 6 for secondary development                                                                                                |
| `returnDest` | integer | Return setting  0 Invalid  1 According to robot settings  2 No return  3 Return to specified point, must set backPt  4 Idle return, must set backPt                                                   |
| `returnTime` | integer | Idle duration, unit: seconds, not required when returnDest is 1 or 2                                                                                              |
| `curPt` | object | Robot current position                                                                                                        |
| `taskPts` | array | Task point list                                                                                                          |
| `backPt` | object | Return point                                                                                                            |



### Return Value `Promise.<any>`

| Name         | Type           | Description            |
| ------------ | ------------- | --------------  |
| `taskId` | String        | Task ID         |



### Request Example

```javascript
...

const taskObj = {
  "dispatchType": 2, // Task type  2 Queue task
  "name": "Create queue task_" + new Date().getTime(),
  "businessId": "${businessId}", // Business identifier, required for queue tasks; can be empty for normal tasks
  // "robotId": "${robotSn}", // Robot identifier for task execution, required for normal tasks; can be empty for queue tasks, but ensure there are robots under the businessId
  "runNum": 1, // Execution count, default is 1, 0 means infinite loop
  "taskType": 4, // Task type 0 Disinfection 1 Return to charging station 2 Restaurant 3 Hotel 4 Delivery (5-in-1) 5 Factory 6 Chassis mini program 7 Charging scheduling
  "runType": 21, // Run type 0 Scheduled disinfection 1 Temporary disinfection 20 Quick delivery 21 Multi-point delivery 22 Direct 23 Cruise 24 Return 25 Charging station 26 Summon 27 Birthday mode 28 Guide 29 Lift 30 Lift cruise 31 Flexible transport 32 Roller 33 Full battery leave station
  "routeMode": 1, // Route mode, default is 1: 1 Sequential routing 2 Shortest distance routing
  "runMode": 1, // Driving mode, default is 1: 1 Flexible obstacle avoidance 2 Drive along track with small range obstacle avoidance 3 Drive along track without obstacle avoidance 4 Drive along track without rack docking point 5 Segmented routing
  "ignorePublicSite": true, // Whether to ignore public sites, default is not to ignore
  "speed": -1, // Robot driving speed, unit: m/s, recommended speed 0.4~1.0
  "sourceType": 6, // Task source type, must be 6 for secondary development
  "returnDest": 1, // Return setting  0 Invalid  1 According to robot settings  2 No return  3 Return to specified point, must set backPt  4 Idle return, must set backPt
  "returnTime": 5, // Idle duration, not required when returnDest is 1 or 2, unit: seconds
  "curPt": {
      "stepActs": [
          {
              "type": 5,
              "data": {
                  "audioId": "3111501",
                  "interval": -1,
                  "mode": 1,
                  "playInBackground": true
              }
          }
      ]
  },
  "taskPts": [
      {
          "x": 5.106577288813696,
          "y": -14.983136481276915,
          "yaw": 95.59169811320771,
          "areaId": "695a1dd928359b42d68a5f0f",
          "type": -1,
          "ext": {
              "name": "19001",
              "id": "695a1dccfff76da93edbf6d4"
          },
          "stepActs": [
              {
                  "type": 5,
                  "data": {
                      "mode": 1,
                      "audioId": "3112056",
                      "interval": -1
                  }
              },
              {
                  "type": 18,
                  "data": {
                      "pauseTime": 5
                  }
              }
          ]
      }
  ],
  "backPt": {
      "x": 1.3910798196548058,
      "y": -24.785015864239313,
      "yaw": 0,
      "stopRadius": 1,
      "areaId": "695a1dd928359b42d68a5f0f",
      "type": 10,
      "ext": {
          "name": "Floor 19 standby point",
          "id": "695a1dccfff76da93edbf6d8"
      }
  },

}
try {
  const res = await this.axRobot.createQueueTask(taskObj)
  this.taskId = res.taskId
  console.log('createQueueTask Success:', res)
  // createTaskV3 Success: {taskId: 'tsn-be48a330-6044-45cc-9756-a9ed7ff9d3d4'}
  console.log('Current task id', this.taskId)
} catch (error) {
  console.log('createQueueTask Error:', error)
}
...
```

### Response Data Example

```JSON
...
    {"taskId": "tsn-be48a330-6044-45cc-9756-a9ed7ff9d3d4"}
...
```