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

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

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

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

اختبار أجهزة Android 14 أو الإصدارات الأحدث

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

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

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

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

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

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

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

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

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

اختبار أجهزة Android 13 أو الإصدارات الأحدث

قبل بدء تشغيل الاختبار، عليك إعداد الأجهزة للاختبار باتّباع الخطوات التالية:

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

  2. تأكَّد من أنّ صورة نظام الجهاز هي Android 13 أو إصدار أحدث. على الرغم من أنّه يمكنك إجراء اختبارات Media CTS على صورة نظام Android 11 أو الإصدارات الأحدث، تتطلّب اختبارات Camera 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 من مستند 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

تشغيل اختبارات CTS الخاصة بـ MediaDrm

تتحقّق اختبارات MediaDrm CTS من متطلبات 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 أو user)، ثم تشغيل اختبارات "مجموعة أدوات اختبار التوافق" (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، أضِف السمة ro.odm.build.media_performance_class مع قيمة فئة الأداء المحدّدة إلى الملف product.prop:

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

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

  1. اختَر التعديل [1627181] إضافة سمة فئة أداء الوسائط إلى 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 Verifier مع تطبيق التصحيحات التي تم تنزيلها، ثم شغِّل إصدار Android المناسب لأجهزتك الاختبارية (مجموعة أدوات اختبار التوافق لنظام التشغيل Android 11 لأجهزة Android 11، ومجموعة أدوات اختبار التوافق لنظام التشغيل 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