AGENT SKILL
10-push-manager
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
02 资源文件 2
- 参考文档agents/openai.yaml165 B
- 脚本scripts/hitl-loop.template.sh1.3 KB
03 SKILL.md 正文
10-push-manager
Status: ACTIVE AppliesTo: v10
MobilePackage 샘플의 PushManager 설계 문서다.
문서 경계 (Scope)
- 이 문서는 PushManager 클라이언트 샘플 코드의 위치/흐름/규약을 설명한다.
- Provider 구현 상세는
11(Apple),12(Google) 문서를 참조한다.
PushManager는 단일 concrete 클래스이다.
플랫폼별 분기는 IPushPlatformProvider 인터페이스를 통해 위임한다.
Implementation Location (3-path mirror)
3-path mirror 정책: devian-unity/04-package-policy, devian-unity/01-policy §SSOT 원칙
| 파일 | UPM (정본) | Packages (sync) | Assets/Samples (import) |
|---|---|---|---|
PushManager.cs |
upm/com.devian.foundation/Samples~/MobilePackage/Runtime/Push/ |
Packages/com.devian.foundation/Samples~/MobilePackage/Runtime/Push/ |
Assets/Samples/Devian Samples/{version}/MobilePackage/Runtime/Push/ |
IPushPlatformProvider.cs |
동일 경로 | 동일 경로 | 동일 경로 |
PushStorage.cs |
동일 경로 | 동일 경로 | 동일 경로 |
LocalNotificationData.cs |
동일 경로 | 동일 경로 | 동일 경로 |
PushProviderApple.cs |
동일 경로 | 동일 경로 | 동일 경로 |
PushProviderGoogle.cs |
동일 경로 | 동일 경로 | 동일 경로 |
PushProviderUnsupported.cs |
동일 경로 | 동일 경로 | 동일 경로 |
- asmdef:
Devian.Samples.MobilePackage(Samples~/MobilePackage/Runtime/Devian.Samples.MobilePackage.asmdef)
Singleton
CompoSingleton<PushManager>.Instance
- Registry key:
PushManager - 다른 매니저에서 접근:
Singleton.Get<PushManager>()
Public API (Sample)
InitializeAsync(ct)→Task<CommonResult>- 로컬 알림 전체 취소 → 권한 요청 → 토큰 획득 → 테이블 기반 토픽 구독 → 저장 토픽 재구독
- 초기화 시작 시 기존 로컬 알림을 모두 clear (03-ssot §H)
- Idempotent: 여러 번 호출해도 동일 Task 반환
- Editor에서는 즉시
PUSH_UNSUPPORTED_PLATFORM반환
SubscribeTopicAsync(topicId, ct)→Task<CommonResult>- 토픽 구독 +
PushStorage.subscribedTopics동기화
- 토픽 구독 +
UnsubscribeTopicAsync(topicId, ct)→Task<CommonResult>- 토픽 해제 +
PushStorage.subscribedTopics동기화
- 토픽 해제 +
ScheduleLocalNotificationAsync(pushId, fireAt, ct)→Task<CommonResult>- pushId로
TB_PUSH_LOCAL조회 →ST_TEXT로 로컬라이즈 Title/Body → 로컬 알림 등록 fireAt:CDateTime(서버 시간 기준).RemoteDataManager.ServerNowUtcMs활용Repeat:RepeatInterval.None고정- IsTest 필터링: §F와 동일 (Release에서 IsTest=true 차단)
- pushId로
CancelLocalNotificationAsync(notificationId, ct)→Task<CommonResult>- 로컬 알림 취소 +
PushStorage.scheduledNotifications에서 제거
- 로컬 알림 취소 +
CancelAllLocalNotificationsAsync(ct)→Task<CommonResult>- 모든 로컬 알림 취소 +
PushStorage.scheduledNotifications초기화
- 모든 로컬 알림 취소 +
ClearStorage()- 저장 데이터 초기화
Events:
OnPermissionResult(bool granted)— 권한 요청 결과
Internal Responsibilities
- 플랫폼 분기:
#if UNITY_IOS/#elif UNITY_ANDROID/else→ Provider 인스턴스 선택 - 토큰 획득: 초기화 시
GetTokenAsync로 FCM 토큰 획득,PushStorage.token에 저장 (로컬 캐시 용도) - 테이블 기반 구독:
TB_PUSH_REMOTE.GetByGroup(DefaultLanguage)→ 행의PushId를 FCM 토픽으로 구독 (03-ssot §F)- Development Build (
Debug.isDebugBuild): 모든 행 구독 / Release Build:IsTest == false만 구독
- Development Build (
- 토픽 복원: 초기화 시
PushStorage.subscribedTopics기반 재구독 - 초기화 시 Local Push Clear:
CancelAllLocalNotificationsAsync+scheduledNotifications.Clear()(03-ssot §H) - 로컬 알림 테이블 기반 등록:
TB_PUSH_LOCAL.Get(pushId)→ST_TEXT.Get(TitleTextId/BodyTextId)→LocalNotificationData조립 (03-ssot §G) - 로컬 알림 Storage 동기화: 등록/취소마다
PushStorage갱신
서버 의존 없음: 토큰 서버 등록/타겟 발송은 사용하지 않는다. 모든 원격 푸시는 토픽 기반 발송만 사용한다. FCM 클라이언트 SDK가 토픽 구독/해제를 직접 처리한다.
Hard Rules (Sample must follow)
- 플랫폼 SDK 직접 호출 금지 —
IPushPlatformProvider를 통해서만 접근 - 토큰 값을 외부(다른 매니저)에 직접 노출하지 않는다
- 초기화 전 API 호출은
PUSH_NOT_INITIALIZED반환 - 권한 미획득 시 토큰 등록을 스킵하고
PUSH_PERMISSION_DENIED반환 - 로컬 알림 ID는
PushStorage가 정본이다 (중복 등록 방지)
Related SSOT
skills/devian-unity/50-mobile-package/52-push-system/03-ssot/SKILL.mdskills/devian-unity/50-mobile-package/52-push-system/01-policy/SKILL.md