כשמעבירים תוכן ל-Web Receiver, למשתמש תמיד צריכה להיות אפשרות לשלוט בו מאפליקציית השולח.
הערה: בהתאם לתנאים ולהגבלות הנוספים למפתחים של Google Cast SDK, אם אפליקציית מדיה מסוג Cast חייבת להשתמש בממשקי ה-API של בקרת המדיה (הודעות הפעלת מדיה) שהוגדרו ל-SDK כדי לשלוט בהפעלת מדיה במקלט האינטרנט.
אפליקציות שולח צריכות לספק בקרות העברה באזורים הבאים:
- תיבת הדו-שיח של העברה (cast) בזמן ההעברה
- פקדי עוצמת הקול של השולח
- בקר מורחב של שולח
- מיני שלט רחוק לשליחת אימייל
- התראה לשולח
- מסך הנעילה של השולח
סטטוס הפעלת ההעברה (cast) והפקדים של אפליקציית השולח באזורים האלה חייבים להיות מסונכרנים עם שינויי ההפעלה שמתרחשים במקלט האינטרנט, גם אם מקורם אינו באפליקציית השולח. הדבר יאפשר טיפול תקין בפקודות של 'שולחים מרובים' וגם בבקרת ההפעלה שמגיעה מהשלט הרחוק של המכשיר, מהלחצנים וכו'.
Android
פקדים בתיבת הדו-שיח Cast
![](https://google-developers.gonglchuangl.net/static/cast/images/a/sender-cast-menu-active1.png?authuser=0&hl=he)
מיני שלט רחוק
![](https://google-developers.gonglchuangl.net/static/cast/images/a/sender-persistent-control1.png?authuser=0&hl=he)
פקדי התראות
![](https://google-developers.gonglchuangl.net/static/cast/images/a/sender-control-notification1.png?authuser=0&hl=he)
פקדי נעילת מסך
![](https://google-developers.gonglchuangl.net/static/cast/images/a/sender-control-lockscreen1.png?authuser=0&hl=he)
iOS
פקדים בתיבת הדו-שיח Cast
![](https://google-developers.gonglchuangl.net/static/cast/images/i/sender-cast-menu-active1.png?authuser=0&hl=he)
מיני שלט רחוק
![](https://google-developers.gonglchuangl.net/static/cast/images/i/sender-persistent-control1.png?authuser=0&hl=he)
Chrome
פקדים בתיבת הדו-שיח Cast
![](https://google-developers.gonglchuangl.net/static/cast/images/w/sender-cast-menu-active1.jpg?authuser=0&hl=he)
מיני שלט רחוק
![](https://google-developers.gonglchuangl.net/static/cast/images/w/sender-persistent-control1.jpg?authuser=0&hl=he)
פקדי עוצמת הקול של השולח
אפליקציית השולח חייבת לאפשר למשתמשים לשלוט בעוצמת הקול של התוכן שמופעל בטלוויזיה או ברמקולים, באמצעות לחצני עוצמת הקול של החומרה ו/או פס ההזזה של עוצמת הקול של התוכנה במכשיר השולח. ההגדרות האלה מאפשרות לכם לשלוט בכל אחד מהמצבים הבאים:
- עוצמת האודיו שנשלחת לטלוויזיה במכשירי Google Cast, כמו Chromecast.
- עוצמת הקול בפועל של הטלוויזיה או הרמקול של Google Cast TV, טלוויזיות עם מערכת Android TV מובנית ורמקולים חכמים.
חובה
א אפליקציית השולח חייבת לאפשר למשתמשים לשלוט בעוצמת הקול של התוכן שמופעל בטלוויזיה או ברמקולים, באמצעות לחצני עוצמת הקול של החומרה ו/או פס ההזזה של עוצמת הקול של התוכנה במכשיר השולח.
- Android: נדרשת תמיכה גם בלחצני חומרה וגם במחוון עוצמת הקול בתוכנה.
- iOS: חובה להשתמש במחוון נפח התוכנה.
- אינטרנט/Chrome: חובה לתמוך בפס ההזזה של עוצמת הקול בתוכנה.
B בנייד, פס ההזזה של עוצמת הקול של התוכנה צריך להיות זמין בתיבת הדו-שיח 'העברה', בזמן ההעברה.
C פס ההזזה של עוצמת הקול באפליקציית השולח חייב להסתנכרן עם עוצמת הקול הנוכחית של Web Receiver אחרי ההתחברות ל-Web Receiver ולשמור על סנכרון.
D פס ההזזה של עוצמת הקול באפליקציית השולח חייב לשקף את השינויים בעוצמת הקול שבוצעו על ידי שולחים אחרים או על ידי השלט הרחוק של אפליקציית Chromecast.
E אסור לאפליקציות השולח להגדיר את עוצמת הקול לרמה מוגדרת מראש הן צריכות לעבור רק שינויים בנפח האחסון ביוזמת המשתמש.
F Android בלבד: כשמשתמשים בלחצני החומרה כדי לשנות את עוצמת הקול ב-Web Receiver, מופיע פס הזזה חזותי של עוצמת הקול (עם סמל Cast משמאל לו) כשלוחצים על לחצני עוצמת הקול של החומרה. הערה: ב-Android Gingerbread (גרסה 2.3), סמל ההעברה לא מופיע.
שיטות מומלצות
- הגדלה של נפח האחסון:
- Android: ה-framework מגדיל את עוצמת הקול באופן אוטומטי.
- iOS ו-Chrome: לגבי לחצני עוצמת הקול של החומרה, יש להשתמש במרווחים של פחות מ-5% או שווה ל-5% מטווח עוצמת הקול המלא של מכשיר ה-Web Receiver עבור מכשירי אודיו/וידאו, ובמרווחים השווה ל-2% מטווח עוצמת הקול המלא של המכשיר Web Receiver עבור מכשירים עם אודיו בלבד.
בקר מורחב של שולח
אפליקציית השולח חייבת לספק בקר מורחב לתוכן שמועבר.
חובה
א זיהוי התוכן שמועבר על ידי הצגת שם התוכן או הגרפיקה.
B לפני תחילת ההפעלה, כדאי להציג אינדיקטור טעינה
ואת שם התוכן או הגרפיקה.
C כשהתוכן מתחיל, מזהים את המצב של Web Receiver.
ד מספקים אמצעי בקרה רלוונטיים.
E בקצה הימני של סרגל ההרצה, מציגים את
זמן ההפעלה הנוכחי.
בצד שמאל, מציגים את
משך הזמן הכולל של השידור אם הוא ידוע, ואם זה לא השידור החי.
F הסתרת פקדים שאינם רלוונטיים להעברה.
G אין לנתק או להפסיק את ההעברה כשמשתמשים מנווטים
אל מחוץ לבקר המורחב.
H מספקים דרך קלה לחזור לבקר המורחב
כשהמשתמשים מנווטים למקום אחר.
שיטות מומלצות
- הוספת פס ההזזה של מיקום ההפעלה עבור שידורי מדיה.
- להציג מטא-נתונים וגרפיקה בעלי משמעות אחרת הקשורים לתוכן.
- זהו את הזמן שחלף ואת משך התוכן עבור זרמי מדיה.
Android
התוכן של השולח בטעינה
![התוכן של השולח בטעינה](https://google-developers.gonglchuangl.net/static/cast/images/a/sender-control-elements1_a.png?authuser=0&hl=he)
התוכן של המקבל בטעינה
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-loading1.gif?authuser=0&hl=he)
תוכן השולח מופעל
![](https://google-developers.gonglchuangl.net/static/cast/images/a/sender-control-elements2_a.png?authuser=0&hl=he)
תוכן שמופעל ב-Web Receiver
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
iOS
התוכן של השולח בטעינה
![](https://google-developers.gonglchuangl.net/static/cast/images/i/sender-control-elements1_a.gif?authuser=0&hl=he)
התוכן של Web Receiver בטעינה
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-loading1.gif?authuser=0&hl=he)
תוכן השולח מופעל
![](https://google-developers.gonglchuangl.net/static/cast/images/i/sender-control-elements2_a.png?authuser=0&hl=he)
תוכן שמופעל ב-Web Receiver
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
Chrome
התוכן של השולח בטעינה
![](https://google-developers.gonglchuangl.net/static/cast/images/w/sender-control-elements1_a.gif?authuser=0&hl=he)
התוכן של Web Receiver בטעינה
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-loading1.gif?authuser=0&hl=he)
תוכן השולח מופעל
![](https://google-developers.gonglchuangl.net/static/cast/images/w/sender-control-elements2_a.jpg?authuser=0&hl=he)
תוכן שמופעל ב-Web Receiver
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
מיני בקר שולח
בקר קטן ומתמשך, שנקרא 'המיני-בקר', אמור להופיע בזמן ההעברה (cast), כשהמשתמש מנווט מחוץ לדף התוכן הנוכחי או מהבקר המורחב לתצוגה אחרת באפליקציית השולח. המיני-בקר הוא תזכורת גלויה להעברה (cast) הנוכחית והוא מספק גישה מיידית.
חובה
א סרגל או תיבה שמציגה את ההעברה (cast) מופיעים ליד החלק התחתון של אפליקציית השולח. אמצעי הבקרה האלה נשארים פעילים בזמן שהמשתמש גולש בתוכן או
בקטעים אחרים באפליקציה.
ב הפקדים פועלים בצורה הטובה ביותר כשהם פשוטים ומעבירים את התוכן שמוצג.
C האפשרות הזו זמינה בכל המסכים של האפליקציה (למעט דף הבקר המורחב).
D הקשה על אזור התוכן תפתח את הבקר המורחב.
ה מספקים אמצעי בקרה אחרים שרלוונטיים לפעולה מיידית.
שיטות מומלצות
כדי ליהנות מחוויית המשתמש הטובה ביותר, מומלץ להשתמש
בתיבת הדו-שיח של ההעברה, בנוסף לשלט הרחוק מיני.
Android
מיני שלט רחוק של השולח
![](https://google-developers.gonglchuangl.net/static/cast/images/a/sender-persistent-control1_a.png?authuser=0&hl=he)
התוכן של Web Receiver מושהה
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
iOS
מיני שלט רחוק של השולח
![](https://google-developers.gonglchuangl.net/static/cast/images/i/sender-persistent-control1_a.png?authuser=0&hl=he)
התוכן של Web Receiver מושהה
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
Chrome
מיני שלט רחוק של השולח
![](https://google-developers.gonglchuangl.net/static/cast/images/w/sender-persistent-control1_a.jpg?authuser=0&hl=he)
התוכן של Web Receiver מושהה
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
הודעת שולח
חובה (Android בלבד)
A יש להשתמש בסמל האפליקציה (לא בסמל Cast)
בהתראה שמופיעה בשורת הסטטוס.
B מזהים איזה תוכן מועבר. לדוגמה, אפשר להציג
שם תוכן או גרפיקה.
C זיהוי ומקלט האינטרנט שמעביר (cast).
D לספק בקרות תוכן בסיסיות.
E עליך להזין "X" כדי להפסיק את ההעברה (cast)
ולהתנתק ממקלט האינטרנט, בשורת הפעולות.
F הקשה על הלוגו, שם התוכן או הגרפיקה של האפליקציה אמורה
לפתוח את הבקר המורחב של אפליקציית השולח.
Notes
- Android בלבד: לא ניתן להטמיע התראות ב-iOS או ב-Chrome.
- ב-Android Gingerbread (גרסה 2.3), ההודעות יציגו רק את הסמל והטקסט של האפליקציה, ולא יופיעו, מושהית או עצירה.
- למידע נוסף, אפשר לקרוא את המאמר הוספת בקרי מדיה להתראות.
Android
סמל של התראת שולח
![](https://google-developers.gonglchuangl.net/static/cast/images/a/sender-control-notification1_a.png?authuser=0&hl=he)
תוכן שמופעל ב-Web Receiver
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
אמצעי בקרה לשליחת הודעות של השולח
![](https://google-developers.gonglchuangl.net/static/cast/images/a/sender-control-notification2_a.png?authuser=0&hl=he)
תוכן שמופעל ב-Web Receiver
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
מסך הנעילה של השולח
חובה (Android בלבד)
א זיהוי של העברת תוכן באמצעות שם התוכן או גרפיקה.
B זיהוי ומקלט האינטרנט שמעביר (cast). לתשומת ליבך:
לא חייבים לעשות את זה באפליקציות של מוזיקה.
ג מספקים את רכיבי ה-UI להפעלה.
D מספקים גישה לבקרת עוצמת הקול באמצעות לחצני חומרה.
נדרש עבור Android 4.4 KitKat וגרסאות מאוחרות יותר:
- סמל האפליקציה
- פריט הגרפיקה (לדוגמה, שער האלבום)
- לציין בטקסט איזה תוכן מעביר (לדוגמה, 'דמעות פלדה')
- זיהוי של מקלט האינטרנט להעברה (לדוגמה, 'Living Room')
חובה במכשירי Android 4.3 Jelly Bean:
- פריט הגרפיקה (לדוגמה, שער האלבום)
- לציין בטקסט איזה תוכן מעביר (לדוגמה, 'דמעות פלדה')
- זיהוי של מקלט האינטרנט להעברה (לדוגמה, 'Living Room')
Notes
- Android בלבד: לא ניתן להטמיע התראות ב-iOS או ב-Chrome.
- הפקדים של מסך הנעילה נדרשים עבור גרסאות Android 4.1 ואילך.
- יש אמצעי בקרה שונים שזמינים לגרסאות שונות של מערכת ההפעלה Android, ומסך הנעילה יכול להכיל רק שדות טקסט. באופן כללי, גרפיקה וסמלים מתארים את התוכן באופן מיידי יותר מאשר טקסט.
- לחצני החומרה לשליטה בעוצמת הקול צריכים לכוונן את עוצמת הקול באפליקציית השולח כשהטלפון נעול.
- אמצעי הבקרה חייב להשתמש ברכיב ה-framework:
MediaSession
אוMediaSessionCompat
(לגרסאות 4.4 ו-4.3) אוNotification
(לגרסאות 5.0 ואילך).
Android
פקדי מסך הנעילה של השולח
![](https://google-developers.gonglchuangl.net/static/cast/images/a/sender-control-lockscreen1_a.png?authuser=0&hl=he)
תוכן שמופעל ב-Web Receiver
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
השולח ממשיך את ההעברה
אפליקציית שולח מחוברת צריכה לשחזר את מצב החיבור שלה לאחר ניתוק מרומז (למשל, נפילה ברשת, מכשיר במעבר למצב שינה או התרוקנות הסוללה).
חובה
א אם אפליקציית השולח מתנתקת באופן לא מפורש (המשתמש לא הפסיק באופן מפורש את ההעברה או התנתק), תוכן ההעברה צריך להמשיך לפעול
במקלט האינטרנט. כאשר האפליקציה או החיבור מופעלים מחדש, אפליקציית השולח צריכה לשחזר את החיבור ל-Web Receiver, כל עוד הסשן של Web Receiver עדיין פעיל.
B לחצן הפעלת Cast אמור לחזור למצב המחובר.
C אם המשתמש יקיש על לחצן הפעלת Cast לפני שהשולח יתחבר מחדש, תוצג רשימת המכשירים של Web Receiver. כשהמשתמש בוחר במקלט האינטרנט
שמועבר כרגע, שלט רחוק מוקטן או שלט רחוק מורחב אמור להופיע באפליקציית השולח.
הערות
ייתכן גם שהאפליקציה Web Receiver תתנתק ולהפסיק לפעול עקב הפסקת חשמל או
הפרעה אחרת ללא הקשר. הפעולה הזו נחשבת כסיום רגיל של סשן, כפי שמתואר במאמר השולח מפסיק את ההעברה.
Android
בחירת האפליקציה
![](https://google-developers.gonglchuangl.net/static/cast/images/a/sender-control-resume1_a.png?authuser=0&hl=he)
תוכן שמופעל ב-Web Receiver
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
החיבור ל-Cast שוחזר
![](https://google-developers.gonglchuangl.net/static/cast/images/a/sender-control-resume2_a.png?authuser=0&hl=he)
תוכן שמופעל ב-Web Receiver
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
iOS
בחירת האפליקציה
![](https://google-developers.gonglchuangl.net/static/cast/images/i/sender-control-resume1_a.png?authuser=0&hl=he)
תוכן שמופעל ב-Web Receiver
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
החיבור ל-Cast שוחזר
![](https://google-developers.gonglchuangl.net/static/cast/images/i/sender-control-resume2_a.png?authuser=0&hl=he)
תוכן שמופעל ב-Web Receiver
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
השולח מפסיק את ההעברה
תוכן שמועבר לטלוויזיה ממשיך לפעול עד שמשתמש בוחר באפשרות 'הפסק להעביר' או ששולח מעביר תוכן חדש. כאשר מספר שולחים מחוברים לאותו Web Receiver, לכל אפליקציית שולח צריך להופיע לחצן 'ניתוק' (במקום הלחצן 'הפסקת העברה') בתיבת הדו-שיח 'העברה'.
חובה
א כאשר מספר שולחים מחוברים למקלט אינטרנט, לחיצה על 'הפסקת העברה' באפליקציית שולח אחת לא משפיעה על מקבל האינטרנט ולא מסירה את ההתראות
ואת בקרות ההעברה מאותו מכשיר של השולח. שאר מכשירי השולחים המחוברים יישארו
מחוברים, עם פקדי העברה זמינים.
B כאשר אפליקציה של שולח מתנתקת באופן לא מפורש (לדוגמה,
מתרוקנת הסוללה של מכשיר השולח או שחיבור הרשת של המכשיר של השולח למקבל האינטרנט
מתנתק), היא לא עושה דבר למקבל האינטרנט, ומסירה את אמצעי הבקרה וההתראות של ההעברה
מהמכשיר של השולח. אפליקציית השולח צריכה לעקוב אחר ניתוקים משתמעים ולנסות
להתחבר מחדש ל-Web Receiver כשאפליקציית השולח נפתחת שוב.
Android
תיבת דו-שיח של העברה (cast), לחצן ניתוק
![](https://google-developers.gonglchuangl.net/static/cast/images/a/sender-control-end1.png?authuser=0&hl=he)
תוכן שמופעל ב-Web Receiver
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
iOS
תיבת דו-שיח של העברה (cast), לחצן ניתוק
![](https://google-developers.gonglchuangl.net/static/cast/images/i/sender-control-end1.png?authuser=0&hl=he)
תוכן שמופעל ב-Web Receiver
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
Chrome
תיבת דו-שיח של העברה (cast), לחצן ניתוק
![](https://google-developers.gonglchuangl.net/static/cast/images/w/sender-control-end1.jpg?authuser=0&hl=he)
תוכן שמופעל ב-Web Receiver
![](https://google-developers.gonglchuangl.net/static/cast/images/r/receiver-content-playing1.png?authuser=0&hl=he)
התמונות שמופיעות במדריך העיצוב הזה הן באדיבות Blaender Foundation, משותפות במסגרת זכויות יוצרים או רישיון Creative Commons.
- חלום הפיל: (c) זכויות יוצרים 2006, בלנדר קרן / הולנד Media Art Institute / www.elephantsdream.org
- Sintel: (c) copyright Blaender Foundation | www.sintel.org
- Tears of Steel: (CC) Blaender Foundation | mango.blender.org
- Big Buck Bunny: (c) copyright 2008, Blaender Foundation / www.bigbuckbunny.org