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

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

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

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

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

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

يقدّم الإصدار 14 من نظام التشغيل Android متطلبات جودة ترميز الفيديو (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
  • ‫‎1920×1080p30fps (أفقي) أو ‎1080×1920p30fps (عمودي)

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

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

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

  2. تأكَّد من أنّ صورة نظام الجهاز هي Android 13 أو إصدار أحدث. على الرغم من أنّه يمكنك إجراء اختبارات مجموعة أدوات اختبار التوافق (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 لملفه الشخصي متطلبات فئة أداء الوسائط (CDD القسم 2.2.7.1) ومتطلبات الكاميرا (CDD القسم 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

تتحقّق اختبارات 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 لنظام الملفات من متطلبات الأداء الواردة في CDD الفقرة 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

لاختبار الأجهزة التي تعمل بالإصدار 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 التي تعمل بوضع userdebug:

    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