סקירה כללית

שלט למכשירי Cast.

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

מופע GCKDeviceManager צריך להישאר בתחום כל עוד נוצר חיבור למכשיר Cast, או כל עוד החיבור נמצא בתהליך של יצירה או פירוק. אפשר לשחרר את האובייקט לפני שהתחיל חיבור עם connect (GCKDeviceManager), או אחרי שהופעלה קריאה חוזרת (callback) של נציג deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) או deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p).

Deprecated:: משתמשים ב-GCKSessionManager וב-GCKCastSession כדי לנהל אינטראקציה עם מכשירי Cast.

המחלקות האלה יורשות מ-NSObject.

סיכום שיטות המופע
(instancetype)	- initWithDevice:clientPackageName:
	יוצר אובייקט GCKDeviceManager חדש עם המכשיר שצוין. עוד...

(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	מאותחל ייעודי. עוד...

(void)	- connect
	מתחברים למכשיר. עוד...

(void)	- disconnect
	התנתקות מהמכשיר. עוד...

(void)	- disconnectWithLeave:
	התנתקות מהמכשיר. עוד...

(BOOL)	- addChannel:
	הוספת ערוץ שדרכו אפשר לשלוח ולקבל הודעות במכשיר הזה במרחב שמות מסוים. עוד...

(BOOL)	- removeChannel:
	מסיר ערוץ שנוסף בעבר. עוד...

(NSInteger)	- launchApplication:
	הפעלת אפליקציה. עוד...

(NSInteger)	- launchApplication:withLaunchOptions:
	מפעיל אפליקציה באמצעות אפשרויות ההפעלה שצוינו. עוד...

(NSInteger)	- launchApplication:relaunchIfRunning:
	מפעיל אפליקציה, ואם היא כבר פועלת, מפעיל אותה מחדש (אופציונלי). עוד...

(NSInteger)	- joinApplication:
	הצטרפות לאפליקציה. עוד...

(NSInteger)	- joinApplication:sessionID:
	הצטרפות לאפליקציה עם מזהה סשן אפליקציה מסוים. עוד...

(BOOL)	- leaveApplication
	יציאה מהאפליקציה הנוכחית. עוד...

(NSInteger)	- stopApplication
	מפסיק את הפעולה של אפליקציות פעילות. עוד...

(NSInteger)	- stopApplicationWithSessionID:
	מפסיקה את האפליקציה עם מזהה הסשן שצוין. עוד...

(NSInteger)	- setVolume:
	הגדרת עוצמת הקול של המערכת. עוד...

(NSInteger)	- setMuted:
	הפעלה או השבתה של השתקה. מידע נוסף...

(NSInteger)	- requestDeviceStatus
	בקשה של הסטטוס הנוכחי של המכשיר. עוד...

סיכום הנכס
BOOL	ignoreAppStateNotifications
	האם האובייקט הזה יאזין להתראות על מצב האפליקציה. עוד...

GCKConnectionState	connectionState
	מצב החיבור הנוכחי של מנהל המכשירים. עוד...

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

BOOL	isConnected
	הערך הוא True אם מנהל המכשירים יצר חיבור למכשיר. עוד...

BOOL	isConnectedToApp
	הערך הוא True אם מנהל המכשיר יצר חיבור לאפליקציה במכשיר. עוד...

BOOL	isReconnecting
	הערך הוא True אם מנהל המכשירים מנותק בגלל אירוע זמני פוטנציאלי (לדוגמה, האפליקציה פועלת ברקע או שהייתה שגיאת רשת שאפשר לפתור על ידי חיבור מחדש). עוד...

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

GCKDevice *	device
	המכשיר שנשלט על ידי GCKDeviceManager. עוד...

id< GCKDeviceManagerDelegate >	delegate
	הנציג לקבלת התראות מ-GCKDeviceManager. עוד...

float	deviceVolume
	עוצמת הקול הנוכחית של המכשיר בטווח [0.0, 1.0], אם ידועה; אחרת 0. עוד...

BOOL	deviceMuted
	מצב ההשתקה הנוכחי של המכשיר, אם ידוע; אחרת `NO`. עוד...

GCKActiveInputStatus	activeInputStatus
	הסטטוס הנוכחי של 'קלט פעיל' במכשיר. עוד...

GCKStandbyStatus	standbyStatus
	הסטטוס הנוכחי של המכשיר הוא 'המתנה'. עוד...

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

GCKApplicationMetadata *	applicationMetadata
	המטא-נתונים של אפליקציית המקלט שפועלת כרגע במקלט, אם יש כאלה. אחרת, `nil`. עוד...

NSString *	applicationStatusText
	הטקסט של הסטטוס שדווח לאחרונה מאפליקציית המקלט שפועלת כרגע, אם יש כזה. אחרת, `nil`. עוד...

פרטי השיטה

- (instancetype) initWithDevice:	(GCKDevice *)	device
clientPackageName:	(NSString *)	clientPackageName

יוצר אובייקט GCKDeviceManager חדש עם המכשיר שצוין.

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

Parameters

device	The device to control.
clientPackageName	The client package name.

- (instancetype) initWithDevice:	(GCKDevice *)	device
clientPackageName:	(NSString *)	clientPackageName
ignoreAppStateNotifications:	(BOOL)	ignoreAppStateNotifications

מאותחל ייעודי.

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

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

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

Parameters

device	The device to control.
clientPackageName	The client package name.
ignoreAppStateNotifications	Whether this object will ignore app state notifications.

- (void) connect

מתחברים למכשיר.

- (void) disconnect

התנתקות מהמכשיר.

זהו ניתוק מפורש.

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

- (void) disconnectWithLeave: (BOOL) leaveApplication

התנתקות מהמכשיר.

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

Parameters

leaveApplication YES if this is an explicit disconnect that should disconnect from ("leave") the receiver application before closing the connection; NO if this is an implicit disconnect that should just close the connection.

- (BOOL) addChannel: (GCKCastChannel *) channel

הוספת ערוץ שדרכו אפשר לשלוח ולקבל הודעות במכשיר הזה במרחב שמות מסוים.

Parameters

channel The channel.

החזרות: YES אם הערוץ נוסף, NO אם הוא לא נוסף כי כבר היה ערוץ שצורף למרחב השמות הזה.

- (BOOL) removeChannel: (GCKCastChannel *) channel

מסיר ערוץ שנוסף בעבר.

Parameters

channel The channel.

החזרות: YES אם הערוץ הוסר, NO אם הוא לא הוסר כי הערוץ שצוין לא צורף קודם.

- (NSInteger) launchApplication: (NSString *) applicationID

הפעלת אפליקציה.

Parameters

applicationID The application ID.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן היה לשלוח את הבקשה.

- (NSInteger) launchApplication:	(NSString *)	applicationID
withLaunchOptions:	(GCKLaunchOptions *__nullable)	launchOptions

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

Parameters

applicationID	The application ID.
launchOptions	The launch options for this request. If `nil`, defaults will be used.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן היה לשלוח את הבקשה.

- (NSInteger) launchApplication:	(NSString *)	applicationID
relaunchIfRunning:	(BOOL)	relaunchIfRunning

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

Deprecated:: במקום זאת, צריך להשתמש ב-launchApplication:withLaunchOptions:.

Parameters

applicationID	The application ID.
relaunchIfRunning	If `YES`, relaunches the application if it is already running instead of joining the running application.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן היה לשלוח את הבקשה.

- (NSInteger) joinApplication: (NSString *__nullable) applicationID

הצטרפות לאפליקציה.

Parameters

applicationID The application ID. If nil, attempts to join whichever application is currently running; otherwise, attempts to join the specified application.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן היה לשלוח את הבקשה.

- (NSInteger) joinApplication:	(NSString *)	applicationID
sessionID:	(NSString *)	sessionID

הצטרפות לאפליקציה עם מזהה סשן אפליקציה מסוים.

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

Parameters

applicationID	The application ID.
sessionID	The application session ID.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן היה לשלוח את הבקשה.

- (BOOL) leaveApplication

יציאה מהאפליקציה הנוכחית.

החזרות: NO אם אי אפשר היה לשלוח את ההודעה.

- (NSInteger) stopApplication

מפסיק את הפעולה של אפליקציות פעילות.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן היה לשלוח את הבקשה.

- (NSInteger) stopApplicationWithSessionID: (NSString *__nullable) sessionID

מפסיקה את האפליקציה עם מזהה הסשן שצוין.

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

Parameters

sessionID The application session ID, which may not be nil.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן היה לשלוח את הבקשה.

- (NSInteger) setVolume: (float) volume

הגדרת עוצמת הקול של המערכת.

Parameters

volume The new volume, in the range [0.0, 1.0]. Out of range values will be silently clipped.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן היה לשלוח את הבקשה.

- (NSInteger) setMuted: (BOOL) muted

הפעלה או השבתה של השתקה.

Parameters

muted Whether audio should be muted or unmuted.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן היה לשלוח את הבקשה.

- (NSInteger) requestDeviceStatus

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

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

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן היה לשלוח את הבקשה.

פרטי הנכס

- (BOOL) ignoreAppStateNotifications

readnonatomicassign

האם האובייקט הזה יאזין להתראות על מצב האפליקציה.

אפשר לציין את הדגל הזה בפונקציית האתחול. ערך ברירת המחדל הוא NO.

- (GCKConnectionState) connectionState

readnonatomicassign

מצב החיבור הנוכחי של מנהל המכשירים.

- (GCKConnectionState) applicationConnectionState

readnonatomicassign

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

- (BOOL) isConnected

readnonatomicassign

הערך הוא True אם מנהל המכשירים יצר חיבור למכשיר.

Deprecated:: שימוש ב-connectionState.

- (BOOL) isConnectedToApp

readnonatomicassign

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

Deprecated:: שימוש ב-applicationConnectionState.

- (BOOL) isReconnecting

readnonatomicassign

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

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

- (NSTimeInterval) reconnectTimeout

readwritenonatomicassign

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

הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 15 שניות.

- (GCKDevice*) device

readnonatomicassign

המכשיר שנשלט על ידי GCKDeviceManager.

- (id<GCKDeviceManagerDelegate>) delegate

readwritenonatomicweak

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

- (float) deviceVolume

readnonatomicassign

עוצמת הקול הנוכחית של המכשיר בטווח [0.0, 1.0], אם ידועה; אחרת 0.

- (BOOL) deviceMuted

readnonatomicassign

מצב ההשתקה הנוכחי של המכשיר, אם ידוע; אחרת NO.

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

הסטטוס הנוכחי של 'קלט פעיל' במכשיר.

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

הסטטוס הנוכחי של המכשיר הוא 'המתנה'.

- (NSString*) applicationSessionID

readnonatomiccopy

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

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

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

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

- (NSString*) applicationStatusText

readnonatomiccopy

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

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

סקירה כללית

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

סיכום הנכס

פרטי השיטה

פרטי הנכס

‫GCKDeviceManager Class