שיעור GCKCastSession

סימוכין לשיעור GCKCastSession

סקירה כללית

כיתה שמנהלת סשן העברה (cast) עם מכשיר של המקבל.

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

מאז
3.0

עוברת בירושה את GCKSession.

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

(instancetype) - initWithDevice:sessionID:castOptions:
 מאתחל ייעודי. עוד...
 
(BOOL) - addChannel:
 רושם את הערוץ עם הסשן. עוד...
 
(BOOL) - removeChannel:
 הסרה של ערוץ שנרשם בעבר מהסשן. עוד...
 
(void) - addDeviceStatusListener:
 הוספה של GCKCastDeviceStatusListener לרשימת המאזינים של האובייקט. עוד...
 
(void) - removeDeviceStatusListener:
 הסרה של GCKCastDeviceStatusListener מרשימת המאזינים של האובייקט. עוד...
 
(GCKRequest *) - setDeviceVolume:forMultizoneDevice:
 מגדיר את עוצמת הקול של מכשיר מסוים בקבוצה מרובת אזורים. עוד...
 
(GCKRequest *) - setDeviceMuted:forMultizoneDevice:
 מגדיר את המצב המושתק של המכשיר בקבוצה בקבוצה מרובת אזורים. עוד...
 
(GCKRequest *) - requestMultizoneStatus
 בקשת סטטוס של מספר אזורים מקבוצה מרובת אזורים. עוד...
 
(instancetype) - initWithDevice:traits:sessionID:
 מפעיל אובייקט סשן חדש עבור המכשיר הנתון. עוד...
 
(GCKRequest *) - setDeviceVolume:
 מגדיר את עוצמת הקול של המכשיר. עוד...
 
(GCKRequest *) - setDeviceMuted:
 מגדיר את מצב ההשתקה של המכשיר. עוד...
 
(void) - start
 התחלת הסשן. עוד...
 
(void) - endAndStopCasting:
 מסיים את הפעילות. עוד...
 
(void) - suspendWithReason:
 משעה את הסשן מהסיבה הנתונה. עוד...
 
(void) - resume
 המשך הסשן. עוד...
 
(void) - notifyDidStartWithSessionID:
 מחלקות משנה קריאה למסגרת כדי ליידע את המסגרת שהסשן התחיל. עוד...
 
(void) - notifyDidFailToStartWithError:
 מחלקות משנה מוצגות קריאה למסגרת כדי ליידע את המערכת שהתחלת הסשן נכשלה. עוד...
 
(void) - notifyDidResume
 מחלקות משנה זו מזומנות כדי להודיע למסגרת שהסשן התחדש. עוד...
 
(void) - notifyDidSuspendWithReason:
 מוצגות קריאות למחלקות המשנה כדי להודיע למסגרת שהסשן הושעה. עוד...
 
(void) - notifyDidEndWithError:
 כיתות משנה קריאה למסגרת כדי ליידע את המסגרת שהסשן הסתיים. עוד...
 
(void) - notifyDidReceiveDeviceVolume:muted:
 מוצגות קריאה למחלקות משנה כדי להודיע ל-framework לעדכון של עוצמת הקול במכשיר ולמצב ההשתקה התקבל מהמכשיר. עוד...
 
(void) - notifyDidReceiveDeviceStatus:
 מוצגות מחלקות משנה כדי להודיע למסגרת שהתקבל מהמכשיר סטטוס מעודכן. עוד...
 

סיכום הנכס

GCKActiveInputStatus activeInputStatus
 הסטטוס הנוכחי של 'הקלט הפעיל' במכשיר. עוד...
 
GCKStandbyStatus standbyStatus
 סטטוס 'המתנה' הנוכחי של המכשיר. עוד...
 
GCKApplicationMetadataapplicationMetadata
 המטא-נתונים של האפליקציה המקבלת שפועלת כרגע במכשיר המקבל, אם יש כזו; אם לא, nil. עוד...
 
GCKDevicedevice
 המכשיר שאליו משויך הסשן הזה. עוד...
 
NSString * sessionID
 מזהה הסשן הנוכחי, אם יש כזה. עוד...
 
GCKConnectionState connectionState
 המצב הנוכחי של החיבור לסשן. עוד...
 
BOOL suspended
 סימון שמציין אם הסשן מושעה כרגע. עוד...
 
NSString * deviceStatusText
 הטקסט של סטטוס המכשיר הנוכחי. עוד...
 
GCKSessionTraitstraits
 תכונות הסשן. עוד...
 
float currentDeviceVolume
 עוצמת הקול הנוכחית של המכשיר, בטווח של [0.0, 1.0]. עוד...
 
BOOL currentDeviceMuted
 מצב ההשתקה הנוכחי של המכשיר. עוד...
 
GCKRemoteMediaClientremoteMediaClient
 האובייקט GCKRemoteMediaClient שיכול לשמש לשליטה בהפעלה של מדיה בסשן הזה. עוד...
 
GCKMediaMetadatamediaMetadata
 המטא-נתונים הנוכחיים של המדיה, אם יש. עוד...
 

פרטי השיטה

- (instancetype) initWithDevice: (GCKDevice *)  device
sessionID: (NSString *__nullable)  sessionID
castOptions: (GCKCastOptions *)  castOptions 

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

יוצר סשן חדש של העברה (cast) עם אפשרויות ההעברה הנתונות.

Parameters
deviceThe receiver device.
sessionIDThe session ID, if resuming; otherwise nil.
castOptionsThe Cast options.
- (BOOL) addChannel: (GCKCastChannel *)  channel

רושם את הערוץ עם הסשן.

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

Parameters
channelThe channel to register.
החזרות
YES אם הערוץ נרשם בהצלחה, NO אחרת.
- (BOOL) removeChannel: (GCKCastChannel *)  channel

הסרה של ערוץ שנרשם בעבר מהסשן.

Parameters
channelThe channel to unregister.
החזרות
YES אם רישום הערוץ בוטל בהצלחה, NO אחרת.
- (void) addDeviceStatusListener: (id< GCKCastDeviceStatusListener >)  listener

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

Parameters
listenerThe listener to add.
- (void) removeDeviceStatusListener: (id< GCKCastDeviceStatusListener >)  listener

הסרה של GCKCastDeviceStatusListener מרשימת המאזינים של האובייקט.

Parameters
listenerThe listener to remove.
- (GCKRequest *) setDeviceVolume: (float)  volume
forMultizoneDevice: (GCKMultizoneDevice *)  device 

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

זוהי פעולה אסינכרונית.

Parameters
volumeThe new volume, in the range [0.0, 1.0].
deviceThe multizone device.
החזרות
אובייקט GCKRequest למעקב אחר הבקשה.
- (GCKRequest *) setDeviceMuted: (BOOL)  muted
forMultizoneDevice: (GCKMultizoneDevice *)  device 

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

זוהי פעולה אסינכרונית.

Parameters
mutedThe new muted state.
deviceThe multizone device.
החזרות
אובייקט GCKRequest למעקב אחר הבקשה.
- (GCKRequest *) requestMultizoneStatus

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

זוהי פעולה אסינכרונית. כאשר יתקבל הסטטוס מרובה אזורים, שיטת הענקת הגישה castSession:didReceiveMultizoneStatus: (GCKCastDeviceStatusListener-p) תישלח.

החזרות
אובייקט GCKRequest למעקב אחר הבקשה.
- (instancetype) initWithDevice: (GCKDevice *)  device
traits: (GCKSessionTraits *)  traits
sessionID: (NSString *__nullable)  sessionID 

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

Parameters
deviceThe device.
traitsThe session traits.
sessionIDThe session ID of an existing session, if this object will be used to resume a session; otherwise nil if it will be used to start a new session.
- (GCKRequest *) setDeviceVolume: (float)  volume

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

זוהי פעולה אסינכרונית. הטמעת ברירת המחדל היא no-op שנכשלת הבקשה עם שגיאת GCKErrorCodesupportedFeature.

Parameters
volumeThe new volume.
החזרות
אובייקט GCKRequest למעקב אחר הבקשה.
מאז
3.4; בגרסאות קודמות של המסגרת, השיטה הזו החזירה void.
- (GCKRequest *) setDeviceMuted: (BOOL)  muted

מגדיר את מצב ההשתקה של המכשיר.

זוהי פעולה אסינכרונית. הטמעת ברירת המחדל היא no-op שנכשלת הבקשה עם שגיאת GCKErrorCodesupportedFeature.

Parameters
mutedThe new mute state.
החזרות
אובייקט GCKRequest למעקב אחר הבקשה.
מאז
3.4; בגרסאות קודמות של המסגרת, השיטה הזו החזירה void.
- (void) start

התחלת הסשן.

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

סופק לפי קטגוריה GCKSession(Protected).

- (void) endAndStopCasting: (BOOL)  stopCasting

מסיים את הפעילות.

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

Parameters
stopCastingWhether to stop casting content to the receiver.

סופק לפי קטגוריה GCKSession(Protected).

- (void) suspendWithReason: (GCKConnectionSuspendReason reason

משעה את הסשן מהסיבה הנתונה.

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

סופק לפי קטגוריה GCKSession(Protected).

- (void) resume

המשך הסשן.

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

סופק לפי קטגוריה GCKSession(Protected).

- (void) notifyDidStartWithSessionID: (NSString *)  sessionID

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

Parameters
sessionIDThe session's unique ID.

סופק לפי קטגוריה GCKSession(Protected).

- (void) notifyDidFailToStartWithError: (NSError *)  error

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

Parameters
errorThe error that occurred.

סופק לפי קטגוריה GCKSession(Protected).

- (void) notifyDidResume

מחלקות משנה זו מזומנות כדי להודיע למסגרת שהסשן התחדש.

סופק לפי קטגוריה GCKSession(Protected).

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason reason

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

Parameters
reasonThe reason for the suspension.

סופק לפי קטגוריה GCKSession(Protected).

- (void) notifyDidEndWithError: (NSError *__nullable)  error

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

Parameters
errorThe error that caused the session to end, if any. Should be nil if the session was ended intentionally.

סופק לפי קטגוריה GCKSession(Protected).

- (void) notifyDidReceiveDeviceVolume: (float)  volume
muted: (BOOL)  muted 

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

Parameters
volumeThe device's current volume. Must be in the range [0, 1.0];
mutedThe device's current mute state.

סופק לפי קטגוריה GCKSession(Protected).

- (void) notifyDidReceiveDeviceStatus: (NSString *__nullable)  statusText

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

Parameters
statusTextThe new status.

סופק לפי קטגוריה GCKSession(Protected).

פרטי הנכס

- (GCKActiveInputStatus) activeInputStatus
readnonatomicassign

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

- (GCKStandbyStatus) standbyStatus
readnonatomicassign

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

- (GCKApplicationMetadata*) applicationMetadata
readnonatomiccopy

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

- (GCKDevice*) device
readnonatomicstronginherited

המכשיר שאליו משויך הסשן הזה.

- (NSString*) sessionID
readnonatomiccopyinherited

מזהה הסשן הנוכחי, אם יש כזה.

- (GCKConnectionState) connectionState
readnonatomicassigninherited

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

- (BOOL) suspended
readnonatomicassigninherited

סימון שמציין אם הסשן מושעה כרגע.

- (NSString*) deviceStatusText
readnonatomiccopyinherited

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

- (GCKSessionTraits*) traits
readnonatomiccopyinherited

תכונות הסשן.

- (float) currentDeviceVolume
readnonatomicassigninherited

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

- (BOOL) currentDeviceMuted
readnonatomicassigninherited

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

- (GCKRemoteMediaClient*) remoteMediaClient
readnonatomicstronginherited

האובייקט GCKRemoteMediaClient שיכול לשמש לשליטה בהפעלה של מדיה בסשן הזה.

השעה nil לפני שהסשן התחילה, או אם הסשן לא תומך ב-API של GCKRemoteMediaClient. מחלקות משנה שמספקות ממשק GCKRemoteMediaClient חייבות לבטל את שיטת getter.

- (GCKMediaMetadata*) mediaMetadata
readnonatomicstronginherited

המטא-נתונים הנוכחיים של המדיה, אם יש.

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