אפליקציות מדיה שיוצרות אינטראקציה קולית עם Google Assistant בטלפונים עם Android, מכוניות, טלוויזיות ואוזניות מופעלות באמצעות ממשקי API להפעלת מדיה ב-Android ומשתמשות בפעולות מדיה. לפעמים קשה לעקוב אחרי מחזור החיים של הפעולה במדיה. אפילו הפעלה פשוטה מהחיפוש הבקשה כוללת שלבי ביניים רבים שבהם משהו עלול להשתבש, כפי שמוצג את ציר הזמן הפשוט:
בדיקת בקרי המדיה (MCT) האפליקציה מאפשרת לבדוק את המורכבות של הפעלת מדיה ב-Android ועוזרת אימות ההטמעה של סשן המדיה.
ב-MCT מוצג מידע על MediaController
של האפליקציה, למשל
PlaybackState
ומטא-נתונים, וניתן להשתמש בהם כדי לבדוק פקדי מדיה בתוך אפליקציות.
MCT כולל גם בדיקות אימות
framework
מאפשר לבצע אוטומציה של בדיקות בקרת האיכות.
כדי להשתמש ב-MCT, לאפליקציה שלך חייב להיות שירות של דפדפן מדיה וצריך לאפשר ל-MCT להתחבר אליו. צפייה יצירת שירות לדפדפן מדיה אפשר לקבל מידע נוסף.
הפעלת MCT
![דף ההשקה של MCT](https://developer.android.com/static/media/images/MCT/MCT-Launch-Screen.png?authuser=2&hl=he)
כשתפעילו את MCT, יוצגו שתי רשימות:
- Active MediaSessions – הרשימה הזו תהיה ריקה בהתחלה כשמפעילים את ה-MCT ותוצג ההודעה "לא נמצאו אפליקציות מדיה. הודעה נדרשת הרשאת האזנה כדי לסרוק סשנים פעילים של מדיה. לוחצים על הגדרות כדי עוברים למסך ההרשאות ומפעילים את ההרשאה ל-MCT.
- הטמעות MediaBrowserService – ברשימה הזו מוצגות אפליקציות שהטמיעו שירות של דפדפן מדיה. אם הטמעת שירות של דפדפן מדיה, האפליקציה שלך תופיע ברשימה הזו, אבל אפשר להשתמש ב-MCT רק אם הגדרת באפליקציה לקבל את כל הפריטים או הוסיפה את ה-MCT לרשימת ההיתרים. למידע נוסף, ראו שליטה בחיבורי לקוחות באמצעות onGetRoot() אפשר לקבל מידע נוסף.
בדיקה ידנית של אפליקציה לטלפון
אם אישרת ל-MCT להתחבר לשירות דפדפן המדיה של האפליקציה, האפליקציה שלך מופיע ברשימת ההטמעות של רשימת השירותים של דפדפן המדיה. חיפוש שם ולוחצים על Control כדי להפעיל את האפליקציה ברקע.
אם לא, תחילה עליך להפעיל את האפליקציה בעצמך ברקע ולאחר מכן ללחוץ על קובעים מתי הוא יופיע ברשימת הסשנים הפעילים של המדיה.
בדיקה של הכנה ומשחק
כש-MCT יתחיל לשלוט באפליקציה, יוצג הסשן הנוכחי של האפליקציה מטא-נתונים: המדיה שנבחרה והפעולות שהסשן ממלא מוכן לטיפול.
![דף הבקרה](https://developer.android.com/static/media/images/MCT/audio-focus.png?authuser=2&hl=he)
בחלק העליון של הדף 'אמצעי בקרה של MCT' יש תפריט נפתח שבו אפשר לבחור חיפוש, URI, מזהה מדיה או ללא, יחד עם שדה טקסט כדי לציין את נתוני הקלט שמשויכים למזהה החיפוש, ל-URI או למזהה המדיה, בוחרים אחת מהאפשרויות האלה.
הלחצנים הכנה והפעלה שמתחת לשדה הטקסט מבצעים את
קריאות מתאימות (onPrepare()
, onPrepareFromSearch()
, onPrepareFromUri()
,
onPrepareFromMediaId()
, onPlay()
, onPlayFromSearch()
, onPlayFromUri()
,
onPlayFromMediaId()
), בהתאם לפעולה שבחרתם.
מתבצעת בדיקה של מיקוד אודיו
אפליקציית מדיה שמתנהלת בצורה תקינה צריכה להיות מסוגלת לטפל באודיו מיקוד. אפשר לבדוק את מיקוד האודיו באמצעות שמפעילה אפליקציית אודיו נוספת לצד האפליקציה שלכם. דף אמצעי הבקרה של MCT כולל לחצן שמבקש ומשחרר את מיקוד האודיו.
כדי לבדוק את מיקוד האודיו, פועלים לפי השלבים הבאים:
- משתמשים בתפריט הנפתח מיקוד אודיו כדי לבחור אחד משלושת הרמזים של משך הזמן.
AUDIOFOCUS_GAIN
,AUDIOFOCUS_GAIN_TRANSIENT
אוAUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK
. - כדי לבקש מיקוד, לוחצים על הלחצן.
- כדי לשחרר את המיקוד, לוחצים שוב על הלחצן.
בדיקה של אמצעי בקרת התנועה
![בדיקה של אמצעי הבקרה לתחבורה](https://developer.android.com/static/media/images/MCT/MCT-Controller-Screen.png?authuser=2&hl=he)
מחליקים שמאלה כדי לראות את תצוגת ממשק המשתמש של MCT. התצוגה הזו כולל את לחצני ההעברה הרגילים של בקר המדיה ומציג את את התמונה והנתונים של התוכנה. לחצני העברה מושבתים מוקפים בעיגול של כתום. כל השאר פעילים.
בודקים את הנגן באמצעות לחצני ההעברה. המצב של לחצני ההעברה אמור להשתנות כמצופה. לדוגמה, כשלוחצים על הלחצן 'הפעלה' תושבת, והלחצנים 'השהיה' ו'עצירה' יהיו מופעלים.
כדי לצפות בפעולות אופציונליות, מחליקים שוב ימינה. כל פעולה כולל אמצעי בקרה שמראה אם הוא פעיל או לא. אם הוא פעיל, תוכל לבצע את הפעולה באמצעות לחיצה עליו.
אם התחברתם לרשימת האפליקציות שיש בהן שירות של דפדפן מדיה, תוכלו: מחליקים שמאלה עוד פעמיים כדי לראות תצוגות שמאפשרות לעבור מעלה ומטה אל התוכן של האפליקציה ההיררכיה, או חיפוש בעץ התוכן.
בדיקה ידנית של אפליקציית וידאו
השתמשו במצב מסך מפוצל כדי לבדוק בקרים של אפליקציות וידאו. קודם כול, פותחים את אפליקציית הווידאו בחלון אחד, ואז פותחים את MCT במצב מסך מפוצל.
מתבצעות בדיקות אימות
מסגרת הבדיקות של האימות מציעה בדיקות בלחיצה אחת שאפשר להריץ לוודא שאפליקציית המדיה מגיבה כראוי לבקשת הפעלה.
בדיקה של אפליקציה לטלפון
![לחצן הבדיקה](https://developer.android.com/static/media/images/MCT/MCT-Test-Button.png?authuser=2&hl=he)
כדי לגשת לבדיקות האימות, לוחצים על הלחצן בדיקה לצד המדיה אפליקציה.
מצב MCT
![מצב בקרת המדיה](https://developer.android.com/static/media/images/MCT/MCT-Testing-Info-Screen.png?authuser=2&hl=he)
בתצוגה הבאה מופיע מידע מפורט על MediaController
של MCT
לדוגמה PlaybackState
, מטא-נתונים ותור. יש שני לחצנים מופעלים
בפינה השמאלית העליונה של סרגל הכלים. הלחצן שבצד ימין עובר בין פריטים ניתנים לניתוח
ביומנים בפורמט הנכון. הלחצן בצד ימין מרענן את התצוגה כדי להציג את
המידע העדכני ביותר.
בחירת הבדיקה
![הדף 'בחירת בדיקה'](https://developer.android.com/static/media/images/MCT/MCT-Testing-Verification-Screen.png?authuser=2&hl=he)
בהחלקה ימינה מגיעים לתצוגה של בדיקות האימות, שבה אפשר רשימה של הבדיקות הזמינות שאפשר לגלול. אם בדיקה משתמשת בשאילתה, כמו מבדיקת החיפוש שמוצגת באיור 7, שדה טקסט להזנת מחרוזת השאילתה.
MCT כולל בדיקות של פעולות המדיה הבאות, ובדיקות נוספות נוסף באופן רציף לפרויקט:
- הפעלה
- הפעלה מחיפוש
- הפעלה ממזהה מדיה
- הפעלה מ-URI
- השהיה
- עצירה
- דילוג אל הלחצן הבא
- דילוג אל הקודם
- דילוג לפריט בתור
- דילוג אל
תוצאות בדיקה
![תוצאת בדיקה מוצלחת](https://developer.android.com/static/media/images/MCT/MCT-Testing-Success-Screen.png?authuser=2&hl=he)
אזור התוצאות בתחתית התצוגה יהיה ריק בהתחלה. יוצג תוצאות בזמן הרצת בדיקה. לדוגמה, כדי להריץ את ההפעלה מבדיקת החיפוש, מזינים שאילתת חיפוש בשדה הטקסט ולוחצים על הרצת בדיקה. הבאים צילום המסך מראה תוצאת בדיקה מוצלחת.
בדיקה של אפליקציה ל-Android TV
כשמפעילים את MCT ב-Android TV, מופיעה רשימה של אפליקציות מדיה מותקנות. לתשומת ליבך: אפליקציה תופיע ברשימה הזו רק אם מוטמע בה דפדפן מדיה לאחר השיפור.
בחירת אפליקציה תעביר אותך למסך הבדיקה. במסך הזה תוצג רשימה של בדיקות האימות בצד שמאל.
כשמבצעים בדיקה, בצד ימין של המסך מוצג מידע על נבחר MediaController. פרטים נוספים זמינים ביומני MCT ב-Logcat.
בדיקות שמחייבות שאילתה מסומנות בסמל מקלדת. לחיצה על אחד מ- בבדיקות האלה נפתח שדה להזנת השאילתה. לוחצים על Enter כדי להריץ את הבדיקה.
כדי להקל על הזנת הטקסט, אפשר להשתמש גם בפקודה adb
:
adb shell input text your-query
אפשר להשתמש ב-"%s" כדי להוסיף רווח בין מילים. לדוגמה, הפקודה מוסיפה את הטקסט "hello world" לשדה להזנת הקלט.
adb shell input text hello%sworld
בניית בדיקה
אתם יכולים לשלוח בקשת משיכה עם עוד בדיקות שלדעתכם יהיו שימושיות. כדי ללמוד כיצד לבנות בדיקות חדשות, אפשר להיכנס אל Wiki של MCT GitHub ולראות את בדיקת אימות הוראות להתאמה אישית.
מומלץ לעיין בהוראות להוספת תוכן.
מקורות מידע נוספים
ה-MCT מיועד לשימוש בשילוב עם אפליקציות שמטמיעות ממשקי API של מדיה. לצפייה נגן מוזיקה אוניברסלי ל-Android דוגמה לאפליקציה כזו.
תיקוני באגים ושיפורים תמיד מתקבלים בברכה. כדאי לעיין הוראות להוספת תוכן.