Firebase is back at Google I/O on May 14! Register now.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

AndroidNotification interface

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');