콘텐츠로 이동

1단계. 연동 환경 구성

Firebase 콘솔에서 준비한 FCM 인증 정보를 Hive 콘솔에 입력하여 푸시 연동 기반을 마련하고, 전용 플러그인을 설치하여 Android 리모트 푸시 구현 환경을 구성합니다.


1. Firebase 콘솔 설정

Firebase 콘솔에서 Hive Axyl 푸시 서비스와 연결할 FCM(Firebase Cloud Messaging) 인증 정보를 생성합니다. 자세한 내용은 콘솔 가이드의 푸시 설정 문서를 참조하세요.

Android에서 리모트 푸시를 수신하려면 Firebase 프로젝트와 Android 앱을 연결하고, 앱 빌드에 필요한 Firebase 설정 파일을 준비해야 합니다.

  • Firebase 프로젝트에 Android 앱을 추가하고 패키지 이름을 등록합니다.
  • FCM 발송에 사용할 서버 인증 정보를 준비합니다.
  • Firebase 콘솔의 프로젝트 설정에서 google-services.json 파일을 내려받습니다.
  • 최소 지원 버전은 Android 10(API 29)입니다. Unity Player Settings의 Minimum API Level을 확인하세요.

2. Hive 콘솔 설정

Firebase 콘솔 설정에서 생성한 FCM 인증 정보를 Hive 콘솔에 등록하여 Hive Axyl 푸시 서버가 Android 디바이스로 푸시 메시지를 발송할 수 있도록 구성합니다. 자세한 내용은 콘솔 가이드의 푸시 설정 문서를 참조하세요.

Hive 콘솔에는 FCM 푸시 수단을 활성화하고, Firebase 콘솔에서 준비한 프로젝트 및 서버 인증 정보 등 푸시 발송에 필요한 값을 등록합니다.


3. Hive Axyl FCM 플러그인 설치

Hive Axyl SDK에서 제공하는 'FCM 플러그인'을 설치합니다.
Android 리모트 푸시에서는 FCM 플러그인으로 디바이스 토큰을 발급받고, 앱 실행 중 수신된 메시지와 알림 탭 이벤트를 처리합니다.

해당 패키지를 아래 예시와 같이 프로젝트 의존성 필드에 추가합니다.

"dependencies": {
  "com.hive.axyl.core": "PLACEHOLDER_AXYL_CORE_VERSION",
  "com.hive.axyl.push": "PLACEHOLDER_AXYL_PUSH_VERSION",
  "com.hive.axyl.push.addon.fcm": "PLACEHOLDER_AXYL_PUSH_FCM_VERSION"
}

플러그인이 네이티브 Firebase Messaging SDK를 직접 사용하므로, Firebase Unity SDK를 별도로 설치할 필요가 없습니다. 푸시 수신에 필요한 Android 매니페스트 항목도 플러그인이 빌드 시 자동으로 병합하므로 앱에서 추가할 작업이 없습니다.

Warning

앱이 이미 Firebase Unity SDK를 다른 용도(애널리틱스 등)로 사용 중이라면 메시징(Firebase Cloud Messaging) 기능은 비활성화하세요. 메시지 수신 서비스가 중복 등록되면 어느 쪽이 알림을 받을지 보장되지 않습니다.

google-services.json 포함

Firebase 콘솔에서 내려받은 google-services.json 파일을 앱에 포함합니다. 이 파일이 없으면 Firebase가 초기화되지 않아 토큰 발급이 실패합니다. 파일은 앱 모듈 위치(Assets/Plugins/Android/<app-module>/)에 둡니다.

알림 권한 요청

Android 13(API 33) 이상에서 알림을 표시하려면 POST_NOTIFICATIONS 런타임 권한이 필요합니다. 현재 SDK는 권한 요청 기능을 제공하지 않으므로 앱이 직접 요청합니다. Unity 표준 API로 구현할 수 있습니다.

#if UNITY_ANDROID
using UnityEngine.Android;

const string PostNotifications = "android.permission.POST_NOTIFICATIONS";

if (!Permission.HasUserAuthorizedPermission(PostNotifications))
{
    Permission.RequestUserPermission(PostNotifications);
}
#endif


다음 단계

2단계. 푸시 알림 권한 요청을 구현합니다.