סקירה כללית

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

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

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

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

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

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

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

סקירה כללית

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

סיכום הנכס

פרטי השיטה

פרטי הנכס