2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main 대신 android-latest-release를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.
알림 제한 및 억제
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
운전 중 주의가 분산되지 않도록 헤드업 알림(HUN)은 운전자의 주의가 디스플레이나 휴대기기로 분산되지 않도록 운전자에게 필수적이고 관련성 높은 정보를 제공합니다. 하지만 HUN은 운전 작업을 방해할 수 있으므로 운전자의 주의가 분산되지 않도록 HUN의 장단점을 고려하는 것이 중요합니다.
다음과 같은 Android 알림 관련 안전 기능을 사용하여 운전자의 주의 분산을 줄이세요.
이 콘텐츠에서는 platform/packages/apps/Car/Notification와 관련된 구성 및 리소스에 대해 설명합니다.
대기열 및 우선순위 지정
수신되는 HUN이 여러 개인 경우 대기열 및 우선순위 지정 메커니즘은 가장 중요하고 관련성 높은 정보를 운전자에게 표시합니다.
대기열 메커니즘을 사용 설정하거나 중지하려면 config_suppressAndThrottleHeadsUp config의 불리언 값을 설정합니다.
대기열에 추가된 HUN은 알림의 카테고리에 따라 결정된 우선순위에 따라 정렬됩니다. 우선순위 내림차순으로 headsup_category_priority 배열을 지정합니다.
CATEGORY_CALL 및 CATEGORY_CAR_EMERGENCY와 같은 일부 시간에 민감한 알림은 대기열에 추가되는 대신 즉시 표시되어야 합니다.
이러한 유형의 HUN을 즉시 표시하려면 이러한 카테고리를 headsup_category_immediate_show 배열에 추가합니다.
속도 제한 및 속도
사용자가 어시스턴트 또는 다이얼러와 상호작용하는 등 HUN을 표시하는 것이 안전하지 않거나 방해가 되는 작업을 실행하는 경우 HUN을 제한할 수 있습니다.
제한을 적용하려면 확인이 필요한 앱의 패키지 이름을 허용 목록 (headsup_throttled_foreground_packages)에 추가합니다. 그러면 지정된 앱이 포그라운드에서 실행되는 동안 대기열에 새 HUN이 표시되지 않습니다.
운전자가 운전에 집중할 수 있도록 각 HUN 표시 사이에 시간 간격을 추가합니다. 이 시간 간격 (headsup_delay_duration)은 headsup_throttled_foreground_packages의 패키지가 백그라운드로 이동한 후에 적용됩니다.
억제
대기열에 장시간 남아 있는 HUN은 억제될 수 있습니다.
HUN이 운전자와 관련성이 없게 되면 주의를 분산시킬 수 있습니다.
HUN을 트리거하는 대신 만료된 알림을 알림 센터로 전달합니다.
운전 및 주차 상태에 서로 다른 값을 지정하여 HUN 관리를 조정할 수 있습니다.
Drive 상태의 경우:
config_expireHeadsUpWhenDriving를 true로 설정하고 headsup_queue_expire_driving_duration_ms를 알림이 만료되는 게시 시간 이후의 시간 (밀리초)으로 지정합니다.
주차 상태의 경우:
config_expireHeadsUpWhenParked를 true로 설정하고 headsup_queue_expire_parked_duration_ms를 알림이 만료되는 게시 시간 이후의 시간 (밀리초)으로 지정합니다.
억제가 발생하면 후행 시스템 HUN을 전송하여 드라이버에 알립니다. hun_suppression_notification_title_drive 및 hun_suppression_notification_title_park 값을 업데이트하여 이 알림의 제목을 수정합니다.
알림 센터가 열릴 때 HUN 대기열을 자동으로 닫으려면 다음 단계를 따르세요.
config_dismissHeadsUpWhenNotificationCenterOpens 불리언을 true로 설정합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-03-25(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-03-25(UTC)"],[],[],null,["# Throttle and suppress notifications\n\nTo reduce distraction while driving,\n[heads-up notifications](/docs/automotive/hmi/notifications/hun)\n(HUN) provide drivers with essential and relevant information **without**\ndiverting their attention to a display or mobile device. However, since HUNs\n*can* interfere with the task of driving, it's crucial to consider\nthe advantages and disadvantages of HUNs to ensure drivers are **not**\ndistracted.\n\nUse these Android notification-specific safety features to reduce driver\ndistraction:\n\n- [Queue and prioritize](#queue)\n- [Throttle and pace](#pace)\n- [Suppression](#suppress)\n\nThis content describes configurations and resources that pertain to\n`platform/packages/apps/Car/Notification`.\n\nQueue and prioritize\n--------------------\n\nWhen multiple incoming HUNs are received, the *queue and prioritize* mechanism\ndisplays the most important and relevant information to the driver.\n\nTo enable or disable the queue mechanism, set the boolean value for the\n`config_suppressAndThrottleHeadsUp config`.\n\nQueued HUNs are sorted based on priority determined by the\n[category](https://developer.android.com/reference/android/app/Notification#category)\nof the notification. Specify the `headsup_category_priority` array in a\ndescending order of priority.\n\nSome time-sensitive notifications, such as `CATEGORY_CALL` and\n`CATEGORY_CAR_EMERGENCY`, should be displayed immediately instead of queued.\n\nTo immediately display these types of HUNs, add these categories to the\n`headsup_category_immediate_show` array.\n\nThrottle and pace\n-----------------\n\nWhen a user performs an action during which it would be unsafe or distracting to\nshow HUNs, such as interacting with Assistant or Dialer, you can *throttle*\nHUNs.\n\nTo employ throttling, add the package names of apps that require attention to\nthe allowlist (`headsup_throttled_foreground_packages`). This stops the queue\nfrom displaying new HUNs while the specified apps run in the foreground.\n\nTo give drivers time to focus on driving, add a time interval between the\ndisplay of each HUN. This time interval (`headsup_delay_duration`)\napplies after packages from `headsup_throttled_foreground_packages` are\nmoved to the background.\n\nSuppression\n-----------\n\nHUNs that remain in the queue for an extended period can be *suppressed.*\nWhen HUNs become irrelevant to the driver, they can cause distraction.\nInstead of triggering a HUN, direct expired notifications to the\nNotification center.\nYou can tailor your management of HUNs by prescribing different values for the\n**Drive** and **Park** states.\n\nFor the **Drive** state:\n\n1. Set `config_expireHeadsUpWhenDriving` to `true` and specify the `headsup_queue_expire_driving_duration_ms` as the duration (in milliseconds) after the post time when the notification is to expire.\n\nFor the **Park** state:\n\n1. Set `config_expireHeadsUpWhenParked` to `true` and specify the `headsup_queue_expire_parked_duration_ms`as the duration (in milliseconds) after the post time when the notification is to expire.\n\nIn the event of a suppression, send a trailing system HUN to notify the\ndriver. Modify the title of this notification by updating the values of\n`hun_suppression_notification_title_drive` and\n`hun_suppression_notification_title_park`\n\nTo automatically dismiss the HUN queue when the Notification center is opened:\n\n1. Set the `config_dismissHeadsUpWhenNotificationCenterOpens` boolean to `true`."]]
