cast.
זהו מרחב השמות cast.framework.system.
מחלקות
ApplicationData
מטא-נתונים שמתארים את הנתונים של האפליקציה שהופעלה.
אירוע
אירוע נשלח על ידי cast.framework.CastReceiverContext שמכיל מידע על המערכת.
FeedbackStartedEvent
אירוע נשלח על ידי cast.framework.CastReceiverContext כשהמערכת מתחילה ליצור דוח משוב.
MaxVideoResolutionChangedEvent
אירוע נשלח על ידי cast.framework.CastReceiverContext כשהמערכת צריכה לעדכן את ההגבלה ברזולוציה המקסימלית של הסרטון.
הודעה
הודעה מותאמת אישית שהתקבלה משולח. כדי להאזין לאירועים בהתאמה אישית, צריך להשתמש בשיטה cast.framework.CastReceiverContext#addCustomMessageListener.
ReadyEvent
אירוע נשלח על ידי cast.framework.CastReceiverContext כשהמערכת מוכנה.
השולח
הערך הזה מייצג את הנתונים של מכשיר שולח מחובר.
SenderConnectedEvent
אירוע נשלח על ידי cast.framework.CastReceiverContext כשיש שולח.
SenderDisconnectedEvent
אירוע נשלח על ידי cast.framework.CastReceiverContext כשהשולח מנותק.
ShutdownEvent
אירוע נשלח על ידי cast.framework.CastReceiverContext כשהאפליקציה מושבתת.
StandbyChangedEvent
אירוע נשלח על ידי cast.framework.CastReceiverContext כשהטלוויזיה
נכנסת למצב המתנה או יוצאת, לכן האפליקציה צריכה תמיד לאמת
את הנכס isStandby. כדי לדעת אם הסטטוס בפועל לא ידוע, האפליקציה יכולה להפעיל את השיטה
cast.framework.CastReceiverContext#getStandbyState.
SystemVolumeChangedEvent
אירוע נשלח על ידי cast.framework.CastReceiverContext כשעוצמת הקול של המערכת משתנה.
SystemVolumeData
הנתון הזה מייצג את נתוני הנפח של המערכת.
VisibilityChangedEvent
אירוע נשלח על ידי cast.framework.CastReceiverContext כשהחשיפה של האפליקציה משתנה – לדוגמה, כשקלט ה-HDMI משתנה או כשהטלוויזיה כבויה.
ספירות
DeviceCapabilities
מחרוזת
מתאר את היכולות של ההגדרה הנוכחית, שמורכבת מהמכשיר שתומך ב-Cast, ובמקרים הרלוונטיים במכשיר המסך שאליו הוא מחובר.
Value |
|
|---|---|
|
AUDIO_ASSISTANT |
מחרוזת תמיכה באסיסטנט האודיו. דוגמאות למכשירים שתומכים ב-Cast עם תמיכה באודיו Assistant כוללות את Google Home ואת Google Home Mini. |
|
BLUETOOTH_SUPPORTED |
מחרוזת תמיכה ב-Bluetooth. |
|
DISPLAY_SUPPORTED |
מחרוזת תמיכה בפלט התצוגה. דוגמאות למכשירים שתומכים ב-Cast עם תמיכה במסך כוללות Chromecast ו-Cast TV. דוגמאות למכשירים שתומכים ב-Cast שאין בהם תמיכה במסך כוללות את Chromecast Audio ואת Google Home. |
|
HI_RES_AUDIO_SUPPORTED |
מחרוזת תמיכה באודיו ברזולוציה גבוהה (עד 24 סיביות / 96KHz). |
|
IS_DV_SUPPORTED |
מחרוזת תמיכה ב-Dolby Vision. |
|
IS_HDR_SUPPORTED |
מחרוזת תמיכה בסרטוני HDR. |
|
TOUCH_INPUT_SUPPORTED |
מחרוזת תמיכה בקלט מגע. דוגמאות למכשירים שתומכים ב-Cast שתומך בקלט מגע כוללות את Google Nest Hub ואת Google Nest Hub Max. |
|
IS_GROUP |
מחרוזת אם המכשיר הוא מכשיר וירטואלי ומייצג יעד קבוצתי ולא מכשיר פיזי. |
|
IS_DEVICE_REGISTERED |
מחרוזת כשהוא מוגדר ל- |
|
IS_CBCS_SUPPORTED |
מחרוזת כשהערך הוא |
|
IS_DOLBY_ATMOS_SUPPORTED |
מחרוזת כשהוא מוגדר כ- |
DisconnectReason
מחרוזת
מייצג את סיבת הניתוק.
Value |
|
|---|---|
|
REQUESTED_BY_SENDER |
מחרוזת אפליקציית השולח ביקשה באופן פעיל לסגור את החיבור (בדרך כלל היא הופעלה על ידי המשתמש). |
|
שגיאה |
מחרוזת אירעה שגיאה בפרוטוקול. |
|
לא ידוע |
מחרוזת לא ידוע אם השולח ביקש להתנתק בקלות על ידי התקשרות אל |
EventType
מחרוזת
אירועי מערכת נשלחים על ידי cast.framework.CastReceiverContext.
Value |
|
|---|---|
|
מוכנה |
מחרוזת מופעל כשהמערכת מוכנה. |
|
SHUTDOWN |
מחרוזת מופעל כשהאפליקציה נסגרת. |
|
SENDER_CONNECTED |
מחרוזת מופעל כששולח חדש מתחבר. |
|
SENDER_DISCONNECTED |
מחרוזת הופעל כששולח התנתק. |
|
שגיאה |
מחרוזת מופעל כשיש שגיאת מערכת. |
|
SYSTEM_VOLUME_CHANGED |
מחרוזת מופעל כשעוצמת הקול של המערכת משתנה. |
|
VISIBILITY_CHANGED |
מחרוזת מופעל כשהחשיפה של האפליקציה משתנה (לדוגמה, לאחר שינוי בקלט HDMI או כשהטלוויזיה כבויה או מופעלת ומכשיר ה-CAST מופעל באופן חיצוני). הערה: ל-API הזה יש אותה השפעה כמו לאירוע webkitvisibilitychange' שהועלה על ידי הדפדפן. הוא מסופק בתור ה-API cast.framework.CastReceiverContext לנוחות ולמניעת תלות באירוע עם תחילית webkit. |
|
STANDBY_CHANGED |
מחרוזת מופעל כשמצב ההמתנה של הטלוויזיה משתנה. האירוע הזה קשור
לאירוע cast.framework.system.EventType.VISIBILITY_CHANGED,
כי אם הטלוויזיה נמצאת במצב המתנה, החשיפה תהיה מצבי החשיפה מפורטים יותר ממצבי המתנה (כי החשיפה כוללת גם אפשרות בחירה של ערוץ טלוויזיה), אבל לא מזוהים באופן מהימן בכל הטלוויזיות. במקרים כאלה אפשר להשתמש במצב המתנה, כי רוב הטלוויזיות מטמיעות זאת. |
|
MAX_VIDEO_RESOLUTION_CHANGED |
מחרוזת |
|
FEEDBACK_STARTED |
מחרוזת מופעל כשהמערכת מתחילה ליצור דוח משוב. |
LaunchedFrom
מחרוזת
הנתון הזה מייצג את סוג הבקשה שהופעלה הנמען.
Value |
|
|---|---|
|
לא ידוע |
מחרוזת לא ניתן היה לקבוע מי הבעלים של ההפעלה. |
|
חיוג |
מחרוזת האפליקציה הופעלה באמצעות בקשת DIAL. |
|
CAST |
מחרוזת האפליקציה הופעלה בעקבות בקשת Cast V2. |
|
ענן |
מחרוזת האפליקציה הופעלה באמצעות בקשה מ-Assistant (לדוגמה, על ידי פקודה של Google Assistant). |
MessageType
מחרוזת
סוגים של הודעות בהתאמה אישית.
Value |
|
|---|---|
|
מחרוזת |
מחרוזת הודעות הן מחרוזות בפורמט חופשי. האפליקציה אחראית לקידוד/לפענוח המידע שמועבר. |
|
JSON |
מחרוזת ההודעות מקודדות בפורמט JSON. התעבורה הבסיסית תשתמש במחרוזת מקודדת של JSON. |
StandbyState
מחרוזת
המצב הזה מייצג את מצב ההמתנה הנוכחי שדווח על ידי הפלטפורמה. אם פלטפורמת ההעברה לא תוכל לקבוע את המצב, ייתכן
UNKNOWN.
Value |
|
|---|---|
|
בהמתנה |
מחרוזת |
|
NOT_STANDBY |
מחרוזת |
|
לא ידוע |
מחרוזת |
SystemState
מחרוזת
הערך הזה מייצג את המצב הנוכחי של המערכת.
Value |
|
|---|---|
|
NOT_STARTED |
מחרוזת עדיין לא נשלחה בקשה להפעלת האפליקציה. |
|
STARTING_IN_BACKGROUND |
מחרוזת האפליקציה מופעלת אבל המשתמש לא יכול לראות אותה. |
|
בתהליך הפעלה |
מחרוזת הגשת הבקשה מתחילה. |
|
מוכנה |
מחרוזת האפליקציה נמצאת בחזית ומוכנה לשליחה ולקבלה של הודעות. |
|
STOPPING_IN_BACKGROUND |
מחרוזת האפליקציה מפסיקה לפעול ברקע. |
|
מתבצעת הפסקה |
מחרוזת האפליקציה מפסיקה. |
VisibilityState
מחרוזת
הערכים האלה מייצגים את מצב החשיפה הנוכחי שדווח על ידי הפלטפורמה. אם לפלטפורמת ההעברה לא תהיה אפשרות לקבוע את מצב
החשיפה, יכול להיות
UNKNOWN.
Value |
|
|---|---|
|
גלוי |
מחרוזת |
|
NOT_VISIBLE |
מחרוזת |
|
לא ידוע |
מחרוזת |
תכונות
DeviceCapabilities
מחרוזת
מתאר את היכולות של ההגדרה הנוכחית, שמורכבת מהמכשיר שתומך ב-Cast, ובמקרים הרלוונטיים במכשיר המסך שאליו הוא מחובר.
Value |
|
|---|---|
|
AUDIO_ASSISTANT |
מחרוזת תמיכה באסיסטנט האודיו. דוגמאות למכשירים שתומכים ב-Cast עם תמיכה באודיו Assistant כוללות את Google Home ואת Google Home Mini. |
|
BLUETOOTH_SUPPORTED |
מחרוזת תמיכה ב-Bluetooth. |
|
DISPLAY_SUPPORTED |
מחרוזת תמיכה בפלט התצוגה. דוגמאות למכשירים שתומכים ב-Cast עם תמיכה במסך כוללות Chromecast ו-Cast TV. דוגמאות למכשירים שתומכים ב-Cast שאין בהם תמיכה במסך כוללות את Chromecast Audio ואת Google Home. |
|
HI_RES_AUDIO_SUPPORTED |
מחרוזת תמיכה באודיו ברזולוציה גבוהה (עד 24 סיביות / 96KHz). |
|
IS_DV_SUPPORTED |
מחרוזת תמיכה ב-Dolby Vision. |
|
IS_HDR_SUPPORTED |
מחרוזת תמיכה בסרטוני HDR. |
|
TOUCH_INPUT_SUPPORTED |
מחרוזת תמיכה בקלט מגע. דוגמאות למכשירים שתומכים ב-Cast שתומך בקלט מגע כוללות את Google Nest Hub ואת Google Nest Hub Max. |
|
IS_GROUP |
מחרוזת אם המכשיר הוא מכשיר וירטואלי ומייצג יעד קבוצתי ולא מכשיר פיזי. |
|
IS_DEVICE_REGISTERED |
מחרוזת כשהוא מוגדר ל- |
|
IS_CBCS_SUPPORTED |
מחרוזת כשהערך הוא |
|
IS_DOLBY_ATMOS_SUPPORTED |
מחרוזת כשהוא מוגדר כ- |
DisconnectReason
מחרוזת
מייצג את סיבת הניתוק.
Value |
|
|---|---|
|
REQUESTED_BY_SENDER |
מחרוזת אפליקציית השולח ביקשה באופן פעיל לסגור את החיבור (בדרך כלל היא הופעלה על ידי המשתמש). |
|
שגיאה |
מחרוזת אירעה שגיאה בפרוטוקול. |
|
לא ידוע |
מחרוזת לא ידוע אם השולח ביקש להתנתק בקלות על ידי התקשרות אל |
EventType
מחרוזת
אירועי מערכת נשלחים על ידי cast.framework.CastReceiverContext.
Value |
|
|---|---|
|
מוכנה |
מחרוזת מופעל כשהמערכת מוכנה. |
|
SHUTDOWN |
מחרוזת מופעל כשהאפליקציה נסגרת. |
|
SENDER_CONNECTED |
מחרוזת מופעל כששולח חדש מתחבר. |
|
SENDER_DISCONNECTED |
מחרוזת הופעל כששולח התנתק. |
|
שגיאה |
מחרוזת מופעל כשיש שגיאת מערכת. |
|
SYSTEM_VOLUME_CHANGED |
מחרוזת מופעל כשעוצמת הקול של המערכת משתנה. |
|
VISIBILITY_CHANGED |
מחרוזת מופעל כשהחשיפה של האפליקציה משתנה (לדוגמה, לאחר שינוי בקלט HDMI או כשהטלוויזיה כבויה או מופעלת ומכשיר ה-CAST מופעל באופן חיצוני). הערה: ל-API הזה יש אותה השפעה כמו לאירוע webkitvisibilitychange' שהועלה על ידי הדפדפן. הוא מסופק בתור ה-API cast.framework.CastReceiverContext לנוחות ולמניעת תלות באירוע עם תחילית webkit. |
|
STANDBY_CHANGED |
מחרוזת מופעל כשמצב ההמתנה של הטלוויזיה משתנה. האירוע הזה קשור
לאירוע cast.framework.system.EventType.VISIBILITY_CHANGED,
כי אם הטלוויזיה נמצאת במצב המתנה, החשיפה תהיה מצבי החשיפה מפורטים יותר ממצבי המתנה (כי החשיפה כוללת גם אפשרות בחירה של ערוץ טלוויזיה), אבל לא מזוהים באופן מהימן בכל הטלוויזיות. במקרים כאלה אפשר להשתמש במצב המתנה, כי רוב הטלוויזיות מטמיעות זאת. |
|
MAX_VIDEO_RESOLUTION_CHANGED |
מחרוזת |
|
FEEDBACK_STARTED |
מחרוזת מופעל כשהמערכת מתחילה ליצור דוח משוב. |
LaunchedFrom
מחרוזת
הנתון הזה מייצג את סוג הבקשה שהופעלה הנמען.
Value |
|
|---|---|
|
לא ידוע |
מחרוזת לא ניתן היה לקבוע מי הבעלים של ההפעלה. |
|
חיוג |
מחרוזת האפליקציה הופעלה באמצעות בקשת DIAL. |
|
CAST |
מחרוזת האפליקציה הופעלה בעקבות בקשת Cast V2. |
|
ענן |
מחרוזת האפליקציה הופעלה באמצעות בקשה מ-Assistant (לדוגמה, על ידי פקודה של Google Assistant). |
MessageType
מחרוזת
סוגים של הודעות בהתאמה אישית.
Value |
|
|---|---|
|
מחרוזת |
מחרוזת הודעות הן מחרוזות בפורמט חופשי. האפליקציה אחראית לקידוד/לפענוח המידע שמועבר. |
|
JSON |
מחרוזת ההודעות מקודדות בפורמט JSON. התעבורה הבסיסית תשתמש במחרוזת מקודדת של JSON. |
StandbyState
מחרוזת
המצב הזה מייצג את מצב ההמתנה הנוכחי שדווח על ידי הפלטפורמה. אם פלטפורמת ההעברה לא תוכל לקבוע את המצב, ייתכן
UNKNOWN.
Value |
|
|---|---|
|
בהמתנה |
מחרוזת |
|
NOT_STANDBY |
מחרוזת |
|
לא ידוע |
מחרוזת |
SystemState
מחרוזת
הערך הזה מייצג את המצב הנוכחי של המערכת.
Value |
|
|---|---|
|
NOT_STARTED |
מחרוזת עדיין לא נשלחה בקשה להפעלת האפליקציה. |
|
STARTING_IN_BACKGROUND |
מחרוזת האפליקציה מופעלת אבל המשתמש לא יכול לראות אותה. |
|
בתהליך הפעלה |
מחרוזת הגשת הבקשה מתחילה. |
|
מוכנה |
מחרוזת האפליקציה נמצאת בחזית ומוכנה לשליחה ולקבלה של הודעות. |
|
STOPPING_IN_BACKGROUND |
מחרוזת האפליקציה מפסיקה לפעול ברקע. |
|
מתבצעת הפסקה |
מחרוזת האפליקציה מפסיקה. |
VisibilityState
מחרוזת
הערכים האלה מייצגים את מצב החשיפה הנוכחי שדווח על ידי הפלטפורמה. אם לפלטפורמת ההעברה לא תהיה אפשרות לקבוע את מצב
החשיפה, יכול להיות
UNKNOWN.
Value |
|
|---|---|
|
גלוי |
מחרוזת |
|
NOT_VISIBLE |
מחרוזת |
|
לא ידוע |
מחרוזת |