אופטימיזציה למסכים חכמים

מסכים חכמים הם מכשירים עם פונקציונליות מגע שמאפשרת לאפליקציות של מקלטי אינטרנט לתמוך בפקדים עם מגע במגע. ה-SDK של מקלט האינטרנט מספק חוויית משתמש ברירת מחדל עם התאמה אישית נוספת של פקדי הנגן.

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

הערה: ההתאמה האישית הזו דורשת את השימוש ברכיב המובנה של ממשק המשתמש של cast-media-player. צריך לבצע מעקב ידני אחרי מצב ממשק המשתמש, המיתוג וכל התאמה אישית אחרת אם לא משתמשים ברכיב הזה.

גישה לפקדי ממשק המשתמש

ניתן לגשת לאובייקט של ממשק המשתמש עם הקוד הבא:

const controls = cast.framework.ui.Controls.getInstance();

אם לא משתמשים ברכיב cast-media-player, צריך להגדיר את המאפיין touchScreenOptimizedApp ל-true ב-UiConfig בקטע CastReceiverOptions.

context.start({
  uiConfig: {
    touchScreenOptimizedApp: true
  }
});

ממשק המשתמש לווידאו המוגדר כברירת מחדל

לחצני ברירת המחדל מוקצים לכל משבצת, על סמך MetadataType ו-MediaStatus.supportedMediaCommands.

MetadataType.Movie, MetadataType.Generic

א. --playback-logo-image

ב. MovieMediaMetadata.subtitle או GenericMediaMetadata.subtitle.

ג. MovieMediaMetadata.title או GenericMediaMetadata.title.

ד. MediaStatus.currentTime

ה. MediaInformation.duration

ו. ControlsSlot.SLOT_SECONDARY_1

ז. ControlsSlot.SLOT_PRIMARY_1

H. הפעלה/השהיה

א. ControlsSlot.SLOT_PRIMARY_2

י. ControlsSlot.SLOT_SECONDARY_2

כשהערך של supportedMediaCommands שווה ל-ALL_BASIC_MEDIA, פריסת ברירת המחדל של הבקרה תוצג כך:

כשהערך של supportedMediaCommands שווה ל-ALL_BASIC_MEDIA | QUEUE_PREV | QUEUE_NEXT, פריסת ברירת המחדל של הבקרה תוצג כך:

כאשר הערך של supportedMediaCommands שווה ל-PAUSE | QUEUE_PREV | QUEUE_NEXT, פריסת ברירת המחדל של הבקרה תופיע כך:

כשרצועות טקסט זמינות, לחצן הכתוביות מוצג תמיד בכתובת SLOT_SECONDARY_1.

כדי לשנות באופן דינמי את הערך של supportedMediaCommands אחרי שמתחילים הקשר של מקבל, אפשר לקרוא לפונקציה PlayerManager.setSupportedMediaCommands כדי לבטל את הערך. בנוסף, אתם יכולים להוסיף פקודה חדשה באמצעות addSupportedMediaCommands, או להסיר את הפקודה הקיימת באמצעות removeSupportedMediaCommands.

ממשק ברירת המחדל של האודיו

סוג מטא נתונים.Music_TRACK

א. --playback-logo-image

ב. MusicTrackMediaMetadata.albumName

ג. MusicTrackMediaMetadata.title

ד. MusicTrackMediaMetadata.albumArtist, MusicTrackMediaMetadata.artist או MusicTrackMediaMetadata.composer

ה. MusicTrackMediaMetadata.images[0]

ו. MediaStatus.currentTime

ז. MediaInformation.duration

ח. ControlsSlot.SLOT_SECONDARY_1

א. ControlsSlot.SLOT_PRIMARY_1

י. הפעלה/השהיה

מ. ControlsSlot.SLOT_PRIMARY_2

ל. ControlsSlot.SLOT_SECONDARY_2

כאשר הערך של supportedMediaCommands שווה ל-ALL_BASIC_MEDIA, פריסת ברירת המחדל של הבקרה תוצג כך:

כאשר הערך של supportedMediaCommands שווה ל-ALL_BASIC_MEDIA | QUEUE_PREV | QUEUE_NEXT, פריסת ברירת המחדל של הבקרה תופיע כך:

כדי לשנות באופן דינמי את הערך של supportedMediaCommands אחרי שמתחילים הקשר של מקלט אינטרנט, אפשר לקרוא לפונקציה PlayerManager.setSupportedMediaCommands כדי לבטל את הערך. בנוסף, אתם יכולים להוסיף פקודות חדשות באמצעות addSupportedMediaCommands, או להסיר את הפקודות הקיימות באמצעות removeSupportedMediaCommands.

התאמה אישית של פריסת הלחצן לשליטה בממשק המשתמש

שימוש בפריסה מותאמת אישית כדי לשנות לחצנים בפקדי ממשק המשתמש.

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

const controls = cast.framework.ui.Controls.getInstance();
controls.clearDefaultSlotAssignments();

לאחר מכן, אפשר להקצות לחצני בקרה ל-4 מקומות על ידי התקשרות ל-assignButton.

controls.assignButton(
  cast.framework.ui.ControlsSlot.SLOT_SECONDARY_1,
  cast.framework.ui.ControlsButton.LIKE
)

controls.assignButton(
  cast.framework.ui.ControlsSlot.SLOT_SECONDARY_2,
  cast.framework.ui.ControlsButton.DISLIKE
)

בנוסף, הפריסה המותאמת אישית תוצג כך:

כשהלחצן שהוקצה לא נתמך ב-MediaStatus.supportedMediaCommands, הלחצן יוצג באפור. לדוגמה, אם הערך supportedMediaCommands הוא ALL_BASIC_MEDIA | QUEUE_NEXT | LIKE | DISLIKE, הלחצן QUEUE_PREV מושבת.

כדי לשנות באופן דינמי את הערך של supportedMediaCommands אחרי הפעלת הקשר של מקלט אינטרנט, אפשר לקרוא ל-PlayerManager.setSupportedMediaCommands כדי לעקוף את הערך. בנוסף, אתם יכולים להוסיף פקודות חדשות באמצעות addSupportedMediaCommands, או להסיר את הפקודות הקיימות באמצעות removeSupportedMediaCommands.

תמונה משנית

תמונה משנית מאפשרת למפתחי Cast להוסיף תמונת מידע לממשק המשתמש באפליקציות אודיו ווידאו, כדי להציג לדוגמה סמלי לוגו של ערוץ מקומי או פורמט מדיה של ערוץ. הפונקציונליות החדשה הזו מספקת מעט מאוד תקורה, תוך שמירה על ממשק משתמש עקבי בפלטפורמות תצוגה שונות של Chromecast: Chromecast, מסכים חכמים ו-Chromecast with Google TV.