> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/workflows/ko/tutorials/integrate-with-ignition/live-video.md).

# 라이브 비디오

Roboflow 스트림의 실시간 주석 포함 동영상을 Ignition Perspective 뷰 또는 Vision 창에 표시합니다.

Roboflow 엣지 디바이스의 모든 스트림은 디바이스의 URL에서 동영상을 게시합니다. Ignition에서는 운영자가 이미 사용하는 태그 및 컨트롤 옆에 Perspective 뷰나 Vision 창으로 해당 동영상을 표시할 수 있습니다.

<figure><img src="https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-d4ababd320d309a8ba954d7b15d6b24757e9885e%2Fignition-video-perspective.png?alt=media" alt="A Perspective view named Bottle Line 1 showing a live video of bottles on a conveyor with Roboflow detections and a count, next to a table of recent inspections"><figcaption><p>Perspective 뷰에 표시된 Roboflow 스트림.</p></figcaption></figure>

## 필수 조건

* 스트림을 실행 중인 엣지 디바이스. 다음에서 관리합니다. [Deployment Manager](https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager).
* Deployment Manager의 디바이스 페이지에 표시된 디바이스의 IP 주소입니다.
* 동영상을 표시하는 모든 컴퓨터는 포트 `8000`에서 디바이스에 연결할 수 있어야 합니다. 동영상은 Ignition 게이트웨이가 아니라 운영자의 브라우저나 Vision 클라이언트에서 로드됩니다.

{% hint style="info" %}
이 단계와 스크린샷은 Ignition 8.1(Designer 8.1.55)을 기준으로 합니다. 8.3을 포함한 다른 버전에서는 메뉴 이름, 대화상자, 속성 이름이 다를 수 있습니다.
{% endhint %}

## 동영상 URL 찾기

실행 중인 각 스트림은 다음 URL을 제공합니다. 다음에서 `<stream>` 을 스트림 이름으로 바꾸세요.

<table data-search="false"><thead><tr><th>URL</th><th>표시 내용</th></tr></thead><tbody><tr><td><code>http://&#x3C;device-ip>:8000/inference_pipelines/&#x3C;stream>/output.mjpeg</code></td><td>Workflow 이미지 출력(예: 상자, 라벨, 개수)의 실시간 동영상</td></tr><tr><td><code>http://&#x3C;device-ip>:8000/inference_pipelines/&#x3C;stream>/input.mjpeg</code></td><td>카메라의 실시간 동영상</td></tr><tr><td><code>http://&#x3C;device-ip>:8000/inference_pipelines/&#x3C;stream>/output.jpg</code></td><td>최신 출력 프레임을 단일 이미지로 표시</td></tr><tr><td><code>http://&#x3C;device-ip>:8000/inference_pipelines/&#x3C;stream>/input.jpg</code></td><td>최신 카메라 프레임을 단일 이미지로 표시</td></tr></tbody></table>

스트림 이름에 공백이나 기호가 포함되어 있다면 URL 인코딩을 적용하세요(예: `Line%201`). 스트림 이름을 확인하려면 `http://<device-ip>:8000/inference_pipelines/list` 을 열고 각 `pipeline_id`.

를 확인하세요. Workflow에서 이미지가 출력되는 경우에만 출력 동영상에 주석이 표시됩니다. 시각화 블록(예: Bounding Box Visualization)을 추가하고 해당 출력의 이름을 `output_image`로 지정하세요. 이미지 출력이 없으면 출력 동영상에 카메라 프레임이 표시됩니다.

트리거 방식 스트림의 경우 이 URL에는 마지막으로 트리거된 프레임이 표시됩니다. 카메라 영상을 표시하려면 `?source=live` 를 추가하세요.

Ignition에 추가하기 전에 운영자의 컴퓨터에서 브라우저로 URL을 여세요. 브라우저에서 재생되면 Ignition에서도 재생됩니다. 자세한 내용은 [로컬 동영상](https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/monitoring/view-a-stream#local-video).

## Perspective

### 이미지 컴포넌트 추가

1. Designer에서 Perspective 뷰를 열고 "Image" 컴포넌트를 끌어다 놓으세요.
2. 다음을 설정하세요. `props.source` 을 `output.mjpeg` URL로 설정하세요.
3. 다음을 설정하세요. `props.fit.mode` 를 `contain` 으로 설정하면 동영상이 컴포넌트 크기에 맞게 조정됩니다.

<figure><img src="https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-fa851d2f0d33d2b3d45f8f48d352641497643841%2Fignition-designer-image-source.png?alt=media" alt="Ignition Designer with a Perspective view open, the live Roboflow stream playing in an Image component, and the Property Editor showing source and fit mode contain"><figcaption><p>Designer에서 스트림은 다음과 같은 즉시 재생됩니다. <code>props.source</code> 로 설정됩니다.</p></figcaption></figure>

모든 줄에 하나의 보기를 사용하려면 보기 매개변수(예: `deviceHost` 및 `stream`)를 추가하고 다음 표현식에 `props.source` 를 바인딩합니다:

```
"http://" + {view.params.deviceHost} + ":8000/inference_pipelines/" + {view.params.stream} + "/output.mjpeg"
```

<figure><img src="https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-2e784017604201dfa476474fb3f442e74ba2a7b6%2Fignition-designer-video-expression.png?alt=media" alt="The Edit Binding dialog for LiveVideo.props.source with an Expression binding built from view.params.deviceHost and a binding preview of the resulting URL"><figcaption><p>미리 보기에 생성된 URL이 표시된 <code>props.source</code>의 표현식 바인딩입니다.</p></figcaption></figure>

"Video Player" 구성 요소는 `props.liveFeed` 가 `true`일 때도 스트림을 재생합니다. 이 설정이 `props.liveFeed` 꺼져 있으면 비디오 파일을 필요로 하며 "미디어를 불러오는 중 오류 발생: 파일이 유효하지 않습니다"라고 표시합니다.

{% hint style="warning" %}
비디오에 "Inline Frame" 구성 요소를 사용하지 마세요. 스트림을 카메라 크기로 재생하고 크기를 조정하는 대신 잘라서 표시합니다.
{% endhint %}

### 프레임을 새로 고쳐 대역폭 절약하기

각 Perspective 세션은 장치에서 카메라의 전체 크기와 스트림의 프레임 속도로 자체 비디오 스트림을 엽니다. 여러 세션에서 같은 스트림을 표시하거나 네트워크가 느리다면, 대신 초당 한 번 새로 고쳐지는 프레임을 표시하세요. 다음 표현식에 `props.source` 를 바인딩합니다:

```
"http://" + {view.params.deviceHost} + ":8000/inference_pipelines/" + {view.params.stream} + "/output.jpg?t=" + toMillis(now(1000))
```

`now(1000)` 는 1,000ms마다 표현식을 다시 실행합니다. 값이 바뀌는 `t` 값으로 인해 브라우저는 캐시된 프레임 대신 새 프레임을 불러옵니다.

### HTTPS에서 Perspective 사용하기

브라우저는 `http://` 로 제공되는 이미지를 `https://`로 로드된 페이지에서 차단합니다. Perspective 세션에서 HTTPS를 사용하면 비디오가 로드되지 않습니다. 장치 앞에 HTTPS 리버스 프록시를 두고 프록시의 `https://` URL을 사용하거나, 공장 네트워크에서 HTTP로 세션을 여세요.

## Vision

1. Designer에서 Vision 창을 열고 "IP Camera Viewer" 구성 요소를 창으로 끌어다 놓습니다.
2. Vision Property Editor에서 "URL"을 다음 `output.mjpeg` URL로 설정합니다. 뷰어는 별도의 설정 없이 MJPEG를 재생합니다.
3. 비디오를 잘라내지 않고 구성 요소에 맞추려면 "Scale Video"를 켭니다. 이 설정은 전문가 속성입니다. 모든 속성을 표시하려면 Property Editor 도구 모음의 필터 메뉴를 사용하세요.

<figure><img src="https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-75ac74ce67b667195b91712c51fe40864eb599e4%2Fignition-vision-ip-camera-viewer.png?alt=media" alt="Ignition Designer with a Vision window showing the Roboflow stream in an IP Camera Viewer, and the Vision Property Editor with Scale Video set to true"><figcaption><p>"Scale Video"를 켠 IP Camera Viewer입니다.</p></figcaption></figure>

비디오 크기를 조정하면 비디오를 표시하는 각 클라이언트에서 CPU를 사용합니다. [IP Camera Viewer](https://docs.inductiveautomation.com/docs/8.3/appendix/components/vision-components/display/ip-camera-viewer).

## 문제 해결

<table data-search="false"><thead><tr><th>문제</th><th>해결 방법</th></tr></thead><tbody><tr><td>깨진 이미지 아이콘</td><td>같은 컴퓨터의 브라우저에서 URL을 여세요. 여기서도 열리지 않으면 컴퓨터가 포트의 장치에 연결할 수 없거나 <code>8000</code>스트림 이름이 잘못된 것입니다.</td></tr><tr><td>브라우저에서는 URL이 작동하지만 HTTPS를 사용하는 Perspective 세션에서는 작동하지 않음</td><td>브라우저에서 혼합 콘텐츠를 차단합니다. "HTTPS에서 Perspective 사용하기"를 참조하세요.</td></tr><tr><td>동영상에 박스나 레이블이 표시되지 않습니다</td><td>워크플로에 이미지 출력이 없습니다. 다음 이름의 시각화 블록을 추가하세요. <code>output_image</code>.</td></tr><tr><td>"미디어 로드 오류: 유효하지 않은 파일"</td><td>다음 값을 <code>props.liveFeed</code> (으)로 <code>true</code> 설정하거나, 비디오 플레이어 대신 이미지 컴포넌트를 사용하세요.</td></tr><tr><td>화면을 여러 개 열면 동영상이 끊깁니다</td><td>해당 화면을 새로 고친 프레임으로 전환하세요.</td></tr><tr><td>트리거된 스트림에 이전 프레임이 표시됩니다</td><td>다음을 <code>?source=live</code> URL에 추가하세요.</td></tr></tbody></table>

## 보안

동영상 URL에 로그인할 필요가 없습니다. 포트에 연결할 수 있는 사람은 누구나 `8000` 스트림을 볼 수 있습니다. 기기를 신뢰할 수 있는 네트워크에 두세요. 자세히 알아보기: [기기 서비스](https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/services).

## 관련 항목

* [기기 HMI 삽입](https://docs.roboflow.com/workflows/ko/tutorials/integrate-with-ignition/embed-the-device-hmi.md): 동영상을 포함한 전체 Roboflow 운영자 화면을 하나의 컴포넌트로 표시합니다.
* [실시간 데이터](https://docs.roboflow.com/workflows/ko/tutorials/integrate-with-ignition/live-data.md): OPC UA를 통해 Ignition 태그로 제공되는 워크플로 결과입니다.
* [이력 데이터](https://docs.roboflow.com/workflows/ko/tutorials/integrate-with-ignition/historical-data.md): 이미지가 포함된 모든 검사 기록입니다.
