2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main
대신 android-latest-release
를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.
운전자 주의 분산 행동 가이드라인
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Android Automotive 앱이 아래 설명된 운전자 주의 분산 행동 가이드라인을 따르는 경우 차량 이동 중 앱을 HU에서 실행할 수 있습니다. DDG는 운전자 주의 분산 행동을 줄이기 위한 것으로, Google에서 제공하는 기준 권장사항으로 구성됩니다.
운전자 주의 분산 행동 가이드라인을 준수하는 앱은 주의 분산 행동 최적화로 태그될 수 있습니다. 이 페이지에서는 Android 플랫폼에서 앱이 사용자 환경 제한 상태로 실행될 수 있도록 앱을 주의 분산 행동 최적화로 태그해야 하는 방법을 자세히 설명합니다. 다음을 자세히 알아보세요.
주의 분산 행동 최적화 앱
앱은 특정 활동을 주의 분산 행동 최적화로 태그할 수 있습니다. 전체 앱이 주의 분산 행동 최적화로 지정되려면 앱의 모든 활동이 운전자 주의 분산 행동 가이드라인을 준수해야 합니다. 차량의 운전 상태가 UX 제한이 활성화된 상태로 변경되는 경우 다음과 같습니다.
- 현재 포그라운드 활동은 매니페스트에서 주의 분산 행동 최적화로 태그된 경우에만 계속 실행할 수 있습니다.
- 새로운 활동을 실행할 때 이 활동은 매니페스트에서 주의 분산 행동 최적화로 태그된 경우에만 허용됩니다.
플랫폼은 매니페스트를 확인하고 주의 분산 행동 최적화 활동만 제한된 상태로 실행할 책임이 있습니다.
참고: 플랫폼은 제한사항에 관한 앱의 실질적인 준수를 감지하거나 시행할 수 없으며 매니페스트에서 앱의 선언만 확인할 수 있습니다. 이러한 운전자 주의 분산 행동 가이드라인 준수는 Google Play 검토 과정에서 시행됩니다.
모든 앱 활동이 주의 분산 행동 최적화일 필요는 없습니다. 앱은 더 제한된 상태에 비해 제한되지 않은 상태(예: 차량이 주차된 경우)를 위한 다양한 사용자 환경을 제공할 수 있습니다. 따라서 AndroidManifest.xml
파일에서 앱의 <activity>
요소에 다음 메타데이터를 추가하면 앱은 특정 활동을 주의 분산 행동 최적화로 태그할 수 있습니다.
<activity android:name=".DistractionOptimizedMainActivity"....>
....
<meta-data android:name="distractionOptimized" android:value="true"/>
</activity>
제한된 상태에서 실행되도록 설계된 활동을 제공하는 앱은 이 정보를 매니페스트에서 선언해야 합니다. 플랫폼은 활동이 제한된 상태에서 실행되도록 허용할지 여부를 결정하기 전에 선언된 정보만 확인합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(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-07-27(UTC)"],[],[],null,["# Driver Distraction Guidelines\n\nWhen Android Automotive apps follow the *Driver Distraction Guidelines* described\nbelow, the apps can run on the HU when a vehicle is moving. DDG consists of baseline\nrecommendations provided by Google and are intended to reduce driver distraction.\n\nApps that meet the Driver Distraction Guidelines can be tagged as\n*Distraction Optimized* . This page details how apps *must* be tagged\nas Distraction Optimized so that the Android platform can enable the apps to run in the User\nExperience Restricted state. To learn more about:\n\n- Car user experience restrictions, see [Car User Experience\n Restrictions](/docs/automotive/driver_distraction/car_uxr).\n- Using car driving state, see [Consuming Car Driving State and\n UX Restrictions](/docs/automotive/driver_distraction/consume).\n\nDistraction Optimized apps\n--------------------------\n\nAn app can tag a specific activity to be Distraction Optimized. For an entire app to\nbe designated as Distraction Optimized, all its activities must adhere to the driver distraction\nguidelines. When the driving state of a vehicle changes to a state in which the UX restrictions are\nactive:\n\n- Current foreground activity can continue to run only when it is tagged as Distraction Optimized in the manifest.\n- When launching a new activity, the new activity is permitted only when it is tagged as Distraction Optimized in the manifest.\n\nThe platform is responsible for checking the manifest and allowing only Distraction Optimized\nactivities to run in a restricted state.\n\n**Note:** The platform can't detect or enforce an app's actual\nadherence to the restrictions; it can only check an app's declaration in the manifest. Adherence to\nthese driver distraction guidelines is enforced during the Google Play review process.\n\nNot all app activities need be Distraction Optimized. An app can provide\ndifferent user experiences for an unrestricted state (for example, when the vehicle is parked)\nversus a more restricted state. As a result, an app can tag a specific activity to be\nDistraction Optimized by adding the following metadata to the `\u003cactivity\u003e` element\nin the `AndroidManifest.xml` file for the app: \n\n```\n\u003cactivity android:name=\".DistractionOptimizedMainActivity\"....\u003e\n....\n\u003cmeta-data android:name=\"distractionOptimized\" android:value=\"true\"/\u003e\n\u003c/activity\u003e\n```\n\nApps that offer activities designed to run in a restricted state must declare that information in\nthe manifest. The platform looks only at the declared information before determining if the activity\ncan be permitted to run (or not) in the restricted state."]]