שיעור GCKCastSession

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

סקירה כללית

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

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

מאז
3.0

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

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

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

סיכום הנכס

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

פרטי השיטה

- (instancetype) initWithDevice: (GCKDevice *)  device
sessionID: (nullable NSString *)  sessionID
sessionOptions: (nullable GCKSessionOptions *)  sessionOptions
castOptions: (GCKCastOptions *)  castOptions 

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

Parameters
deviceThe receiver device.
sessionIDThe session ID, if resuming; otherwise nil.
sessionOptionsThe session options, if any; otherwise nil.
castOptionsThe Cast options.
מאז
4.0
- (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 לרשימת המאזינים של האובייקט.

ה-listener שצורף מוחזק חלש וצריך לשמור אותו כדי להימנע משיתוף פעולה בלתי צפוי.

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: (nullable GCKSessionTraits *)  traits
sessionID: (nullable NSString *)  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.
- (instancetype) initWithDevice: (GCKDevice *)  device
traits: (nullable GCKSessionTraits *)  traits
sessionID: (nullable NSString *)  sessionID
sessionOptions: (nullable GCKSessionOptions *)  sessionOptions 

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

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.
sessionOptionsThe session options, if any; otherwise nil.
מאז
4.0
- (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) endWithAction: (GCKSessionEndAction action

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

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

Parameters
actionThe action to take when ending the session; see GCKSessionEndAction for more details.

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

- (void) notifyDidStartWithSessionID: (NSString *)  sessionID

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

Parameters
sessionIDThe session's unique ID.

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

- (void) notifyDidFailToStartWithError: (GCKError *)  error

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

Parameters
errorThe error that occurred.

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

- (void) notifyDidEndWithError: (nullable NSError *)  error
willTryToResume: (BOOL)  willTryToResume 

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

Parameters
errorThe error that caused the session to end, if any. Should be nil if the session was ended intentionally.
willTryToResumeWhether the session will try to resume itself automatically.

סופק לפי קטגוריה 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: (nullable NSString *)  statusText

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

Parameters
statusTextThe new status.

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

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason reason

הוצא משימוש, לא לשימוש – מיושם כ-no-op.

Deprecated:
אין להתקשר.

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

- (void) notifyDidResume

הוצא משימוש, לא לשימוש – מיושם כ-no-op.

Deprecated:
אין להתקשר.

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

פרטי הנכס

- (GCKActiveInputStatus) activeInputStatus
readnonatomicassign

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

- (GCKStandbyStatus) standbyStatus
readnonatomicassign

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

- (GCKApplicationMetadata*) applicationMetadata
readnonatomiccopy

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

- (GCKDevice*) device
readnonatomicstronginherited

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

- (NSString*) sessionID
readnonatomiccopyinherited

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

- (GCKSessionOptions*) sessionOptions
readnonatomicstronginherited

אפשרויות הסשן, אם יש כאלה.

מאז
4.0
- (GCKConnectionState) connectionState
readnonatomicassigninherited

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

- (BOOL) suspended
readnonatomicassigninherited

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

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