> ## Documentation Index
> Fetch the complete documentation index at: https://guide.dorothy.land/llms.txt
> Use this file to discover all available pages before exploring further.

# 도로시 서버 OBS / PRISM 설정

> 도로시가 방송 화면을 받을 수 있도록 송출 프로그램을 연결하는 방법입니다.

도로시가 방송 화면을 받을 수 있도록 송출 프로그램을 연결하는 방법입니다. 현재 워크스페이스의 **방송 설정**에서는 `https://…/whip/…` 형식의 **OBS 방송 주소** 한 개를 제공합니다.

## 시작 전 확인

1. [방송 설정](https://dorothy.land/workspace/broadcast)을 엽니다.
2. **방송 플랫폼 연결**에서 사용할 채널을 연결합니다.
3. **기본 정보**의 스트리머 이름과 방송 주제를 입력하고 **저장**합니다.
4. **API 키**가 발급되어 있는지 확인합니다.
5. 화면 아래 **OBS 방송 주소**가 표시되는지 확인합니다.

<Danger>
  OBS 방송 주소와 API 키에는 나의 방송 연결 정보가 포함되어 있어요. 이 가이드나 스크린샷에 실제 값을 붙여 넣지 마세요.
</Danger>

### API 키가 아직 없다면

1. **방송 설정 → API 키 → API 키 발급**을 누릅니다.
2. 발급 완료 창에 나타난 키를 즉시 복사해 안전한 곳에 보관합니다.
3. 창을 닫기 전에 정확히 저장했는지 확인합니다.

API 키 원문은 발급 직후 한 번만 표시되고 이후에는 마스킹됩니다. 잃어버렸다면 **API 키 재발급**이 필요하며, 재발급하는 즉시 기존 키는 사용할 수 없게 됩니다.

## OBS Studio에서 연결하기

### 1. 도로시 주소 복사

**방송 설정 → OBS 방송 주소**에서 가려진 값을 눌러 확인한 뒤 **복사**를 누릅니다.

### 2. WHIP 서비스 선택

OBS Studio에서 다음 순서로 이동합니다.

1. **설정**을 엽니다.
2. 왼쪽 메뉴에서 **방송**을 선택합니다.
3. **서비스**를 `WHIP`으로 선택합니다.

### 3. 주소 입력

* **서버**: 도로시에서 복사한 전체 OBS 방송 주소를 붙여 넣습니다.
* **Bearer Token**: 도로시에서 발급한 **API 키**를 붙여 넣습니다.

**적용 → 확인**을 누르면 연결 준비가 끝납니다.

### 4. 연결 확인

1. OBS의 장면과 오디오 미터가 정상인지 확인합니다.
2. **방송 시작**을 누릅니다.
3. 도로시 워크스페이스에서 방송 상태가 정상적으로 바뀌는지 확인합니다.

<Warning>
  OBS의 기본 방송 대상을 도로시 WHIP로 바꾸는 설정입니다. 도로시 서버와 실제 플랫폼으로 화면이 전달되는 전체 흐름은 비공개 테스트 방송에서 먼저 확인해 주세요. 별도 멀티 출력 플러그인은 도로시의 공식 안내를 확인하기 전 임의로 설치하지 않는 편이 안전합니다.
</Warning>

<Info>
  OBS에 `WHIP` 항목이 없다면 OBS Studio를 최신 버전으로 업데이트해 주세요. 공식 OBS 안내에서도 WHIP은 **설정 → 방송 → 서비스: WHIP**에서 서버와 Bearer Token을 입력하는 방식입니다.
</Info>

## PRISM Live Studio에서 사용하기

### 먼저 알아둘 점

현재 도로시가 제공하는 주소는 **WHIP(HTTPS)** 주소입니다. PRISM 공식 FAQ는 일부 WHIP 출력을 안내하지만 임의의 WHIP 제공자 연결 절차는 명확히 설명하지 않습니다. 따라서 **Custom RTMP** 입력란에 도로시의 WHIP 주소를 RTMP 주소처럼 붙여 넣으면 안 됩니다.

가장 안전한 현재 방식은 아래의 **PRISM 가상 카메라 → OBS → 도로시** 연결입니다.

### PRISM 직접 연결은 현재 확인 중이에요

PRISM에 WHIP 관련 항목이 보이더라도 도로시의 임의 WHIP 서버와 Bearer Token을 받을 수 있는지는 공식 문서만으로 확인되지 않습니다. 검증이 끝나기 전에는 공개 방송에서 직접 연결을 사용하지 말고 아래 OBS 경유 방식을 이용해 주세요.

### PRISM 화면을 OBS를 거쳐 보내기

1. PRISM에서 방송 장면을 모두 구성합니다.
2. PRISM 오른쪽 사이드바에서 **가상 카메라 시작**을 누릅니다.
3. OBS의 **소스** 영역에서 **+ → 비디오 캡처 장치**를 선택합니다.
4. 장치 목록에서 PRISM 가상 카메라를 선택합니다.
5. PRISM 화면이 OBS 미리보기에 보이도록 크기를 맞춥니다.
6. 마이크와 데스크톱 오디오는 OBS 오디오 믹서에서도 들어오는지 확인합니다. 같은 소리가 두 번 잡히면 한쪽 입력을 음소거합니다.
7. 위의 [OBS Studio에서 연결하기](#obs-studio에서-연결하기) 순서대로 도로시 WHIP 주소를 설정합니다.
8. OBS에서 **방송 시작**을 누릅니다.

<Warning>
  PRISM의 RTMP 전용 화면에는 **WHIP 주소를 입력하지 마세요.** 직접 연결 지원 여부는 PRISM 버전과 도로시의 제공 방식에 따라 달라질 수 있습니다.
</Warning>

## 문제 해결

### OBS에서 연결할 수 없다고 나와요

* 서버 칸에 주소 전체가 빠짐없이 들어갔는지 확인합니다.
* 주소 앞뒤에 공백이 붙지 않았는지 확인합니다.
* VPN이나 회사·학교 네트워크를 사용 중이라면 일반 네트워크에서 다시 확인합니다.
* OBS를 완전히 종료한 뒤 다시 실행합니다.

### PRISM 화면은 보이는데 소리가 없어요

가상 카메라는 영상만 전달하는 경우가 있습니다. OBS에 **오디오 입력 캡처**와 필요한 **데스크톱 오디오**를 별도로 추가해 주세요.

### 같은 소리가 두 번 들려요

PRISM과 OBS에서 같은 마이크 또는 데스크톱 소리를 동시에 받고 있는지 확인하고, 한쪽을 음소거합니다.

## 참고

* [OBS 공식 WHIP 송출 가이드](https://obsproject.com/kb/whip-streaming-guide)
* [PRISM Desktop 공식 시작 가이드](https://guide.prismlive.com/desktop/guides/getting-started-with-prism-desktop)
* [PRISM 공식 FAQ](https://prismlive.com/ko_kr/faq/faq.html)