نظرة عامة
صف يدير الجلسات
يتم استخدام الطريقة startSessionWithDevice: (GCKSessionManager) لإنشاء جلسة جديدة باستخدام GCKDevice معيّن. يستخدم مدير الجلسة GCKDeviceProvider لنوع الجهاز هذا من أجل إنشاء عنصر GCKSession جديد، ثمّ يفوّض إليه جميع طلبات الجلسة.
تعمل السمة GCKSessionManager على استئناف الجلسات المعلّقة تلقائيًا (أي استئناف الجلسات التي انتهت عندما انتقل التطبيق إلى الخلفية، أو في حال تعطُّل التطبيق أو إنهاء المستخدم له بالقوة). عند استئناف التطبيق أو إعادة تشغيله، سينتظر مدير الجلسة لفترة قصيرة إلى أن يعثر موفّر الجهاز للجهاز الذي تم تعليق الجلسة عليه على هذا الجهاز مرة أخرى، وإذا عثر عليه، سيحاول إعادة الاتصال به وإعادة إنشاء الجلسة تلقائيًا.
إذا أنشأ التطبيق GCKUICastButton بدون توفير هدف ومحدّد، سيؤدي النقر على الزر من قِبل المستخدم إلى عرض مربّع الحوار التلقائي لخدمة Cast، وسيبدأ الجلسات ويتوقف عنها تلقائيًا استنادًا إلى اختيار المستخدم أو قطع اتصال الجهاز. أما إذا كان التطبيق يوفّر واجهة مستخدم خاصة به لاختيار الأجهزة أو التحكّم فيها، فيجب أن يستخدم 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:. المزيد... | |
ملخّص الموقع | |
| GCKSession * | currentSession |
| الجلسة الحالية، إن وُجدت المزيد... | |
| GCKCastSession * | currentCastSession |
| تمثّل هذه السمة جلسة البث الحالية، إن وُجدت. المزيد... | |
| GCKConnectionState | connectionState |
| حالة اتصال الجلسة الحالية المزيد... | |
تفاصيل الطريقة
| - (instancetype) init |
لا يتوفّر برنامج تهيئة تلقائي.
| - (BOOL) startSessionWithDevice: | (GCKDevice *) | device |
يبدأ جلسة جديدة مع الجهاز المحدّد.
هذه عملية غير متزامنة.
- Parameters
-
device The device to use for this session.
- المرتجعات
YESإذا تم بدء العملية بنجاح، أوNOإذا كانت هناك جلسة حالية أو إذا تعذّر بدء العملية
| - (BOOL) suspendSessionWithReason: | (GCKConnectionSuspendReason) | reason |
تعليق الجلسة الحالية
هذه عملية غير متزامنة.
- Parameters
-
reason The reason for the suspension.
- المرتجعات
YESإذا تم بدء العملية بنجاح،NOإذا لم يتم إنشاء جلسة حاليًا أو إذا تعذّر بدء العملية
| - (BOOL) endSession |
لإنهاء الجلسة الحالية
هذه عملية غير متزامنة.
- المرتجعات
YESإذا تم بدء العملية بنجاح،NOإذا لم يتم إنشاء جلسة حاليًا أو إذا تعذّر بدء العملية
| - (BOOL) endSessionAndStopCasting: | (BOOL) | stopCasting |
تنهي هذه الطريقة الجلسة الحالية، ويمكنها إيقاف البث.
هذه عملية غير متزامنة.
- Parameters
-
stopCasting Whether 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
-
listener The listener to add.
| - (void) removeListener: | (id< GCKSessionManagerListener >) | listener |
يزيل هذا الإجراء معالجًا تمت إضافته سابقًا باستخدام addListener:.
- Parameters
-
listener The listener to remove.
تفاصيل الموقع
|
readnonatomicstrong |
الجلسة الحالية، إن وُجدت
|
readnonatomicstrong |
تمثّل هذه السمة جلسة البث الحالية، إن وُجدت.
|
readnonatomicassign |
حالة اتصال الجلسة الحالية