إطار عمل جودة الوسائط

نقدّم إطار عمل "جودة الوسائط" في نظام التشغيل Android 16 لأجهزة Android TV بهدف إنشاء واجهة برمجة تطبيقات موحّدة لتعديل جودة الصورة (PQ) وجودة الصوت (AQ). والهدف الأساسي هو توفير طريقة موحّدة لإجراء هذه التعديلات على جميع أجهزة Android TV المختلفة. يهدف إطار العمل الموحّد هذا إلى تبسيط عملية التطوير لمطوّري التطبيقات والمصنّعين الأصليين للأجهزة ومورّدي المنظومة على الرقاقة (SoC) من خلال توفير مجموعة متسقة من واجهات برمجة التطبيقات لنظام Android. بالنسبة إلى مورّدي المنظومات على الرقاقة (SoC) على وجه التحديد، يتيح ذلك لإطار عمل Android التعامل مع إعدادات جودة الصورة والصوت، ما يقلّل من تكلفة التعاون مع مطوّري التطبيقات المختلفين.

في النهاية، يساعد ذلك Google ونظام Android الأساسي في تقليل التجزئة وتحسين الجودة وقابلية التوسّع وتوفير ميزات جديدة ووضع الأساس لواجهة مستخدم موحّدة لجودة الصوت/جودة الصورة وتحسين تجربة المستخدم.

يتيح إطار عمل "جودة الوسائط" حالات استخدام مختلفة لتحسين تجربة مشاهدة التلفزيون. يمكن إدارة الملفات الشخصية والإعدادات لكل اسم حزمة (تطبيق) أو لكل رقم تعريف إدخال. بالإضافة إلى ذلك، يمكن إنشاء الملفات الشخصية من خلال تطبيقات النظام أو التطبيقات المدرَجة في القائمة المسموح بها، ولا يمكن تعديلها أو إزالتها إلا من قِبل مالكها.

وعلى وجه التحديد، يدير الإطار ملفات تعريف الصورة والصوت. تشمل أمثلة مَعلمات الصورة السطوع والتباين والحدة، بينما تشمل أمثلة مَعلمات الصوت الجهير والحاد.

يمكن تطبيق هذه الملفات الشخصية في سياقات مختلفة، بما في ذلك ضبط الملفات الشخصية التلقائية العامة، وملفات البث الشخصية باستخدام MediaCodec، وضبط ملفات التطبيقات الشخصية التلقائية لتطبيقات وسائط معيّنة، وضبط ملفات صور إدخال التلفزيون لإدخالات معيّنة مثل HDMI. يتيح إطار العمل أيضًا تغييرات الحالة (ما يسمح باستخدام مجموعات مختلفة من المَعلمات للحالات مثل النطاق العالي الديناميكية)، ويدير ملفات تعريف الصور النشطة للمعالجة المستمرة، ويتعامل مع ميزات الإضاءة الخلفية المحيطة.

يتعاون فريق Android مع شركائنا في المنظومة المتكاملة لتوفير إطار عمل "جودة الوسائط".

المكونات

يتألف إطار عمل جودة الوسائط من عدة مكوّنات أساسية تعمل معًا على مستوى التطبيق وإطار العمل وطبقات الأجهزة.

• Media Quality Manager (SDK API): هي واجهة برمجة تطبيقات لحزمة تطوير البرامج (SDK) تواجه التطبيق وتسمح للتطبيقات بإدارة ملفات تعريف الصور والصوت.
• خدمة جودة الوسائط: هي خدمة تابعة لنظام التشغيل تحتوي على منطق النشاط التجاري الأساسي، وتدير الملفات الشخصية والأذونات والتواصل مع طبقة تجريد الأجهزة (HAL).
• قاعدة بيانات جودة الوسائط: هي قاعدة بيانات SQLite تخزّن جميع ملفات تعريف الصور والأصوات.
• عقد جودة الوسائط: يحدّد المَعلمات الموحّدة وبُنى البيانات المستخدَمة للتواصل بين التطبيقات والإطار.
• Media Quality HAL: هي طبقة تجريد الأجهزة التي ينفّذها مورّدو نظام SoC للتواصل بشأن تغييرات ملفات تعريف الصور والصوت مع الأجهزة الأساسية.

الميزات

يتوافق "إطار عمل جودة الوسائط" مع مجموعة كبيرة من الميزات لتوفير نظام مرن وفعّال لإدارة جودة الوسائط.

إدارة الملف الشخصي

• الملفات الشخصية التي تديرها التطبيقات: يمكن للتطبيقات إنشاء ملفاتها الشخصية وتعديلها وحذفها لتوفير تجربة مخصّصة.
• الملفات الشخصية التلقائية: يمكن لتطبيقات النظام ضبط ملفات شخصية تلقائية لتطبيقات معيّنة أو مصادر إدخال التلفزيون (مثل HDMI 1).
• الملف التعريفي التلقائي العام: هو ملف تعريفي احتياطي على مستوى النظام يتم تطبيقه عندما لا يتم ضبط أي ملف تعريفي محدّد.

سير العمل العام

توضّح المخططات التالية تسلسلات طلبات البيانات لعمليات جودة الوسائط الشائعة.

إنشاء ملف شخصي للصور وتطبيقه

1. يطلب أحد تطبيقات النظام من setPictureProfileAllowList() منح تطبيق وسائط إذنًا بإنشاء ملفات شخصية.
2. يسجّل تطبيق موسيقى PictureProfileCallback لتلقّي إشعارات بشأن التغييرات في الملف الشخصي.
3. يستدعي تطبيق موسيقى createPictureProfile() باستخدام عنصر PictureProfile.
4. يعالج MediaQualityService الطلب ويحفظ الملف الشخصي في قاعدة البيانات، ثم يرسل إشعارًا إلى التطبيق بشأن نجاح العملية أو فشلها باستخدام دالة الرجوع المسجّلة (onPictureProfileAdded() أو onError()).

ضبط ملف تعريف صورة لكل بث

يوضّح سير العمل هذا كيف يمكن لتطبيق ما تطبيق ملف شخصي معيّن على محتوى الفيديو أثناء تشغيله.

1. يطلب تطبيق الوسائط من MediaQualityManager الحصول على قائمة بملفات تعريف الصور المتاحة.
2. يستخدم التطبيق بعد ذلك MediaCodec.setParameters لاختيار الملف الشخصي المحدّد وضبطه للبث.
3. يُرسِل إطار العمل هذا الخيار إلى طبقة تجريد الأجهزة (HAL) الخاصة بجودة الوسائط (MQ)، مع إرسال معرّف الملف الشخصي ومَعلماته.
4. أخيرًا، يرسل MQ HAL هذه المَعلمات إلى Composer HAL، الذي يعرض بث الفيديو باستخدام ملف تعريف الصورة المحدّد.

ضبط ملف شخصي تلقائي عام

يمكن لتطبيقات النظام فقط ضبط الملف الشخصي التلقائي العام، والذي يعمل كخيار احتياطي لأي محتوى لم يتم تعيين ملف شخصي محدّد له.

1. يسترد تطبيق النظام قائمة بملفات تعريف الصور المتاحة من إطار العمل.
2. يختار التطبيق بعد ذلك أحد هذه الملفات الشخصية ليكون الملف التلقائي العام الجديد من خلال استدعاء setDefaultPictureProfile(id).
3. يرسل إطار العمل مَعلمات الملف الشخصي إلى Media Quality HAL، الذي يطبّق التغييرات بعد ذلك.

Media Quality SDK API

توفّر واجهة برمجة التطبيقات الخاصة بحزمة تطوير البرامج (SDK) لجودة الوسائط الأدوات اللازمة للتطبيقات للتفاعل مع إطار العمل. نقطة الدخول الرئيسية هي حزمة android.media.quality.

android.media.quality

تحتوي هذه الحزمة على الفئات الأساسية لإدارة جودة الوسائط.

MediaQualityManager

تشمل الطرق الرئيسية ما يلي:

عنصر PictureProfile

يحتوي العنصر PictureProfile على جميع المعلومات الخاصة بوضع صورة معيّن.

public final class PictureProfile {
  private String id;
  private int type; // System or Application
  private String name; // e.g., "Movie", "Game"
  private String inputId; // e.g., "HDMI1"
  private String packageName; // e.g., "com.google.android.youtube"
  private PersistableBundle parameters; // Bundle containing all PQ parameters
}

طبقة تجريد الأجهزة (HAL) الخاصة بجودة الوسائط

إنّ Media Quality HAL هي واجهة مستندة إلى AIDL تم تعريفها في hardware/interfaces/tv/mediaquality/aidl/. على مورّدي منظومة على رقاقة (SoC) تنفيذ هذه الواجهة لتفعيل إطار عمل جودة الوسائط على أجهزتهم. تعمل طبقة HAL كجسر للتواصل بين MediaQualityService في إطار عمل Android والأجهزة الأساسية، وهي مسؤولة عن تطبيق تعديلات على الصور والأصوات.

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

الوحدات

تتألف واجهة HAL من عدة ملفات AIDL رئيسية: