본문으로 건너뛰기

알림 (Notification)

푸시 알림 권한 확인, FCM 토큰 조회, 로컬 알림 전송을 처리하는 모듈입니다.

개요​

appify.notification은 앱의 알림 기능 전반을 관리합니다. 권한 상태 확인 및 요청, 서버 푸시를 위한 FCM 토큰 조회, 네트워크 없이 즉시 표시하는 로컬 알림 전송을 지원합니다. 푸시 알림 연동 전체 흐름은 관련 문서를 참고하십시오.

API​

checkPermission(): Promise<boolean>​

알림 권한 상태를 확인하고, 아직 요청하지 않은 경우 시스템 권한 요청 다이얼로그를 표시합니다.

매개변수

없음

반환값: Promise<boolean> - 알림 권한 허용 여부

예제

import { appify } from '@nolraunsoft/appify-sdk';

const isAllowed = await appify.notification.checkPermission();
if (!isAllowed) {
  console.log('알림 권한이 거부되었습니다.');
}

getToken(): Promise<string>​

푸시 서버 등록에 사용할 FCM 토큰을 조회합니다.

매개변수

없음

반환값: Promise<string> - FCM 토큰 문자열

예제

import { appify } from '@nolraunsoft/appify-sdk';

const token = await appify.notification.getToken();
console.log('FCM 토큰:', token);

sendLocalNotification(options: LocalNotificationOptions): Promise<boolean>​

네트워크 없이 기기에 즉시 로컬 알림을 표시합니다.

매개변수

이름타입필수설명
optionsLocalNotificationOptions예알림 옵션 객체
options.titlestring예알림 제목
options.bodystring예알림 본문

반환값: Promise<boolean> - 알림 전송 성공 여부

예제

import { appify } from '@nolraunsoft/appify-sdk';

const isAllowed = await appify.notification.checkPermission();
if (isAllowed) {
  const token = await appify.notification.getToken();
  // token을 서버에 등록하여 푸시 알림 발송에 활용

  await appify.notification.sendLocalNotification({
    title: '안녕하세요!',
    body: 'Appify SDK에서 보내는 알림입니다.',
  });
}

관련 문서​