بدءًا من Android 13 ، يتم تعريف HAL لـ Hardware Composer (HWC) في AIDL ويتم إهمال إصدارات HIDL التي تتراوح من android.hardware.graphics.composer@2.1 إلى android.hardware.graphics.composer@2.4 .
تصف هذه الصفحة الاختلافات بين AIDL و HIDL HAL لـ HWC وتنفيذ واختبار AIDL HAL.
نظرًا للمزايا التي يوفرها AIDL ، يتم تشجيع البائعين على تنفيذ مؤلف AIDL HAL بدءًا من Android 13 بدلاً من إصدار HIDL. راجع قسم التنفيذ لمزيد من المعلومات.
الاختلافات بين AIDL و HIDL HALs
تم تعريف مؤلف AIDL الجديد ، المسمى android.hardware.graphics.composer3 ، في IComposer.aidl . يعرض واجهة برمجة تطبيقات مشابهة لـ HIDL HAL android.hardware.graphics.composer@2.4 مع التغييرات التالية:
إزالة قائمة انتظار الرسائل السريعة (FMQ) لصالح الأوامر القابلة للتقسيم.
يحدد AIDL HAL واجهة الأوامر بناءً على الأنواع القابلة للتجزئة المكتوبة بشدة بدلاً من الأوامر المتسلسلة عبر FMQ في HIDL. يوفر هذا واجهة مستقرة للأوامر وتعريف أكثر قابلية للقراءة لكيفية تفسير حمولة الأمر.
يتم تعريف طريقة
executeCommandsفيIComposerClient.aidlكـCommandResultPayload[] executeCommands(in DisplayCommand[] commands);حيث يكون كل أمر من النوع القابل للطرود المكتوب بشدة والمعرف في
DisplayCommand.aidl. استجابات الأوامر هي عناصر مكتوبة بشدة محددة فيCommandResultPayload.aidl.إزالة
IComposerClient.getClientTargetSupportلعدم وجود عملاء نشطين لهذه الطريقة.تمثيل الألوان على هيئة عوامات بدلاً من بايت لمحاذاة أفضل مع مجموعة الرسومات العلوية في Android كما هو محدد في
ASurfaceTransaction_setColor.إضافة حقول جديدة للتحكم في محتوى HDR.
في AIDL HAL ، تدعم مجموعات طبقات SDR / HDR المختلطة التعتيم السلس لطبقات SDR عندما تكون طبقة HDR على الشاشة في نفس الوقت.
يتيح مجال
brightnessفيLayerCommandتحديد سطوع لكل طبقة ، بحيث يقوم HWC بتعتيم محتوى الطبقة في مساحة الضوء الخطي ، على عكس مساحة جاما.يتيح حقل
brightnessفيClientTargetPropertyWithBrightnessتحديد مساحة السطوع لتكوين العميل وإصدار تعليماتRenderEngineإلى ما إذا كان سيتم تعتيم طبقات SDR في تكوين العميل.يسمح حقل
dimmingStageبالتكوين عندما يجبRenderEngineتعتيم المحتوى. يلائم ذلكColorModesالمحدد من قبل البائع ، والذي قد يفضل تعتيم مساحة جاما ، للسماح بتحسينات التباين المحددة من قبل البائع في خطوط أنابيب الألوان الخاصة بهم.إضافة نوع تكوين جديد
DISPLAY_DECORATIONفيComposition.aidlلتزيين الشاشة.تحتوي بعض الأجهزة على أجهزة مخصصة لتحسين رسم قناع ألفا الذي ينعم الزوايا الدائرية والقواطع على شاشات العرض. يجب أن تقوم الأجهزة المزودة بمثل هذه الأجهزة بتنفيذ
IComposerClient.getDisplayDecorationSupportلإرجاع بنيةDisplayDecorationSupportعلى النحو المحدد فيDisplayDecorationSupport.aidlالجديد. تصف هذه البنيةPixelFormatوAlphaInterpretationالمطلوب بواسطة الجهاز. عند هذا التنفيذ ، تحدد واجهة مستخدم النظام طبقة قناع ألفا باسمDISPLAY_DECORATION، وهو نوع تكوين جديد يستفيد من الأجهزة المخصصة.إضافة حقل
expectedPresentTimeجديد في الوقت الحالي إلىDisplayCommand.aidl.يتيح الحقل "
expectedPresentTimeفي الوقت الحالي" لجهاز SurfaceFlinger تعيين الوقت الحالي المتوقع إلى وقت وجوب عرض المحتوى الحالي على الشاشة. باستخدام هذه الميزة ، يرسل SurfaceFlinger أمرًا حاضرًا للتنفيذ مسبقًا ، مما يسمح له بتوجيه المزيد من أعمال التكوين.إضافة واجهات برمجة تطبيقات جديدة للتحكم في تكوين عرض التمهيد.
باستخدام
BOOT_DISPLAY_CONFIG، يمكن للبائعين تحديد دعم تكوين عرض التمهيد. تستخدم أساليبsetBootDisplayConfigوclearBootDisplayConfigوgetPreferredBootDisplayConfigBOOT_DISPLAY_CONFIGعلى النحو التالي:باستخدام
setBootDisplayConfig، يقوم إطار العمل بإعلام البائعين بتكوين عرض وقت التمهيد. يجب على البائعين التخزين المؤقت في تكوين عرض التمهيد ، والتمهيد في هذا التكوين عند إعادة التشغيل التالية. إذا كان الجهاز غير قادر على التمهيد في هذا التكوين ، يجب على البائع العثور على التكوين الذي يطابق الدقة ومعدل التحديث لهذا التكوين. في حالة عدم وجود مثل هذا التكوين ، يجب على البائع استخدام تهيئة العرض المفضلة لديه.باستخدام
clearBootDisplayConfig، يُعلم إطار العمل البائعين بمسح تكوين عرض التمهيد ، والتمهيد في تكوين العرض المفضل لديهم أثناء إعادة التشغيل التالية.باستخدام
getPreferredBootDisplayConfig، يستعلم إطار العمل عن وضع التمهيد المفضل لدى البائع.
عندما لا يتم دعم تكوين عرض التمهيد ، ترجع هذه الطرق قيمة غير
UNSUPPORTED.إضافة واجهات برمجة تطبيقات جديدة للتحكم في مؤقت الخمول للعرض.
باستخدام
DISPLAY_IDLE_TIMER، يمكن للبائعين تحديد أنه تم تنفيذ مؤقت عدم النشاط بواسطة البائع لهذه الشاشة. عند الخمول ، تغير هذه الإمكانية معدل التحديث إلى إعداد أقل للحفاظ على الطاقة. تستخدم المنصةsetIdleTimerEnabledللتحكم في مهلة المؤقت ، وفي بعض الحالات ، لتعطيلها من أجل منع تبديل معدل التحديث غير المرغوب فيه عند الخمول.يشير استخدام رد الاتصال
IComposerCallback.onVsyncIdleإلى النظام الأساسي إلى أن الشاشة خاملة وأن إيقاعvsyncقد تغير. يستجيب النظام الأساسي لرد الاتصال هذا بإعادة تعيين نموذجvsyncالخاص به. إنه يفرض إعادة مزامنةvsyncفي الإطار التالي ، ويتعلم إيقاعvsyncالجديد.
تطبيق
لا يُطلب من البائعين تنفيذ AIDL HAL لنظام Android 13. ومع ذلك ، يتم تشجيعهم على تطبيق AIDL composer HAL بدلاً من إصدار HIDL لاستخدام الوظائف وواجهات برمجة التطبيقات الجديدة.
يتم تنفيذ تطبيق مرجعي لـ AIDL HWC HAL في محاكيات Android.
اختبارات
لاختبار التنفيذ ، قم بتشغيل VtsHalGraphicsComposer3_TargetTest .