AGENT SKILL
14-purchase-settings
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
02 资源文件 5
- 参考文档agents/openai.yaml226 B
- 参考文档references/command-map.md6.0 KB
- 参考文档references/troubleshooting.md6.2 KB
- 参考文档SOURCE.md333 B
- 参考文档TRUST.auto.yaml2.3 KB
03 SKILL.md 正文
14-purchase-settings
Status: ACTIVE AppliesTo: v13
SSOT
이 문서는 PurchaseSettings ScriptableObject의 필드, 경로, PurchaseManager 연동 규칙을 정의한다.
목적/범위
PurchaseManager에서 분리한 인스펙터 설정 전용 ScriptableObject.
- AES 암호화 불필요 (민감 데이터 아님)
Resources.Load로 lazy 로드,_settingsLoaded플래그로 중복 로드 방지- 에셋 미존재 시 코드 내 기본값(fallback)으로 동작
소스 경로
Implementation Location (3-path mirror)
3-path mirror 정책: devian-unity/04-package-policy, devian-unity/01-policy §SSOT 원칙
| 위치 | 경로 |
|---|---|
| UPM (정본) | framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/Purchase/PurchaseSettings.cs |
| Packages (sync) | framework-cs/apps/UnityExample/Packages/com.devian.foundation/Samples~/MobilePackage/Runtime/Purchase/PurchaseSettings.cs |
| Assets/Samples (import) | framework-cs/apps/UnityExample/Assets/Samples/Devian Samples/{version}/MobilePackage/Runtime/Purchase/PurchaseSettings.cs |
에셋 경로
| 항목 | 경로 |
|---|---|
| Resources 경로 | Devian/PurchaseSettings |
| 프로젝트 에셋 | Assets/Resources/Devian/PurchaseSettings.asset |
| 에셋 생성 | Unity Editor → Project → Create → Devian → MobilePackage → Purchase Settings |
필드
| 필드 | 타입 | 기본값 | 설명 |
|---|---|---|---|
SeasonPurchaseBlockedBeforeEndDays |
int |
3 |
시즌 종료 N일 전 구매 차단 |
MaxVerifyRecoveryRetries |
int |
3 |
검증 복구 최대 재시도 횟수 |
AlreadyOwnedRecoveryPollCount |
int |
50 |
이미 소유 복구 폴링 횟수 (~5s) |
PurchaseManager 연동
PurchaseManager는 ensureSettings() 패턴으로 로드한다.
PurchaseSettings _settings;
bool _settingsLoaded;
PurchaseSettings ensureSettings()
{
if (!_settingsLoaded)
{
_settings = Resources.Load<PurchaseSettings>(PurchaseSettings.ResourcesPath);
_settingsLoaded = true;
}
return _settings;
}
사용 예:
// SeasonPurchaseBlockedBeforeEndDays
ensureSettings()?.SeasonPurchaseBlockedBeforeEndDays ?? 3
// MaxVerifyRecoveryRetries
ensureSettings()?.MaxVerifyRecoveryRetries ?? 3
// AlreadyOwnedRecoveryPollCount
ensureSettings()?.AlreadyOwnedRecoveryPollCount ?? 50
DoD (검증 가능)
PASS 조건
- [ ]
PurchaseSettings.cs최상단 SSOT가 이 문서를 가리킴 - [ ] 3-path mirror 동일
- [ ]
Assets/Resources/Devian/PurchaseSettings.asset존재, 기본값 일치 - [ ] PurchaseManager에
[SerializeField]설정 필드 0건 - [ ] PurchaseManager에 설정 관련
const0건
FAIL 조건
- PurchaseManager에 설정
[SerializeField]/const잔존 - 3-path mirror 불일치
- SSOT 주석이 다른 문서를 가리킴
Related
- 03-ssot — Purchase 통합 SSOT