סקירה כללית

מחלקה שמכילה אובייקטים ומצב גלובליים ל-framework.

ההקשר חייב להתחיל בשלב מוקדם במחזור החיים של האפליקציה באמצעות קריאה ל-setSharedInstanceWithOptions: (GCKCastContext).

מאז: 3.0

יורש את NSObject.

סיכום שיטות של מכונה
(void)	- registerDeviceProvider:
	רושם ספק מכשירים, כדי להוסיף תמיכה בסוג חדש של מכשיר (לא העברה). עוד...

(void)	- unregisterDeviceProviderForCategory:
	מבטל את הרישום של ספק המכשירים בקטגוריית מכשירים נתונה. עוד...

(void)	- setLaunchCredentialsData:
	מגדיר את נתוני פרטי הכניסה של המשתמש הנוכחי. עוד...

(void)	- presentCastDialog
	מציג את תיבת הדו-שיח 'העברה'. עוד...

(GCKUICastContainerViewController *)	- createCastContainerControllerForViewController:
	הפונקציה יוצרת GCKUICastContainerViewController שמטמיעה את בקר התצוגה הנתון. עוד...

(GCKUIMiniMediaControlsViewController *)	- createMiniMediaControlsViewController
	הפונקציה יוצרת GCKUIMiniMediaControlsViewController. עוד...

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

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

(void)	- clearCastInstructionsShownFlag
	פעולה זו מנקה את הסימון הקבוע שעוקב אחר הצגת בקר התצוגה המפורטת של הוראות ההעברה (cast). עוד...

(void)	- presentDefaultExpandedMediaControls
	הצגה של פקדי המדיה המורחבת של Cast שמוגדרים כברירת מחדל. עוד...

סיכום של שיטת כיתה
(void)	+ setSharedInstanceWithOptions:
	מגדיר את המופע המשותף ומספק אובייקט של אפשרויות העברה. עוד...

(BOOL)	+ setSharedInstanceWithOptions:error:
	מגדיר את המופע המשותף ומספק אובייקט של אפשרויות העברה. עוד...

(instancetype)	+ sharedInstance
	מחזירה את המופע של singleton. עוד...

(BOOL)	+ isSharedInstanceInitialized
	הפונקציה בודקת אם המופע של singleton כבר אותחל. עוד...

מאפיינים ציבוריים
NSString *const	kGCKNotificationKeyCastState
	המפתח `userInfo` למצב ההעברה החדש בהודעה על שינוי מצב העברה. עוד...

NSString *const	kGCKCastStateDidChangeNotification
	שם ההודעה שתפורסם כשמצב ההעברה ישתנה. עוד...

NSString *const	kGCKExpandedMediaControlsTriggeredNotification
	שם ההתראה שתפורסם כשפקדי המדיה המורחבת יוצגו למשתמשים. עוד...

NSString *const	kGCKUICastDialogWillShowNotification
	שם ההודעה שתפורסם כשתיבת הדו-שיח 'העברה' תוצג. עוד...

NSString *const	kGCKUICastDialogDidHideNotification
	שם ההתראה שתפורסם כשתיבת הדו-שיח 'העברה' תיסגר. עוד...

סיכום הנכס
GCKCastState	castState
	מצב ההעברה הנוכחי של האפליקציה. עוד...

GCKDiscoveryManager *	discoveryManager
	מנהל הגילוי. עוד...

GCKSessionManager *	sessionManager
	מנהל הסשן. עוד...

id< GCKUIImageCache >	imageCache
	הטמעת מטמון התמונות שתשמש את ה-framework לאחזור תמונות שמתבצעת אליהן הפניה במטא-נתונים של מדיה. עוד...

id< GCKUIImagePicker >	imagePicker
	ההטמעה של בוחר התמונות שתשמש לבחירת תמונה למטרה ספציפית. עוד...

BOOL	useDefaultExpandedMediaControls
	המדיניות הזו מגדירה את ההתנהגות של ה-framework כשיש פעולת משתמש שאמורה לגרום להצגה של הפקדים המורחבים. עוד...

GCKUIExpandedMediaControlsViewController *	defaultExpandedMediaControlsViewController
	המופע של בקר התצוגה של פקדי המדיה המורחבת של Cast שמוגדר כברירת מחדל. עוד...

פרטי השיטה

+ (void) setSharedInstanceWithOptions: (GCKCastOptions *) options

מגדיר את המופע המשותף ומספק אובייקט של אפשרויות העברה.

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

Parameters

options The Cast options.

+ (BOOL) setSharedInstanceWithOptions:	(GCKCastOptions *)	options
error:	(GCKError _Nullable _Nullable)	error

מגדיר את המופע המשותף ומספק אובייקט של אפשרויות העברה.

הקריאה תיכשל אם ההקשר כבר אותחל. צריך לקרוא לשיטה הזו ב-thread הראשי.

Parameters

options	The Cast options.
error	A pointer at which to store the error in case of a failure.

החזרות: YES - בהצלחה, NO - כישלון.

מאז: 4.0

+ (instancetype) sharedInstance

מחזירה את המופע של singleton.

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

+ (BOOL) isSharedInstanceInitialized

הפונקציה בודקת אם המופע של singleton כבר אותחל.

מאז: 3.5.4

- (void) registerDeviceProvider: (GCKDeviceProvider *) deviceProvider

רושם ספק מכשירים, כדי להוסיף תמיכה בסוג חדש של מכשיר (לא העברה).

Parameters

deviceProvider An instance of a GCKDeviceProvider subclass for managing the devices.

- (void) unregisterDeviceProviderForCategory: (NSString *) category

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

Parameters

category A string that uniquely identifies the type of device.

- (void) setLaunchCredentialsData: (GCKCredentialsData *_Nullable) credentialsData

מגדיר את נתוני פרטי הכניסה של המשתמש הנוכחי.

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

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

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

Parameters

credentialsData An instance of GCKCredentialsData. May be nil.

- (void) presentCastDialog

מציג את תיבת הדו-שיח 'העברה'.

סופק לפי קטגוריה GCKCastContext(UI).

- (GCKUICastContainerViewController *) createCastContainerControllerForViewController: (UIViewController *) viewController

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

סופק לפי קטגוריה GCKCastContext(UI).

- (GCKUIMiniMediaControlsViewController *) createMiniMediaControlsViewController

הפונקציה יוצרת GCKUIMiniMediaControlsViewController.

סופק לפי קטגוריה GCKCastContext(UI).

- (BOOL) presentCastInstructionsViewControllerOnce

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

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

Deprecated:: משתמשים ב-presentCastinstructionsViewController ברגעWithCastbutton:.

סופק לפי קטגוריה GCKCastContext(UI).

- (BOOL) presentCastInstructionsViewControllerOnceWithCastButton: (GCKUICastButton *) castButton

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

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

מאז: 4.1

סופק לפי קטגוריה GCKCastContext(UI).

- (void) clearCastInstructionsShownFlag

פעולה זו מנקה את הסימון הקבוע שעוקב אחר הצגת בקר התצוגה המפורטת של הוראות ההעברה (cast).

סופק לפי קטגוריה GCKCastContext(UI).

- (void) presentDefaultExpandedMediaControls

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

סופק לפי קטגוריה GCKCastContext(UI).

תיעוד בנושא נתוני חברים

- (NSString* const) kGCKNotificationKeyCastState

המפתח userInfo למצב ההעברה החדש בהודעה על שינוי מצב העברה.

- (NSString* const) kGCKCastStateDidChangeNotification

שם ההודעה שתפורסם כשמצב ההעברה ישתנה.

- (NSString* const) kGCKExpandedMediaControlsTriggeredNotification

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

- (NSString* const) kGCKUICastDialogWillShowNotification

שם ההודעה שתפורסם כשתיבת הדו-שיח 'העברה' תוצג.

מאז: 3.4

- (NSString* const) kGCKUICastDialogDidHideNotification

שם ההתראה שתפורסם כשתיבת הדו-שיח 'העברה' תיסגר.

מאז: 3.4

פרטי הנכס

- (GCKCastState) castState

readnonatomicassign

מצב ההעברה הנוכחי של האפליקציה.

ניתן לעקוב אחר שינויים בנכס הזה באמצעות KVO או על ידי האזנה להתראות של kGCKCastStateDidChangeNotification.

- (GCKDiscoveryManager*) discoveryManager

readnonatomicstrong

מנהל הגילוי.

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

- (GCKSessionManager*) sessionManager

readnonatomicstrong

מנהל הסשן.

האובייקט הזה מנהל את האינטראקציה עם מכשירי המקבל.

- (id<GCKUIImageCache>) imageCache

readwritenonatomicstrong

הטמעת מטמון התמונות שתשמש את ה-framework לאחזור תמונות שמתבצעת אליהן הפניה במטא-נתונים של מדיה.

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

סופק לפי קטגוריה GCKCastContext(UI).

- (id<GCKUIImagePicker>) imagePicker

readwritenonatomicstrong

ההטמעה של בוחר התמונות שתשמש לבחירת תמונה למטרה ספציפית.

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

סופק לפי קטגוריה GCKCastContext(UI).

- (BOOL) useDefaultExpandedMediaControls

readwritenonatomicassign

המדיניות הזו מגדירה את ההתנהגות של ה-framework כשיש פעולת משתמש שאמורה לגרום להצגה של הפקדים המורחבים.

אם הערך הוא YES, תוצג ב-framework תצוגת ברירת המחדל של פקדים עם הרחבה. אם הערך הוא NO, ה-framework רק יפעיל GCKCastContext::kGCKExpandedMediaControlsTriggeredNotification.

סופק לפי קטגוריה GCKCastContext(UI).

- (GCKUIExpandedMediaControlsViewController*) defaultExpandedMediaControlsViewController

readnonatomicstrong

המופע של בקר התצוגה של פקדי המדיה המורחבת של Cast שמוגדר כברירת מחדל.

סופק לפי קטגוריה GCKCastContext(UI).

שיעור GCKCastContext

סקירה כללית

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

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

מאפיינים ציבוריים

סיכום הנכס

פרטי השיטה

תיעוד בנושא נתוני חברים

פרטי הנכס