AGENT SKILL
42-savedata-savecloud
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
02 资源文件 1
- 参考文档agents/openai.yaml105 B
03 SKILL.md 正文
42-savedata-savecloud — SaveCloud (Internal)
Purpose
- Android(GPGS) / iOS(iCloud) 공통 클라우드 저장 기능을 제공한다.
- SaveCloudManager는 삭제됨. 모든 클라우드 로직은
SaveDataManager의 private/internal 메서드로 통합되었다. - Editor/Guest에서는 CloudSave를 사용하지 않는다(Failure 반환).
- 외부 진입점은 없고,
SaveDataManager내부(SyncGameStorageAsync/ResolveConflictAsync/SaveGameStorageAsync)에서만SaveDataManager.Instance._initializeCloudAsync(ct)를 호출한다. - public API는 단일 primary save만 다루며, cloud client는 내부적으로 primary cloud slot에 접근한다.
Implementation Location (3-path mirror)
- UPM (정본):
framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/AppleSaveCloudClient.csframework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/SaveCloudTypes.csframework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/ISaveCloudClient.csframework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/SaveCloudClientGoogle.csframework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/SaveCloudClient.csframework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/SaveCloudCrypto.csframework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/SaveCloudPayload.csframework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/SaveCloudResult.cs
- Packages (sync, 직접 수정 금지):
framework-cs/apps/UnityExample/Packages/com.devian.foundation/Samples~/MobilePackage/...
Assembly Definition (asmdef)
- 단일 asmdef(
Devian.Samples.MobilePackage)에 포함되어 MobilePackage 번들 샘플과 함께 설치된다.
Platform behavior
- Editor: CloudSave는 지원되지 않는다(
CLOUDSAVE_NOCLIENTFailure 반환). LocalSave만 사용한다. - Android:
SaveCloudClientGoogle(GPGS)가 기본 선택된다. - iOS:
AppleSaveCloudClient(iCloud)가 기본 선택된다.
What it does
SaveDataManager.Instance._initializeCloudAsync(ct)로 플랫폼별 client 선택 및 초기화를 수행한다.- 정책: Unity Editor에서는 CloudSave를 사용하지 않는다(SaveDataManager가 Failure 반환).
- payload 난독화는
ComplexUtil로 수행 (경량 바이트 치환, Key/IV 불필요).
Usage
- 직접 호출 불가. SaveCloudManager는 삭제됨.
LoginManager/상위 흐름은SaveDataManagerpublic API(SyncGameStorageAsync,ResolveConflictAsync,SaveGameStorageAsync)만 호출한다.- cloud client 초기화/로그인은
SaveDataManager내부_initializeCloudAsync경로에서 처리된다. - Sync/Resolve는
SaveDataManager.SyncGameStorageAsync/ResolveConflictAsync를 통해 간접 사용.
Non-goals
- 로그인/인증 플로우 → 33-account-manager
- 로컬 저장 → 41-savedata-savelocal
- 트리거/주기, 재시도/충돌 정책 같은 비즈니스 로직
Notes
- iOS에서는
AppleSaveCloudClient(iCloud)가 사용된다. - Editor에서는 CloudSave를 사용하지 않으며,
SaveDataManager가 Failure를 반환한다(SSOT). - iCloud 구현 상세: 아래 "Cloud Save Firebase" 섹션 참조
Cloud Save Firebase (Firestore) — Inline Reference
SaveCloudClient는 Firestore 기반 저장을 제공한다.
- 사용자 식별:
FirebaseAuth(Anonymous sign-in) - 저장 위치:
users/{uid}/cloudsave/{slot}
- 슬롯 단위 저장:
- 문서 1개 = 슬롯 1개
- 저장 필드(문서):
Version(int)UpdateTime(string, 표시/진단용)Payload(string)DeviceId(string)SaveSeq(long, same-device Sync 최신성 판정용)Account(object:loginType,socialUserId,lastUpdatedAtUtcMs)- (legacy
UtcTime/Checksum필드는 SaveAsync 시FieldValue.Delete로 제거)
Runtime behavior
SignInIfNeededAsync:- Firebase dependencies 체크 후(
CheckAndFixDependenciesAsync) SignInAnonymouslyAsync수행
- Firebase dependencies 체크 후(
SaveAsync:- 슬롯 문서에 payload 메타/데이터 저장(
SetAsync(..., MergeAll))
- 슬롯 문서에 payload 메타/데이터 저장(
LoadAsync:- 슬롯 문서를 읽어 payload 복원
SaveCloudResult.NotFound는 "클라우드 데이터 없음(첫 저장 전)"을 의미하며, Sync에서는 실패가 아닌Success(null)로 취급한다.
- SaveDataManager Sync 규칙:
Payload동일하면 deviceId가 달라도SuccessDeviceId동일 +Payload상이하면SaveSeq로 same-device 최신본 자동 선택DeviceId상이하면Conflict(유저 선택)
DeleteAsync:- 슬롯 문서 삭제
How to use (iOS)
정책: Unity Editor에서는 CloudSave를 사용하지 않는다(LocalSave only). SaveDataManager._initializeCloudAsync가 Failure를 반환한다.
iOS 런타임 빌드 기본 client는 AppleSaveCloudClient를 사용한다.
현재 샘플은 외부 client 주입 API를 노출하지 않는다.
주의:
AppleSaveCloudClient(iCloud)는 "설계대로 유지"하며, 준비 완료 후 iOS 분기 주입을 교체한다.
Prerequisites (Unity)
Firebase Unity SDK가 프로젝트에 포함되어 있어야 한다.
- 최소 요구(예시):
- Firebase Core
- Firebase Auth
- Firebase Firestore
이 문서는 SDK 설치/프로젝트 설정 자체는 다루지 않는다.
(설치가 없으면 Firebase.* 네임스페이스 관련 컴파일 에러가 발생할 수 있다.)
Firebase Notes
SaveCloudClient는SignInIfNeededAsync를 통해 클라우드 인증을 자체 처리한다.- 플랫폼 네이티브 저장소(GPGS/iCloud)와의 크로스플랫폼 세이브 공유는 비목표다.
- Firebase 저장소는 "Editor/iOS 임시/대체 구현" 또는 "향후 통합 백엔드" 옵션으로 사용한다.