הרצת בדיקות של סוג הביצועים של המדיה

חבילת בדיקות התאימות (CTS) של Android כוללת בדיקות של סיווג ביצועים של מדיה למכשירים עם Android מגרסה 11 ואילך. תהליך הבדיקה שונה בין מכשירים עם Android 13 לבין מכשירים עם Android 11 או Android 12, לכן חשוב לפעול לפי ההוראות שמתאימות לגרסת Android שפועלת במכשירים שלכם.

הורדת בדיקות

מורידים את הבדיקות הבאות:

בדיקת מכשירים עם Android מגרסה 14 ואילך

בקטע הזה מפורטים הבדיקות הנדרשות למכשירים עם Android מגרסה 14 ואילך.

הפעלת בדיקות של איכות קידוד הווידאו (VEQ) של קמפיין למיקסום הביצועים מסוג 14 (PC14)

ב-Android 14 נוספו דרישות לגבי איכות קידוד הווידאו (VEQ) למכשירים מסוג Performance Class 14 (PC14). הדרישות של PC14-VEQ מגדירות למעשה דרישת יעד בסיסית לאיכות באופן מדיד עבור מקודדי הווידאו של החומרה במכשיר PC14.

המטרה היא לוודא שכל מכשיר שמריץ Android ומסווג כ-Performance Class 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 קטנה מאפס או שווה לאפס.

בדיקת ה-CTS‏ PC14-VEQ כוללת הגדרות קידוד, כולל:

  • מקודדי חומרה של 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 עבור 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 Section 2.2.7.1) ודרישות המצלמה (CDD Section 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 ב-CDD Section 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 של מערכת הקבצים מאמתות את דרישות הביצועים שמפורטות ב-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

כדי לבדוק מכשירים עם Android בגרסה 11 או 12, קודם צריך להגדיר את מכשירי הבדיקה (ההגדרה שונה בהתאם לגרסת Android ולסוג המכשיר: userdebug או user), ואז להריץ בדיקות CTS ובדיקות אימות CTS.

פרסום של סיווג הביצועים של המדיה

כדי להגדיר מכשירי בדיקה להצגת מודעות עם סיווג הביצועים הנכון באמצעות מאפיין המערכת ro.odm.build.media_performance_class:

  • לגבי מחלקת ביצועים 12 (PC12), מגדירים את ערך המאפיין ל-31.

  • לגבי סיווג ביצועים 11 (PC11), מגדירים את ערך המאפיין ל-30.

מכשירים מסוג Userdebug

כדי להגדיר מכשירי Android userdebug:

  • מכשירי 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] הוספת נכס של סיווג ביצועים של מדיה אל sepolicy.

  2. הגדרה של MANAGE_EXTERNAL_STORAGE עבור com.android.cts.verifier:

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

הרצת בדיקות CTS ו-ITS

מבצעים Build של CTS ושל CTS Verifier עם התיקונים שהורדו, ואז מריצים את הגרסה המתאימה של Android למכשירי הבדיקה (Android 11 CTS למכשירי Android 11, ‏ Android 12 CTS למכשירי 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