תמיכה בפעולות קוליות

כדי לשפר את הבטיחות והנוחות של הנהגים ולצמצם את הסחות הדעת, כדאי לשלב פעולות קוליות באפליקציית המדיה. כשמערכת Android Auto או Android Automotive OS ‏ (AAOS) מזהה ומפרשת פעולה קולית, היא מעבירה את הפעולה לאפליקציה באמצעות הקריאה החוזרת onPlayFromSearch.

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

אם האפליקציה שלכם מפעילה פריט מדיה אחד, המשתמש יכול להגיד "הפעלת [שם השיר]" כדי להנחות את האפליקציה להפעיל שיר אחר בלי להסתכל על המסך של הרכב או לגעת בו. המשתמשים יכולים להפעיל שאילתות בלחיצה על הלחצנים המתאימים בהגה או באמירת מילות ההפעלה "Ok Google".

הנחיות עיצוב: מידע נוסף זמין במאמר בנושא יצירת אפליקציות.

כשמערכת Android Auto או AAOS מזהה ומפרשת פעולה קולית, היא מעבירה את הפעולה הקולית לאפליקציה דרך onPlayFromSearch. כשמתקבלת קריאה חוזרת (callback) כזו, האפליקציה מוצאת תוכן שתואם למחרוזת query ואז מתחילה בהפעלה.

המשתמשים יכולים לציין בשאילתה שלהם קטגוריות שונות של מונחים: ז'אנר, אומן, אלבום, שם שיר, תחנת רדיו או פלייליסט, ועוד. כשמפתחים תמיכה בחיפוש, צריך להתייחס לכל הקטגוריות שרלוונטיות לאפליקציה. אם מערכת Android Auto או AAOS מזהה ששאילתה מסוימת מתאימה לקטגוריה ספציפית, היא מוסיפה פרמטרים נוספים בפרמטר extras. אפשר לשלוח את התוספים הבאים:

• EXTRA_MEDIA_ALBUM
• EXTRA_MEDIA_ARTIST
• EXTRA_MEDIA_GENRE
• EXTRA_MEDIA_PLAYLIST
• EXTRA_MEDIA_TITLE

צריך להביא בחשבון מחרוזת ריקה query, שיכולה להישלח על ידי Android Auto או AAOS אם המשתמש לא מציין מונחי חיפוש. לדוגמה, אם המשתמש אומר ‫"Play some music". במקרה כזה, האפליקציה יכולה להתחיל להשמיע טראק חדש או טראק שהושמע לאחרונה.

אם האפליקציה לא יכולה לעבד חיפוש במהירות, אל תחסמו ב-onPlayFromSearch. במקום זאת, מגדירים את מצב ההפעלה ל-STATE_CONNECTING ומבצעים את החיפוש בשרשור אסינכרוני.

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

בנוסף לשאילתות מסוג 'הפעלה', מערכות Android Auto ו-AAOS מזהות שאילתות קוליות לשליטה בהפעלה, כמו 'השהיית המוזיקה' ו'השיר הבא', ומתאימות את הפקודות האלה לקריאות חוזרות (callback) מתאימות של סשן המדיה, כמו onPause ו-onSkipToNext.

מידע נוסף על הטמעה של פעולות הפעלה באמצעות קול זמין במאמר בנושא Google Assistant ואפליקציות מדיה.