장면 모음 및 프로필
OBS는 설정을 장면 모음(장면과 소스의 묶음)과 프로필(출력, 인코더, 서비스 설정)로 관리합니다. 이 가이드에서는 장면 모음과 프로필 간의 전환, 비디오 출력 구성, 방송 서비스 목적지 설정 방법을 다룹니다.
장면 모음
| 함수 | 설명 |
|---|
GetSceneCollectionList() | OBS에서 장면 모음 목록 새로 고침 |
SetCurrentSceneCollection(Name) | 장면 모음으로 전환 (OBS 재로드 발생!) |
CreateSceneCollection(Name) | 새 모음 생성 후 전환 |
GetCachedSceneCollections() | 로컬에 캐시된 모음 이름 가져오기 |
GetCurrentSceneCollectionName() | 현재 모음 이름 가져오기 (캐시) |
경고: 장면 모음을 전환하면 OBS가 모든 소스를 다시 로드하므로, 잠깐의 중단이 발생할 수 있습니다.
프로필
| 함수 | 설명 |
|---|
GetProfileList() | OBS에서 프로필 목록 새로 고침 |
SetCurrentProfile(Name) | 프로필로 전환 |
CreateProfile(Name) | 새 프로필 생성 후 전환 |
RemoveProfile(Name) | 프로필 삭제 (현재 프로필은 삭제 불가!) |
GetProfileParameter(Category, Name) | 프로필 설정 파라미터 가져오기 |
SetProfileParameter(Category, Name, Value) | 프로필 설정 파라미터 지정 |
GetCachedProfiles() | 로컬에 캐시된 프로필 이름 가져오기 |
GetCurrentProfileName() | 현재 프로필 이름 가져오기 (캐시) |
자주 사용하는 프로필 파라미터
| 카테고리 | 파라미터 | 설명 |
|---|
Output | RecFilePath | 녹화 디렉터리 |
Output | Mode | 출력 모드 (Simple/Advanced) |
Stream | key | 스트림 키 |
Stream | server | RTMP 서버 URL |
비디오 설정
| 함수 | 설명 |
|---|
GetVideoSettings() | 현재 해상도 및 FPS 가져오기 |
SetVideoSettings(Settings) | 여러 비디오 설정을 한 번에 지정 |
SetBaseResolution(Width, Height) | 캔버스 해상도 설정 |
SetOutputResolution(Width, Height) | 출력/스케일 해상도 설정 |
SetFPS(Numerator, Denominator) | 프레임 레이트 설정 |
GetCachedVideoSettings() | 로컬에 캐시된 비디오 설정 가져오기 |
경고: 방송 또는 녹화 중에는 비디오 설정을 변경할 수 없습니다!
자주 사용하는 FPS 값
| FPS | Numerator | Denominator |
|---|
| 24 | 24 | 1 |
| 30 | 30 | 1 |
| 29.97 (NTSC) | 30000 | 1001 |
| 60 | 60 | 1 |
| 59.94 (NTSC) | 60000 | 1001 |
| 120 | 120 | 1 |
방송 서비스 설정
| 함수 | 설명 |
|---|
GetStreamServiceSettings() | 현재 방송 목적지 설정 가져오기 |
SetStreamServiceSettings(Settings) | 구조체를 사용하여 방송 서비스 설정 |
SetSimpleRTMPSettings(Server, StreamKey) | 커스텀 RTMP 빠른 설정 |
GetCachedStreamServiceSettings() | 로컬에 캐시된 방송 설정 가져오기 |
서비스 유형
| 유형 | 설명 |
|---|
rtmp_custom | 커스텀 RTMP 서버 (서버 URL을 직접 입력) |
rtmp_common | 사전 구성된 서비스 (Twitch, YouTube 등) |
자주 사용하는 RTMP 서버
| 서비스 | 서버 URL |
|---|
| Twitch | rtmp://live.twitch.tv/app |
| YouTube | rtmp://a.rtmp.youtube.com/live2 |
| Facebook | rtmps://live-api-s.facebook.com:443/rtmp/ |
| Kick | rtmps://fa723fc1b171.global-contribute.live-video.net/app/ |
설정 구조체 (FOBSStreamServiceSettings)
| 필드 | 유형 | 설명 |
|---|
StreamServiceType | FString | rtmp_custom 또는 rtmp_common |
Server | FString | RTMP 서버 URL (rtmp_custom용) |
Key | FString | 스트림 키 (민감 정보!) |
Service | FString | 서비스 이름 (rtmp_common용, 예: “Twitch”) |
bUseAuth | bool | 인증 사용 여부 |
Username | FString | 인증 사용자 이름 |
Password | FString | 인증 비밀번호 |
참고:
- 변경 사항을 적용하려면 방송을 다시 시작해야 합니다.
- 스트림 키는 민감한 데이터이므로 안전하게 취급하십시오.
- OBS는 이 설정에 대한 이벤트를 전송하지 않으므로, 수동으로 새로 고침하십시오.
이벤트
설정 변경에 반응하려면 다음 이벤트를 구독하십시오.
OnCurrentSceneCollectionChanging(SceneCollectionName): 장면 모음 전환 직전OnCurrentSceneCollectionChanged(SceneCollectionName): 장면 모음 전환 완료OnSceneCollectionListChanged: 장면 모음 목록 변경됨OnCurrentProfileChanging(ProfileName): 프로필 전환 직전OnCurrentProfileChanged(ProfileName): 프로필 전환 완료OnProfileListChanged: 프로필 목록 변경됨OnStreamServiceSettingsReceived(Settings): 방송 서비스 설정 수신 완료
참고 항목