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

# XAppCapture (API 콘텐츠)

> XAppCapture

# XAppCapture

XBOX와 데스크톱은 각각 사용자가 방송할 수 있는 애플리케이션에 대한 고유한 규칙과 함께 기본 방송 환경을 포함합니다. 이러한 API를 통해 개발자는 방송 UI를 표시하고 사용자가 방송 중인지 감지할 수 있습니다. 앱 개발자는 캡처된 비디오 및 오디오 파일/스트림과 함께 저장되거나 방송될 메타데이터 이벤트 및 상태를 제공할 수 있습니다.

## 함수

| 함수 | 설명 |
| - | - |
| [XAppBroadcastGetStatus](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappbroadcastgetstatus.md) | 디바이스 및 현재 앱에 대한 방송의 현재 상태를 검색합니다. |
| [XAppBroadcastIsAppBroadcasting](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappbroadcastisappbroadcasting.md) | 앱이 현재 방송 중인지 여부를 결정합니다. |
| [XAppBroadcastMonitorCallback](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappbroadcastmonitorcallback.md) | [XAppBroadcastRegisterIsAppBroadcastingChanged](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappbroadcastregisterisappbroadcastingchanged.md)에 대한 콜백 함수를 설정합니다. 여기서 설정된 함수는 방송 상태가 변경될 때마다 호출됩니다. |
| [XAppBroadcastRegisterIsAppBroadcastingChanged](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappbroadcastregisterisappbroadcastingchanged.md) | 앱 방송 상태 변경 이벤트 처리기를 등록합니다. |
| [XAppBroadcastShowUI](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappbroadcastshowui.md) | 앱 사용자에게 방송 UI를 표시하여 방송 활동을 시작할 수 있도록 합니다. |
| [XAppBroadcastUnregisterIsAppBroadcastingChanged](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappbroadcastunregisterisappbroadcastingchanged.md) | 앱 방송 상태 변경 이벤트 처리기를 제거합니다. |
| [XAppCaptureCancelUserRecord](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturecanceluserrecord.md) | [XAppCaptureStartUserRecord](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturestartuserrecord.md)를 통해 시작되고 입력된 ID로 지정된 진행 중인 GameDVR 사용자 녹화를 중지하고 삭제합니다. |
| [XAppCaptureCloseLocalStream](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturecloselocalstream.md) | 지정된 녹화 스트림을 닫고 삭제합니다. |
| [XAppCaptureCloseScreenshotStream](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream.md) | 스크린샷 스트림을 닫습니다. |
| [XAppCaptureDisableRecord](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturedisablerecord.md) | 플레이어에 대해 비디오 녹화를 비활성화합니다. |
| [XAppCaptureEnableRecord](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcaptureenablerecord.md) | 현재 사용자에 대해 녹화/스크린샷을 활성화합니다. |
| [XAppCaptureGetVideoCaptureSettings](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturegetvideocapturesettings.md) | 인코딩 형식, 색상 형식, 해상도, 가능한 최대 녹화 길이 및 현재 사용자가 게임에 의한 캡처를 허용하는지 여부를 포함하는 디바이스의 GameDVR 설정을 쿼리합니다. |
| [XAppCaptureMetadataAddDoubleEvent](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent.md) | double 값이 있는 메타데이터 이벤트를 앱 캡처에 추가합니다. |
| [XAppCaptureMetadataAddInt32Event](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md) | Int32 값이 있는 메타데이터 이벤트를 앱 캡처에 추가합니다. |
| [XAppCaptureMetadataAddStringEvent](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md) | 문자열 값이 있는 메타데이터 이벤트를 앱 캡처에 추가합니다. |
| [XAppCaptureMetadataPurgedCallback](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturemetadatapurgedcallback.md) | 메타데이터 제거가 발생할 때 호출될 콜백 함수를 설정합니다. |
| [XAppCaptureMetadataRemainingStorageBytesAvailable](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable.md) | 앱 캡처 메타데이터에 대해 사용 가능한 남은 저장소를 반환합니다. 바이트 단위로 측정됩니다. |
| [XAppCaptureMetadataStartDoubleState](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md) | double 값이 있는 메타데이터 상태를 앱 캡처에 추가합니다. |
| [XAppCaptureMetadataStartInt32State](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturemetadatastartint32state.md) | Int32 값이 있는 메타데이터 상태를 앱 캡처에 추가합니다. |
| [XAppCaptureMetadataStartStringState](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md) | 문자열 값이 있는 메타데이터 상태를 앱 캡처에 추가합니다. |
| [XAppCaptureMetadataStopAllStates](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturemetadatastopallstates.md) | 현재 활성 상태인 모든 상태 이벤트를 중지합니다. |
| [XAppCaptureMetadataStopState](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturemetadatastopstate.md) | 앱 캡처 메타데이터에 특정 명명된 상태에 대한 상태 중지를 추가합니다. |
| [XAppCaptureOpenScreenshotStream](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md) | 스크린샷 스트림을 엽니다. |
| [XAppCaptureReadLocalStream](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturereadlocalstream.md) | 이전에 [XAppCaptureRecordTimespan](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturerecordtimespan.md) 호출로 생성된 .mp4 파일의 내용을 읽습니다. |
| [XAppCaptureReadScreenshotStream](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturereadscreenshotstream.md) | 스크린샷 스트림을 읽습니다. |
| [XAppCaptureRecordDiagnosticClip](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip.md) | 앱에서 진단 클립을 녹화합니다. |
| [XAppCaptureRecordTimespan](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturerecordtimespan.md) | GameDVR 녹화를 수행합니다. |
| [XAppCaptureRegisterMetadataPurged](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcaptureregistermetadatapurged.md) | 메타데이터 제거 이벤트에 대한 이벤트 처리기를 등록합니다. |
| [XAppCaptureStartUserRecord](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturestartuserrecord.md) | 사용자가 트리거한 것처럼 녹화를 시작합니다. |
| [XAppCaptureStopUserRecord](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturestopuserrecord.md) | [XAppCaptureStartUserRecord](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturestartuserrecord.md)를 통해 시작되고 입력된 ID로 지정된 진행 중인 사용자 녹화를 중지하고 저장합니다. |
| [XAppCaptureTakeDiagnosticScreenshot](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot.md) | 앱에서 진단 스크린샷을 촬영합니다. |
| [XAppCaptureTakeScreenshot](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturetakescreenshot.md) | 스크린샷을 촬영합니다. |
| [XAppCaptureUnRegisterMetadataPurged](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged.md) | 메타데이터 제거 이벤트에 대한 이벤트 처리기를 제거합니다. |

## 구조체

| 구조체 | 설명 |
| - | - |
| [XAppBroadcastStatus](https://docs.xbox.com/ko/reference/system/xappcapture/structs/xappbroadcaststatus.md) | 앱/게임의 방송 기능 상태를 설명합니다. |
| [XAppCaptureDiagnosticScreenshotResult](https://docs.xbox.com/ko/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult.md) | 앱 캡처 스크린샷 및 설명 정보입니다. |
| [XAppCaptureLocalResult](https://docs.xbox.com/ko/reference/system/xappcapture/structs/xappcapturelocalresult.md) | XAppCaptureRecordTimespan 호출의 결과를 포함합니다. |
| [XAppCaptureRecordClipResult](https://docs.xbox.com/ko/reference/system/xappcapture/structs/xappcapturerecordclipresult.md) | 캡처된 비디오 클립 및 설명 정보입니다. |
| [XAppCaptureScreenshotFile](https://docs.xbox.com/ko/reference/system/xappcapture/structs/xappcapturescreenshotfile.md) | 캡처된 스크린샷 및 설명 정보입니다. |
| [XAppCaptureScreenshotStream](https://docs.xbox.com/ko/reference/system/xappcapture/structs/xappcapturescreenshotstream.md) | 스크린샷 스트림을 나타냅니다. |
| [XAppCaptureTakeScreenshotResult](https://docs.xbox.com/ko/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md) | 스크린샷 촬영 결과를 나타냅니다. |
| [XAppCaptureUserRecordingResult](https://docs.xbox.com/ko/reference/system/xappcapture/structs/xappcaptureuserrecordingresult.md) | [XAppCaptureStopUserRecord](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturestopuserrecord.md) 호출의 결과를 포함합니다. |
| [XAppCaptureVideoCaptureSettings](https://docs.xbox.com/ko/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md) | GameDVR 비디오 캡처 설정입니다. |

## 열거형

| 열거형 | 설명 |
| - | - |
| [XAppCaptureMetadataPriority](https://docs.xbox.com/ko/reference/system/xappcapture/enums/xappcapturemetadatapriority.md) | 앱 캡처 메타데이터의 우선 순위 레벨입니다. 저장소 제약이 적용되고 일부 메타데이터를 삭제해야 할 때 어떤 데이터가 가장 중요한지 결정하는 데 사용됩니다. |
| [XAppCaptureScreenshotFormatFlag](https://docs.xbox.com/ko/reference/system/xappcapture/enums/xappcapturescreenshotformatflag.md) | 스크린샷 캡처의 정의 품질을 결정합니다. |
| [XAppCaptureVideoColorFormat](https://docs.xbox.com/ko/reference/system/xappcapture/enums/xappcapturevideocolorformat.md) | GameDVR 녹화에서 사용되는 색상 형식입니다. |
| [XAppCaptureVideoEncoding](https://docs.xbox.com/ko/reference/system/xappcapture/enums/xappcapturevideoencoding.md) | 비디오 캡처의 비디오 인코딩 형식을 결정합니다. |

## 개념 설명서

* [Game DVR 및 방송](https://docs.xbox.com/ko/build/console-features/game-dvr/gamedvr-broadcast.md)
* [시간에 민감한 스레드](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 오류 코드](https://docs.xbox.com/ko/reference/system/xappcapture/xappcapture_errors.md)\
[시스템 API 참조](https://docs.xbox.com/ko/reference/system/gc-reference-system-toc.md)


## Related topics

- [XAppCaptureVideoEncoding](https://docs.xbox.com/ko/reference/system/xappcapture/enums/xappcapturevideoencoding.md)
- [XAppCaptureMetadataAddInt32Event](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)
- [XAppCaptureMetadataAddStringEvent](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md)
- [XAppCaptureMetadataStartInt32State](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturemetadatastartint32state.md)
- [XAppCaptureMetadataStartStringState](https://docs.xbox.com/ko/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)