نظرة عامة

فئة أساسية مجردة تمثل جلسة باستخدام جهاز استقبال.

يجب أن تنفّذ الفئات الفرعية الطُرق 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 قبل بدء الجلسة، أو إذا كانت الجلسة لا تدعم واجهة برمجة تطبيقات GCKRemoteMediaClient. يجب أن تلغي الفئات الفرعية التي توفر واجهة GCKRemoteMediaClient طريقة getter.

- (GCKMediaMetadata*) mediaMetadata

readnonatomicstrong

البيانات الوصفية الحالية للوسائط، إن وُجدت

سيتم nil إذا لم تتوافق الجلسة مع مساحة اسم الوسائط أو إذا لم يتم تحميل أي وسائط حاليًا على جهاز الاستقبال.

فئة GCKSession

نظرة عامة

ملخص طريقة المثيل

ملخص الموقع

تفاصيل الطريقة

تفاصيل العقار