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

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

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

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

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

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

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

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

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

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

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

يشمل اختبار CTS الخاص بـ PC14-VEQ إعدادات الترميز، بما في ذلك ما يلي:

  • برامج ترميز AVC وHEVC للأجهزة
  • وضع التحكّم في معدّل نقل البيانات بمعدل متغيّر
  • ترميز الإطارات P/B
  • 1920x1080p30fps (أفقي) أو 1080x1920p30fps (عمودي)

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

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

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

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

إجراء اختبارات 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 من "CDD") ومتطلبات الكاميرا (الفقرة 2.2.7.2 من CDD. شغِّل خطة اختبار 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

تتحقّق اختبارات CTS الخاصة بـ MediaDrm من متطلبات MediaDrm في القسم 2.2.7.1 من CDD. يمكنك تنفيذ اختبارات 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 من CDD.

  • لاختبار متطلبات القراءة والكتابة التسلسلية، استخدِم الأمر التالي:

    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

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

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

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

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

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

أجهزة 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

  • أجهزة Android 11 التي تعمل بوضع userdebug:

    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 userdebug، أضِف سمة ro.odm.build.media_performance_class التي تحتوي على قيمة class المطلوبة للأداء إلى ملف product.prop. في ما يلي مثال:

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

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

  1. اختَر [1627181] إضافة سمة فئة أداء الوسائط إلى sepolicy patch.

  2. نفِّذ الأمر التالي:

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

إجراء اختبارات CTS وITS

أنشئ حِزم CTS وCTS Verifier مع تطبيق التعديلات التي تم تنزيلها، ثم شغِّل الإصدار المناسب من 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