סקירה כללית
בקר לתצוגות ממשק משתמש המשמש לשליטה או להצגת הסטטוס של הפעלת מדיה במקלט Cast.
אפליקציית הקריאה רושמת בבקר את פקדי ממשק המשתמש הקשורים למדיה על ידי הגדרת המאפיינים המתאימים. לאחר מכן, הבקר מגיב לאירועי מגע בפקדים באמצעות הנפקת פקודות מדיה מתאימות למקלט, ומעדכן את הפקדים בהתבסס על פרטי סטטוס ומטא נתונים של מדיה שהתקבלו מהמקבל. הבקר מפעיל ומשבית באופן אוטומטי את הפקדים בממשק המשתמש בהתאם לסשן הנוכחי ולמצב נגן המדיה הנוכחי. בנוסף, כל אמצעי הבקרה יושבתו במהלך הטיפול בבקשה.
למידע על הפרוטוקול להאצלת הגישה, אפשר להיכנס לכתובת GCKUIMediaControllerDelegate.
- מאז
- 3.0
יורש את NSObject.
סיכום שיטות של מכונה | |
(instancetype) | - init |
מפעיל מכונה. עוד... | |
(void) | - bindLabel:toMetadataKey: |
מקשרת UILabel למפתח מטא-נתונים. עוד... | |
(void) | - bindLabel:toMetadataKey:withFormatter: |
מקשרת UILabel למפתח מטא-נתונים. עוד... | |
(void) | - bindTextView:toMetadataKey: |
מחייבת UITextView למפתח מטא נתונים. עוד... | |
(void) | - bindTextView:toMetadataKey:withFormatter: |
מחייבת UITextView למפתח מטא נתונים. עוד... | |
(void) | - bindImageView:toImageHints: |
מחייבת UIImageView למופע של GCKUIImageHints. עוד... | |
(void) | - bindControlView:toRewindForTime: |
הפונקציה מחייבת UIControl כדי להריץ לאחור את ההפעלה של הפריט הנוכחי בערך שנקבע לשניות. עוד... | |
(void) | - bindControlView:toForwardForTime: |
הפונקציה מחייבת UIControl כדי להעביר את ההפעלה של הפריט הנוכחי בערך שהועבר כשניות. עוד... | |
(void) | - unbindView: |
ביטול הקישור של התצוגה שצוינה. עוד... | |
(void) | - unbindAllViews |
ביטול הקישור של כל התצוגות המפורטות. עוד... | |
(GCKMediaRepeatMode) | - cycleRepeatMode |
שינוי מצב החזרה של התור למצב הבא במחזור החיים: עוד... | |
(void) | - selectTracks |
שיטה נוחה להצגת ממשק המשתמש לבחירת טראק של מדיה. עוד... | |
(void) | - skipAd |
שליחת הבקשה לדילוג על המודעה ומעקב אחריה. עוד... | |
סיכום הנכס | |
id< GCKUIMediaControllerDelegate > | delegate |
מיופה כוח לקבלת התראות מ-GCKUIMediaController. עוד... | |
GCKSession * | session |
הסשן שמשויך לבקר הזה. עוד... | |
BOOL | mediaLoaded |
האם מדיה נטענת (או נטענת) כרגע במקלט. עוד... | |
BOOL | hasCurrentQueueItem |
האם יש פריט נוכחי בתור. עוד... | |
BOOL | hasLoadingQueueItem |
האם יש פריט שנטען מראש בתור. עוד... | |
GCKMediaPlayerState | lastKnownPlayerState |
המצב העדכני של נגן המדיה הידוע. עוד... | |
NSTimeInterval | lastKnownStreamPosition |
המיקום הידוע האחרון של זרם מדיה. עוד... | |
UIButton * | playButton |
לחצן 'הפעלה'. עוד... | |
UIButton * | pauseButton |
לחצן 'השהיה'. עוד... | |
GCKUIMultistateButton * | playPauseToggleButton |
לחצן להפעלה/השהיה. עוד... | |
GCKUIPlayPauseToggleController * | playPauseToggleController |
מתג להפעלה/השהיה. עוד... | |
UIButton * | stopButton |
לחצן 'עצירה'. עוד... | |
UIButton * | forward30SecondsButton |
לחצן לדילוג 30 שניות קדימה בפריט המדיה שמופעל עכשיו. עוד... | |
UIButton * | rewind30SecondsButton |
לחצן להרצה של 30 שניות אחורה בפריט המדיה שמופעל עכשיו. עוד... | |
UIButton * | pauseQueueButton |
לחצן להשהיית ההפעלה של רשימת 'הבאים בתור' כשההפעלה של הפריט הנוכחי תסתיים. עוד... | |
UIButton * | nextButton |
לחצן 'הבא'. עוד... | |
UIButton * | previousButton |
לחצן "הקודם". עוד... | |
GCKUIMultistateButton * | repeatModeButton |
לחצן לרכיבה על אופניים בין מצבי החזרה הזמינים בתור. עוד... | |
UISlider * | streamPositionSlider |
פס הזזה להצגה ולשינוי של המיקום הנוכחי של השידור. עוד... | |
UIProgressView * | streamProgressView |
תצוגה שמראה את ההתקדמות הנוכחית של השידור. עוד... | |
UILabel * | streamPositionLabel |
תווית להצגת המיקום הנוכחי של השידור, בדקות ובשניות. עוד... | |
UILabel * | streamDurationLabel |
תווית להצגת משך השידור הנוכחי, בדקות ובשניות. עוד... | |
UILabel * | streamTimeRemainingLabel |
תווית להצגת זמן השידור שנותר (משך הזמן פחות המיקום) בדקות ובשניות. עוד... | |
GCKUIStreamPositionController * | streamPositionController |
בקר למיקום של זרם. עוד... | |
GCKUIPlaybackRateController * | playbackRateController |
בקר לקצב ההפעלה של סטרימינג. עוד... | |
BOOL | displayTimeRemainingAsNegativeValue |
האם זמן השידור שנותר יוצג כערך שלילי, לדוגמה, ' -1:23:45'. עוד... | |
BOOL | hideStreamPositionControlsForLiveContent |
אם הפקדים של מיקום השידור (כולל פס ההזזה של מיקום השידור, תווית המיקום של השידור, תווית משך השידור ותצוגת ההתקדמות של השידור) צריכים להיות מוסתרים בתוכן בשידור חי. עוד... | |
UIButton * | tracksButton |
לחצן לבחירת טראקים של אודיו ו/או כתוביות. עוד... | |
UILabel * | smartSubtitleLabel |
תווית להצגת כותרת משנה של המדיה שנטענה כרגע. עוד... | |
UIActivityIndicatorView * | mediaLoadingIndicator |
תצוגת אינדיקטור של פעילות, שמציינת שהמדיה במצב טעינה. עוד... | |
UILabel * | skipAdLabel |
תווית להצגת משך הזמן שנותר עד שניתן לדלג על המודעה. עוד... | |
UIButton * | skipAdButton |
לחצן לדילוג על המודעה הנוכחית. עוד... | |
פרטי השיטה
- (instancetype) init |
מפעיל מכונה.
- (void) bindLabel: | (UILabel *) | label | |
toMetadataKey: | (NSString *) | key | |
מקשרת UILabel למפתח מטא-נתונים.
בתצוגה יוצג הערך הנוכחי של שדה המטא-נתונים התואם.
בכתובת GCKMediaMetadata מופיעה רשימה של מפתחות מטא-נתונים שהוגדרו מראש.
- Parameters
-
label The UILabel that will display the value. key The metadata key.
- (void) bindLabel: | (UILabel *) | label | |
toMetadataKey: | (NSString *) | key | |
withFormatter: | (GCKUIValueFormatter) | formatter | |
מקשרת UILabel למפתח מטא-נתונים.
בתצוגה יוצג הערך הנוכחי של שדה המטא-נתונים התואם.
בכתובת GCKMediaMetadata מופיעה רשימה של מפתחות מטא-נתונים שהוגדרו מראש.
- Parameters
-
label The UILabel that will display the value. key The metadata key. formatter A block that will produce the desired string representation of the value.
- (void) bindTextView: | (UITextView *) | textView | |
toMetadataKey: | (NSString *) | key | |
מחייבת UITextView למפתח מטא נתונים.
בתצוגה יוצג הערך הנוכחי של שדה המטא-נתונים התואם.
בכתובת GCKMediaMetadata מופיעה רשימה של מפתחות מטא-נתונים שהוגדרו מראש.
- Parameters
-
textView The UITextView that will display the value. key The metadata key.
- (void) bindTextView: | (UITextView *) | textView | |
toMetadataKey: | (NSString *) | key | |
withFormatter: | (GCKUIValueFormatter) | formatter | |
מחייבת UITextView למפתח מטא נתונים.
בתצוגה יוצג הערך הנוכחי של שדה המטא-נתונים התואם.
בכתובת GCKMediaMetadata מופיעה רשימה של מפתחות מטא-נתונים שהוגדרו מראש.
- Parameters
-
textView The UITextView that will display the value. key The metadata key. formatter A block that will produce the desired string representation of the value.
- (void) bindImageView: | (UIImageView *) | imageView | |
toImageHints: | (GCKUIImageHints *) | imageHints | |
מחייבת UIImageView למופע של GCKUIImageHints.
ה-GCKUIImagePicker שמותקן כרגע ישמש לבחירת תמונה מהמטא-נתונים של התצוגה.
- Parameters
-
imageView The UIImageView that will display the selected image. imageHints The image hints.
- (void) bindControlView: | (UIControl *) | control | |
toRewindForTime: | (NSTimeInterval) | rewindSeconds | |
הפונקציה מחייבת UIControl
כדי להריץ לאחור את ההפעלה של הפריט הנוכחי בערך שנקבע לשניות.
התצוגה תעודכן בהתאם למצב GCKCastSession
, למצב ההפעלה מרחוק ואם מדובר בשידור חי. נוסף יעד ל-UIControl
כדי לתעד את האירוע UIControlEventTouchUpInside
. אין להוסיף יעד מהסוג הזה בUIControl
. כדי לתעד את האירוע, יש להשתמש בשיטות GCKUIMediaControllerDelegate
במקום זאת.
- Parameters
-
control The UI element that the user interacts with. Typically this would be an instance of UIButton
.rewindSeconds The number of seconds to rewind the media.
- (void) bindControlView: | (UIControl *) | control | |
toForwardForTime: | (NSTimeInterval) | forwardSeconds | |
הפונקציה מחייבת UIControl
כדי להעביר את ההפעלה של הפריט הנוכחי בערך שהועבר כשניות.
התצוגה תעודכן בהתאם למצב GCKCastSession
, למצב ההפעלה מרחוק ואם מדובר בשידור חי. נוסף יעד ל-UIControl
כדי לתעד את האירוע UIControlEventTouchUpInside
. אין להוסיף יעד מהסוג הזה בUIControl
. כדי לתעד את האירוע, יש להשתמש בשיטות GCKUIMediaControllerDelegate
במקום זאת.
- Parameters
-
control The UI element that the user interacts with. Typically this would be an instance of UIButton
.forwardSeconds The number of seconds to skip the media.
- (void) unbindView: | (UIView *) | view |
ביטול הקישור של התצוגה שצוינה.
- Parameters
-
view The view to unbind.
- (void) unbindAllViews |
ביטול הקישור של כל התצוגות המפורטות.
- (GCKMediaRepeatMode) cycleRepeatMode |
משנה את מצב החזרה עבור התור למצב הבא במחזור:
GCKMediaRepeatModeOff ← GCKMediaRepeatModeAll ← GCKMediaRepeatModeSingle ← GCKMediaRepeatModeAllAndShuffle
- החזרות
- מצב החזרה החדש.
- (void) selectTracks |
שיטה נוחה להצגת ממשק המשתמש לבחירת טראק של מדיה.
- (void) skipAd |
שליחת הבקשה לדילוג על המודעה ומעקב אחריה.
- מאז
- 4.3
פרטי הנכס
|
readwritenonatomicweak |
מיופה כוח לקבלת התראות מ-GCKUIMediaController.
|
readnonatomicstrong |
הסשן שמשויך לבקר הזה.
|
readnonatomicassign |
האם מדיה נטענת (או נטענת) כרגע במקלט.
אם אין סשן העברה פעיל, הערך יהיה NO
.
|
readnonatomicassign |
האם יש פריט נוכחי בתור.
|
readnonatomicassign |
האם יש פריט שנטען מראש בתור.
|
readnonatomicassign |
המצב העדכני של נגן המדיה הידוע.
אם אין סשן העברה פעיל, יוצג מצב הנגן ממש לפני שהסשן האחרון הסתיים. אם לא היה סשן קודם, הוא יהיה GCKMediaPlayerStateUnknown.
|
readnonatomicassign |
המיקום הידוע האחרון של זרם מדיה.
אם אין סשן העברה פעיל, זה יהיה המיקום של שידור המדיה ממש לפני שהסשן האחרון הסתיים. אם לא היה סשן קודם, הערך יהיה kGCKInvalidTimeInterval.
|
readwritenonatomicweak |
לחצן 'הפעלה'.
כשמקישים על הלחצן, ההפעלה של המדיה שנטען עכשיו מתחילה במכשיר או ממשיכה לפעול במכשיר. הלחצן יושבת אם ההפעלה כבר מתבצעת, אם לא נטענת מדיה כרגע או אם אין סשן העברה פעיל.
|
readwritenonatomicweak |
לחצן 'השהיה'.
כשמקישים על הלחצן, ההפעלה של המדיה שנטענה כרגע מושהית במכשיר המקבל. הלחצן יושבת אם המדיה שנטענה כרגע לא תומכת בהשהיה, אם ההפעלה לא מתבצעת כרגע, או אם לא נטענת מדיה כרגע, או אם אין סשן העברה פעיל.
|
readwritenonatomicweak |
לחצן להפעלה/השהיה.
מבצע הקריאה החוזרת צריך להגדיר סמלים מתאימים למצבי הלחצן GCKUIButtonStatePlay, GCKUIButtonStatePlayLive ו-GCKUIButtonStatePause, כלומר סמל 'השהיה' למצב ההפעלה, סמל 'עצירה' למצב 'הפעלה בשידור חי' וסמל 'הפעלה' למצב ההשהיה. מצב הלחצן מתעדכן באופן אוטומטי כדי לשקף את מצב ההפעלה הנוכחי במכשיר של המקבל. כשמקישים על הלחצן, ההפעלה של המדיה שנטענה כרגע מושהית או ממשיכים במכשיר המקבל. הלחצן יושבת אם המדיה שנטענה כרגע לא תומכת בהשהיה, אם ההפעלה לא מתבצעת או מושהית כרגע, או אם לא מתבצעת כרגע מדיה נטענת, או אם אין סשן העברה פעיל.
|
readwritenonatomicstrong |
מתג להפעלה/השהיה.
משמש כרכיב ממשק משתמש לשינוי הפעלה והשהיה, בהתאמה אישית, שהאפליקציות מספקות. את יכולה לראות עוד פרטים בכתובת GCKUIPlayPauseToggleController.
- מאז
- 3.4
|
readwritenonatomicweak |
לחצן 'עצירה'.
כשמקישים על הלחצן, ההפעלה של המדיה שנטענה כרגע במקלט מופסקת. אם לא נטענת מדיה כרגע, או אם אין סשן העברה פעיל, הלחצן יושבת.
|
readwritenonatomicweak |
לחצן לדילוג 30 שניות קדימה בפריט המדיה שמופעל עכשיו.
אם לא נטענת מדיה כרגע, או אם אין סשן העברה פעיל, הלחצן יושבת.
|
readwritenonatomicweak |
לחצן להרצה של 30 שניות אחורה בפריט המדיה שמופעל עכשיו.
אם לא נטענת מדיה כרגע, או אם אין סשן העברה פעיל, הלחצן יושבת.
|
readwritenonatomicweak |
לחצן להשהיית ההפעלה של רשימת 'הבאים בתור' כשההפעלה של הפריט הנוכחי תסתיים.
|
readwritenonatomicweak |
לחצן 'הבא'.
כשמקישים על הלחצן, ההפעלה עוברת לפריט המדיה הבא בתור. הלחצן יושבת אם הפעולה לא נתמכת, אם לא נטענת מדיה כרגע או אם אין סשן העברה פעיל.
|
readwritenonatomicweak |
לחצן "הקודם".
כשמקישים על הלחצן, ההפעלה עוברת לפריט המדיה הקודם בתור. הלחצן יושבת אם הפעולה לא נתמכת, אם לא נטענת מדיה כרגע או אם אין סשן העברה פעיל.
|
readwritenonatomicweak |
לחצן לרכיבה על אופניים בין מצבי החזרה הזמינים בתור.
(פרטים נוספים זמינים ב-GCKMediaRepeatMode). מבצע הקריאה החוזרת צריך להגדיר סמלים מתאימים למצבי הלחצן GCKUIButtonStateRepeatOff, GCKUIButtonStateRepeatSingle, GCKUIButtonStateRepeatAll ו-GCKUIButtonStateShuffle. מצב הלחצן מתעדכן באופן אוטומטי כדי לשקף את מצב החזרה הנוכחי של התור במכשיר המקבל. הקשה על הלחצן תעביר למצב החזרה הבא, לפי הסדר:
GCKMediaRepeatModeOff ← GCKMediaRepeatModeAll ← GCKMediaRepeatModeSingle ← GCKMediaRepeatModeAllAndShuffle
אם אין כרגע סשן העברה פעיל, הלחצן יושבת.
|
readwritenonatomicweak |
פס הזזה להצגה ולשינוי של המיקום הנוכחי של השידור.
כשהמשתמש משנה את ערך פס ההזזה, מיקום הסטרימינג של המדיה שנטענה כרגע מתעדכן במקלט. בזמן שמתבצעת הפעלה של המדיה במכשיר המקבל, הערך של פס ההזזה מתעדכן בזמן אמת כדי לשקף את המיקום הנוכחי של הסטרימינג. פס ההזזה יושבת אם המדיה שנטענה כרגע לא תומכת בדילוג, או אם לא נטענה מדיה כרגע או אם אין סשן העברה פעיל.
|
readwritenonatomicweak |
תצוגה שמראה את ההתקדמות הנוכחית של השידור.
בזמן הפעלת המדיה במכשיר המקבל, ערך הצפיות מתעדכן בזמן אמת כדי לשקף את המיקום הנוכחי של השידור. אם המדיה שנטענה כרגע היא שידור חי, או אם לא נטענת מדיה כרגע, או אם אין סשן העברה פעיל, התצוגה תושבת.
|
readwritenonatomicweak |
תווית להצגת המיקום הנוכחי של השידור, בדקות ובשניות.
אם לא נטענה אף מדיה כרגע, או אם אין סשן העברה פעיל, התווית תציג תבנית מותאמת לשוק המקומי – "--:--".
|
readwritenonatomicweak |
תווית להצגת משך השידור הנוכחי, בדקות ובשניות.
אם למדיה שנטענה כרגע אין משך זמן (לדוגמה, אם זהו שידור חי), או אם לא נטענת מדיה כרגע, או אם אין סשן העברה פעיל כרגע, התווית תציג תבנית מותאמת לשוק המקומי של "--:--".
|
readwritenonatomicweak |
תווית להצגת זמן השידור שנותר (משך הזמן פחות המיקום) בדקות ובשניות.
אם למדיה שנטענה כרגע אין משך זמן (לדוגמה, אם זהו שידור חי), או אם לא נטענת מדיה כרגע, או אם אין סשן העברה פעיל כרגע, התווית תציג תבנית מותאמת לשוק המקומי של "--:--".
|
readwritenonatomicstrong |
בקר למיקום של זרם.
משמש כמיקום של סטרימינג בהתאמה אישית שסופק על ידי אפליקציה, או בממשק משתמש לחיפוש. את יכולה לראות עוד פרטים בכתובת GCKUIStreamPositionController.
- מאז
- 3.4
|
readwritenonatomicstrong |
|
readwritenonatomicassign |
האם זמן השידור שנותר יוצג כערך שלילי, לדוגמה, ' -1:23:45'.
כברירת מחדל, הנכס הזה מוגדר לערך YES
.
|
readwritenonatomicassign |
אם הפקדים של מיקום השידור (כולל פס ההזזה של מיקום השידור, תווית המיקום של השידור, תווית משך השידור ותצוגת ההתקדמות של השידור) צריכים להיות מוסתרים בתוכן בשידור חי.
ערך ברירת המחדל הוא NO
.
- מאז
- 4.0
|
readwritenonatomicweak |
לחצן לבחירת טראקים של אודיו ו/או כתוביות.
כשמקישים על הלחצן, ממשק המשתמש לבחירת טראקים של מדיה מוצג למשתמש. הלחצן יושבת אם למדיה שנטענה כרגע אין טראקים שניתן לבחור עבורם מדיה, או אם לא נטענת מדיה כרגע, או אם אין סשן העברה פעיל כרגע.
|
readwritenonatomicweak |
תווית להצגת כותרת משנה של המדיה שנטענה כרגע.
אם אין שדה של כתוביות שמוגדר במפורש במטא-נתונים, הלייבל יציג את שדה המטא-נתונים המתאים ביותר לפי סוג המדיה. לדוגמה, שם האולפן של סרט או שם האומן של טראק מוזיקה.
|
readwritenonatomicweak |
תצוגת אינדיקטור של פעילות, שמציינת שהמדיה במצב טעינה.
|
readwritenonatomicweak |
תווית להצגת משך הזמן שנותר עד שניתן לדלג על המודעה.
- מאז
- 4.3
|
readwritenonatomicweak |
לחצן לדילוג על המודעה הנוכחית.
- מאז
- 4.3