إجراء اختبارات فئة أداء الوسائط

تتضمّن مجموعة أدوات اختبار التوافق (CTS) على Android اختبارات فئة أداء الوسائط للأجهزة التي تعمل بنظام التشغيل Android 11 أو إصدار أحدث. بما أنّ عملية الاختبار تختلف بين الأجهزة التي تعمل بنظام التشغيل Android 13 والأجهزة التي تعمل بنظام التشغيل Android 11 أو Android 12، احرص على اتّباع التعليمات الخاصة بإصدار Android الذي يعمل على أجهزتك.

تنزيل الاختبارات

نزِّل الاختبارات التالية:

اختبار الأجهزة التي تعمل بنظام التشغيل Android 14 أو إصدار أحدث

اختبار الأجهزة التي تعمل بنظام التشغيل Android 14 أو إصدار أحدث

يحدّد هذا القسم الاختبارات المطلوبة للأجهزة التي تعمل بنظام التشغيل Android 14 أو إصدار أحدث. 14 أو إصدار أحدث.

إجراء اختبارات جودة ترميز الفيديو (VEQ) لفئة الأداء 14 (PC14)

يقدّم Android 14 متطلبات جودة ترميز الفيديو (VEQ) لأجهزة فئة الأداء 14 (PC14). تحدّد متطلبات PC14-VEQ بشكل أساسي متطلبًا أساسيًا لجودة قابلة للقياس لبرامج ترميز الفيديو على الأجهزة (HW) في جهاز PC14.

الهدف هو التأكّد من أنّ كل جهاز يعمل بنظام التشغيل Android ومصنّف ضمن فئة الأداء 14 يقدّم تجربة وسائط ممتازة للمستخدمين النهائيين من خلال إنشاء محتوى فيديو عالي الجودة.

يتم التحقّق من متطلبات PC14-VEQ من خلال اختبار جديد في مجموعة اختبار التوافق (CTS) يُسمى CtsVideoEncodingQualityHostTest.

يُجري اختبار مجموعة اختبار التوافق (CTS) هذا مجموعة من حالات اختبار الترميز المحدّدة من خلال ملفات JSON للإعدادات ، ويستخدِم واجهة برمجة التطبيقات Jetpack Media3 Transformer. لكل حالة اختبار، يتم إنشاء منحنى معدّل التشويش (RD) لبرنامج الترميز الذي يتم اختباره من خلال ترميز دفق بت باستخدام إعدادات برنامج الترميز من ملف JSON. يتم تضمين منحنى معدّل التشويش المرجعي في ملف JSON نفسه. يتم استخدام Video Multimethod Assessment Fusion (VMAF) vmaf_v0.6.1.json لحساب التشويش (أي فقدان الجودة).

لا يمكن أن تجتاز حالة الاختبار إلا إذا كانت نتيجة BDRATE-VMAF أقل من صفر أو تساوي صفرًا.

يغطّي اختبار PC14-VEQ في مجموعة اختبار التوافق (CTS) إعدادات الترميز، بما في ذلك ما يلي:

  • برامج ترميز AVC وHEVC على الأجهزة (HW)
  • وضع التحكّم في المعدّل VBR
  • ترميز الإطارات P/الإطارات B
  • ‫1920×1080p30 إطارًا في الثانية (وضع أفقي) أو 1080×1920p30 إطارًا في الثانية (وضع عمودي)

اختبار الأجهزة التي تعمل بنظام التشغيل Android 13 أو إصدار أحدث

اختبار الأجهزة التي تعمل بنظام التشغيل Android 13 أو إصدار أحدث

قبل بدء عملية الاختبار، عليك إعداد الأجهزة للاختبار:

  1. اضبط الجهاز للإعلان عن فئة أداء الوسائط 13 (PC13) من خلال ضبط قيمة سمة النظام _ro.odm.build.media_performance_class على 33.

  2. تأكَّد من أنّ صورة نظام الجهاز هي Android 13 أو

  3. تأكَّد من أنّ صورة نظام الجهاز هي Android 13 أو إصدار أحدث. على الرغم من أنّه يمكنك إجراء اختبارات الوسائط في مجموعة اختبار التوافق (CTS) على صورة نظام Android 11 أو إصدار أحدث، تتطلّب اختبارات الكاميرا في مجموعة اختبار التوافق (CTS) صورة نظام Android 13، وتتطلّب اختبارات الكاميرا في مجموعة اختبار التوافق (CTS) ميزات Android 13 لفئة الأداء 13.

إجراء اختبارات نظام اختبار الكاميرا (ITS)

لإجراء اختبارات نظام اختبار الكاميرا (ITS) فقط، عليك أولاً ضبط الأرقام التسلسلية للجهاز والجهاز اللوحي في config.yml. بعد الإعداد، يمكنك إجراء اختبارات للكاميرات الأمامية والخلفية:

python tools/run_all_tests.py camera=[PRIMARY_REAR_CAMERA_ID] scenes=2_c
python tools/run_all_tests.py camera=[PRIMARY_FRONT_CAMERA_ID] scenes=2_c

إجراء اختبارات فئة أداء الوسائط

تتحقّق خطة اختبار cts-media-performance-class من متطلبات مستند تعريف التوافق (CDD) لفئة أداء الوسائط (القسم 2.2.7.1 من مستند تعريف التوافق) ومتطلبات الكاميرا (القسم 2.2.7.2 من مستند تعريف التوافق). أجرِ اختبار cts-media-performance-class:

cts-tradefed run cts-media-performance-class

لإجراء اختبارات الكاميرا فقط في مجموعة اختبار التوافق (CTS):

cts-tradefed run singleCommand cts --disable-reboot -m CtsCameraTestCases -t android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#testCameraPerfClassCharacteristics

لإجراء اختبارات الوسائط فقط في مجموعة اختبار التوافق (CTS):

cts-tradefed run singleCommand cts --disable-reboot -m CtsMediaPerformanceClassTestCases

إجراء اختبارات MediaDrm في مجموعة اختبار التوافق (CTS)

تتحقّق اختبارات MediaDrm في مجموعة اختبار التوافق (CTS) من متطلبات MediaDrm في القسم 2.2.7.1 من مستند تعريف التوافق. أجرِ اختبارات MediaDrm في مجموعة اختبار التوافق (CTS):

cts-tradefed run singleCommand cts --disable-reboot -c android.mediapc.cts.PerformanceClassTest -m testSecureHwDecodeSupport
cts-tradefed run singleCommand cts --disable-reboot -c android.mediapc.cts.PerformanceClassTest -m testMediaDrmSecurityLevelHwSecureAll

إجراء اختبارات نظام الملفات في مجموعة اختبار التوافق (CTS)

تتحقّق اختبارات نظام الملفات في مجموعة اختبار التوافق (CTS) من متطلبات الأداء في القسم 2.2.7.4 من مستند تعريف التوافق.

  • لاختبار متطلبات القراءة والكتابة المتسلسلة:

    cts-tradefed run singleCommand cts --disable-reboot -m CtsFileSystemTestCases -t android.filesystem.cts.SequentialRWTest

  • لاختبار متطلبات القراءة والكتابة العشوائية:

    cts-tradefed run singleCommand cts --disable-reboot -m CtsFileSystemTestCases -t android.filesystem.cts.RandomRWTest

اختبار الأجهزة التي تعمل بنظام التشغيل Android 11 أو 12

لاختبار الأجهزة التي تعمل بنظام التشغيل Android 11 أو 12، عليك أولاً إعداد أجهزة الاختبار (يختلف الإعداد بين إصدار Android وأجهزة userdebug وأجهزة المستخدمين)، ثم إجراء اختبارات مجموعة اختبار التوافق (CTS) وأداة التحقّق من مجموعة اختبار التوافق (CTS).

الإعلان عن فئة أداء الوسائط

اتّبِع الخطوات التالية لإعداد أجهزة الاختبار للإعلان عن فئة الأداء الصحيحة باستخدام سمة النظام ro.odm.build.media_performance_class:

  • بالنسبة إلى فئة الأداء 12 (PC12)، اضبط قيمة السمة على 31.

  • بالنسبة إلى فئة الأداء 11 (PC11)، اضبط قيمة السمة على 30.

أجهزة userdebug

لإعداد أجهزة userdebug على Android:

  • أجهزة userdebug على Android 12:

    adb root
adb shell setprop ro.odm.build.media_performance_class 31   // use 30 for PC11
adb shell stop && sleep 1 && adb shell start
adb shell pkill -f camera

  • أجهزة userdebug على Android 11:

    adb root
adb shell setenforce 0
adb shell setprop ro.odm.build.media_performance_class 31   // use 30 for PC11
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0

يمكنك ضبط سمة النظام ro.odm.build.media_performance_class مرة واحدة فقط لكل عملية إعادة تشغيل (ولكن ليس عليك إعادة تشغيل الجهاز قبل ضبطها للمرة الأولى).

أجهزة المستخدمين

لإعداد أجهزة المستخدمين على Android، أضِف السمة ro.odm.build.media_performance_class مع قيمة فئة الأداء المحدّدة إلى ملف product.prop:

ro.odm.build.media_performance_class=31   // use 30 for PC11

بالنسبة إلى أجهزة المستخدمين التي تعمل بنظام التشغيل Android 11، اتّبِع الخطوات الإضافية التالية:

  1. اختَر التصحيح [1627181] Add media performance class property to sepolicy.

  2. اضبط MANAGE_EXTERNAL_STORAGE لـ com.android.cts.verifier:

    adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0

إجراء اختبارات مجموعة اختبار التوافق (CTS) ونظام اختبار الكاميرا (ITS)

أنشئ مجموعة اختبار التوافق (CTS) وأداة التحقّق من مجموعة اختبار التوافق (CTS) مع تطبيق التصحيحات التي تم تنزيلها، ثم شغِّل إصدار Android المناسب لأجهزة الاختبار (مجموعة اختبار التوافق (CTS) على Android 11 للأجهزة التي تعمل بنظام التشغيل Android 11، ومجموعة اختبار التوافق (CTS) على Android 12 للأجهزة التي تعمل بنظام التشغيل Android 12).

الوسائط

لإجراء اختبارات الوسائط في مجموعة اختبار التوافق (CTS):

cts-tradefed run singleCommand cts --disable-reboot -m CtsMediaPerformanceClassTestCases

الكاميرا

لإجراء اختبارات الكاميرا في مجموعة اختبار التوافق (CTS):

cts-tradefed run singleCommand cts --disable-reboot -m CtsCameraTestCases -t android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#testCameraPerfClassCharacteristics
python tools/run_all_tests.py device=DEVICE camera=PRIMARY_CAMERA_ID chart=CHART_ID scenes=2_c

بالنسبة إلى الأجهزة التي تعمل بنظام التشغيل Android 12:

cts-tradefed run singleCommand cts --disable-reboot -m CtsCameraApi31TestCases

الأجهزة

لإجراء اختبارات الأجهزة في مجموعة اختبار التوافق (CTS):

cts-tradefed run singleCommand cts --disable-reboot -m CtsFileSystemTestCases -t android.filesystem.cts.RandomRWTest
cts-tradefed run singleCommand cts --disable-reboot -m CtsFileSystemTestCases -t android.filesystem.cts.SequentialRWTest