23-firebase-callable-manager
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
02 资源文件 2
- 参考文档examples.md4.3 KB
- 参考文档reference.md3.4 KB
03 SKILL.md 正文
23-firebase-callable-manager — FirebaseCallableManager
Status: ACTIVE AppliesTo: v10
Purpose
Firebase Cloud Functions callable 통합 래퍼.
함수별 typed API, 에러 매핑, 응답 파싱, region 관리, 값 추출 헬퍼를 통합한다.
FirebaseFunctions 인스턴스는 외부에 노출하지 않는다.
game 도메인 테이블(TB_PURCHASE 등)은 참조하지 않는다 - 서버 응답 raw 값을 typed result에 그대로 저장한다.
internal sealed class - 같은 어셈블리(Devian.Samples.MobilePackage) 내부에서만 접근 가능하다.
외부 어셈블리(Assembly-CSharp 등)에서는 직접 접근할 수 없으며, LoginManager/각 시스템 매니저를 통해 간접 사용한다.
Scope
| 포함 | 제외 |
|---|---|
| Functions region 관리 | Firebase Auth (AccountLoginFirebase 소관) |
| 함수별 typed public API | Firebase 의존성 초기화 (CheckAndFixDependenciesAsync) |
| FunctionsException 에러 매핑 (per-function) | 도메인 변환 (ResolveRewardGroupId 등) |
| 응답 파싱 -> typed result | Editor 전용 mock (각 manager 자체 처리) |
| 응답 정규화 (internal) | |
값 추출 헬퍼 (ReadLong/ReadString/ReadBool) |
Sample SSOT
com.devian.foundation/Samples~/MobilePackage
Implementation Location (3-path mirror)
3-path mirror 정책: devian-unity/04-package-policy
- UPM (정본):
framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/FirebaseCallable/FirebaseCallableManager.cs - Packages (sync):
framework-cs/apps/UnityExample/Packages/com.devian.foundation/Samples~/MobilePackage/Runtime/FirebaseCallable/FirebaseCallableManager.cs - Assets/Samples (import):
framework-cs/apps/UnityExample/Assets/Samples/Devian Samples/{version}/MobilePackage/Runtime/FirebaseCallable/FirebaseCallableManager.cs
Singleton
CompoSingleton<FirebaseCallableManager> 기반.
Bootstrap prefab에 부착한다.
MobileApplication에 [RequireComponent(typeof(FirebaseCallableManager))]로 선언.
API
FirebaseCallableManager는
internal클래스이므로 같은 어셈블리 내부에서만 접근 가능하다.
Instance Methods - Region
onInitAwake()에서MobileApplication.Instance.FirebaseFunctionsRegion을 읽어 internal region을 초기화한다.- region 값이 비어 있으면 기본 리전(
us-central1)을 사용한다. getFunctionsInstance()호출 시 region이 비어 있으면MobileApplication.Instance를 다시 참조해 lazy 초기화를 시도한다.
Instance Methods - Purchase callable (7개)
VerifyPurchaseAsync(data, ct) -> Task<CommonResult<VerifyPurchaseResponse>>verifyPurchasecallable 호출 -> 응답 파싱 ->VerifyPurchaseResponse반환- 에러 매핑:
PURCHASE_UNAUTHENTICATED,PURCHASE_VERIFY_INVALID_ARGUMENT,PURCHASE_VERIFY_FAILED_PRECONDITION,PURCHASE_VERIFY_CALL_FAILED,PURCHASE_NETWORK_UNAVAILABLE
GetEntitlementsAsync(ct) -> Task<CommonResult<EntitlementsSnapshot>>getEntitlementscallable 호출 -> 응답 파싱 ->EntitlementsSnapshot반환- 응답 원본 값을 그대로 반환한다.
GetRecentPurchases30dAsync(data, ct) -> Task<CommonResult<RecentPurchaseItem>>getRecentPurchases30dcallable 호출 -> items[0] 파싱 ->RecentPurchaseItem반환- 아이템 없으면
PURCHASE_RECENT_NOT_FOUND
GetPurchaseAdjustmentsAsync(data, ct) -> Task<CommonResult<RefundPageResult>>getPurchaseAdjustmentscallable 호출 -> 페이지네이션 파싱 ->RefundPageResult반환PurchaseAdjustmentItem은 서버 raw 필드만 포함. domain 변환은 PurchaseManager가 수행.
AckPurchaseClientGrantAsync(data, ct) -> Task<CommonResult>ackPurchaseClientGrantcallable 호출
AckPurchaseStoreConfirmAsync(data, ct) -> Task<CommonResult>ackPurchaseStoreConfirmcallable 호출
AckRefundAppliedAsync(data, ct) -> Task<CommonResult>ackRefundAppliedcallable 호출
Static Methods (순수 함수)
-
ReadLong(IDictionary<string, object> source, string key) -> long- 지정 키의 값을
long으로 추출한다. long,int,double,float,string타입을 처리한다.- 키가 없거나 변환 불가 시
0L반환.
- 지정 키의 값을
-
ReadString(IDictionary<string, object> source, string key) -> string- 지정 키의 값을
string으로 추출한다. - 키가 없거나 null이면
string.Empty반환.
- 지정 키의 값을
-
ReadBool(IDictionary<string, object> source, string key) -> bool- 지정 키의 값을
bool로 추출한다. bool,int,long,double,string타입을 처리한다.- 키가 없거나 변환 불가 시
false반환.
- 지정 키의 값을
Private Methods (네이밍: 소문자 시작)
callFunctionAsync()- callable 호출 + 응답 정규화 (raw dict 반환)getFunctionsInstance()- 리전 기반FirebaseFunctions인스턴스 획득normalizeCallableResponse()- 재귀적 응답 정규화normalizeStringObjectMap(),normalizeAnyMap(),normalizeCallableValue()- 정규화 내부 헬퍼
Integration
PurchaseManager
var result = await FirebaseCallableManager.Instance.VerifyPurchaseAsync(data, ct);
if (result.IsFailure)
return CommonResult<VerifyPurchaseResponse>.Failure(result.Error!);
var response = result.Value!;
PurchaseManager는 FunctionsException을 catch하지 않는다. 에러 매핑은 FirebaseCallableManager가 수행한다.
domain 변환(ResolveRewardGroupId 등)은 PurchaseManager가 typed result 수신 후 수행한다.
PurchaseManager는 같은 어셈블리이므로 internal FirebaseCallableManager에 직접 접근 가능하다.
MobileApplication
// MobileApplication은 FirebaseCallableManager region을 직접 설정하지 않는다.
// FirebaseCallableManager가 MobileApplication.Instance.FirebaseFunctionsRegion을 읽어 자체 초기화한다.
Hard Rules
FirebaseFunctions인스턴스를 외부에 노출하지 않는다.FunctionsException에러 매핑은 FirebaseCallableManager 각 메서드 내부에서 수행한다. 호출자는CommonResult만 소비한다.- FirebaseCallableManager는 game 도메인 테이블(TB_PURCHASE 등)을 참조하지 않는다. 서버 응답 raw 값을 typed result에 그대로 저장한다.
- Firebase Auth 관련 로직은
AccountLoginFirebase가 소유한다. FirebaseCallableManager는 Auth를 다루지 않는다. - Firebase Functions region 설정 owner는
MobileApplication이고, 실제 region 초기화는FirebaseCallableManager가MobileApplication.Instance참조로 수행한다. - 외부에서 사용하지 않는 메서드는
private으로 선언하고 소문자로 시작한다. - Editor mock 응답은 각 manager가 자체 처리한다. FirebaseCallableManager는 Editor 전용 분기를 갖지 않는다.
Related
- 11-mobile-application — Bootstrap, RequireComponent, region 설정