> ## 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. # Services C API 개요 - PFGameSaveFilesUi.h > Services C API 개요 - PFGameSaveFilesUi.h ## 함수 | 함수 | 설명 | | - | - | | [PFGameSaveFilesSetUiActiveDeviceContentionResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiactivedevicecontentionresponse.md) | PFGameSaveFilesUiActiveDeviceContentionCallback에 대한 사용자 응답을 설정합니다. 이 함수는 콜백 내부 또는 외부에서 호출할 수 있습니다. 사용자가 응답을 선택하거나 비동기 API가 취소될 때까지 상태 머신은 진행되지 않습니다. | | [PFGameSaveFilesSetUiCallbacks](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuicallbacks.md) | UI 콜백을 설정합니다. 이러한 UI 콜백은 PFGameSaveFilesAddUserWithUiAsync() 또는 PFGameSaveFilesUploadWithUiAsync() 중에 트리거됩니다. PFGameSaveFilesAddUserWithUiAsync()는 모든 UI 콜백을 트리거할 수 있지만, PFGameSaveFilesUploadWithUiAsync()는 PFGameSaveFilesUiProgressCallback 및/또는 PFGameSaveFilesUiSyncFailedCallback만 트리거합니다. Windows가 아닌 플랫폼에서는 게임에서 렌더링하는 UI 대화 상자를 트리거하려면 이러한 콜백을 설정해야 합니다. XBOX 및 Windows 플랫폼에서는 파일 동기화가 프로세스 외부에서 수행되고 플랫폼에서 기본 UI를 제공하지만, 타이틀은 원하는 경우 이러한 콜백을 설정하여 사용자 지정 UI 대화 상자를 렌더링할 수 있습니다. | | [PFGameSaveFilesSetUiConflictResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiconflictresponse.md) | PFGameSaveFilesUiConflictCallback에 대한 사용자 응답을 설정합니다. 이 함수는 콜백 내부 또는 외부에서 호출할 수 있습니다. 사용자가 응답을 선택하거나 비동기 API가 취소될 때까지 상태 머신은 진행되지 않습니다. | | [PFGameSaveFilesSetUiOutOfStorageResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuioutofstorageresponse.md) | PFGameSaveFilesUiOutOfStorageCallback에 대한 사용자 응답을 설정합니다. 이 함수는 콜백 내부 또는 외부에서 호출할 수 있습니다. 사용자가 응답을 선택하거나 비동기 API가 취소될 때까지 상태 머신은 진행되지 않습니다. | | [PFGameSaveFilesSetUiProgressResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiprogressresponse.md) | PFGameSaveFilesUiProgressCallback에 대한 사용자 응답을 설정합니다. 이 함수는 콜백 내부 또는 외부에서 호출할 수 있습니다. 사용자가 응답을 선택하거나 비동기 API가 취소될 때까지 상태 머신은 진행되지 않습니다. | | [PFGameSaveFilesSetUiSyncFailedResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuisyncfailedresponse.md) | PFGameSaveFilesUiSyncFailedCallback에 대한 사용자 응답을 설정합니다. 이 함수는 콜백 내부 또는 외부에서 호출할 수 있습니다. 사용자가 응답을 선택하거나 비동기 API가 취소될 때까지 상태 머신은 진행되지 않습니다. | | [PFGameSaveFilesUiActiveDeviceContentionCallback](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiactivedevicecontentioncallback.md) | 활성 디바이스 경합 콜백입니다. | | [PFGameSaveFilesUiConflictCallback](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiconflictcallback.md) | 충돌 콜백입니다. | | [PFGameSaveFilesUiOutOfStorageCallback](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuioutofstoragecallback.md) | 로컬 디바이스의 저장 공간이 부족할 때 트리거되는 콜백입니다. | | [PFGameSaveFilesUiProgressCallback](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogresscallback.md) | 동기화 작업이 새 상태로 전환될 때 발생하는 알림 콜백입니다. 이 콜백은 상태 전환마다 한 번씩 발생하며(예: PreparingForUpload에 대해 한 번, Uploading에 대해 한 번), 상태 내에서 진행률이 증가할 때 반복적으로 발생하지 않습니다. 상태 내의 세부 진행률을 확인하려면 PFGameSaveFilesUiProgressGetProgress를 호출하여 현재 바이트 수와 전체 바이트 수를 폴링하세요. 타이틀은 이 콜백이 높은 빈도로 발생할 것으로 예상하지 말고 상태 변경 알림(예: 진행률 대화 상자 표시 또는 업데이트)으로 처리해야 합니다. | | [PFGameSaveFilesUiProgressGetProgress](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogressgetprogress.md) | 동기화 작업의 현재 진행률을 가져옵니다. 최신 바이트 수준 진행률을 확인하려면 PFGameSaveFilesUiProgressCallback 내에서 이 함수를 호출하거나 동기화가 진행되는 동안 주기적으로 폴링하세요. PreparingForUpload 중에는 current/total이 처리된/예상되는 비압축 바이트 수를 나타냅니다. Uploading 중에는 current/total이 전송된/예상되는 비압축 바이트 수를 나타냅니다. Downloading 중에는 current/total이 다운로드된/예상되는 바이트 수를 나타냅니다. total이 0이면 전체 크기를 아직 알 수 없으므로, 타이틀은 0으로 나누거나 0%를 표시하는 대신 이를 불확정 진행률로 처리해야 합니다(예: 스피너 표시). | | [PFGameSaveFilesUiSyncFailedCallback](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuisyncfailedcallback.md) | 동기화 실패 콜백입니다. | ## 구조체 | 구조체 | 설명 | | - | - | | [PFGameSaveUICallbacks](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/structs/pfgamesaveuicallbacks.md) | 게임 저장 작업을 위한 UI 콜백입니다. | ## 상태 변경 | 상태 변경 | 설명 | | - | - | ## 열거형 | 열거형 | 설명 | | - | - | | [PFGameSaveFilesUiActiveDeviceContentionUserAction](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiactivedevicecontentionuseraction.md) | PFGameSaveFilesUiActiveDeviceContentionCallback의 사용자 작업입니다. | | [PFGameSaveFilesUiConflictUserAction](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiconflictuseraction.md) | PFGameSaveFilesUiConflictCallback의 사용자 작업입니다. | | [PFGameSaveFilesUiOutOfStorageUserAction](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuioutofstorageuseraction.md) | PFGameSaveFilesUiOutOfStorageCallback의 사용자 작업입니다. | | [PFGameSaveFilesUiProgressUserAction](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiprogressuseraction.md) | PFGameSaveFilesUiProgressCallback의 사용자 작업입니다. | | [PFGameSaveFilesUiSyncFailedUserAction](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuisyncfaileduseraction.md) | PFGameSaveFilesUiSyncFailedCallback의 사용자 작업입니다. | ## Related topics - [Services C API 개요 - PFGameSaveFiles.h](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members.md) - [XGameSaveFiles API 개요](https://docs.xbox.com/ko/build/core-features/common/game-save/xgamesavefiles.md) - [Services C API 개요 - PFGameSaveFilesTypes.h](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilestypes/pfgamesavefilestypes_members.md) - [게임 저장 개요](https://docs.xbox.com/ko/build/core-features/common/game-save/game-saves-overview.md) - [PFGameSaveFilesUiConflictCallback](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiconflictcallback.md)