فئة GCKSessionManager

مرجع صف GCKSessionManager

نظرة عامة

فئة تدير الجلسات.

يتم استخدام الطريقة startSessionWithDevice: (GCKSessionManager) لإنشاء جلسة جديدة باستخدام GCKDevice محدّد. يستخدِم مدير الجلسة GCKDeviceProvider لهذا النوع من الأجهزة لإنشاء كائن GCKSession جديد، ثم تفويض مفوضي جميع طلبات الجلسات.

يعالج GCKSessionManager الاستئناف التلقائي للجلسات المعلّقة (أي استئناف الجلسات التي انتهت عند انتقال التطبيق إلى الخلفية، أو في حالة تعطل التطبيق أو إنهاؤه إجباريًا من قِبل المستخدم). عند استئناف التطبيق أو إعادة تشغيله، سينتظر مدير الجلسة لفترة قصيرة حتى يتمكّن موفّر جهاز الجهاز المعلّق من اكتشاف ذلك الجهاز مرة أخرى، وإذا فعل ذلك، سيحاول إعادة الاتصال بذلك الجهاز وإعادة إنشاء الجلسة تلقائيًا.

إذا أنشأ التطبيق GCKUICastButton بدون تقديم هدف وأداة اختيار، سيعرض المستخدم الذي ينقر على الزر مربّع الحوار التلقائي للإرسال وسيبدأ تلقائيًا الجلسات وإيقافها استنادًا إلى اختيار المستخدم أو إلغاء ربط الجهاز. ومع ذلك، إذا كان التطبيق يوفِّر واجهة مستخدم لمربّع حوار اختيار/التحكُّم في جهازه، يجب أن يستخدم GCKSessionManager مباشرةً لإنشاء الجلسات والتحكُّم فيها.

سواء كان التطبيق يستخدم GCKSessionManager للتحكّم في الجلسات أم لا، يمكنه إرفاق GCKSessionManagerListener ليتم إشعاره بأحداث الجلسة، ويمكنه أيضًا استخدام KVO لمراقبة الخاصية connectionState لتتبُّع حالة دورة حياة الجلسة الحالية.

سينسي
3.0

يكتسب NSObject.

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

(instancetype) - init
 المُنشئ التلقائي غير متاح. المزيد...
 
(BOOL) - startSessionWithDevice:
 لبدء جلسة جديدة باستخدام الجهاز المحدد. المزيد...
 
(BOOL) - suspendSessionWithReason:
 لتعليق الجلسة الحالية. المزيد...
 
(BOOL) - endSession
 لإنهاء الجلسة الحالية. المزيد...
 
(BOOL) - endSessionAndStopCasting:
 إنهاء الجلسة الحالية، وإيقاف الإرسال بشكل اختياري. المزيد...
 
(BOOL) - hasConnectedSession
 لاختبار ما إذا كانت جلسة تتم إدارتها حاليًا بواسطة مدير الجلسة هذا، ومتصلة حاليًا. المزيد...
 
(BOOL) - hasConnectedCastSession
 لاختبار ما إذا كانت جلسة الإرسال تتم إدارتها حاليًا بواسطة مدير الجلسة هذا، وهي متصلة حاليًا. المزيد...
 
(void) - addListener:
 لإضافة مستمع لتلقي إشعارات. المزيد...
 
(void) - removeListener:
 يزيل أداة معالجة الأحداث التي تمت إضافتها في السابق باستخدام addListener:. المزيد...
 

ملخص الموقع

GCKSessioncurrentSession
 الجلسة الحالية، إن وجدت. المزيد...
 
GCKCastSessioncurrentCastSession
 جلسة البث الحالية، إن وجدت. المزيد...
 
GCKConnectionState connectionState
 حالة اتصال الجلسة الحالية. المزيد...
 

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

- (instancetype) init

المُنشئ التلقائي غير متاح.

- (BOOL) startSessionWithDevice: (GCKDevice *)  device

لبدء جلسة جديدة باستخدام الجهاز المحدد.

هذه عملية غير متزامنة.

Parameters
deviceThe device to use for this session.
المرتجعات
YES إذا تم بدء العملية بنجاح، NO إذا كانت هناك جلسة تم إنشاؤها حاليًا أو تعذر بدء العملية.
- (BOOL) suspendSessionWithReason: (GCKConnectionSuspendReason reason

لتعليق الجلسة الحالية.

هذه عملية غير متزامنة.

Parameters
reasonThe reason for the suspension.
المرتجعات
YES إذا تم بدء العملية بنجاح، NO إذا لم تكن هناك جلسة حالية أو إذا تعذر بدء العملية.
- (BOOL) endSession

لإنهاء الجلسة الحالية.

هذه عملية غير متزامنة.

المرتجعات
YES إذا تم بدء العملية بنجاح، NO إذا لم تكن هناك جلسة حالية أو إذا تعذر بدء العملية.
- (BOOL) endSessionAndStopCasting: (BOOL)  stopCasting

إنهاء الجلسة الحالية، وإيقاف الإرسال بشكل اختياري.

هذه عملية غير متزامنة.

Parameters
stopCastingWhether casting of content on the receiver should be stopped when the session is ended.
المرتجعات
YES إذا تم بدء العملية بنجاح، NO إذا لم تكن هناك جلسة حالية أو إذا تعذر بدء العملية.
- (BOOL) hasConnectedSession

لاختبار ما إذا كانت جلسة تتم إدارتها حاليًا بواسطة مدير الجلسة هذا، ومتصلة حاليًا.

ستكون هذه القيمة YES إذا كانت حالة الجلسة GCKConnectionStateConnected.

- (BOOL) hasConnectedCastSession

لاختبار ما إذا كانت جلسة الإرسال تتم إدارتها حاليًا بواسطة مدير الجلسة هذا، وهي متصلة حاليًا.

ستكون هذه القيمة YES إذا كانت حالة الجلسة GCKConnectionStateConnected وكانت الجلسة عبارة عن جلسة بث.

- (void) addListener: (id< GCKSessionManagerListener >)  listener

لإضافة مستمع لتلقي إشعارات.

Parameters
listenerThe listener to add.
- (void) removeListener: (id< GCKSessionManagerListener >)  listener

يزيل أداة معالجة الأحداث التي تمت إضافتها في السابق باستخدام addListener:.

Parameters
listenerThe listener to remove.

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

- (GCKSession*) currentSession
readnonatomicstrong

الجلسة الحالية، إن وجدت.

- (GCKCastSession*) currentCastSession
readnonatomicstrong

جلسة البث الحالية، إن وجدت.

- (GCKConnectionState) connectionState
readnonatomicassign

حالة اتصال الجلسة الحالية.