Push 개요 | Push | Appbox Android SDK 가이드
Android SDK 연동
Push 개요
| 전제 | 내용 |
|---|---|
| 필요 artifact | appbox-push + 초기화 설정의 push (예외는 함수별 표기) |
| 전제 미충족 시 | 콜백 error로 AppBoxPushUnavailableException(artifact 없음) 또는 AppBoxPushNotConfiguredException(설정 없음) → 예외 카탈로그 |
| 콘솔, 서버 전제 | topic 등록은 서버에서 관리합니다. 등록되지 않은 topic은 필터되어 무시됩니다(호출은 성공 처리) |
| 웹 브릿지 대응 | message.setPushAgree, getToken, getPushList, subscribeToTopic, unsubscribeFromTopic, setChannelPhoneNumber |
클릭 라우팅
수신 → 표시 → 클릭. 클릭의 목적지는 초기화 설정의 usageMode가 결정합니다.
| usageMode | 클릭하면 |
|---|---|
APPBOX_WEBVIEW | AppBox 관리 화면으로 이동 |
SERVICE_APP (기본) | SDK는 이동하지 않음. 앱이 setPushEventListener payload로 직접 처리 |
listener는 Application.onCreate()에서 등록하세요.
topic 규칙 요약
구독, 해제 4개 함수의 공통 계약입니다. 상세 동작은 아래 동작 설명에 있습니다.
| 상황 | 동작 |
|---|---|
success == true | 서버 접수 의미: 실제 구독 상태를 보장하지 않음 |
| 미등록 topic | 걸러지고 성공 처리 (무엇이 걸러졌는지 알 수 없음) |
| 부분 실패 | 없음. 전체 반영 또는 전체 오류 |
AOS-<PROJECT_ID> | 1.4.0부터 SDK 보호 topic 이 아닙니다. 서버가 시스템 topic 으로 보고 처리하지 않으므로 구독, 해제 모두 반영되지 않습니다(네이티브는 성공으로 끝나지만 아무 것도 바뀌지 않음, 웹 브릿지는 failed). 수신을 끄려면 setPushAgreement(false) |
| 웹 브릿지 | topic별 succeeded/failed 배열 반환 (네이티브와 다름) |
동작 설명
topic 구독, 해제 요청은 다음 순서로 처리됩니다.
success == true는 서버가 변경 요청을 접수했다는 의미입니다. FCM 구독, 해제는 서버가 기기 토큰으로 대행하므로 이 값으로 실제 구독 상태를 확인할 수 없습니다.- 서버가 요청한 topic을 모두 거부해도
success == true입니다. 등록되지 않은 topic 이름을 보낸 경우가 여기에 해당하며, 어떤 topic이 걸러졌는지는 응답으로 알 수 없습니다. - 부분 실패나 롤백이라는 상태가 없습니다. 어느 단계든 실패하면 요청 전체가 오류로 끝나고 아무 topic도 반영되지 않으며, 성공하면 filter를 통과한 topic 전체가 한 번에 반영됩니다.
- 앞뒤 공백이 제거되고 빈 값과 중복이 정리됩니다. 처리할 대상이 남지 않으면 아무 것도 하지 않고 성공으로 끝납니다.
- 수신 동의는 topic 이 아니라 토큰 등록의 동의값으로 서버에 반영됩니다. 동의하지 않은 기기는 콘솔 전체 발송, 구독 그룹, 여정, API 그룹 발송에서 빠집니다. SDK 가 수신 동의에 맞춰 topic 을 구독, 해제하지 않습니다.