# tracking-workspace-get-roi-state

tracking-workspace-get-roi-state 태스크는 tracking-workspace 커넥터와 연결된 태스크로서, 해당 ROI(카메라) 내의 오브젝트의 위치를 나타냅니다.

검출 방식에 따라서 카메라 내의 모든 오브젝트의 위치가 표시되거나 혹은 하나의 위치만 반환될 수 있습니다.

반환되는 데이터의 예는 다음과 같습니다.

```
[
  {
    "unknownRetention": 0,
    "id": "2",
    "roi": "camera01",
    "pose": {
      "x": 0.1782659549148684,
      "y": -0.5313646090700984,
      "z": 0.17637237602903633,
      "u": -0.08667200042963932,
      "v": 176.70228445783243,
      "w": -154.54114889855498
    },
    "retention": 0,
    "updatedAt": 1606356709754,
    "movedAt": 1606356709754
  }
]
```

위치가 리스트의 형태로 오는 것에 유의 합니다.

반환되는 값 중에서 첫번째 값을 사용하려면 `stepname`[0] 과 같이 표시합니다.

## 파라미터

- 접근자(accessor)
  - 데이터 접근자 : 특정 스텝에서 반환되는 결과를 받기 위한 접근자. 데이터 접근자는 카메라의 이름(ROI)을 반환합니다.
  - `stepname`
  - `stepname.property`
  - `stepname.property.property. ...`
- 카메라 이름
  - 데이터 접근자가 없을 경우 사용되며 커넥터로 연결된 카메라의 이름을 지정합니다.

## 시나리오 작성 예

![tracking-workspace-get-roi-state example](../images/tracking-ws-get-roi-state-example.png 'tracking-workspace-get-roi-state example')
