Push 모듈

원격 푸시 알림을 받을 디바이스 토큰을 Hive Axyl 서버에서 관리하는 모듈입니다. 디바이스 토큰 등록, 토큰의 언어와 푸시 알림 수신 동의 변경, 토큰과 사용자의 연결 해제를 제공합니다.

이 모듈은 푸시 알림을 보내지 않습니다. 앱 서버가 푸시 알림을 보낼 때는 Hive Axyl Server API의 리모트 푸시 전송을 사용하며, 이 모듈로 등록한 디바이스 토큰의 기기가 알림을 받습니다.

모듈 정보

항목	값
패키지	com.com2usplatform.hiveaxyl.push
네임스페이스	Hive.Axyl.Push
지원 플랫폼	전체 (서버 API)
최소 사양	Unity 6000.0+

제공 인터페이스

인터페이스	등록 메서드	설명
IPushService	AddPush()	디바이스 토큰 등록, 언어 변경, 수신 동의 변경, 사용자 연결 해제

푸시 알림 Add-on과의 관계

디바이스 토큰 발급과 원격 푸시 알림 수신은 기기에서 Firebase Cloud Messaging이나 Apple의 알림 프레임워크를 직접 호출해야 하므로 푸시 알림 Add-on이 담당합니다. 발급받은 토큰을 Hive Axyl 서버에 등록하고 관리하는 작업은 이 모듈이 담당합니다. Add-on은 토큰을 Hive Axyl 서버에 자동으로 등록하지 않으므로, Add-on으로 받은 토큰을 이 모듈의 UpsertTokenAsync로 등록하세요.

플랫폼	푸시 서비스	함께 사용하는 Add-on
Android	Firebase Cloud Messaging(FCM)	Firebase Cloud Messaging 푸시 알림 Add-on
iOS, macOS	Apple Push Notification service(APNs)	Apple Push Notification service 푸시 알림 Add-on

macOS에서 로컬 푸시 알림을 예약하는 Apple 로컬 푸시 알림 Add-on은 Hive Axyl 서버를 거치지 않으므로 이 모듈과 함께 사용하지 않아도 됩니다.

등록과 획득

HiveBootstrap.Initialize의 등록 단계에서 AddPush()로 등록한 뒤 HiveCore.Resolve<T>()로 가져옵니다.

Unity

using Hive.Axyl.Core;
using Hive.Axyl.Core.Unity;   // HiveBootstrap
using Hive.Axyl.Push;

var config = CoreConfig.CreateBuilder("{appId}").Build();

HiveBootstrap.Initialize(config, builder =>
{
    builder.AddPush();
});

IPushService push = HiveCore.Resolve<IPushService>();

IPushService의 모든 메서드는 로그인 세션이 필요합니다. 서버가 로그인 세션의 인증 토큰으로 사용자를 확인하므로, Auth 모듈로 로그인하고 세션을 등록한 뒤 호출하세요.