> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # XAppCapture > XAppCapture # XAppCapture XBOX와 데스크톱은 각각 사용자가 방송할 수 있는 애플리케이션에 대한 고유한 규칙과 함께 기본 방송 환경을 포함합니다. 이러한 API를 통해 개발자는 방송 UI를 표시하고 사용자가 방송 중인지 감지할 수 있습니다. 앱 개발자는 캡처된 비디오 및 오디오 파일/스트림과 함께 저장되거나 방송될 메타데이터 이벤트 및 상태를 제공할 수 있습니다. ## 함수 | 함수 | 설명 | | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [XAppBroadcastGetStatus](/reference/system/xappcapture/functions/xappbroadcastgetstatus) | 디바이스 및 현재 앱에 대한 방송의 현재 상태를 검색합니다. | | [XAppBroadcastIsAppBroadcasting](/reference/system/xappcapture/functions/xappbroadcastisappbroadcasting) | 앱이 현재 방송 중인지 여부를 결정합니다. | | [XAppBroadcastMonitorCallback](/reference/system/xappcapture/functions/xappbroadcastmonitorcallback) | [XAppBroadcastRegisterIsAppBroadcastingChanged](/reference/system/xappcapture/functions/xappbroadcastregisterisappbroadcastingchanged)에 대한 콜백 함수를 설정합니다. 여기서 설정된 함수는 방송 상태가 변경될 때마다 호출됩니다. | | [XAppBroadcastRegisterIsAppBroadcastingChanged](/reference/system/xappcapture/functions/xappbroadcastregisterisappbroadcastingchanged) | 앱 방송 상태 변경 이벤트 처리기를 등록합니다. | | [XAppBroadcastShowUI](/reference/system/xappcapture/functions/xappbroadcastshowui) | 앱 사용자에게 방송 UI를 표시하여 방송 활동을 시작할 수 있도록 합니다. | | [XAppBroadcastUnregisterIsAppBroadcastingChanged](/reference/system/xappcapture/functions/xappbroadcastunregisterisappbroadcastingchanged) | 앱 방송 상태 변경 이벤트 처리기를 제거합니다. | | [XAppCaptureCancelUserRecord](/reference/system/xappcapture/functions/xappcapturecanceluserrecord) | [XAppCaptureStartUserRecord](/reference/system/xappcapture/functions/xappcapturestartuserrecord)를 통해 시작되고 입력된 ID로 지정된 진행 중인 GameDVR 사용자 녹화를 중지하고 삭제합니다. | | [XAppCaptureCloseLocalStream](/reference/system/xappcapture/functions/xappcapturecloselocalstream) | 지정된 녹화 스트림을 닫고 삭제합니다. | | [XAppCaptureCloseScreenshotStream](/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream) | 스크린샷 스트림을 닫습니다. | | [XAppCaptureDisableRecord](/reference/system/xappcapture/functions/xappcapturedisablerecord) | 플레이어에 대해 비디오 녹화를 비활성화합니다. | | [XAppCaptureEnableRecord](/reference/system/xappcapture/functions/xappcaptureenablerecord) | 현재 사용자에 대해 녹화/스크린샷을 활성화합니다. | | [XAppCaptureGetVideoCaptureSettings](/reference/system/xappcapture/functions/xappcapturegetvideocapturesettings) | 인코딩 형식, 색상 형식, 해상도, 가능한 최대 녹화 길이 및 현재 사용자가 게임에 의한 캡처를 허용하는지 여부를 포함하는 디바이스의 GameDVR 설정을 쿼리합니다. | | [XAppCaptureMetadataAddDoubleEvent](/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent) | double 값이 있는 메타데이터 이벤트를 앱 캡처에 추가합니다. | | [XAppCaptureMetadataAddInt32Event](/reference/system/xappcapture/functions/xappcapturemetadataaddint32event) | Int32 값이 있는 메타데이터 이벤트를 앱 캡처에 추가합니다. | | [XAppCaptureMetadataAddStringEvent](/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent) | 문자열 값이 있는 메타데이터 이벤트를 앱 캡처에 추가합니다. | | [XAppCaptureMetadataPurgedCallback](/reference/system/xappcapture/functions/xappcapturemetadatapurgedcallback) | 메타데이터 제거가 발생할 때 호출될 콜백 함수를 설정합니다. | | [XAppCaptureMetadataRemainingStorageBytesAvailable](/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable) | 앱 캡처 메타데이터에 대해 사용 가능한 남은 저장소를 반환합니다. 바이트 단위로 측정됩니다. | | [XAppCaptureMetadataStartDoubleState](/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate) | double 값이 있는 메타데이터 상태를 앱 캡처에 추가합니다. | | [XAppCaptureMetadataStartInt32State](/reference/system/xappcapture/functions/xappcapturemetadatastartint32state) | Int32 값이 있는 메타데이터 상태를 앱 캡처에 추가합니다. | | [XAppCaptureMetadataStartStringState](/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate) | 문자열 값이 있는 메타데이터 상태를 앱 캡처에 추가합니다. | | [XAppCaptureMetadataStopAllStates](/reference/system/xappcapture/functions/xappcapturemetadatastopallstates) | 현재 활성 상태인 모든 상태 이벤트를 중지합니다. | | [XAppCaptureMetadataStopState](/reference/system/xappcapture/functions/xappcapturemetadatastopstate) | 앱 캡처 메타데이터에 특정 명명된 상태에 대한 상태 중지를 추가합니다. | | [XAppCaptureOpenScreenshotStream](/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream) | 스크린샷 스트림을 엽니다. | | [XAppCaptureReadLocalStream](/reference/system/xappcapture/functions/xappcapturereadlocalstream) | 이전에 [XAppCaptureRecordTimespan](/reference/system/xappcapture/functions/xappcapturerecordtimespan) 호출로 생성된 .mp4 파일의 내용을 읽습니다. | | [XAppCaptureReadScreenshotStream](/reference/system/xappcapture/functions/xappcapturereadscreenshotstream) | 스크린샷 스트림을 읽습니다. | | [XAppCaptureRecordDiagnosticClip](/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip) | 앱에서 진단 클립을 녹화합니다. | | [XAppCaptureRecordTimespan](/reference/system/xappcapture/functions/xappcapturerecordtimespan) | GameDVR 녹화를 수행합니다. | | [XAppCaptureRegisterMetadataPurged](/reference/system/xappcapture/functions/xappcaptureregistermetadatapurged) | 메타데이터 제거 이벤트에 대한 이벤트 처리기를 등록합니다. | | [XAppCaptureStartUserRecord](/reference/system/xappcapture/functions/xappcapturestartuserrecord) | 사용자가 트리거한 것처럼 녹화를 시작합니다. | | [XAppCaptureStopUserRecord](/reference/system/xappcapture/functions/xappcapturestopuserrecord) | [XAppCaptureStartUserRecord](/reference/system/xappcapture/functions/xappcapturestartuserrecord)를 통해 시작되고 입력된 ID로 지정된 진행 중인 사용자 녹화를 중지하고 저장합니다. | | [XAppCaptureTakeDiagnosticScreenshot](/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot) | 앱에서 진단 스크린샷을 촬영합니다. | | [XAppCaptureTakeScreenshot](/reference/system/xappcapture/functions/xappcapturetakescreenshot) | 스크린샷을 촬영합니다. | | [XAppCaptureUnRegisterMetadataPurged](/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged) | 메타데이터 제거 이벤트에 대한 이벤트 처리기를 제거합니다. | ## 구조체 | 구조체 | 설명 | | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | [XAppBroadcastStatus](/reference/system/xappcapture/structs/xappbroadcaststatus) | 앱/게임의 방송 기능 상태를 설명합니다. | | [XAppCaptureDiagnosticScreenshotResult](/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult) | 앱 캡처 스크린샷 및 설명 정보입니다. | | [XAppCaptureLocalResult](/reference/system/xappcapture/structs/xappcapturelocalresult) | XAppCaptureRecordTimespan 호출의 결과를 포함합니다. | | [XAppCaptureRecordClipResult](/reference/system/xappcapture/structs/xappcapturerecordclipresult) | 캡처된 비디오 클립 및 설명 정보입니다. | | [XAppCaptureScreenshotFile](/reference/system/xappcapture/structs/xappcapturescreenshotfile) | 캡처된 스크린샷 및 설명 정보입니다. | | [XAppCaptureScreenshotStream](/reference/system/xappcapture/structs/xappcapturescreenshotstream) | 스크린샷 스트림을 나타냅니다. | | [XAppCaptureTakeScreenshotResult](/reference/system/xappcapture/structs/xappcapturetakescreenshotresult) | 스크린샷 촬영 결과를 나타냅니다. | | [XAppCaptureUserRecordingResult](/reference/system/xappcapture/structs/xappcaptureuserrecordingresult) | [XAppCaptureStopUserRecord](/reference/system/xappcapture/functions/xappcapturestopuserrecord) 호출의 결과를 포함합니다. | | [XAppCaptureVideoCaptureSettings](/reference/system/xappcapture/structs/xappcapturevideocapturesettings) | GameDVR 비디오 캡처 설정입니다. | ## 열거형 | 열거형 | 설명 | | ------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | | [XAppCaptureMetadataPriority](/reference/system/xappcapture/enums/xappcapturemetadatapriority) | 앱 캡처 메타데이터의 우선 순위 레벨입니다. 저장소 제약이 적용되고 일부 메타데이터를 삭제해야 할 때 어떤 데이터가 가장 중요한지 결정하는 데 사용됩니다. | | [XAppCaptureScreenshotFormatFlag](/reference/system/xappcapture/enums/xappcapturescreenshotformatflag) | 스크린샷 캡처의 정의 품질을 결정합니다. | | [XAppCaptureVideoColorFormat](/reference/system/xappcapture/enums/xappcapturevideocolorformat) | GameDVR 녹화에서 사용되는 색상 형식입니다. | | [XAppCaptureVideoEncoding](/reference/system/xappcapture/enums/xappcapturevideoencoding) | 비디오 캡처의 비디오 인코딩 형식을 결정합니다. | ## 개념 설명서 * [Game DVR 및 방송](/build/console-features/game-dvr/gamedvr-broadcast) * [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads) * [Microsoft Game Development Kit이란?](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/intro/introduction) * [Unity 프로젝트에서 GDK API용 C# 래퍼 사용](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/tutorials/get-started-with-unity-pc/features/gdk-unity-api-wrappers) ## 함께 보기 [XAppCapture 오류 코드](/reference/system/xappcapture/xappcapture_errors)\ [시스템 API 참조](/reference/system/gc-reference-system-toc) ## Related topics - [XAppCapture 오류 코드](/ko/reference/system/xappcapture/xappcapture_errors.md) - [XAppCaptureVideoCaptureSettings](/ko/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md) - [XAppCaptureMetadataPriority](/ko/reference/system/xappcapture/enums/xappcapturemetadatapriority.md) - [XAppCaptureTakeScreenshot](/ko/reference/system/xappcapture/functions/xappcapturetakescreenshot.md) - [XAppCaptureGetVideoCaptureSettings](/ko/reference/system/xappcapture/functions/xappcapturegetvideocapturesettings.md)