نظرة عامة
فئة تدير عملية اكتشاف الجهاز.
يدير GCKDiscoveryManager مجموعة من GCKDeviceProvider مثيلات الفئة الفرعية، ويتحمل كلٌ منها مسؤولية اكتشاف الأجهزة من نوع معيّن. ويحتوي أيضًا على قائمة مرتبة ترتيبًا لغويًا بالأجهزة المكتشفة حاليًا.
يبدأ إطار العمل عملية الاكتشاف تلقائيًا عندما ينتقل التطبيق إلى المقدّمة ويعلّقه عند انتقاله إلى الخلفية. بشكل عام، ليس من الضروري أن يطلب التطبيق startDiscovery (GCKDiscoveryManager) وstopDiscovery (GCKDiscoveryManager)، إلا كإجراء لتحسين للحد من حركة بيانات الشبكة واستخدام وحدة المعالجة المركزية (CPU) في مناطق التطبيق التي لا تستخدم وظيفة البثّ.
إذا كان التطبيق يستخدم مربع حوار البث الخاص بإطار العمل، إما من خلال GCKUICastButton أو من خلال تقديمه مباشرةً، سيستخدم مربّع الحوار هذا GCKDiscoveryManager لتعبئة قائمة الأجهزة المتاحة له. مع ذلك، إذا كان التطبيق يوفر واجهة مستخدم خاصة بمربّع حوار اختيار/التحكُّم في الجهاز، يجب أن يستخدم GCKDiscoveryManager وبروتوكول المستمع المرتبط به GCKDiscoveryManagerListener لتعبئة قائمة الأجهزة المتاحة وتعديلها.
- منذ
- 3.0
تكتسب NSObject.
ملخّص طريقة المثيل | |
| (instancetype) | - init |
| أداة الإعداد التلقائية غير متوفّرة. المزيد... | |
| (void) | - addListener: |
| لإضافة مستمع سيتلقّى إشعارات استكشاف المحتوى المزيد... | |
| (void) | - removeListener: |
| لإزالة مستمع مسجَّل سابقًا. المزيد... | |
| (void) | - startDiscovery |
| بدء عملية الاستكشاف المزيد... | |
| (void) | - stopDiscovery |
| يؤدي هذا الإجراء إلى إيقاف عملية الاكتشاف. المزيد... | |
| (BOOL) | - isDiscoveryActiveForDeviceCategory: |
| لاختبار ما إذا كان الاكتشاف نشطًا حاليًا لفئة الجهاز المحدّدة. المزيد... | |
| (GCKDevice *) | - deviceAtIndex: |
| لعرض الجهاز ضمن الفهرس المحدّد ضمن قائمة الأجهزة التي تم اكتشافها من قِبل المدير. المزيد... | |
| (nullable GCKDevice *) | - deviceWithUniqueID: |
| لعرض الجهاز باستخدام المعرّف الفريد المحدّد في قائمة الأجهزة التي تم اكتشافها من قِبل المدير. المزيد... | |
| (void) | - findDeviceWithUniqueID:timeout:completion: |
| تنتظر حتى يتم اكتشاف جهاز بالمعرّف الفريد المحدد، ثم يستدعي مقطع إكمال. المزيد... | |
| (void) | - cancelFindOperation |
| لإلغاء أي عملية بحث قيد التقدم تم بدؤها من خلال findDeviceWithUniqueID:timeout:complete:. المزيد... | |
ملخّص الموقع | |
| GCKDiscoveryState | discoveryState |
| حالة الاكتشاف الحالية المزيد... | |
| BOOL | hasDiscoveredDevices |
| علامة تشير إلى ما إذا كان قد تم اكتشاف أي أجهزة من خلال أي من موفّري بيانات الاكتشاف تحت إدارة هذا الكائن المزيد... | |
| BOOL | passiveScan |
| علامة تشير إلى ما إذا كان يجب أن يستخدم الاكتشاف فحصًا "سلبيًا". المزيد... | |
| BOOL | discoveryActive |
| علامة تشير إلى ما إذا كان الاكتشاف نشطًا أم لا. المزيد... | |
| NSUInteger | deviceCount |
| عدد الأجهزة التي تم اكتشافها حاليًا. المزيد... | |
تفاصيل الطريقة
| - (instancetype) init |
أداة الإعداد التلقائية غير متوفّرة.
| - (void) addListener: | (id< GCKDiscoveryManagerListener >) | listener |
لإضافة مستمع سيتلقّى إشعارات استكشاف المحتوى
إنّ أداة معالجة الطلبات التي تمت إضافتها ضعيفة، ويجب الاحتفاظ بها لتجنُّب تخصيص العرض بشكل غير متوقّع.
- Parameters
-
listener The listener to add.
| - (void) removeListener: | (id< GCKDiscoveryManagerListener >) | listener |
لإزالة مستمع مسجَّل سابقًا.
- Parameters
-
listener The listener to remove.
| - (void) startDiscovery |
بدء عملية الاستكشاف
| - (void) stopDiscovery |
يؤدي هذا الإجراء إلى إيقاف عملية الاكتشاف.
| - (BOOL) isDiscoveryActiveForDeviceCategory: | (NSString *) | deviceCategory |
لاختبار ما إذا كان الاكتشاف نشطًا حاليًا لفئة الجهاز المحدّدة.
| - (GCKDevice *) deviceAtIndex: | (NSUInteger) | index |
لعرض الجهاز ضمن الفهرس المحدّد ضمن قائمة الأجهزة التي تم اكتشافها من قِبل المدير.
| - (nullable GCKDevice *) deviceWithUniqueID: | (NSString *) | uniqueID |
لعرض الجهاز باستخدام المعرّف الفريد المحدّد في قائمة الأجهزة التي تم اكتشافها من قِبل المدير.
- Parameters
-
uniqueID The device's unique ID.
- المرتجعات
- كائن GCKDevice المطابق، أو
nilفي حال عدم العثور على جهاز مطابق.
| - (void) findDeviceWithUniqueID: | (NSString *) | uniqueID | |
| timeout: | (NSTimeInterval) | timeout | |
| completion: | (void(^)(GCKDevice *)) | completion | |
تنتظر حتى يتم اكتشاف جهاز بالمعرّف الفريد المحدد، ثم يستدعي مقطع إكمال.
وإذا كان هناك جهاز مطابق في قائمة الأجهزة التي تم اكتشافها، سيتم استدعاء مجموعة الأجهزة المكتملة على الفور (ولكن بعد إعادة هذه الطريقة). لا يمكن أن تكون إلا عملية بحث واحدة نشطة في كل مرة، وسيؤدي بدء عملية بحث جديدة أثناء إجراء عملية أخرى إلى إلغاء العملية الحالية.
- Parameters
-
uniqueID The unique ID of the device. timeout The maximum amount of time to wait for the device to be discovered. completion The completion block to invoke when either the device is found or the timeout is reached. The device (if found) or nil(if not found) will be passed to the completion block.
- منذ
- 4.0
| - (void) cancelFindOperation |
لإلغاء أي عملية بحث قيد التقدم تم بدؤها من خلال findDeviceWithUniqueID:timeout:complete:.
- منذ
- 4.0
تفاصيل الموقع
|
readnonatomicassign |
حالة الاكتشاف الحالية
|
readnonatomicassign |
علامة تشير إلى ما إذا كان قد تم اكتشاف أي أجهزة من خلال أي من موفّري بيانات الاكتشاف تحت إدارة هذا الكائن
|
readwritenonatomicassign |
علامة تشير إلى ما إذا كان يجب أن يستخدم الاكتشاف فحصًا "سلبيًا".
تكون عمليات الفحص السلبية أقل كثافة استخدام للموارد، ولكنها لا تقدّم نتائج حديثة مثل عمليات الفحص النشطة.
|
readnonatomicassign |
علامة تشير إلى ما إذا كان الاكتشاف نشطًا أم لا.
- منذ
- 3.4
|
readnonatomicassign |
عدد الأجهزة التي تم اكتشافها حاليًا.