이 번역은 최신 영어 원문보다 늦을 수 있습니다. 영어 버전 보기

스튜디오 모드 및 전환

이 가이드에서는 스튜디오 모드(미리보기/프로그램 워크플로 및 T-Bar 직접 제어 포함)와 장면 전환(전환 선택, 시간 설정, 전환 이벤트 반응)을 다룹니다.

스튜디오 모드

함수	설명
`SetStudioModeEnabled(Enabled)`	스튜디오 모드 활성화 또는 비활성화
`GetStudioModeEnabled()`	현재 스튜디오 모드 상태 가져오기
`IsStudioModeEnabled()`	스튜디오 모드 활성화 여부 확인 (캐시)
`SetCurrentPreviewScene(Name)`	미리보기 장면 설정 (스튜디오 모드 전용)
`GetCurrentPreviewScene()`	현재 미리보기 장면 가져오기
`GetPreviewSceneName()`	미리보기 장면 이름 가져오기 (캐시)
`TriggerStudioModeTransition()`	미리보기를 프로그램으로 전환

T-Bar 제어: GetClient()->GetStudioMode()->SetTBarPosition(Position, bRelease)는 스튜디오 모드 전환 T-Bar를 직접 구동합니다. Position은 0.0과 1.0 사이로 고정됩니다. bRelease = false를 전달하면 바를 특정 위치에 고정하고(예: Sequencer 플로트 트랙에서 스크럽할 때), true를 전달하면 바를 해제하여 OBS가 전환을 완료합니다. 스튜디오 모드와 Cut이 아닌 전환이 필요합니다.

// Hold the T-Bar at the halfway point, then release to complete the transition
UInhyeongOBSWebSocketClient* Client = OBS->GetClient();
Client->GetStudioMode()->SetTBarPosition(0.5f, /*bRelease=*/false);
// ...later...
Client->GetStudioMode()->SetTBarPosition(1.0f, /*bRelease=*/true);

참고: 미리보기 장면 함수는 스튜디오 모드가 활성화된 경우에만 동작합니다.

전환

함수	설명
`GetSceneTransitionList()`	사용 가능한 전환 목록 새로 고침
`GetCurrentSceneTransition()`	현재 전환 세부 정보 가져오기
`SetCurrentSceneTransition(Name)`	활성 장면 전환 설정
`SetCurrentSceneTransitionDuration(Ms)`	전환 시간을 밀리초 단위로 설정
`GetCurrentTransitionName()`	현재 전환 이름 가져오기 (캐시)
`GetCurrentTransitionDuration()`	현재 시간(밀리초) 가져오기 (캐시)
`IsTransitionActive()`	전환이 현재 진행 중인지 확인
`GetCachedTransitions()`	로컬에 캐시된 전환 목록 가져오기

참고: Cut과 같은 고정 전환은 시간 변경을 지원하지 않으므로, 시간을 수정하기 전에 bTransitionFixed를 확인하십시오.

이벤트

스튜디오 모드

OnStudioModeStateChanged(bEnabled): 스튜디오 모드 활성화 또는 비활성화됨
OnCurrentPreviewSceneChanged(SceneName, SceneUuid): 미리보기 장면이 변경됨

전환

OnCurrentTransitionChanged(TransitionName): 활성 전환이 변경됨
OnTransitionDurationChanged(DurationMs): 전환 시간이 변경됨
OnTransitionStarted(TransitionName): 장면 전환이 시작됨
OnTransitionEnded(TransitionName): 장면 전환이 완료됨
OnTransitionVideoEnded(TransitionName): 전환 영상이 종료됨 (스팅어 전환에 유용)
OnTransitionListUpdated: 전환 목록이 새로 고쳐짐

모든 OBS 도메인에 걸친 이벤트 전체 목록은 이벤트 레퍼런스를 참조하십시오.