نريد معرفة ملاحظاتك. يُرجى المشاركة في استطلاع لمساعدتنا في تحسين تجربة تطوير تطبيقات السيارات.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

الاختبار باستخدام الوحدة الرئيسية لسطح المكتب

تتيح لك أداة Desktop Head Unit (DHU) محاكاة وحدة رئيسية في Android Auto على جهاز التطوير، ما يتيح لك تشغيل تطبيقات Android Auto واختبارها. يعمل DHU على أنظمة Windows وmacOS وLinux.

بعد تثبيت DHU، يمكنك اختبار تطبيقات Android Auto من خلال ربط جهازك الجوّال به باستخدام إحدى آليات الربط المتوافقة الموضّحة في تشغيل DHU.

للإبلاغ عن أخطاء أو طلب ميزات متعلّقة بـ DHU، استخدِم أداة تتبُّع المشاكل.

تثبيت تطبيق "مساعد القيادة"

لتثبيت DHU على جهاز التطوير، اتّبِع الخطوات التالية:

فعِّل وضع المطوّرين على جهاز جوّال يعمل بنظام التشغيل Android 9 (المستوى 28 لواجهة برمجة التطبيقات) أو إصدار أحدث، كما هو موضّح في ضبط خيارات المطوّرين على الجهاز.
تجميع تطبيقك وتثبيته على الجهاز
ثبِّت Android Auto على الجهاز. إذا كان تطبيق Android Auto مثبّتًا، تأكَّد من استخدام أحدث إصدار منه.
في "استوديو Android"، افتح SDK Manager وانتقِل إلى علامة التبويب أدوات حزمة تطوير البرامج (SDK)، ثم نزِّل حزمة محاكي الوحدة الرئيسية لـ Android Auto على الكمبيوتر.

مدير حزمة تطوير البرامج (SDK) الذي يعرض الإصدار 2.0 من DHU

يتم تثبيت DHU في الدليل SDK_LOCATION/extras/google/auto/.
على أنظمة Linux أو macOS، نفِّذ الأمر التالي في هذا الدليل لجعل ملف DHU الثنائي قابلاً للتنفيذ:

chmod +x ./desktop-head-unit

خطوات إضافية لنظام التشغيل Linux

إذا كنت تستخدم الإصدار 2.x من DHU على نظام Linux، عليك تثبيت بعض المكتبات الإضافية. يعتمد ملف DHU الثنائي على الإصدار 2.32 من GLIBC أو الإصدارات الأحدث. يمكنك التحقّق من إصدار GLIBC لنظامك من خلال تنفيذ الأمر التالي:

ldd --version

إذا كان الإصدار أقل من 2.32، عليك تحديث GLIBC إلى الإصدار 2.32 أو إصدار أحدث، وقد يتطلّب ذلك ترقية نظام التشغيل إلى إصدار متوافق مع GLIBC 2.32 أو إصدار أحدث.

يجب أيضًا تثبيت المكتبتَين libc++1 وlibc++abi1. تختلف إجراءات التثبيت حسب توزيعة Linux التي تستخدمها. على سبيل المثال، في توزيعات Linux المستندة إلى Debian، يمكنك تثبيت المكتبات باستخدام الأمر التالي:

sudo apt-get install libc++1 libc++abi1

تثبيت إصدارات تجريبية من DHU

للوصول إلى إصدارات ما قبل الإصدار من DHU، يمكنك إما استخدام إصدار مبكر حصري من "استوديو Android" أو تغيير قناة التحديث لعملية تثبيت "استوديو Android" الحالية إلى قناة الإصدار التجريبي.

تشغيل DHU

بعد تثبيت DHU، يمكنك اختبار تطبيقات Android Auto من خلال ربط جهازك الجوّال ومحطة العمل عبر USB. شغِّل DHU من خلال توصيل جهازك الجوّال بجهاز تطوير باستخدام وضع الملحقات (الخيار المقترَح لإصدار DHU 2.x) أو نفق ADB.

الاتصال باستخدام "وضع الأجهزة الملحقة"

يتوافق Android Auto مع الربط بالإصدار 2.x من DHU باستخدام بروتوكول Android Open Accessory (AOA)، وذلك باستخدام الأمر التالي:

./desktop-head-unit --usb

تتصفّح DHU تلقائيًا قائمة أجهزة USB المتاحة وتحاول الاتصال بأول جهاز متوافق. لاستهداف جهاز معيّن، أدرِج معرّف الجهاز كجزء من الأمر --usb على النحو التالي:

./desktop-head-unit --usb=[DEVICE_ID]

الاتصال باستخدام ميزة "نفق ADB"

تتطلّب هذه الطريقة إعداد اتصال بخادم وحدة رأس Android Auto باستخدام Android Debug Bridge (adb). اتّبِع الخطوات التالية لإعداد النفق وتشغيل DHU:

فعِّل وضع مطوّر البرامج في Android Auto إذا لم يكن مفعّلاً بعد.
إذا لم يكن خادم وحدة التحكّم الرئيسية قيد التشغيل، افتح قائمة الخيارات الإضافية واختَر بدء تشغيل خادم وحدة التحكّم الرئيسية، كما هو موضّح في الشكل 1.

يظهر على الجهاز إشعار في منطقة الإشعارات يشير إلى أنّ الخادم قيد التشغيل، كما هو موضّح في الشكل 2.

الشكل 1. قائمة السياقات التي تتضمّن خيارات المطوّرين

الشكل 2. إشعار بأنّ خادم وحدة التحكّم الرئيسية قيد التشغيل
في تطبيق Android Auto، انقر على السيارات التي تم ربطها سابقًا بالقرب من أعلى الإعدادات وتأكَّد من تفعيل خيار إضافة سيارات جديدة إلى Android Auto.
وصِّل الجهاز الجوّال بجهاز التطوير باستخدام كابل USB.
تأكَّد من فتح قفل شاشة الجهاز الجوّال حتى يتمكّن من تشغيل تطبيق "مساعد القيادة من Google".
على جهاز التطوير، شغِّل الأمر adb التالي لإعادة توجيه اتصالات المقبس من المنفذ 5277 على جهاز التطوير إلى رقم المنفذ نفسه على الجهاز الجوّال. يتيح هذا الإعداد لتطبيق DHU الاتصال بخادم وحدة التحكم الرئيسية الذي يعمل على الجهاز الجوّال عبر مقبس TCP.
```
adb forward tcp:5277 tcp:5277
```
ابدأ تشغيل DHU من خلال تنفيذ الأمر desktop-head-unit.exe على نظام التشغيل Windows أو الأمر ./desktop-head-unit على نظام التشغيل macOS أو Linux من الدليل SDK_LOCATION/extras/google/auto/:
```
cd SDK_LOCATION/extras/google/auto
desktop-head-unit.exe # Windows
./desktop-head-unit # macOS or Linux
```

إذا كانت هذه هي المرة الأولى التي تربط فيها الجهاز الجوّال بوحدة DHU، تحقَّق من شاشة الجهاز الجوّال للموافقة على بنود الخدمة وتعديل إعدادات الأذونات حسب الحاجة.

بعد بدء تشغيل DHU، يمكنك استخدام أوامر وحدة تحكّم DHU لتشغيل تطبيقك واختباره.

خيارات سطر الأوامر

يتصل خادم وحدة التحكم الرئيسية تلقائيًا عبر المنفذ 5277. لتجاوز المضيف أو المنفذ، استخدِم العلامة --adb=<[localhost:]port>، كما هو موضّح في المثال التالي:

./desktop-head-unit --adb=5999

بشكلٍ تلقائي، يحاكي DHU وحدة رأس متوافقة مع Android Auto تتضمّن واجهة مستخدم بشاشة تعمل باللمس. محاكاة لمسات المستخدم من خلال النقر على DHU باستخدام الماوس لمحاكاة وحدات رأس تستخدم أداة تحكّم دوّارة للإدخال، يمكنك استخدام العلامة -i rotary، كما هو موضّح في المثال التالي:

./desktop-head-unit -i controller

عندما يكون تطبيق DHU في وضع التحكّم الدوّار، يمكنك استخدام اختصارات لوحة المفاتيح لمحاكاة عمليات التحكّم. يمكنك الاطّلاع على قسم وحدة التحكّم الدورانية لمزيد من التفاصيل. في وضع التحكّم الدوّار، تتجاهل DHU نقرات الماوس. يجب تشغيل Android Auto باستخدام عمليات وحدة التحكّم الدوّارة المحاكية.

في ما يلي خيارات أخرى لسطر الأوامر في DHU:

خيار	الوصف
‫`-c`، `--config=FILE`	استخدِم ملف الإعداد `.ini` المحدّد. راجِع قسم ضبط إعدادات DHU لمزيد من التفاصيل.
‫`-i`، `--input=INPUT`	استخدِم وضع الإدخال المحدّد، وهو أحد الخيارات التالية: `touch` أو `rotary` أو `hybrid`.
‫`-a`، `--adb=HOSTPORT`	استخدِم بروتوكول نقل بيانات تصحيح الأخطاء عبر Android. اختياري `host:port` أو `port` القيمة التلقائية هي المنفذ 5277.
‫`-a`، `--usb=DEVICE_ID`	استخدام بروتوكول نقل بيانات AOA عبر USB اختياري `DEVICE_ID`
‫`-v`، `--version`	عرض معلومات الإصدار
‫`-l`، `--licenses`	عرض تراخيص البرامج المفتوحة المصدر
‫`-h`، `--headless`	تشغيل التطبيق في وضع التشغيل بلا واجهة مستخدم رسومية، بدون واجهة مستخدم
‫`-t`، `--always_show_window_on_top`	عرض نوافذ "مساعد Google" للسيارات فوق النوافذ الأخرى (غير مفعَّل تلقائيًا)
‫`-?`، `--help`	عرض قائمة المساعدة

دليل مستخدم "مساعد Google" على أجهزة Android

يوضّح هذا القسم الميزات المتوافقة مع DHU وكيفية استخدامها.

يتم إدخال الأوامر في نافذة المحطة الطرفية التي بدأت فيها DHU. يمكن تنفيذ أوامر متعددة في السطر نفسه من خلال الفصل بينها باستخدام ;.

النظام

الأمر	المفتاح	الوصف
`help [command]`		عرض مجموعة الأوامر الكاملة إذا تم تحديد اسم أمر، اعرض المساعدة الخاصة بهذا الأمر.
`quit` `exit`	`Alt+Q`	اخرج من وحدة التحكّم الرئيسية.
`sleep [seconds]`		الانتظار لمدة ثانية واحدة إذا تم تحديد مدة تأخير، سيتم إيقاف التنفيذ مؤقتًا لمدة `seconds`. يمكن استخدام ذلك لإنشاء نصوص برمجية للوحدة الرئيسية تتضمّن `./desktop-head-unit < script.txt`، مثلاً في بيئة CI.
`screenshot filename.png`		حفظ لقطة شاشة في `filename.png.`
`licenses`		عرض تراخيص المكتبات المستخدَمة في DHU
`keycode keycode`		أرسِل `keycode`، وهو أحد الأسماء المُدرَجة في قسم رموز المفاتيح.

الشاشة التي تعمل باللمس ولوحة اللمس

عندما تكون ميزة اللمس أو لوحة اللمس مفعّلة، يتم تسجيل النقر في نافذة العرض على أنّه حدث لمس.

بالنسبة إلى اللمس، يمكنك محاكاة اللمس المتعدد من خلال النقر بزر الماوس الأيمن على موضع الإصبع الأول، ثم النقر مع الاستمرار في الضغط على الزر الأيمن للإصبع الثاني. يبقى موضع الإصبعين ثابتًا، ويتيح لك تحريك الماوس تدويرهما حول الموضع أو التكبير والتصغير أو كليهما.

باستخدام لوحة اللمس، انقر مع الاستمرار على الزر الأيسر للتنقّل بين عناصر واجهة المستخدم المختلفة على الشاشة. يؤدي النقر على الزر الأيمن إلى تحديد العنصر الذي يركّز عليه المؤشر.

الأمر	المفتاح	الوصف
`tap x y`		محاكاة حدث لمس في الإحداثيات المحدّدة

وحدة تحكّم دوّارة

يتوافق تطبيق "مساعد القيادة في Android" مع وحدات التحكّم الدوّارة. عندما يكون هذا الخيار مفعَّلاً، تتوفّر الإجراءات التالية:

النقر على الأسهم للأعلى والأسفل واليمين واليسار على لوحة التحكّم
التدوير في اتجاه عقارب الساعة وعكس اتجاه عقارب الساعة
تنفيذ حركة دوران سريعة (خمس خطوات في آن واحد)
النقر مع الاستمرار على زر الرجوع في وحدة التحكّم

يتم إدراج الأوامر واختصارات لوحة المفاتيح في الجدول التالي.

ترسل عجلة التمرير على الماوس أوامر dpad rotate، بينما يرسل النقر على زر الماوس الأوسط، وهو عادةً عجلة التمرير، أوامر dpad click.

يُرجى العِلم أنّ معظم السيارات مزوّدة بشاشات تعمل باللمس. تتضمّن بعض السيارات أدوات تحكّم دوّارة فقط، بينما تتضمّن أخرى أدوات تحكّم تعمل باللمس وبالأزرار. يمكن أن تتوافق السيارات أيضًا مع لوحة لمس يمكن استخدامها لتحريك الخريطة وإدخال النص. يُرجى الانتباه إلى هذه الإعدادات المختلفة عند محاكاة وحدات أساسية مختلفة للمركبة.

الأمر	المفتاح	الوصف
`dpad {up\|down\|left\|right}`	`مفاتيح الأسهم`	حرِّك وحدة التحكّم الدوّارة.
`dpad {ur\|dl\|ul\|dr}`		حرِّك وحدة التحكّم الدوّارة.
`dpad soft {left\|right}`	`Shift+مفاتيح الأسهم`	أزرار جانبية متوفرة في بعض وحدات التحكّم الدوّارة
`dpad click`	`الرجوع`	اضغط على وحدة التحكّم الدوّارة.
`dpad back`	`Backspace`	اضغط على زر الرجوع المتوفّر في بعض وحدات التحكّم الدوّارة.
`dpad rotate left`	`1`	أدر وحدة التحكّم الدوّارة عكس عقارب الساعة (إلى اليسار).
`dpad rotate right`	`2`	أدرِ وحدة التحكّم الدوّارة في اتجاه عقارب الساعة (إلى اليمين).
`dpad flick left`	`Shift+1`	أدر وحدة التحكّم الدوّارة بسرعة عكس اتجاه عقارب الساعة.
`dpad flick right`	`Shift+2`	تدوير وحدة التحكّم الدوّارة بسرعة في اتجاه عقارب الساعة
`dpad 0-9*#+`	`لوحة المفاتيح الرقمية`

الميكروفون

يتيح تطبيق DHU استخدام ميكروفون للإدخال الصوتي أو لتشغيل مقطع صوتي مسجّل مسبقًا. لتسهيل الأمر، يتم تضمين ملفات الصوت التالية لأوامر الصوت الشائعة مع DHU. توجد ملفات الصوت هذه في الدليل SDK_LOCATION/extras/google/auto/voice/.

اسم الملف	نص
`navhome.wav`	الانتقال إلى الصفحة الرئيسية
`navwork.wav`	الانتقال إلى العمل
`navsoh.wav`	انتقِل إلى "دار أوبرا سيدني".
`navgoogle.wav`	التَّوَجُّهْ إِلَى 1600 Amphitheatre Parkway, California, USA.
`exitnav.wav`	الخروج من التنقّل
`howlong.wav`	ما الوقت المتبقي للوصول؟
`showtraffic.wav`	إظهار حركة المرور
`showalternateroute.wav`	عرض مسارات بديلة
`pause.wav`	أوقِف الموسيقى مؤقتًا.
`nextturn.wav`	متى سأصل إلى المنعطف التالي؟

لتشغيل ملف .wav فردي في موجّه DHU، استخدِم الأمر التالي:

mic play /path/to/filename.wav

يسرد الجدول التالي أوامر أخرى ذات صلة بالميكروفون:

الأمر	المفتاح	الوصف
`mic begin`	`M`	فعِّل الميكروفون، محاكيًا نقرة على زر عجلة القيادة، وانتظر إدخالاً من ميكروفون الكمبيوتر.
`mic play filename.wav`		فعِّل الميكروفون وشغِّل تسجيل ملف WAV المحدّد. ملاحظة: لن تسمع صوت ملف WAV، ولكنك ستسمع الرد من Android Auto.
`mic repeat`		تكرار التسجيل الأخير المستخدَم مع `mic play`
`mic reject {on\|off}`		تفعيل أو إيقاف رفض طلبات الوصول إلى الميكروفون عندما يكون الميكروفون مفعَّلاً، يتم رفض جميع طلبات الوصول إليه.

أجهزة الاستشعار

يتيح DHU محاكاة التغييرات في بيانات أجهزة الاستشعار في المركبة باستخدام الأوامر التالية. لمحاكاة بيانات أجهزة الاستشعار وإرسالها إلى Android Auto، يجب تفعيل أجهزة الاستشعار المعنية باستخدام ملف الإعدادات .ini المُستخدَم عند بدء تشغيل أداة DHU.

الأمر	الوصف
`fuel [percentage]`	اضبط مستوى الوقود على النسبة المئوية المحدّدة أو (بدون تمرير أي قيمة) أوقِف مستوى الوقود.
`range [km]`	اضبط النطاق على الكيلومترات المحدّدة أو (بدون تمرير أي قيمة) أوقِف بيانات النطاق.
`lowfuel [{on\|off}]`	اضبط جهاز استشعار التحذير من انخفاض مستوى الوقود أو أوقِفه (بدون تمرير أي قيمة).
`accel [x] [y] [z]`	اضبط مقياس التسارع على قيم x وy وz المحدّدة (م/ث^2) أو (بدون تمرير أي مَعلمات) ألغِ ضبط بيانات مقياس التسارع. أدخِل NAN لتخطّي المَعلمات الاختيارية إذا لزم الأمر.
`compass bearing [pitch] [roll]`	اضبط البوصلة على قيم الاتجاه والميل والانحراف المحدّدة (بالدرجات). أدخِل NAN لتخطّي المَعلمات الاختيارية إذا لزم الأمر.
`gyro [x] [y] [z]`	اضبط الجيروسكوب على سرعة الدوران المحدّدة x وy وz (راديان/ثانية) أو (بدون تمرير أي مَعلمات) ألغِ ضبط بيانات الجيروسكوب. أدخِل NAN لتخطّي المَعلمات الاختيارية إذا لزم الأمر.
`location lat long [accuracy] [altitude] [speed] [bearing]`	اضبط الموقع الجغرافي على قيم خطوط الطول والعرض المحدّدة بالإضافة إلى الدقة (بالمتر) والارتفاع (بالمتر) والسرعة (بالمتر في الثانية) والاتجاه (بالدرجات) الاختيارية. أدخِل NAN لتخطّي المَعلمات الاختيارية إذا لزم الأمر.
`odometer km [current_trip_km]`	اضبط عدّاد المسافات على عدد الكيلومترات المحدّد مع قيمة اختيارية بالكيلومترات للرحلة الحالية.
`speed [speed]`	اضبط سرعة المركبة على القيمة المحدّدة (م/ث) أو أوقِف جهاز الاستشعار (بدون تمرير أي قيمة).
`tollcard {insert\|remove}`	إدراج بطاقة دفع رسوم المرور أو إزالتها
`gps_satellite number_in_use [[azimuth] [elevation] [prn] [snr] [used_in_fix]]`	اضبط مستشعر القمر الصناعي لنظام تحديد المواقع العالمي (GPS) على الرقم المحدّد في قيمة الاستخدام مع القائمة الاختيارية لسمات السمت (درجة ضمن النطاق من 0 إلى 360) والارتفاع (درجة ضمن النطاق من 0 إلى 90) ورقم الضوضاء العشوائية الزائفة (PRN) ونسبة الإشارة إلى الضوضاء (SNR) (ديسيبل) والاستخدام في تحديد الموقع الجغرافي (`true` أو `false`).
`parking_brake engaged`	اضبط مستشعر فرامل الانتظار على `true` أو `false`.
`gear gear_value`	اضبط مستشعر التروس على القيمة المحدّدة (على سبيل المثال، `0` للوضع المحايد، و`100` للقيادة، و`101` لوضع الانتظار، و`102` للرجوع إلى الخلف).

الوضع النهاري والليلي

يتيح DHU محاكاة التبديل بين الوضعين النهاري والليلي باستخدام الأوامر واختصارات المفاتيح التالية:

الأمر	المفتاح	الوصف
`day`	`Shift+N`	فعِّل وضع النهار: سطوع عالٍ وألوان كاملة.
`night`	`Ctrl+N`	تفعيل الوضع الليلي: سطوع منخفض وتباين عالٍ
`daynight` `nightday`	`شمال`	التبديل بين الوضع النهاري والليلي

إدارة التركيز

يتيح DHU محاكاة ما إذا كان Android Auto يركّز على وحدة التحكم الرئيسية أم لا، وذلك باستخدام الأوامر التالية:

الأمر	الوصف
`focus video {on\|off\|toggle}`	تفعيل ميزة "تركيز الفيديو" أو إيقافها على وحدة التحكّم الرئيسية يؤدي إيقاف تركيز الفيديو إلى محاكاة إخفاء الوحدة الرئيسية لتطبيق Android Auto.
`focus audio {on\|off\|toggle}`	تفعيل ميزة "تركيز الصوت" أو إيقافها على وحدة التحكّم الرئيسية يؤدي إيقاف ميزة "تركيز الصوت" إلى محاكاة وحدة التحكم الرئيسية التي تشغّل مصدر الصوت الخاص بها.
`focus nav {on\|off\|toggle}`	تفعيل ميزة "تركيز التنقّل" أو إيقافها على وحدة التحكّم الرئيسية يؤدي إيقاف ميزة تركيز التنقّل إلى محاكاة الوحدة الرئيسية التي تشغّل نظام التنقّل الخاص بها.

القيود وحالة القيادة

يتيح DHU محاكاة بعض القيود عندما تكون المركبة في حالة حركة، مثل إيقاف لوحة المفاتيح وعدم السماح بإعدادات الهاتف، وذلك باستخدام الأوامر التالية:

الأمر	المفتاح	الوصف
`restrict none`	`U`	أوقِف جميع القيود.
`restrict all`	`Shift+U`	فعِّل جميع القيود، مثل محاكاة القيادة.

مجموعة العدادات

يتيح DHU محاكاة مجموعة أدوات القياس. عادةً ما تكون هذه الشاشة خلف عجلة القيادة، وتعرض معلومات أساسية أثناء التنقّل حول المنعطف التالي، مثل اسم الطريق التالي أو سهم الانعطاف أو المسافة أو الوقت. تعرض أيضًا معلومات حول المكالمات الهاتفية الجارية.

يمكن تفعيل ذلك باستخدام الإدخال instrumentcluster في القسم [general] من ملف الإعدادات، أو باستخدام الإدخالين navcluster أو phonecluster للتحكّم في كل ميزة بشكل منفصل.

[general]
...
instrumentcluster = true

Cluster Display

تتضمّن بعض المركبات شاشات لوحة عدادات يمكنها عرض معلومات مرئية مفصّلة، مثل مربّعات الخرائط. بدءًا من الإصدار 2.1 من DHU (المتاح حاليًا من خلال قناة الإصدار التجريبي من "استوديو Android")، يمكنك محاكاة هذه الشاشة على جهاز التطوير.

يمكن إجراء ذلك باستخدام ملف إعداد يتضمّن قسم [display] للمجموعة. تتيح أقسام [display] خيارات إعدادات الفيديو نفسها التي تتيحها الشاشة الرئيسية التي تم ضبط إعداداتها في قسم [general] من الملف.

**الشكل 3.** الشاشة الرئيسية عند تشغيل DHU مع شاشة مجموعة ثانوية

**الشكل 4.** شاشة المجموعة عند تشغيل DHU مع شاشة مجموعة ثانوية

...

# The display name following the colon can be whatever you like.
[display:cluster]
# Setting the displaytype as cluster is what lets the DHU know how to handle it.
displaytype = cluster
resolution = 800x480
dpi = 160
...

يمكن إضافة هذا الإعداد مباشرةً إلى ملف .ini حالي أو يمكنك إعادة استخدامه من خلال وضعه في ملف منفصل وتمرير ملفات إعدادات متعددة عند تشغيل DHU. عند استخدام ملفات إعداد متعددة، تلغي التعريفات اللاحقة لقيمة معيّنة التعريفات السابقة.

# Launch your landscape configuration with your cluster display configuration
./desktop-head-unit -c landscape.ini -c cluster.ini

# Launch the portait configuration with the same cluster display configuration
./desktop-head-unit -c portrait.ini -c cluster.ini

حالة تشغيل الوسائط

يتيح DHU عرض معلومات إضافية لعرض حالة تشغيل الوسائط، مثل المقطع الصوتي الذي يتم تشغيله.

يمكن تفعيل هذه الميزة باستخدام الإدخال playbackstatus في القسم [general].

[general]
...
playbackstatus = true

رموز المفاتيح

توفّر حزمة تطوير واجهة المستخدم للسيارات مجموعة من رموز المفاتيح التلقائية التي تحاكي مجموعة أزرار الاختصارات المتوفّرة عادةً في المركبات. على سبيل المثال، يمكن تفعيل home keycode في طلب DHU على النحو التالي:

keycode home

يعرض الجدول التالي رموز المفاتيح الأخرى المتاحة:

رمز المفتاح	الوصف
`home`	انتقل إلى الشاشة الرئيسية.
`back`	الرجوع
`call` `endcall`	إجراء مكالمة أو إنهاؤها
`search`	بدء البحث
`media_play_pause` `media_play` `media_pause`	تشغيل الوسائط أو إيقافها مؤقتًا
`media_next` `media_previous`	الانتقال إلى مقطع الوسائط التالي أو السابق
`media`	انتقِل إلى تطبيق الموسيقى التلقائي.
`navigation`	انتقِل إلى تطبيق التنقّل التلقائي.
`tel`	انتقِل إلى تطبيق الهاتف التلقائي.

ضبط إعدادات DHU

يتيح DHU استخدام ملف إعدادات .ini لتغيير أوضاع الإدخال بين شاشة اللمس وأداة التحكّم الدوّارة، ولضبط عدد اللقطات في الثانية ودرجة الدقة وعدد النقاط في البوصة التي يطلبها الجهاز الرئيسي من الهاتف.

الموقع التلقائي لملف الإعداد هو ~/.android/headunit.ini. لتغيير إعدادات وحدة التحكّم الرئيسية في نظامك، يمكنك تعديل هذا الملف.

يمكنك أيضًا تحديد ملف إعداد لتحميله باستخدام العلامة -c:

./desktop-head-unit -c /path/to/config.ini

يعرض المقتطف التالي نموذجًا للإعدادات:

[general]
touch = true
touchpad = false
controller = false
instrumentcluster = false
resolution = 800x480
dpi = 160
framerate = 30
fueltypes = unleaded,electric,hydrogen
evconnectors = supercharger

تتوفّر ملفات إعداد نموذجية توضّح إعدادات مختلفة لوحدة التحكّم الرئيسية يمكنك اختبارها ضمن المجلد SDK_LOCATION/extras/google/auto/config/. بالنسبة إلى حالات الاستخدام الأكثر تقدّمًا، يُرجى الرجوع إلى الإعدادات المتوافقة التالية:

إعدادات الإدخال

يسرد الجدول التالي خيارات إعداد الإدخال:

الاسم	تلقائي	النوع	الوصف
`inputmode`	`default`	سلسلة	حدِّد وضع الإدخال. تفعّل الخيارات `touch` و`rotary` و`hybrid` وتوقِف إمكانية استخدام شاشة اللمس وأداة التحكّم الدوّارة، وتضبط رموز المفاتيح التلقائية، حسب الاقتضاء. يتم تأجيل `default` إلى الخيارين `touch` و`controller`.
`controller`	`false`	قيمة منطقية	تفعيل إدخال البيانات باستخدام أداة التحكّم الدوّارة يتم تجاهل هذه السمة ما لم تكن قيمة `inputmode` هي `default`.
`touch`	`true`	قيمة منطقية	فعِّل الشاشة التي تعمل باللمس. يتم تجاهل هذه السمة ما لم تكن قيمة `inputmode` هي `default`.
`touchpad`	`false`	قيمة منطقية	فعِّل لوحة اللمس.
`touchpadnavigation`	`false`	قيمة منطقية	فعِّل إمكانية استخدام لوحة اللمس للتنقّل في واجهة المستخدم.
`touchpadtapasselect`	`false`	قيمة منطقية	عندما تكون القيمة صحيحة، يكون النقر على لوحة اللمس حدث اختيار.
`touchpaduiabsolute`	`false`	قيمة منطقية	عندما تكون قيمة `touchpadnavigation` هي `true`، حدِّد ما إذا كان يجب التعامل مع اللمسات على أنّها مطلقة أو على أنّها إيماءات.

إعدادات الفيديو

يتوافق Android Auto مع ثلاث درجات دقة للفيديو:

‫480p (800x480، الإعداد التلقائي)
720 بكسل (1280×720)
‫1080p (1920x1080)

لدعم نسب عرض إلى ارتفاع أخرى، يمكن لوحدة رأس السيارة تحديد هامش لإنشاء تأثير letterbox (pillarbox) حسب الحاجة. على سبيل المثال، إذا كنت تريد شاشة بحجم 1000×600، اضبط الدقة على 720p (1280×720) وmarginwidth على 280 وmarginheight على 120. سيؤدي ذلك إلى إضافة هامش يبلغ 140 بكسل على الحافتين اليمنى واليسرى، وهامش يبلغ 60 بكسل على الحافتين العلوية والسفلية.

يحاكي نموذج الإعداد التالي شاشة عادية بحجم 6 بوصات (750 × 450):

[general]
...
resolution = 800x480
marginwidth = 50
marginheight = 30

ويحاكي مثال الإعداد التالي شاشة عريضة جدًا:

[general]
...
resolution = 1280x720
marginwidth = 0
marginheight = 220

يسرد الجدول التالي خيارات أخرى لإعداد الفيديو:

الاسم	تلقائي	النوع	الوصف
`resolution`	`800x480`	سلسلة	قيمة من: `800x480` أو `1280x720` أو `1920x1080`.
`dpi`	`160`	عدد صحيح
`normalizedpi`	`false`	قيمة منطقية	عندما تكون قيمة `true`، قلِّل حجم نافذة DHU لاحتساب قيم النقاط لكل بوصة الأكبر. عند ضبط `false`، تؤدي قيم النقاط لكل بوصة (DPI) الأكبر إلى نوافذ أكبر، ما لا يحاكي الشاشات الحقيقية، ولكنّه يساعد في فحص المحتوى المرئي.
`realdpi`	`160`	عدد صحيح	تُستخدَم في إعدادات الفيديو.
`framerate`	`30`	عدد صحيح	تُستخدَم في إعدادات الفيديو.
`marginheight`	`0`	عدد صحيح	تُستخدَم في إعدادات الفيديو.
`marginwidth`	`0`	عدد صحيح	تُستخدَم في إعدادات الفيديو.
`margins`	`0,0,0,0`	سلسلة	تُستخدَم في إعدادات الفيديو. تتجاهل هذه السياسة `marginwidth` و`marginheight` في حال توفّرهما. التنسيق هو أعلى، أسفل، يسار، يمين.
`contentinsets`	`0,0,0,0`	سلسلة	تُستخدَم في إعدادات الفيديو. التنسيق هو أعلى، أسفل، يمين، يسار.
`stablecontentinsets`	`0,0,0,0`	سلسلة	تُستخدَم في إعدادات الفيديو. القيمة التلقائية هي قيمة `contentinsets`. التنسيق هو أعلى، أسفل، يسار، يمين.
`cropmargins`	`false`	قيمة منطقية	في حال تحديد `margins` أو `marginheight` أو `marginwidth`، يؤدي استخدام القيمة `true` لهذا الإعداد إلى إزالة تلك الهوامش من الفيديو المعروض. ويعكس ذلك بشكل أدق ما يراه المستخدم النهائي.
`pixelaspectratio`	`1.0`	نافذة عائمة	تُستخدَم في إعدادات الفيديو.

إعدادات أجهزة الاستشعار

لمحاكاة بيانات المستشعر وإرسالها إلى Android Auto، يجب تفعيل المستشعرات المعنية باستخدام الخيارات التالية. في حال عدم تفعيل أحد أجهزة الاستشعار، سيتم تجاهل أي بيانات يتم إرسالها إلى جهاز الاستشعار هذا باستخدام أوامر DHU. يجب وضع هذا الإعداد في القسم [sensors]، وليس في القسم [general] المستخدَم لمعظم الإعدادات الأخرى.

[general]
touch = true
...

[sensors]
location = true
fuel = true
...

الاسم	تلقائي	النوع	الوصف
`accelerometer`	`false`	قيمة منطقية	تفعيل بيانات جهاز قياس السرعة
`compass`	`false`	قيمة منطقية	فعِّل بيانات مستشعر البوصلة.
`driving_status`	`false`	قيمة منطقية	فعِّل بيانات جهاز استشعار حالة القيادة.
`fuel`	`false`	قيمة منطقية	فعِّل بيانات أداة استشعار الوقود.
`gyroscope`	`false`	قيمة منطقية	فعِّل بيانات مستشعر الجيروسكوب.
`location`	`false`	قيمة منطقية	فعِّل بيانات مستشعر الموقع الجغرافي للمركبة.
`night_mode`	`false`	قيمة منطقية	فعِّل بيانات مستشعر "الوضع الليلي".
`odometer`	`false`	قيمة منطقية	فعِّل بيانات أداة استشعار عدّاد المسافات.
`speed`	`false`	قيمة منطقية	فعِّل بيانات مستشعر السرعة.
`toll_card`	`false`	قيمة منطقية	فعِّل بيانات جهاز استشعار بطاقة رسوم المرور.
`gps_satellite`	`false`	قيمة منطقية	فعِّل بيانات مستشعر القمر الصناعي لنظام تحديد المواقع العالمي (GPS).
`parking_brake`	`false`	قيمة منطقية	فعِّل بيانات مستشعر فرامل الانتظار.
`gear`	`false`	قيمة منطقية	فعِّل بيانات مستشعر التروس.

خيارات الإعداد المتنوعة

يسرد الجدول التالي خيارات الضبط الأخرى:

الاسم	تلقائي	النوع	الوصف
`instrumentcluster`	`false`	قيمة منطقية	تفعيل مجموعة العدادات تضيف هذه السمة نافذة إلى واجهة المستخدم لعرض حالة التنقّل والهاتف.
`navcluster`	`false`	قيمة منطقية	تفعيل مجموعة العدادات تضيف هذه السمة نافذة إلى واجهة المستخدم لعرض حالة التنقّل.
`phonecluster`	`false`	قيمة منطقية	تفعيل مجموعة العدادات تضيف هذه السمة نافذة إلى واجهة المستخدم لعرض حالة الهاتف.
`playbackstatus`	`false`	قيمة منطقية	تفعيل حالة التشغيل تضيف هذه السمة نافذة إلى واجهة المستخدم لعرض رسائل حالة التشغيل.
`driverposition`	`left`	سلسلة	قيمة من: `left` أو `center` أو `right`
`windowleft`		عدد صحيح	تضبط هذه السمة موضع النافذة الرئيسية على الجانب الأيسر.
`windowtop`		عدد صحيح	تضبط هذه السمة الموضع العلوي للنافذة الرئيسية.
`fueltypes`	`unleaded`	آلات وترية	واحد أو أكثر ممّا يلي، في قائمة مفصولة بفواصل: `unleaded` `leaded` `diesel-1` `diesel-2` `biodiesel` `e85` `lpg` `cng` `lng` `hydrogen` `electric` `other` `unknown`
`evconnectors`		آلات وترية	صفر أو أكثر مما يلي، في قائمة مفصولة بفواصل: `j1772` `mennekes` `chademo` `combo-1` `combo-2` `roadster` `hpwc` `gbt` `supercharger` `other` `unknown` يجب ضبط هذا الحقل فقط إذا كان `fueltypes` يتضمّن `electric`.

تحديد المشاكل وحلّها

في بعض الأحيان، يعرض تطبيق "مساعد القيادة" شاشة فارغة عند الاتصال لأول مرة. يمكنك حلّ هذه المشكلة باتّباع الخطوات التالية:

أغلِق تطبيق "مساعد القيادة" (DHU).
اتّبِع الخطوة 5 الموضّحة في تشغيل DHU لإيقاف خادم Head Unit وإعادة تشغيله.
أعِد تشغيل تطبيق "Android Auto على الهاتف" (DHU).
امنح أي أذونات إضافية مطلوبة على شاشة الهاتف. قد يتم إيقاف وحدة DHU مرة أخرى.
أعِد تشغيل تطبيق "مساعد القيادة" إذا لزم الأمر.