> 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/deployment/ko/self-hosted/enterprise/deployment-manager/setting-up/add-a-stream.md).

# 스트림 추가

워크플로를 실행하는 데 사용할 수 있는 스트림을 구성하는 방법을 알아봅니다.

Deployment Manager로 관리되는 엣지 디바이스에서 Workflow를 실행하려면 Stream을 추가해야 합니다. Stream은 카메라 피드를 입력으로 받아 카메라의 데이터를 선택한 Workflow에서 실행합니다.

Stream을 추가하려면 다음이 필요합니다.

* Deployment Manager가 설정된 디바이스
* 디바이스에서 사용할 수 있는 카메라 또는 RTSP Simulator로 재생할 동영상 파일
* 디바이스에 배포하려는 Workflow

Stream에서 읽을 수 있는 항목:

* RTSP 스트림
* USB로 엣지 디바이스에 직접 연결된 웹캠
* GigE(Ethernet) 또는 USB 3.0으로 연결된 Basler 카메라
* GigE(Ethernet)로 연결된 Lucid 카메라

Basler 또는 Lucid 라인 스캔 카메라의 경우 "Basler Line Scan" 또는 "Lucid Line Scan"을 선택한 다음  [라인 레이트, 프레이밍 및 노출을 설정하세요.](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/making-changes/configure-line-scan-cameras.md).

{% hint style="info" %}
Basler 및 Lucid 산업용 카메라는 Enterprise 요금제에서 사용할 수 있습니다. 사용하려면  [영업팀에 문의하세요.](https://roboflow.com/sales).
{% endhint %}

Stream을 추가하려면 대시보드에서 Deployment Manager에 등록한 Device를 클릭한 다음 "Add Stream"을 클릭하세요.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-3ae23858553ea42a0d252c1d8a1128e15bad6163%2Fenterprise-add-stream-button.png?alt=media" alt="Add Stream button in the Streams tab" width="350"><figcaption></figcaption></figure>

창에는 "Camera", "Workflow", "Capture"의 세 단계가 있습니다. "Next"를 클릭해 다음 단계로 이동하고, "Back"을 클릭해 이전 단계로 돌아가세요.

### 카메라

1. "Camera"에서 "New Camera", 디바이스의 다른 Stream에서 사용하는 카메라(참조:  [공유 카메라](#shared-cameras)), 또는 디바이스가 검색했지만 아직 Stream이 연결되지 않은 카메라(예: "Discovered: TRI032S-C (224500123)")를 선택하세요. 이 필드는 디바이스에서 선택할 수 있는 카메라가 있을 때만 표시됩니다.
2. "Stream Type"을 선택하세요(예: "RTSP Stream", "RTSP Simulator", "USB Camera", "Basler Camera", "Lucid Camera").
3. 해당 스트림 유형의 동영상 소스를 입력하세요.
   * "RTSP Stream": 카메라의 "RTSP URL"입니다.
   * "RTSP Simulator": 카메라 없이 테스트할 때 디바이스에서 반복 재생할 동영상 파일입니다. 참조:  [테스트 동영상 스트리밍](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/setting-up/stream-a-test-video.md).
   * "USB Camera": 디바이스에 연결된 카메라의 "USB Camera Index"입니다. 카메라가 하나만 연결되어 있다면 값은 대개 0입니다. USB 카메라를 추가하면 추론 컨테이너에 권한 모드가 활성화되어 하드웨어에 더 많이 접근할 수 있습니다.
   * "Basler Camera": 카메라의 "Serial Number"입니다. 참조:  [Basler 카메라](#basler-cameras) 아래
   * "Lucid Camera", "Lucid Line Scan", "Basler Line Scan": 카메라의 "Serial Number" 또는 "IP Address"입니다. 디바이스는 마지막으로 설정한 필드에 따라 카메라를 엽니다. 일련 번호를 알고 있다면 이를 사용하세요. Lucid 카메라에 IP 주소를 사용하는 경우 Roboflow가 해당 주소를  [카메라에 할당된 상태로 유지합니다.](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/making-changes/set-camera-static-ip.md). Lucid 카메라에서 "Camera Index"를 대신 입력하려면 두 필드를 모두 비워 두세요. 그러면 해당 위치에 있는 Lucid 카메라에 연결됩니다. Lucid Line Scan Stream은 기본 라인 스캔 설정으로 시작합니다.

검색된 카메라에서 소스를 미리 입력하려면 "Camera"에서 카메라를 선택하거나 "Cameras" 표에서 해당 카메라 행의 "Add Stream"을 클릭하세요. 참조:  [카메라 찾기](#find-cameras).

### 워크플로

Stream에서 실행할 Workflow와 버전, 매개변수를 선택하세요.

### 캡처

1. Stream의 "Name"을 입력하세요. Roboflow가 Workflow를 바탕으로 이름을 제안합니다. 영문자, 숫자, 하이픈, 밑줄을 사용하세요. 공백은 하이픈으로 바뀌며, 각 이름은 디바이스에서 고유해야 합니다.
2. "Mode"를 선택하세요. "Continuous"(기본값)는 추론을 계속 실행하고, "Triggered"는 명시적으로 트리거할 때만 Workflow를 실행합니다. 참조:  [Stream 트리거](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/making-changes/trigger-a-stream.md) 트리거 옵션을 확인하세요.
3. 카메라 설정을 지정한 다음 "Create Stream"을 클릭하세요.

다음을 통해 추가한 Stream은  [구성 업데이트](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager.md#update-config) 다음 항목 없이  `workflow_id` 내장된 RF-DETR 객체 감지 Workflow를 실행합니다.

새 스트림을 처음 설정할 때 디바이스가 Workflow와 관련 모델 가중치를 다운로드하므로 몇 분이 걸릴 수 있습니다. 다운로드가 끝나면 Stream 목록에 해당 Stream이 표시됩니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-25e38f03d984c9f54fbae3d409b7f60b6ad7097e%2Fenterprise-streams.png?alt=media" alt="Running Streams with inference FPS, camera FPS, and sharpness"><figcaption></figcaption></figure>

Stream을 처음 추가하면 상태가 "Provisioning"으로 표시됩니다. Workflow가 디바이스에 다운로드되어 실행되면 Stream의 상태가 "Running"으로 업데이트됩니다.

스트림 상태가 "Running"이면 다음을 의미합니다.

1. Workflow가 기기에서 실행 중입니다.
2. Stream에서 프레임과 로그를 확인할 수 있습니다.

설정 후 해상도, 밝기 또는 프레임 속도를 조정하려면 [카메라 설정을 구성하세요](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/making-changes/configure-camera-settings.md).

### 카메라 찾기

Streams 목록 아래의 "Cameras" 표에는 기기에서 감지할 수 있는 카메라가 표시됩니다. "Scan for Cameras"를 클릭하면 다시 검색합니다. 기기는 USB 카메라, GigE 또는 USB로 연결된 Basler 카메라, Lucid GigE 카메라, ONVIF 네트워크 카메라를 찾습니다. 검색은 약 15초 후 종료되며 그때까지 발견한 카메라를 표시하므로, 카메라가 보이지 않으면 다시 검색하세요. 기기가 오프라인이거나 준비되지 않은 상태에서는 버튼에 "Request Scan"이라고 표시됩니다.

각 행에는 해당 카메라에 대해 다음에 할 수 있는 작업이 표시됩니다. "Add Stream"을 클릭하면 미리 입력된 Stream 양식이 열리고, "Open Stream"을 클릭하면 해당 카메라를 이미 사용하는 Stream이 열립니다(다른 Stream을 추가할 수 있도록 행에도 "Add Stream"이 표시됨). 동영상 스트림 URL을 제공하지 않은 ONVIF 카메라에는 "Add RTSP URL"이 표시됩니다. 카메라에 전용 [카메라 포트](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/making-changes/configure-device-network.md#dedicated-camera-port) 를 먼저 설정해야 하는 경우 "Set Up Camera Port"가 표시됩니다. 포트를 설정하기 전까지는 해당 카메라가 "Camera"에 표시되지 않습니다.

### 공유 카메라

카메라 한 대에서 둘 이상의 Workflow를 실행하려면 "Add Stream"을 클릭한 다음 "Camera"에서 카메라를 선택하세요. 카메라 항목에는 해당 카메라를 사용하는 Streams가 표시됩니다(예: "Basler Camera: 40543892 (used by line-a)"). Streams는 카메라에서 하나의 캡처를 공유하므로 새 Stream에는 카메라 설정이 복사되며, "Capture" 단계에서는 설정을 변경할 수 없습니다. 나중에 설정을 변경하려면 Streams 중 하나를 수정하세요. Roboflow가 새 카메라 설정을 해당 카메라를 사용하는 모든 Stream에 복사합니다. 카메라에 RTSP 자격 증명이 필요한 경우 새 Stream에도 다시 입력하세요.

Update Config을 통해 [Update Config](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager.md#update-config)각 Stream의 `video_reference.$ref` 를 다음 경로 아래의 카메라 하나를 가리키도록 설정하세요. `config.video_sources` (예: `#/config/video_sources/line_camera`).

캡처를 공유하려면 기기의 [Configuration](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/making-changes/update-device-configuration.md).

### 에서 "Multiprocessing"이 활성화된, 이를 지원하는 inference 버전이 필요합니다.

일련번호만 입력하세요. Edge가 카메라가 GigE인지 USB인지 판별하고, GigE 카메라의 경우 스트림이 시작될 때 포트를 찾아 호환되는 IP를 설정합니다. IP 주소로 설정된 이전 Stream은 일련번호를 입력할 때까지 계속 작동합니다.

검색된 카메라 표에서 "Network mismatch" 배지는 Edge가 카메라의 주소를 직접 변경한다는 뜻입니다. "Network review"는 포트가 공유 중이거나 기본 경로를 전달하고 있다는 뜻이므로 [IP를 직접 설정하세요](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/making-changes/set-camera-static-ip.md). 행의 버튼에 "Set Up Camera Port"가 표시되면 먼저 [전용 카메라 포트](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/making-changes/configure-device-network.md#dedicated-camera-port) 를 설정해야 합니다.

표에는 기기에서 찾을 수 없는 카메라("Never seen")를 포함하여 Streams에서 사용하는 카메라도 표시됩니다. 카메라 행을 클릭하면 카메라 연결 및 네트워크 점검 목록인 "Diagnostics"가 열립니다. 통과하지 못한 점검 항목에는 문제를 해결하는 버튼(예: "Set Static IP")이 표시될 수 있으며, "Copy Report"를 클릭하면 공유할 수 있도록 결과가 복사됩니다.

### Workflow 호환성

Workflow를 선택하면 Roboflow가 기기에서 실행 중인 inference 버전과 호환되는지 확인합니다. Workflow 필드 옆의 빨간색 X는 기기에서 해당 Workflow를 실행할 수 없다는 뜻입니다. 아이콘에 마우스를 올리면 지원되지 않는 블록과 그 이유를 확인할 수 있습니다. 이 문제를 해결하려면 기기의 inference 서비스 버전을 업데이트하세요. [Configuration 페이지](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/making-changes/update-device-configuration.md).

이 검사는 기기에서 보고한 정보를 사용합니다. 지원하는 블록을 아직 보고하지 않은 기기에는 아이콘이 표시되지 않습니다.

### RTSP 자격 증명

카메라에 사용자 이름과 비밀번호가 필요한 경우 RTSP URL에 추가하지 말고 "Username" 및 "Password" 필드에 입력하세요.

암호화된 자격 증명을 지원하는 기기에서는 Roboflow가 사용자 이름과 비밀번호를 스트림 URL이 아닌 기기에 암호화하여 저장합니다. 구형 기기는 URL에 저장합니다.

저장된 자격 증명은 다시 표시되지 않습니다. 필드에는 "Saved (enter to change)"라고 표시되며, 자격 증명을 변경하려면 사용자 이름과 비밀번호를 모두 입력해야 합니다.

### RTSPS 인증서

다음으로 시작하는 RTSP URL은 `rtsps://` TLS를 통해 연결되며, 기기는 카메라의 인증서를 확인합니다. 카메라가 자체 서명 인증서를 제공하는 경우 "Allow self-signed TLS certificate"를 선택하세요. 이 체크박스는 `rtsps://` URL에서만 표시되며, URL을 `rtsp://`.

로 다시 변경하면 선택이 해제됩니다. 이 설정은 기기 전체에 적용됩니다. 한 스트림에서 이 옵션을 켜면 해당 기기의 모든 RTSPS 스트림에서 인증서 확인을 건너뜁니다. 가능하면 기기의 "Networking" 탭에서 "CA Certificates" 아래에 발급 인증서를 추가하세요.
