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

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

הורדת בדיקות

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

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

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

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

המטרה היא להבטיח שכל מכשיר Android שמוקצה לקבוצה 'רמת ביצועים 14' יספק למשתמשי הקצה חוויית מדיה ברמה גבוהה על ידי יצירת תוכן וידאו באיכות גבוהה.

הדרישות PC14-VEQ מאומתות באמצעות בדיקת CTS חדשה שנקראת CtsVideoEncodingQualityHostTest

בבדיקה הזו של CTS פועלת קבוצה של תרחישי בדיקה לקידוד שמוגדרים על ידי קובצי ה-JSON של התצורה. לכל מקרה בדיקה, המערכת יוצרת את עקומת קצב-העיוות (RD) של המקודד שנבדק על ידי קידוד של מקור נתונים (bitstream) באמצעות הגדרות המקודד מקובץ ה-JSON. עקומת ההמרה של קצב-עיוות נכללת באותו קובץ JSON. The 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 ואילך, אבל כדי להריץ בדיקות 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

הרצת בדיקות CTS של MediaDrm

בדיקות CTS של MediaDrm מאמתות את הדרישות של MediaDrm ב-CDD קטע 2.2.7.1. מריצים את בדיקות CTS של MediaDrm באמצעות הפקודות הבאות:

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 לעומת מכשירי משתמשים), ואז להריץ את בדיקות CTS ובדיקות CTS verifier.

פרסום של הכיתה 'ביצועי מדיה'

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

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

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

מכשירים לניפוי באגים אצל משתמשים

כדי להגדיר מכשירים לניפוי באגים של משתמשים ב-Android, מריצים את הפקודות הבאות:

  • מכשירים לניפוי באגים אצל משתמשים ב-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:

    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 עם ערך סיווג הביצועים הרצוי לקובץ product.prop. כך אפשר לראות דוגמה:

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

במכשירים עם Android 11, מבצעים את השלבים הנוספים הבאים:

  1. בחר בקפידה את [1627181] הוספת הנכס לסיווג ביצועי מדיה אל Sepolicy תיקון.

  2. מריצים את הפקודה הבאה:

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

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

יוצרים את 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