نظرة عامة

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

يجب أن تنفّذ الفئات الفرعية الطرق 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

تضبط هذه السمة مستوى صوت الجهاز.

هذه عملية غير متزامنة. التنفيذ التلقائي هو عملية غير نشطة تؤدي إلى تعذُّر الطلب مع ظهور الخطأ GCKErrorCodeUnsupportedFeature.

Parameters

volume The new volume.

المرتجعات: كائن GCKRequest لتتبُّع الطلب

منذ: 3.4؛ في إصدارات إطار العمل السابقة، كانت هذه الطريقة تعرض void.

- (GCKRequest *) setDeviceMuted: (BOOL) muted

تضبط هذه السمة حالة كتم صوت الجهاز.

هذه عملية غير متزامنة. التنفيذ التلقائي هو عملية غير نشطة تؤدي إلى تعذُّر الطلب مع ظهور الخطأ GCKErrorCodeUnsupportedFeature.

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 طريقة الحصول على البيانات.

- (GCKMediaMetadata*) mediaMetadata

readnonatomicstrong

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

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

فئة GCKSession تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

نظرة عامة

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

ملخّص الموقع

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

تفاصيل الموقع

فئة GCKSession