AndroidConfig 에 포함될 수 있는 Android 관련 알림 옵션을 나타냅니다. .
서명:
export interface AndroidNotification
속성
재산 | 유형 | 설명 |
---|---|---|
몸 | 끈 | Android 알림의 본문입니다. 제공되면 admin.messaging.Notification 통해 설정된 본문을 재정의합니다. |
bodyLocArgs | 끈[] | bodyLocKey 의 형식 지정자 대신 사용될 리소스 키 배열입니다. |
몸체잠금키 | 끈 | 본문 텍스트를 현지화하는 데 사용할 앱 문자열 리소스의 본문 문자열 키입니다. |
채널 ID | 끈 | Android 알림 채널 ID(Android O의 새로운 기능)입니다. 이 채널 ID가 포함된 알림을 수신하려면 먼저 앱에서 이 채널 ID로 채널을 만들어야 합니다. 요청에 이 채널 ID를 보내지 않거나 제공된 채널 ID가 아직 앱에서 생성되지 않은 경우 FCM은 앱 매니페스트에 지정된 채널 ID를 사용합니다. |
클릭액션 | 끈 | 사용자가 알림을 클릭하는 것과 관련된 작업입니다. 지정된 경우 사용자가 알림을 클릭하면 일치하는 인텐트 필터가 있는 활동이 시작됩니다. |
색상 | 끈 | #rrggbb 형식의 알림 아이콘 색상입니다. |
기본 조명 설정 | 부울 | true 로 설정하면 알림에 Android 프레임워크의 기본 LED 조명 설정을 사용합니다. 기본값은 config.xml 에 지정됩니다. . default_light_settings 가 true 로 설정되고 light_settings 도 설정된 경우 기본값 대신 사용자가 지정한 light_settings 사용됩니다. |
기본소리 | 부울 | true 로 설정하면 알림에 Android 프레임워크의 기본 사운드를 사용합니다. 기본값은 config.xml 에 지정됩니다. . |
기본진동타이밍 | 부울 | true 로 설정하면 알림에 Android 프레임워크의 기본 진동 패턴을 사용합니다. 기본값은 config.xml 에 지정됩니다. . default_vibrate_timings 가 true 로 설정되고 vibrate_timings 도 설정된 경우 사용자가 지정한 vibrate_timings 대신 기본값이 사용됩니다. |
이벤트타임스탬프 | 날짜 | 절대 시간 참조로 이벤트에 대해 사용자에게 알리는 알림의 경우 알림에서 이벤트가 발생한 시간을 설정합니다. 패널의 알림은 이 시간을 기준으로 정렬됩니다. |
상 | 끈 | Android 알림의 아이콘 리소스입니다. |
이미지 URL | 끈 | 알림에 표시될 이미지의 URL입니다. |
조명 설정 | 조명 설정 | 장치에서 LED를 사용할 수 있는 경우 알림의 LED 깜박임 속도와 색상을 제어하는 설정입니다. 총 깜박임 시간은 OS에 의해 제어됩니다. |
로컬 전용 | 부울 | 이 알림이 현재 장치에만 관련되는지 여부를 설정합니다. 일부 알림은 Wear OS 시계와 같은 원격 표시를 위해 다른 장치에 연결될 수 있습니다. 이 알림을 브리징하지 않도록 권장하도록 이 힌트를 설정할 수 있습니다. Wear OS 가이드 보기 . |
알림 개수 | 숫자 | 이 알림이 나타내는 항목 수를 설정합니다. 배지를 지원하는 실행기의 경우 배지 수로 표시될 수 있습니다. 알림배지 보기 . 예를 들어, 하나의 알림을 사용하여 여러 개의 새 메시지를 표시하지만 여기에서 총 새 메시지 수를 나타내려는 경우 유용할 수 있습니다. 0이거나 지정되지 않은 경우 배지를 지원하는 시스템은 기본값을 사용합니다. 즉, 새 알림이 도착할 때마다 길게 누르기 메뉴에 표시되는 숫자가 증가합니다. |
우선 사항 | ('최소' | '낮음' | '기본값' | '높음' | '최대') | 이 알림의 상대적 우선순위를 설정합니다. 특정 상황에서는 우선순위가 낮은 알림이 사용자에게 숨겨질 수 있습니다. 이 우선순위는 AndroidMessagePriority 와 다릅니다. 이 우선순위는 메시지가 전달된 후 클라이언트에 의해 처리됩니다. 반면 AndroidMessagePriority 는 메시지 전달 시기를 제어하는 FCM 개념입니다. |
소리 | 끈 | 장치가 알림을 수신할 때 재생할 사운드의 파일 이름입니다. |
어려운 | 부울 | false 로 설정하거나 설정하지 않으면 사용자가 패널에서 알림을 클릭할 때 알림이 자동으로 해제됩니다. true 로 설정하면 사용자가 클릭해도 알림이 지속됩니다. |
꼬리표 | 끈 | 알림 태그. 알림 서랍에 있는 기존 알림을 대체하는 데 사용되는 식별자입니다. 지정하지 않으면 각 요청마다 새 알림이 생성됩니다. |
증권 시세 표시기 | 끈 | 접근성 서비스로 전송되는 "티커" 텍스트를 설정합니다. API 레벨 21(Lollipop) 이전에는 알림이 처음 도착할 때 상태 표시줄에 표시되는 텍스트를 설정합니다. |
제목 | 끈 | Android 알림의 제목입니다. 제공되면 admin.messaging.Notification 통해 설정된 제목을 재정의합니다. |
titleLocArgs | 끈[] | titleLocKey 의 형식 지정자 대신 사용될 리소스 키 배열입니다. |
제목자물쇠 | 끈 | 제목 텍스트를 현지화하는 데 사용할 앱 문자열 리소스의 제목 문자열 키입니다. |
vibrateTimingsMillis | 숫자[] | 사용할 진동 패턴을 설정합니다. 진동기를 켜거나 끄려면 밀리초 배열을 전달합니다. 첫 번째 값은 진동기를 켜기 전에 기다리는 시간을 나타냅니다. 다음 값은 진동기를 켜두는 기간을 나타냅니다. 후속 값은 진동기를 끄는 기간과 진동기를 켜는 기간을 교대로 나타냅니다. vibrate_timings 가 설정되고 default_vibrate_timings true 로 설정된 경우 사용자가 지정한 vibrate_timings 대신 기본값이 사용됩니다. |
시계 | ('비공개' | '공개' | '비밀') | 알림의 가시성을 설정합니다. private , public 또는 secret 중 하나여야 합니다. 지정하지 않으면 기본값은 private 입니다. |
AndroidNotification.body
Android 알림의 본문입니다. 제공되면 admin.messaging.Notification
통해 설정된 본문을 재정의합니다. .
서명:
body?: string;
AndroidNotification.bodyLocArgs
bodyLocKey
의 형식 지정자 대신 사용될 리소스 키 배열 .
서명:
bodyLocArgs?: string[];
AndroidNotification.bodyLocKey
본문 텍스트를 현지화하는 데 사용할 앱 문자열 리소스의 본문 문자열 키입니다.
서명:
bodyLocKey?: string;
AndroidNotification.channelId
Android 알림 채널 ID(Android O의 새로운 기능)입니다. 이 채널 ID가 포함된 알림을 수신하려면 먼저 앱에서 이 채널 ID로 채널을 만들어야 합니다. 요청에 이 채널 ID를 보내지 않거나 제공된 채널 ID가 아직 앱에서 생성되지 않은 경우 FCM은 앱 매니페스트에 지정된 채널 ID를 사용합니다.
서명:
channelId?: string;
AndroidNotification.clickAction
사용자가 알림을 클릭하는 것과 관련된 작업입니다. 지정된 경우 사용자가 알림을 클릭하면 일치하는 인텐트 필터가 있는 활동이 시작됩니다.
서명:
clickAction?: string;
AndroidNotification.color
#rrggbb
형식의 알림 아이콘 색상입니다.
서명:
color?: string;
AndroidNotification.defaultLightSettings
true
로 설정된 경우 , 알림에 Android 프레임워크의 기본 LED 조명 설정을 사용합니다. 기본값은 config.xml 에 지정됩니다. . default_light_settings
가 true
로 설정되고 light_settings
도 설정된 경우 기본값 대신 사용자가 지정한 light_settings
사용됩니다.
서명:
defaultLightSettings?: boolean;
AndroidNotification.defaultSound
true
로 설정된 경우 , 알림에 Android 프레임워크의 기본 소리를 사용하세요. 기본값은 config.xml 에 지정됩니다. .
서명:
defaultSound?: boolean;
AndroidNotification.defaultVibrateTimings
true
로 설정된 경우 , 알림에 Android 프레임워크의 기본 진동 패턴을 사용하세요. 기본값은 config.xml 에 지정됩니다. . default_vibrate_timings
가 true
로 설정되고 vibrate_timings
도 설정된 경우 사용자가 지정한 vibrate_timings
대신 기본값이 사용됩니다. .
서명:
defaultVibrateTimings?: boolean;
AndroidNotification.eventTimestamp
절대 시간 참조로 이벤트에 대해 사용자에게 알리는 알림의 경우 알림에서 이벤트가 발생한 시간을 설정합니다. 패널의 알림은 이 시간을 기준으로 정렬됩니다.
서명:
eventTimestamp?: Date;
AndroidNotification.icon
Android 알림의 아이콘 리소스입니다.
서명:
icon?: string;
AndroidNotification.imageUrl
알림에 표시될 이미지의 URL입니다.
서명:
imageUrl?: string;
AndroidNotification.lightSettings
장치에서 LED를 사용할 수 있는 경우 알림의 LED 깜박임 속도와 색상을 제어하는 설정입니다. 총 깜박임 시간은 OS에 의해 제어됩니다.
서명:
lightSettings?: LightSettings;
AndroidNotification.localOnly
이 알림이 현재 장치에만 관련되는지 여부를 설정합니다. 일부 알림은 Wear OS 시계와 같은 원격 표시를 위해 다른 장치에 연결될 수 있습니다. 이 알림을 브리징하지 않도록 권장하도록 이 힌트를 설정할 수 있습니다. Wear OS 가이드 보기 .
서명:
localOnly?: boolean;
AndroidNotification.notificationCount
이 알림이 나타내는 항목 수를 설정합니다. 배지를 지원하는 실행기의 경우 배지 수로 표시될 수 있습니다. 알림배지 보기 . 예를 들어, 하나의 알림을 사용하여 여러 개의 새 메시지를 표시하지만 여기에서 총 새 메시지 수를 나타내려는 경우 유용할 수 있습니다. 0이거나 지정되지 않은 경우 배지를 지원하는 시스템은 기본값을 사용합니다. 즉, 새 알림이 도착할 때마다 길게 누르기 메뉴에 표시되는 숫자가 증가합니다.
서명:
notificationCount?: number;
AndroidNotification.priority
이 알림의 상대적 우선순위를 설정합니다. 특정 상황에서는 우선순위가 낮은 알림이 사용자에게 숨겨질 수 있습니다. 이 우선순위는 AndroidMessagePriority
와 다릅니다. . 이 우선순위는 메시지가 전달된 후 클라이언트에 의해 처리됩니다. 반면 AndroidMessagePriority
는 메시지 전달 시기를 제어하는 FCM 개념입니다.
서명:
priority?: ('min' | 'low' | 'default' | 'high' | 'max');
AndroidNotification.sound
장치가 알림을 수신할 때 재생할 사운드의 파일 이름입니다.
서명:
sound?: string;
AndroidNotification.sticky
false
로 설정하거나 설정하지 않으면 사용자가 패널에서 알림을 클릭할 때 알림이 자동으로 해제됩니다. true
로 설정하면 , 사용자가 클릭해도 알림이 지속됩니다.
서명:
sticky?: boolean;
AndroidNotification.tag
알림 태그. 알림 서랍에 있는 기존 알림을 대체하는 데 사용되는 식별자입니다. 지정하지 않으면 각 요청마다 새 알림이 생성됩니다.
서명:
tag?: string;
AndroidNotification.ticker
접근성 서비스로 전송되는 "티커" 텍스트를 설정합니다. API 레벨 21(Lollipop) 이전에는 알림이 처음 도착할 때 상태 표시줄에 표시되는 텍스트를 설정합니다.
서명:
ticker?: string;
AndroidNotification.제목
Android 알림의 제목입니다. 제공되면 admin.messaging.Notification
을 통해 설정된 제목을 재정의합니다. .
서명:
title?: string;
AndroidNotification.titleLocArgs
titleLocKey
의 형식 지정자 대신 사용될 리소스 키 배열 .
서명:
titleLocArgs?: string[];
AndroidNotification.titleLocKey
제목 텍스트를 현지화하는 데 사용할 앱 문자열 리소스의 제목 문자열 키입니다.
서명:
titleLocKey?: string;
AndroidNotification.vibrateTimingsMillis
사용할 진동 패턴을 설정합니다. 진동기를 켜거나 끄려면 밀리초 배열을 전달합니다. 첫 번째 값은 진동기를 켜기 전에 기다리는 시간을 나타냅니다. 다음 값은 진동기를 켜두는 기간을 나타냅니다. 후속 값은 진동기를 끄는 기간과 진동기를 켜는 기간을 교대로 나타냅니다. vibrate_timings
가 설정되고 default_vibrate_timings
true
로 설정된 경우 , 사용자가 지정한 vibrate_timings
대신 기본값이 사용됩니다. .
서명:
vibrateTimingsMillis?: number[];
AndroidNotification.visibility
알림의 가시성을 설정합니다. private
여야 합니다. , public
또는 secret
. 지정하지 않으면 기본값은 private
입니다. .
서명:
visibility?: ('private' | 'public' | 'secret');