סקירה כללית

בקר לתצוגות בממשק המשתמש שמשמשות לשליטה בהפעלה של מדיה במכשיר 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< GCKUIMediaControllerDelegate >	delegate
	הנציג לקבלת התראות מ-GCKUIMediaController. עוד...

GCKSession *	session
	הסשן שמשויך לבקר הזה. עוד...

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

BOOL	hasCurrentQueueItem
	האם יש פריט נוכחי בתור. עוד...

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

GCKMediaPlayerState	lastKnownPlayerState
	המצב האחרון הידוע של נגן המדיה. עוד...

NSTimeInterval	lastKnownStreamPosition
	המיקום האחרון הידוע בשידור המדיה. עוד...

UIButton *	playButton
	לחצן 'הפעלה'. עוד...

UIButton *	pauseButton
	לחצן 'השהיה'. עוד...

GCKUIButton *	playPauseToggleButton
	כפתור הפעלה או השהיה. עוד...

GCKUIPlayPauseToggleController *	playPauseToggleController
	בקר הפעלה/השהיה. עוד...

UIButton *	stopButton
	לחצן 'עצירה'. עוד...

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

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

UIButton *	pauseQueueButton
	לחצן להשהיית ההפעלה של התור אחרי שהפריט הנוכחי יסיים את ההפעלה. עוד...

UIButton *	nextButton
	לחצן 'הבא'. עוד...

UIButton *	previousButton
	לחצן 'הקודם'. עוד...

GCKUIButton *	repeatModeButton
	לחצן למעבר בין מצבי החזרה הזמינים של התור. עוד...

UISlider *	streamPositionSlider
	פס הזזה להצגה ולשינוי של המיקום הנוכחי בשידור. עוד...

UIProgressView *	streamProgressView
	תצוגה להצגת התקדמות השידור הנוכחי. עוד...

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

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

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

GCKUIStreamPositionController *	streamPositionController
	בקר מיקום בשידור. עוד...

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

UIButton *	tracksButton
	לחצן לבחירת פסקול או כתוביות. עוד...

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

UIActivityIndicatorView *	mediaLoadingIndicator
	תצוגה של אינדיקטור פעילות שמציין שהמדיה במצב טעינה. עוד...

פרטי השיטה

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

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

Parameters

imageView	The UIImageView that will display the selected image.
imageHints	The image hints.

- (void) unbindView: (UIView *) view

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

Parameters

view	The view to unbind.

- (void) unbindAllViews

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

- (GCKMediaRepeatMode) cycleRepeatMode

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

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

החזרות: מצב החזרה החדש.

- (void) selectTracks

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

פרטי הנכס

- (id<GCKUIMediaControllerDelegate>) delegate

readwritenonatomicweak

הנציג לקבלת התראות מ-GCKUIMediaController.

- (GCKSession*) session

readnonatomicstrong

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

- (BOOL) mediaLoaded

readnonatomicassign

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

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

- (BOOL) hasCurrentQueueItem

readnonatomicassign

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

- (BOOL) hasLoadingQueueItem

readnonatomicassign

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

- (GCKMediaPlayerState) lastKnownPlayerState

readnonatomicassign

המצב האחרון הידוע של נגן המדיה.

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

- (NSTimeInterval) lastKnownStreamPosition

readnonatomicassign

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

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

- (UIButton*) playButton

readwritenonatomicweak

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

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

- (UIButton*) pauseButton

readwritenonatomicweak

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

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

- (GCKUIButton*) playPauseToggleButton

readwritenonatomicweak

כפתור הפעלה או השהיה.

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

- (GCKUIPlayPauseToggleController*) playPauseToggleController

readwritenonatomicstrong

בקר הפעלה/השהיה.

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

מאז: 3.4

- (UIButton*) stopButton

readwritenonatomicweak

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

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

- (GCKUIButton*) forward30SecondsButton

readwritenonatomicweak

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

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

- (GCKUIButton*) rewind30SecondsButton

readwritenonatomicweak

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

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

- (UIButton*) pauseQueueButton

readwritenonatomicweak

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

- (UIButton*) nextButton

readwritenonatomicweak

לחצן 'הבא'.

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

- (UIButton*) previousButton

readwritenonatomicweak

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

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

- (GCKUIButton*) repeatModeButton

readwritenonatomicweak

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

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

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

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

- (UISlider*) streamPositionSlider

readwritenonatomicweak

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

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

- (UIProgressView*) streamProgressView

readwritenonatomicweak

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

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

- (UILabel*) streamPositionLabel

readwritenonatomicweak

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

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

- (UILabel*) streamDurationLabel

readwritenonatomicweak

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

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

- (UILabel*) streamTimeRemainingLabel

readwritenonatomicweak

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

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

- (GCKUIStreamPositionController*) streamPositionController

readwritenonatomicstrong

בקר מיקום בשידור.

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

מאז: 3.4

- (BOOL) displayTimeRemainingAsNegativeValue

readwritenonatomicassign

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

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

- (UIButton*) tracksButton

readwritenonatomicweak

לחצן לבחירת פסקול או כתוביות.

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

- (UILabel*) smartSubtitleLabel

readwritenonatomicweak

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

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

- (UIActivityIndicatorView*) mediaLoadingIndicator

readwritenonatomicweak

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

סיווג GCKUIMediaController קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

סקירה כללית

סיכום שיטות המופע

סיכום הנכס

פרטי השיטה

פרטי הנכס

סיווג GCKUIMediaController