از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
دستورالعمل های حواس پرتی راننده
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
وقتی برنامه‌های Android Automotive از دستورالعمل‌های حواس‌پرتی راننده که در زیر توضیح داده شده است پیروی می‌کنند، برنامه‌ها می‌توانند در HU در هنگام حرکت خودرو اجرا شوند. DDG شامل توصیه های پایه ارائه شده توسط Google است و هدف آن کاهش حواس پرتی راننده است.
برنامه‌هایی که دستورالعمل‌های حواس‌پرتی راننده را رعایت می‌کنند، می‌توانند با عنوان «بهینه‌سازی حواس‌پرتی» برچسب‌گذاری شوند. در این صفحه توضیح داده می‌شود که چگونه برنامه‌ها باید به‌عنوان Distraction Optimized برچسب‌گذاری شوند تا پلتفرم Android بتواند برنامه‌ها را در حالت User Experience Restricted اجرا کند. برای کسب اطلاعات بیشتر در مورد:
برنامه های بهینه سازی حواس پرتی
یک برنامه می تواند یک فعالیت خاص را برای بهینه سازی حواس پرتی برچسب گذاری کند. برای اینکه یک برنامه کامل به‌عنوان «بهینه‌سازی حواس‌پرتی» تعیین شود، تمام فعالیت‌های آن باید از دستورالعمل‌های حواس‌پرتی راننده پیروی کند. هنگامی که وضعیت رانندگی یک وسیله نقلیه به حالتی تغییر می کند که در آن محدودیت های UX فعال هستند:
- فعالیت پیش‌زمینه کنونی تنها زمانی می‌تواند به اجرای آن ادامه دهد که در مانیفست به‌عنوان Distraction Optimized برچسب‌گذاری شود.
- هنگام راه‌اندازی یک فعالیت جدید، فعالیت جدید تنها زمانی مجاز است که در مانیفست با عنوان Distraction Optimized برچسب‌گذاری شود.
این پلتفرم مسئول بررسی مانیفست است و فقط به فعالیت‌های Distraction Optimized اجازه می‌دهد در حالت محدود اجرا شوند.
توجه: پلتفرم نمی‌تواند پایبندی واقعی برنامه به محدودیت‌ها را تشخیص دهد یا اعمال کند. فقط می تواند اعلان برنامه را در مانیفست بررسی کند. رعایت این دستورالعمل‌های حواس‌پرتی راننده در طول فرآیند بررسی Google Play اعمال می‌شود.
همه فعالیت‌های برنامه نیازی به بهینه‌سازی حواس‌پرتی ندارند. یک برنامه می‌تواند تجربیات کاربری متفاوتی را برای حالت نامحدود (مثلاً زمانی که وسیله نقلیه پارک شده است) در مقابل حالت محدودتر ارائه دهد. در نتیجه، یک برنامه می‌تواند با افزودن متادیتای زیر به عنصر <activity> در فایل AndroidManifest.xml برای برنامه، فعالیت خاصی را به‌عنوان Distraction Optimized برچسب‌گذاری کند:
<activity android:name=".DistractionOptimizedMainActivity"....>
....
<meta-data android:name="distractionOptimized" android:value="true"/>
</activity>
برنامه‌هایی که فعالیت‌هایی را ارائه می‌کنند که برای اجرا در حالت محدود طراحی شده‌اند، باید آن اطلاعات را در مانیفست اعلام کنند. پلتفرم فقط به اطلاعات اعلام شده نگاه می کند قبل از اینکه مشخص کند آیا می توان فعالیت را در حالت محدود اجرا کرد (یا نه).
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-29 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]
