סיווג GCKUIMediaController

הפניה למחלקה GCKUIMediaController

סקירה כללית

בקר לתצוגות ממשק משתמש המשמש לשליטה או להצגת הסטטוס של הפעלת מדיה במקלט 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< GCKUIMediaControllerDelegatedelegate
 מיופה כוח לקבלת התראות מ-GCKUIMediaController. עוד...
 
GCKSessionsession
 הסשן שמשויך לבקר הזה. עוד...
 
BOOL mediaLoaded
 האם מדיה נטענת (או נטענת) כרגע במקלט. עוד...
 
BOOL hasCurrentQueueItem
 האם יש פריט נוכחי בתור. עוד...
 
BOOL hasLoadingQueueItem
 האם יש פריט שנטען מראש בתור. עוד...
 
GCKMediaPlayerState lastKnownPlayerState
 המצב העדכני של נגן המדיה הידוע. עוד...
 
NSTimeInterval lastKnownStreamPosition
 המיקום הידוע האחרון של זרם מדיה. עוד...
 
UIButton * playButton
 לחצן 'הפעלה'. עוד...
 
UIButton * pauseButton
 לחצן 'השהיה'. עוד...
 
GCKUIMultistateButtonplayPauseToggleButton
 לחצן להפעלה/השהיה. עוד...
 
GCKUIPlayPauseToggleControllerplayPauseToggleController
 מתג להפעלה/השהיה. עוד...
 
UIButton * stopButton
 לחצן 'עצירה'. עוד...
 
UIButton * forward30SecondsButton
 לחצן לדילוג 30 שניות קדימה בפריט המדיה שמופעל עכשיו. עוד...
 
UIButton * rewind30SecondsButton
 לחצן להרצה של 30 שניות אחורה בפריט המדיה שמופעל עכשיו. עוד...
 
UIButton * pauseQueueButton
 לחצן להשהיית ההפעלה של רשימת 'הבאים בתור' כשההפעלה של הפריט הנוכחי תסתיים. עוד...
 
UIButton * nextButton
 לחצן 'הבא'. עוד...
 
UIButton * previousButton
 לחצן "הקודם". עוד...
 
GCKUIMultistateButtonrepeatModeButton
 לחצן לרכיבה על אופניים בין מצבי החזרה הזמינים בתור. עוד...
 
UISlider * streamPositionSlider
 פס הזזה להצגה ולשינוי של המיקום הנוכחי של השידור. עוד...
 
UIProgressView * streamProgressView
 תצוגה שמראה את ההתקדמות הנוכחית של השידור. עוד...
 
UILabel * streamPositionLabel
 תווית להצגת המיקום הנוכחי של השידור, בדקות ובשניות. עוד...
 
UILabel * streamDurationLabel
 תווית להצגת משך השידור הנוכחי, בדקות ובשניות. עוד...
 
UILabel * streamTimeRemainingLabel
 תווית להצגת זמן השידור שנותר (משך הזמן פחות המיקום) בדקות ובשניות. עוד...
 
GCKUIStreamPositionControllerstreamPositionController
 בקר למיקום של זרם. עוד...
 
GCKUIPlaybackRateControllerplaybackRateController
 בקר לקצב ההפעלה של סטרימינג. עוד...
 
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
labelThe UILabel that will display the value.
keyThe metadata key.
- (void) bindLabel: (UILabel *)  label
toMetadataKey: (NSString *)  key
withFormatter: (GCKUIValueFormatter formatter 

מקשרת UILabel למפתח מטא-נתונים.

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

בכתובת GCKMediaMetadata מופיעה רשימה של מפתחות מטא-נתונים שהוגדרו מראש.

Parameters
labelThe UILabel that will display the value.
keyThe metadata key.
formatterA block that will produce the desired string representation of the value.
- (void) bindTextView: (UITextView *)  textView
toMetadataKey: (NSString *)  key 

מחייבת UITextView למפתח מטא נתונים.

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

בכתובת GCKMediaMetadata מופיעה רשימה של מפתחות מטא-נתונים שהוגדרו מראש.

Parameters
textViewThe UITextView that will display the value.
keyThe metadata key.
- (void) bindTextView: (UITextView *)  textView
toMetadataKey: (NSString *)  key
withFormatter: (GCKUIValueFormatter formatter 

מחייבת UITextView למפתח מטא נתונים.

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

בכתובת GCKMediaMetadata מופיעה רשימה של מפתחות מטא-נתונים שהוגדרו מראש.

Parameters
textViewThe UITextView that will display the value.
keyThe metadata key.
formatterA block that will produce the desired string representation of the value.
- (void) bindImageView: (UIImageView *)  imageView
toImageHints: (GCKUIImageHints *)  imageHints 

מחייבת UIImageView למופע של GCKUIImageHints.

ה-GCKUIImagePicker שמותקן כרגע ישמש לבחירת תמונה מהמטא-נתונים של התצוגה.

Parameters
imageViewThe UIImageView that will display the selected image.
imageHintsThe image hints.
- (void) bindControlView: (UIControl *)  control
toRewindForTime: (NSTimeInterval)  rewindSeconds 

הפונקציה מחייבת UIControl כדי להריץ לאחור את ההפעלה של הפריט הנוכחי בערך שנקבע לשניות.

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

Parameters
controlThe UI element that the user interacts with. Typically this would be an instance of UIButton.
rewindSecondsThe number of seconds to rewind the media.
- (void) bindControlView: (UIControl *)  control
toForwardForTime: (NSTimeInterval)  forwardSeconds 

הפונקציה מחייבת UIControl כדי להעביר את ההפעלה של הפריט הנוכחי בערך שהועבר כשניות.

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

Parameters
controlThe UI element that the user interacts with. Typically this would be an instance of UIButton.
forwardSecondsThe number of seconds to skip the media.
- (void) unbindView: (UIView *)  view

ביטול הקישור של התצוגה שצוינה.

Parameters
viewThe view to unbind.
- (void) unbindAllViews

ביטול הקישור של כל התצוגות המפורטות.

- (GCKMediaRepeatMode) cycleRepeatMode

משנה את מצב החזרה עבור התור למצב הבא במחזור:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

החזרות
מצב החזרה החדש.
- (void) selectTracks

שיטה נוחה להצגת ממשק המשתמש לבחירת טראק של מדיה.

- (void) skipAd

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

מאז
4.3

פרטי הנכס

- (id<GCKUIMediaControllerDelegate>) delegate
readwritenonatomicweak

מיופה כוח לקבלת התראות מ-GCKUIMediaController.

- (GCKSession*) session
readnonatomicstrong

הסשן שמשויך לבקר הזה.

- (BOOL) mediaLoaded
readnonatomicassign

האם מדיה נטענת (או נטענת) כרגע במקלט.

אם אין סשן העברה פעיל, הערך יהיה NO.

- (BOOL) hasCurrentQueueItem
readnonatomicassign

האם יש פריט נוכחי בתור.

- (BOOL) hasLoadingQueueItem
readnonatomicassign

האם יש פריט שנטען מראש בתור.

- (GCKMediaPlayerState) lastKnownPlayerState
readnonatomicassign

המצב העדכני של נגן המדיה הידוע.

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

- (NSTimeInterval) lastKnownStreamPosition
readnonatomicassign

המיקום הידוע האחרון של זרם מדיה.

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

- (UIButton*) playButton
readwritenonatomicweak

לחצן 'הפעלה'.

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

- (UIButton*) pauseButton
readwritenonatomicweak

לחצן 'השהיה'.

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

- (GCKUIMultistateButton*) playPauseToggleButton
readwritenonatomicweak

לחצן להפעלה/השהיה.

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

- (GCKUIPlayPauseToggleController*) playPauseToggleController
readwritenonatomicstrong

מתג להפעלה/השהיה.

משמש כרכיב ממשק משתמש לשינוי הפעלה והשהיה, בהתאמה אישית, שהאפליקציות מספקות. את יכולה לראות עוד פרטים בכתובת GCKUIPlayPauseToggleController.

מאז
3.4
- (UIButton*) stopButton
readwritenonatomicweak

לחצן 'עצירה'.

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

- (UIButton*) forward30SecondsButton
readwritenonatomicweak

לחצן לדילוג 30 שניות קדימה בפריט המדיה שמופעל עכשיו.

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

- (UIButton*) rewind30SecondsButton
readwritenonatomicweak

לחצן להרצה של 30 שניות אחורה בפריט המדיה שמופעל עכשיו.

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

- (UIButton*) pauseQueueButton
readwritenonatomicweak

לחצן להשהיית ההפעלה של רשימת 'הבאים בתור' כשההפעלה של הפריט הנוכחי תסתיים.

- (UIButton*) nextButton
readwritenonatomicweak

לחצן 'הבא'.

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

- (UIButton*) previousButton
readwritenonatomicweak

לחצן "הקודם".

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

- (GCKUIMultistateButton*) repeatModeButton
readwritenonatomicweak

לחצן לרכיבה על אופניים בין מצבי החזרה הזמינים בתור.

(פרטים נוספים זמינים ב-GCKMediaRepeatMode). מבצע הקריאה החוזרת צריך להגדיר סמלים מתאימים למצבי הלחצן GCKUIButtonStateRepeatOff, GCKUIButtonStateRepeatSingle, GCKUIButtonStateRepeatAll ו-GCKUIButtonStateShuffle. מצב הלחצן מתעדכן באופן אוטומטי כדי לשקף את מצב החזרה הנוכחי של התור במכשיר המקבל. הקשה על הלחצן תעביר למצב החזרה הבא, לפי הסדר:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

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

- (UISlider*) streamPositionSlider
readwritenonatomicweak

פס הזזה להצגה ולשינוי של המיקום הנוכחי של השידור.

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

- (UIProgressView*) streamProgressView
readwritenonatomicweak

תצוגה שמראה את ההתקדמות הנוכחית של השידור.

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

- (UILabel*) streamPositionLabel
readwritenonatomicweak

תווית להצגת המיקום הנוכחי של השידור, בדקות ובשניות.

אם לא נטענה אף מדיה כרגע, או אם אין סשן העברה פעיל, התווית תציג תבנית מותאמת לשוק המקומי – "--:--".

- (UILabel*) streamDurationLabel
readwritenonatomicweak

תווית להצגת משך השידור הנוכחי, בדקות ובשניות.

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

- (UILabel*) streamTimeRemainingLabel
readwritenonatomicweak

תווית להצגת זמן השידור שנותר (משך הזמן פחות המיקום) בדקות ובשניות.

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

- (GCKUIStreamPositionController*) streamPositionController
readwritenonatomicstrong

בקר למיקום של זרם.

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

מאז
3.4
- (GCKUIPlaybackRateController*) playbackRateController
readwritenonatomicstrong

בקר לקצב ההפעלה של סטרימינג.

את יכולה לראות עוד פרטים בכתובת GCKUIPlaybackRateController.

מאז
4.0
- (BOOL) displayTimeRemainingAsNegativeValue
readwritenonatomicassign

האם זמן השידור שנותר יוצג כערך שלילי, לדוגמה, ' -1:23:45'.

כברירת מחדל, הנכס הזה מוגדר לערך YES.

- (BOOL) hideStreamPositionControlsForLiveContent
readwritenonatomicassign

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

ערך ברירת המחדל הוא NO.

מאז
4.0
- (UIButton*) tracksButton
readwritenonatomicweak

לחצן לבחירת טראקים של אודיו ו/או כתוביות.

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

- (UILabel*) smartSubtitleLabel
readwritenonatomicweak

תווית להצגת כותרת משנה של המדיה שנטענה כרגע.

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

- (UIActivityIndicatorView*) mediaLoadingIndicator
readwritenonatomicweak

תצוגת אינדיקטור של פעילות, שמציינת שהמדיה במצב טעינה.

- (UILabel*) skipAdLabel
readwritenonatomicweak

תווית להצגת משך הזמן שנותר עד שניתן לדלג על המודעה.

מאז
4.3
- (UIButton*) skipAdButton
readwritenonatomicweak

לחצן לדילוג על המודעה הנוכחית.

מאז
4.3