Skip to main content
Microsoft Game Development Kit(GDK)에는 방송 UI를 표시하고, 스크린샷, 비디오 클립, 방송에 메타데이터를 추가하고, 진단용 스크린샷과 비디오를 캡처하기 위한 방송 알림용 API 집합이 포함되어 있습니다. 방송 알림은 방송 파이프라인에 대한 인사이트를 제공합니다. 방송 UI는 사용자가 방송을 시작하고 중지할 수 있도록 합니다. 메타데이터를 추가하면 맵 이름, 게임의 레벨 또는 캡처된 그 특정 순간에 대한 무엇이든 추가하여 녹화 파일을 검색하기가 더 쉬워집니다. 이러한 API를 함께 사용하면 스크린샷, 비디오 클립, 방송에 대한 더 나은 제어와 인사이트를 얻을 수 있습니다.

방송 알림 및 UI

XAppBroadcastGetStatus는 방송 상태의 업데이트를 보여줍니다. 이 메서드를 사용하여 방송을 시작할 수 있는지 확인합니다. 캡처 리소스를 사용할 수 있는지, 게임이 방송을 허용하는지, 사용자 및/또는 시스템이 방송을 비활성화했는지 등 방송을 시작할 수 있는지 결정하는 데 많은 요소가 관여합니다. XAppBroadcastStatus 구조체의 모든 멤버(canStartBroadcast 제외)가 false를 반환하면 canStartBroadcasttrue를 반환합니다. 방송을 시작할 수 있는 경우 XAppBroadcastShowUI를 호출하여 현재 사용자에게 방송 UI를 표시합니다. 그런 다음 사용자가 수동으로 방송을 시작해야 합니다. XAppBroadcastIsAppBroadcasting은 현재 앱이 방송 중인지 확인하는 데 사용됩니다. XAppBroadcastUnregisterIsAppBroadcasting은 방송 상태 변경 이벤트에서 등록을 해제하는 데 사용됩니다.

스크린샷, 비디오 클립, 방송에 메타데이터 추가

스크린샷, 비디오 클립 또는 방송에 첨부된 메타데이터를 추가하고 관리하는 데 여러 API가 사용됩니다. 메타데이터 추가는 선택 사항입니다. 그러나 이를 통해 사용자가 원하는 녹화 파일을 더 쉽게 찾을 수 있습니다. 메타데이터는 문자열, 정수, double과 같은 다양한 형식을 취할 수 있습니다. 시스템은 메타데이터 항목을 위한 저장 공간을 할당합니다. 할당된 공간이 부족해지면 AppCaptureMetatPriority를 사용하여 저장된 메타데이터 항목의 상대적 우선순위와 공간 확보를 위해 메타데이터가 제거되는 순서를 결정합니다.

음성 채팅

음성 채팅은 개인 식별 정보 또는 기타 잠재적으로 민감한 데이터를 포함할 수 있는 사용자 생성 콘텐츠로 간주해야 합니다. 이 때문에 게임 채팅에서 사용자의 렌더링된 음성은 녹화된 클립이나 게임 캡처에 포함되어서는 안 됩니다. 이를 위해 사용자 음성이 포함된 렌더 스트림에 적절한 오디오 카테고리, 즉 AudioCategory_GameChat을 할당할 수 있습니다. 그러면 스트림이 적절히 태그되어 시스템이 게임 DVR 클립을 캡처할 때 이 오디오 스트림을 무시해야 함을 알 수 있습니다.

진단용 스크린샷 및 비디오 클립

이러한 Microsoft Game Development Kit(GDK) API를 사용하면 진단 목적으로 스크린샷과 비디오 클립을 캡처할 수 있습니다. 이러한 진단 API는 개발 키트에서만 사용할 수 있습니다. 리테일 콘솔에서 이러한 API를 호출하면 즉시 실패합니다. 캡처된 스크린샷과 비디오 클립은 일반적인 사용자 저장소가 아닌 로컬 게임 파티션으로 이동합니다. 게임이 HDR(High Dynamic Range)로 실행 중인 경우 호출자는 SDR(Standard Dynamic Range) 스크린샷, HDR 스크린샷 또는 두 가지 모두를 캡처할지 여부를 지정할 수 있습니다. 스크린샷이 기록된 후 결과 구조체에는 스크린샷 파일의 위치에 대한 경로 정보가 포함됩니다. 비디오 클립의 경우 사용자의 게임 DVR 설정에 따라 H264(AVC, Advanced Video Coding) 인코딩 비디오 또는 H265(HEVC, High Efficiency Video Coding) 인코딩 비디오가 반환될 수 있습니다. 결과 구조체에는 시작 시간, 지속 시간, 너비 및 높이와 같은 정보도 포함됩니다.

일반 스크린샷

Microsoft Game Development Kit(GDK)에 새로 추가된 기능은 일반 스크린샷을 캡처하는 기능입니다. 결과 스크린샷은 스크린샷용 일반 사용자 저장소에 저장됩니다. 또한 스크린샷이 캡처되었다는 시스템 알림이 표시됩니다. 스크린샷은 게임 파티션에서 직접 액세스할 수 없는 별도 파티션에 저장되기 때문에, 제공된 open/read/close 스트림 API를 사용하여 기록된 스크린샷에 액세스해야 합니다. 게임이 HDR로 실행 중인 경우 스크린샷의 SDR 버전과 HDR 버전 모두에 대한 경로가 반환됩니다.

참조 API 설명서

함께 보기

XAppCapture
마지막 수정일 2026년 8월 13일