> 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/roboflow-cloud/cloud-streaming/connect-a-source.md).

# 소스 연결

USB, RTSP, ONVIF, 웹캠, 휴대폰 또는 직접 RTMP 비디오를 Cloud Streaming에 연결하고 각 소스의 수명을 이해하세요.

소스는 Cloud Streaming에 비디오를 제공합니다. 소스를 연결해도 Workflow가 시작되지는 않습니다. 라이브 비디오를 확인한 후 [소스에서 Workflow를](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/run-a-workflow.md) 실행하세요.

<table data-search="false"><thead><tr><th>소스</th><th>연결</th><th>사용 기간</th></tr></thead><tbody><tr><td>USB, RTSP 또는 ONVIF 카메라</td><td>카메라가 연결된 컴퓨터 또는 네트워크의 Video Connector</td><td>커넥터와 카메라를 사용할 수 있는 동안 재사용 가능한 소스</td></tr><tr><td>Roboflow Outpost 앱이 설치된 휴대폰</td><td>휴대폰의 앱</td><td>앱이 스트리밍하는 동안 재사용 가능한 소스</td></tr><tr><td>커넥터 로컬 파일</td><td>파일 디렉터리가 있는 Video Connector</td><td>반복 재생되는 라이브 테스트 소스이며, 일괄 업로드용 파일은 아닙니다</td></tr><tr><td>브라우저 웹캠 또는 휴대폰 QR 세션</td><td>브라우저 카메라 게시자</td><td>임시 세션이며 미리 보기만 가능</td></tr><tr><td>RTMP 또는 RTMPS 게시자</td><td>앱에서 제공하는 직접 게시 URL</td><td>재사용 가능한 직접 소스</td></tr></tbody></table>

## 웹 앱

### USB 카메라

[커넥터를 설치하고 시작한 다음](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/install-a-connector.md) 해당 컴퓨터에서 카메라 접근을 허용하세요. 검색이 완료되면 지원되는 USB 카메라가 "Cloud Streaming"에 표시됩니다. 캐시된 썸네일이 아니라 소스의 라이브 미리 보기를 확인하세요. 해상도, 프레임 속도 또는 비트 전송률을 변경하려면 소스 페이지에서 "Capture Settings"를 사용하세요(자세한 내용은 [캡처 및 코덱 설정](#capture-and-codec-settings)).

### RTSP 및 ONVIF 카메라

"Cloud Streaming"에서 커넥터를 열고 "RTSP Cameras"를 찾으세요. 또는 "Add Video Source"를 클릭한 다음 "Connect a Camera"를 클릭하고, "Add to an existing connector" 아래에서 카메라 네트워크에 연결된 커넥터를 선택할 수도 있습니다. [커넥터 업데이트](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/install-a-connector.md#preserve-state-when-updating) 앱에서 요청하면 업데이트하세요. 이 방법으로 커넥터 하나에 최대 50대의 카메라를 추가할 수 있습니다.

알고 있는 스트림을 추가하려면 "Add by RTSP URL"을 클릭하고, 이름과 카메라의 전체 RTSP URL을 입력하세요. 사용자 이름과 비밀번호는 각각 별도의 입력란에 입력한 다음 "Add camera"를 클릭하세요.

"Cameras found on the network" 아래에서 카메라 옆의 "Add"를 클릭하고 "Username"과 "Password"를 입력한 다음 "Add camera"를 클릭하세요. 카메라 정보가 확인되면 드롭다운에서 프로필을 선택하세요.

처리가 시작되기 전에 "Applied"가 표시되고 라이브 소스가 나타날 때까지 기다리세요. 패널에 "Rejected by the connector"가 표시되면 사유를 확인하고 설정을 수정한 후 다시 저장하세요.

카메라를 편집하면 스트림이 중단될 수 있습니다. 카메라를 삭제한 다음 다시 추가하면 새 소스가 생성됩니다. 저장된 비밀번호를 다시 확인할 수는 없습니다.

### 휴대폰 앱

휴대폰을 상시 카메라로 사용하려면 "Add Video Source"를 클릭한 다음 "Phone"을 클릭하세요. 휴대폰의 앱 스토어(App Store 또는 Google Play)에 해당하는 코드를 스캔하고 Roboflow Outpost 앱을 설치하세요. 로그인하고 워크스페이스를 선택한 다음 스트리밍을 시작하세요. 휴대폰이 소스로 표시됩니다. 앱은 백그라운드에서도 스트리밍을 유지하고 자동으로 다시 연결합니다.

* [iOS용 Roboflow Outpost](https://apps.apple.com/us/app/roboflow-outpost/id6813159424)
* [Android용 Roboflow Outpost](https://play.google.com/store/apps/details?id=com.roboflow.connector)

### URL로 카메라 추가

인터넷에서 연결을 허용하는 카메라는 커넥터가 필요하지 않습니다. "Add Video Source"에서 "Camera URL" 탭을 선택하고 RTSP 또는 RTSPS URL이나 HLS 재생목록 URL을 입력하세요. 자세한 내용은 [URL로 카메라 추가](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/add-cameras-by-url.md).

### Verkada 카메라

"Add Video Source"에서 "Verkada" 탭을 선택하고 API 키로 Verkada 조직을 연결한 다음 카메라를 추가하세요. 자세한 내용은 [Verkada 카메라](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/verkada.md).

### 임시 웹캠 및 휴대폰 세션

Workflow 편집기의 실행 패널에서 웹캠을 스트리밍하거나 Agent에서 "Use Webcam" 또는 "Use Your Phone"을 선택하세요. 휴대폰을 사용하는 경우 QR 코드를 스캔한 다음 "Start Camera"를 탭하세요. 코드는 한 번만 사용할 수 있으며 5분 후에 만료됩니다. 세션을 종료하려면 "Stop Streaming"을 탭하세요.

스트림을 중단하지 않고 렌즈를 전환하려면 휴대폰 페이지의 카메라 메뉴를 사용하세요.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-ba4bedba2138e02567e1476891df3c69ce2c548f%2Fcloud-streaming-shot08-webcam.png?alt=media" alt="Agent test-source picker with File, Webcam and Stream options."><figcaption><p>임시 브라우저 카메라 미리 보기를 시작하려면 Webcam을 선택하세요.</p></figcaption></figure>

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-560ab41d13a8aa8d52bf271ee8ec30dd87418903%2Fcloud-streaming-shot08-phone.png?alt=media" alt="Connect your phone panel with QR pairing instructions and an expiry timer."><figcaption><p>휴대폰 페어링 코드를 스캔하고 세션이 진행되는 동안 게시 페이지를 열어 두세요.</p></figcaption></figure>

게시자 연결이 끊기거나 세션이 중지되면 세션과 해당 작업이 종료됩니다. 휴대폰이 계속 게시 중이어도 미리 보기를 제어하는 브라우저를 닫으면 미리 보기가 종료됩니다. 임시 소스는 미리 보기만 실행할 수 있으며 상시 소스로 전환할 수 없습니다. 지속적인 처리를 원하면 커넥터 또는 직접 소스를 사용하세요.

### 직접 RTMP 및 RTMPS

{% hint style="info" %}
직접 입력은 "RTMP 스트림"으로 표시되며 "파일럿" 라벨이 붙습니다. "소스 동영상 관리" 권한이 필요하며, 아직 EU 리전에서는 사용할 수 없습니다.
{% endhint %}

1. "동영상 소스 추가"를 열고 "RTMP 스트림"을 선택한 다음 "소스 이름"을 입력하고 "스트림 소스 만들기"를 클릭합니다.
2. 프로토콜을 선택합니다. 송출 장치가 지원한다면 RTMPS를 사용하는 것이 좋습니다. RTMP는 동영상과 스트림 키를 암호화하지 않고 전송합니다.
3. "서버 URL"과 "스트림 키"를 카메라나 인코더에 복사합니다. 주소를 하나만 입력할 수 있다면 "전체 URL 복사"를 사용하고 키 입력란은 비워 둡니다.
4. 방송을 시작하고 라이브 동영상이 표시될 때까지 기다린 다음 "워크플로 실행"을 선택합니다.

Roboflow는 소스를 만든 후 24시간 동안 동영상이 수신되지 않은 직접 소스를 삭제합니다. 단, 해당 소스에서 워크플로 작업이 대기 중이거나 실행 중인 경우는 제외됩니다. 송출 장치를 사용할 준비가 되었을 때 소스를 만드세요.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-648c95ce19005239e05a99053e061050d3322773%2Fcloud-streaming-shot09-rtmp-pilot.png?alt=media" alt="RTMP Stream Pilot setup with RTMPS selected and a masked stream key."><figcaption><p>제공된 송출 정보를 인코더에 복사합니다. 스트림 키는 안전하게 보관하세요.</p></figcaption></figure>

호스트 이름을 직접 만들거나 URL 스킴을 변경하지 말고 앱에서 반환한 URL을 사용하세요.

정보를 다시 확인하려면 소스 메뉴에서 "연결 설정"을 선택합니다. "키 교체"를 선택하면 방송 연결이 끊깁니다. 송출 장치를 업데이트한 다음 다시 방송하세요. "사용자 지정 키 설정"에는 8\~128자의 영문자, 숫자, 하이픈 또는 밑줄을 입력할 수 있습니다.

연결이 끊긴 후 [재개되지 않으면 워크플로를](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/run-a-workflow.md#restarts) 다시 시작하세요.

## 캡처 및 코덱 설정

USB 카메라의 경우 소스 메뉴에서 "캡처 설정"을 선택하고 카메라에서 보고한 모드를 선택합니다. "적용됨"이 표시될 때까지 기다리세요. "설정이 거부됨"은 카메라가 기존 설정을 유지한다는 뜻입니다. 설정을 적용하면 스트림이 다시 시작될 수 있습니다.

RTSP 카메라는 일반적으로 재인코딩 없이 카메라 자체의 인코딩된 스트림을 사용합니다. 커넥터의 USB 설정으로는 RTSP 카메라의 해상도, FPS 또는 대역폭을 낮출 수 없습니다. 대신 카메라의 프로필이나 인코더 설정을 변경하세요.

다양한 브라우저에서 원활히 재생하려면 B 프레임이 없는 H.264를 사용하세요. 가능하면 베이스라인 프로필을 권장합니다. H.265 또는 B 프레임을 사용하는 H.264는 릴레이에 도달해도 브라우저에서 재생되지 않을 수 있습니다. 전송 방식만 변경해도 호환되지 않는 코덱 문제는 해결되지 않습니다. 호환되는 카메라 프로필을 사용하거나 성능이 충분한 호스트에서 의도적으로 트랜스코딩하세요.

## 커넥터 CLI

### 로컬 파일 반복 재생

로컬 디렉터리의 동영상을 등록하려면 다음을 실행합니다.

```sh
~/.rfv-connector/rfv-connector \
  --api-key "$ROBOFLOW_API_KEY" \
  --files-dir ./videos
```

커넥터는 폴더에 있는 각 동영상 파일을(하위 폴더 제외) 라이브 소스로 반복 재생합니다. 라이브 처리 중에는 프레임이 건너뛰어질 수 있습니다. 파일을 끝까지 처리하려면 다음을 사용하세요. [일괄 처리](https://docs.roboflow.com/deployment/ko/roboflow-cloud/batch-processing.md).

### 썸네일 제어

커넥터는 카메라를 찾으면 각 카메라의 스틸 이미지를 캡처하고, 이후에는 하루에 한 번 캡처합니다. 이때 카메라 표시등이 잠시 켜질 수 있습니다.

향후 캡처를 중지하려면 커넥터 페이지에서 "카메라 썸네일"을 끄거나 다음 옵션을 사용해 실행하세요. `--no-thumbnails` 를 로컬 재정의 옵션으로 사용합니다. 캡처를 비활성화해도 기존 썸네일은 삭제되지 않습니다. 썸네일은 라이브 동영상이나 녹화본이 아니며 처리가 실행 중이라는 증거도 아닙니다.

## HTTP API

경로에 지정된 워크스페이스의 인증 정보를 사용해 [API 인증](https://docs.roboflow.com/reference/platform/rest-api/authenticate-with-the-rest-api) 을 수행합니다. 인터넷에서 연결할 수 있는 카메라를 추가하려면 [URL로 카메라 추가 API](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/add-cameras-by-url.md#http-api)를 참조하세요. Roboflow 앱에서 RTSP 카메라를 커넥터에 추가하고, 커넥터를 구성하고, 직접 RTMP 소스를 만들고, 송출 키를 교체할 수 있습니다. 이러한 기능을 위한 API 엔드포인트는 없습니다.

### 등록된 소스 나열

작업을 시작하기 전에 연결된 소스의 ID를 복사하세요.

{% openapi src="/files/ae7e4311e69eb877b2de6277c1563407df651d51" path="/{workspace}/video-sources/v1" method="get" %}
[cloud-streaming.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

### 소스 동영상 미리보기

모델을 실행하지 않고 카메라를 확인합니다. 플레이어가 열린 상태에서 다시 호출하세요. URL은 비공개로 유지하세요.

{% openapi src="/files/ae7e4311e69eb877b2de6277c1563407df651d51" path="/{workspace}/video-sources/v1/{sourceId}/preview" method="post" %}
[cloud-streaming.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

### 임시 세션 할당

2분 이내에 반환된 WHIP URL로 동영상을 송출합니다. Idempotency-Key는 같은 요청을 재시도할 때만 재사용하세요. `Idempotency-Key` 같은 요청을 재시도할 때만 재사용하세요.

{% openapi src="/files/ae7e4311e69eb877b2de6277c1563407df651d51" path="/{workspace}/video-sources/v1/temporary" method="post" %}
[cloud-streaming.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

임시 세션 작업은 미리보기 전용입니다. 송출 세션과 해당 작업 소유자의 수명은 서로 다릅니다. 자세한 내용은 [임시 미리보기 소유권](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/run-a-workflow.md#hold-a-temporary-preview).

### 임시 세션 중지

캡처가 끝나면 세션을 중지하세요. 이렇게 하면 송출 권한이 취소되고 세션의 작업이 취소됩니다. 워크플로 작업만 중지하는 것은 해당 소스 세션을 종료하는 것과 다릅니다.

{% openapi src="/files/ae7e4311e69eb877b2de6277c1563407df651d51" path="/{workspace}/video-sources/v1/{sourceId}/stop-session" method="post" %}
[cloud-streaming.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}
