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