מחלקה של 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) - unbindView:
 ביטול הקישור של התצוגה שצוינה. עוד...
 
(void) - unbindAllViews
 ביטול הקישור של כל התצוגות המקושרות. עוד...
 
(GCKMediaRepeatMode- cycleRepeatMode
 משנה את מצב החזרה של התור למצב הבא במחזור: עוד...
 
(void) - selectTracks
 שיטה נוחה להצגת ממשק המשתמש לבחירת טראק של מדיה. עוד...
 

סיכום הנכס

id< GCKUIMediaControllerDelegatedelegate
 בעל הגישה לקבלת הודעות מ-GCKUIMediaController. עוד...
 
GCKSessionsession
 הסשן המשויך לבקר הזה. עוד...
 
BOOL mediaLoaded
 האם מדיה שנטענה (או נטענת) במקלט כרגע. עוד...
 
BOOL hasCurrentQueueItem
 אם קיים פריט בתור. עוד...
 
BOOL hasLoadingQueueItem
 אם יש פריט שנטען מראש בתור. עוד...
 
GCKMediaPlayerState lastKnownPlayerState
 המצב העדכני של נגן המדיה הידוע. עוד...
 
NSTimeInterval lastKnownStreamPosition
 המיקום העדכני ביותר של זרם המדיה. עוד...
 
UIButton * playButton
 לחצן "הפעלה". עוד...
 
UIButton * pauseButton
 לחצן 'השהיה'. עוד...
 
GCKUIButtonplayPauseToggleButton
 לחצן החלפת מצב "הפעלה/השהיה". עוד...
 
GCKUIPlayPauseToggleControllerplayPauseToggleController
 שלט רחוק מסוג 'הפעלה/השהיה'. עוד...
 
UIButton * stopButton
 לחצן "עצירה". עוד...
 
GCKUIButtonforward30SecondsButton
 לחצן לחיפוש 30 שניות קדימה בפריט המדיה שפועל כעת. עוד...
 
GCKUIButtonrewind30SecondsButton
 לחצן לחיפוש 30 שניות אחורה בפריט המדיה שמופעל עכשיו. עוד...
 
UIButton * pauseQueueButton
 לחצן להשהיית ההפעלה של 'הבאים בתור' ברגע שהפריט הנוכחי מסתיים. עוד...
 
UIButton * nextButton
 לחצן "הבא". עוד...
 
UIButton * previousButton
 לחצן "הקודם". עוד...
 
GCKUIButtonrepeatModeButton
 לחצן לרכיבה על אופניים במצבים הזמינים של 'הבאים בתור' בתור. עוד...
 
UISlider * streamPositionSlider
 פס הזזה להצגה ולשינוי של מיקום השידור הנוכחי. עוד...
 
UIProgressView * streamProgressView
 תצוגה להצגת ההתקדמות הנוכחית בסטרימינג. עוד...
 
UILabel * streamPositionLabel
 תווית להצגת המיקום הנוכחי של הסטרימינג בדקות ובשניות. עוד...
 
UILabel * streamDurationLabel
 תווית להצגת משך השידור הנוכחי, בדקות ובשניות. עוד...
 
UILabel * streamTimeRemainingLabel
 תווית להצגת זמן השידור שנותר (משך הזמן בניכוי המיקום), בדקות ובשניות. עוד...
 
GCKUIStreamPositionControllerstreamPositionController
 שלט רחוק לרכיבת סטרימינג. עוד...
 
BOOL displayTimeRemainingAsNegativeValue
 אם זמן השידור שנותר יוצג כערך שלילי, לדוגמה, " -1:23:45". עוד...
 
UIButton * tracksButton
 לחצן לבחירת טראקים של אודיו ו/או כתוביות. עוד...
 
UILabel * smartSubtitleLabel
 תווית להצגת כתובית למדיה שטעונה כרגע. עוד...
 
UIActivityIndicatorView * mediaLoadingIndicator
 תצוגת מחוון פעילות לציון המדיה נמצאת במצב טעינה. עוד...
 

פרטי השיטה

- (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.

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

Parameters
imageViewThe UIImageView that will display the selected image.
imageHintsThe image hints.
- (void) unbindView: (UIView *)  view

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

Parameters
viewThe view to unbind.
- (void) unbindAllViews

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

- (GCKMediaRepeatMode) cycleRepeatMode

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

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

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

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

פרטי הנכס

- (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

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

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

- (GCKUIButton*) playPauseToggleButton
readwritenonatomicweak

לחצן החלפת מצב "הפעלה/השהיה".

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

- (GCKUIPlayPauseToggleController*) playPauseToggleController
readwritenonatomicstrong

שלט רחוק מסוג 'הפעלה/השהיה'.

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

סינסה
3.4
- (UIButton*) stopButton
readwritenonatomicweak

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

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

- (GCKUIButton*) forward30SecondsButton
readwritenonatomicweak

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

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

- (GCKUIButton*) rewind30SecondsButton
readwritenonatomicweak

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

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

- (UIButton*) pauseQueueButton
readwritenonatomicweak

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

- (UIButton*) nextButton
readwritenonatomicweak

לחצן "הבא".

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

- (UIButton*) previousButton
readwritenonatomicweak

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

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

- (GCKUIButton*) repeatModeButton
readwritenonatomicweak

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

(ראה GCKMediaRepeatMode). על המתקשר להגדיר סמלים מתאימים למצבים UIControlStatenormal (חזרה על לחצן ההפעלה), GCKUIControlStateRepeatSingle, GCKUIControlStateRepeatAll ו-GCKUIControlStateShuffle. מצב הלחצן מתעדכן באופן אוטומטי כדי לשקף את מצב החזרה הנוכחי של המקלט במקלט. הקשה על הלחצן חוזרת למצב החזרה הבא, לפי הסדר:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

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

- (UISlider*) streamPositionSlider
readwritenonatomicweak

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

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

- (UIProgressView*) streamProgressView
readwritenonatomicweak

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

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

- (UILabel*) streamPositionLabel
readwritenonatomicweak

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

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

- (UILabel*) streamDurationLabel
readwritenonatomicweak

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

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

- (UILabel*) streamTimeRemainingLabel
readwritenonatomicweak

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

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

- (GCKUIStreamPositionController*) streamPositionController
readwritenonatomicstrong

שלט רחוק לרכיבת סטרימינג.

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

סינסה
3.4
- (BOOL) displayTimeRemainingAsNegativeValue
readwritenonatomicassign

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

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

- (UIButton*) tracksButton
readwritenonatomicweak

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

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

- (UILabel*) smartSubtitleLabel
readwritenonatomicweak

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

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

- (UIActivityIndicatorView*) mediaLoadingIndicator
readwritenonatomicweak

תצוגת מחוון פעילות לציון המדיה נמצאת במצב טעינה.