סקירה כללית

מחלקה בסיסית מופשטת המייצגת סשן עם מקלט.

מחלקות משנה חייבות להטמיע את השיטות start (GCKSession(Protected)), endAndStopCasting: (GCKSession(Protected)), suspendWithReason: (GCKSession(Protected)) ו-resume (GCKSession(Protected)), וחייבות להפעיל את השיטות המתאימות (למשל, notifyDidStartWithSessionID: (GCKSession(Protected))) כדי לציין את השינויים המתאימים במצב הסשן. סיווגי המשנה יכולים גם להטמיע את setDeviceVolume: (GCKSession), setDeviceMuted: (GCKSession) ואת remoteMediaClient אם המכשיר תומך בפעולות כאלה.

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

סינסה: 3.0

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

עברה בירושה על ידי GCKCastSession.

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

(void)	- notifyDidReceiveDeviceStatus:
	קריאות למחלקות משנה שמטרתן להודיע למסגרת על כך שהתקבל סטטוס מעודכן מהמכשיר. עוד...

סיכום הנכס
GCKDevice *	device
	המכשיר המשויך לסשן הזה. עוד...

NSString *	sessionID
	מזהה הסשן הנוכחי, אם יש כזה. עוד...

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

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

NSString *	deviceStatusText
	הטקסט הנוכחי של סטטוס המכשיר. עוד...

GCKSessionTraits *	traits
	הפעילות היא מאפיין. עוד...

float	currentDeviceVolume
	נפח המכשיר הנוכחי, בטווח [0.0, 1.0]. עוד...

BOOL	currentDeviceMuted
	המצב הנוכחי של השתקת המכשיר. עוד...

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

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

פרטי השיטה

- (instancetype) initWithDevice:	(GCKDevice *)	device
traits:	(GCKSessionTraits *)	traits
sessionID:	(NSString *__nullable)	sessionID

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

Parameters

device	The device.
traits	The session traits.
sessionID	The 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

volume The new volume.

החזרות: אובייקט GCKRequest למעקב אחר הבקשה.

סינסה: 3.4; בגרסאות הקודמות של המסגרת, השיטה הזו החזירה void.

- (GCKRequest *) setDeviceMuted: (BOOL) muted

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

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

Parameters

muted The new mute state.

החזרות: אובייקט GCKRequest למעקב אחר הבקשה.

סינסה: 3.4; בגרסאות הקודמות של המסגרת, השיטה הזו החזירה void.

- (void) start

מתחיל את הסשן.

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

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

- (void) endAndStopCasting: (BOOL) stopCasting

סיום הסשן.

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

Parameters

stopCasting Whether to stop casting content to the receiver.

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

- (void) suspendWithReason: (GCKConnectionSuspendReason) reason

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

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

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

- (void) resume

ממשיך בסשן.

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

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

- (void) notifyDidStartWithSessionID: (NSString *) sessionID

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

Parameters

sessionID The session's unique ID.

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

- (void) notifyDidFailToStartWithError: (NSError *) error

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

Parameters

error The error that occurred.

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

- (void) notifyDidResume

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

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

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason) reason

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

Parameters

reason The reason for the suspension.

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

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

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

Parameters

error The 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

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

Parameters

volume	The device's current volume. Must be in the range [0, 1.0];
muted	The device's current mute state.

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

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

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

Parameters

statusText The new status.

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

פרטי הנכס

- (GCKDevice*) device

readnonatomicstrong

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

- (NSString*) sessionID

readnonatomiccopy

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

- (GCKConnectionState) connectionState

readnonatomicassign

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

- (BOOL) suspended

readnonatomicassign

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

- (NSString*) deviceStatusText

readnonatomiccopy

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

- (GCKSessionTraits*) traits

readnonatomiccopy

הפעילות היא מאפיין.

- (float) currentDeviceVolume

readnonatomicassign

נפח המכשיר הנוכחי, בטווח [0.0, 1.0].

- (BOOL) currentDeviceMuted

readnonatomicassign

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

- (GCKRemoteMediaClient*) remoteMediaClient

readnonatomicstrong

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

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

- (GCKMediaMetadata*) mediaMetadata

readnonatomicstrong

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

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

שיעור GCKSession

סקירה כללית

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

סיכום הנכס

פרטי השיטה

פרטי הנכס