סקירה כללית

בקר לתצוגות ממשק משתמש המשמש לשליטה או להצגת הסטטוס של הפעלת מדיה במקלט 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

פרטי הנכס

- (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. מצב הלחצן מתעדכן באופן אוטומטי כדי לשקף את מצב החזרה הנוכחי של התור במכשיר המקבל. הקשה על הלחצן תעביר למצב החזרה הבא, לפי הסדר:

GCKMediaRepeatModeOff ← GCKMediaRepeatModeAll ← GCKMediaRepeatModeSingle ← GCKMediaRepeatModeAllAndShuffle

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

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

סיווג GCKUIMediaController

סקירה כללית

סיכום שיטות של מכונה

סיכום הנכס

פרטי השיטה

פרטי הנכס