کلاس GCKDiscoveryManager

مرجع کلاس GCKDiscoveryManager

بررسی اجمالی

کلاسی که فرآیند کشف دستگاه را مدیریت می کند.

GCKDiscoveryManager مجموعه‌ای از نمونه‌های زیرکلاس GCKDeviceProvider را مدیریت می‌کند که هر کدام مسئول کشف دستگاه‌هایی از نوع خاصی هستند. همچنین فهرستی از دستگاه‌های کشف‌شده در حال حاضر از نظر واژه‌شناسی مرتب شده است.

فریم ورک به طور خودکار فرآیند کشف را هنگامی که برنامه به پیش زمینه می رود شروع می کند و زمانی که برنامه به پس زمینه می رود آن را به حالت تعلیق در می آورد. معمولاً لازم نیست برنامه startDiscovery (GCKDiscoveryManager) و stopDiscovery (GCKDiscoveryManager) را فراخوانی کند، مگر به عنوان یک اقدام بهینه سازی برای کاهش ترافیک شبکه و استفاده از CPU در مناطقی از برنامه که از عملکرد Cast استفاده نمی کنند.

اگر برنامه از کادر گفتگوی Cast چارچوب استفاده می‌کند، یا از طریق 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:completion: آغاز شده را لغو می کند. بیشتر...

خلاصه اموال

GCKDiscoveryState  discoveryState
وضعیت کشف فعلی بیشتر...
BOOL  hasDiscoveredDevices
پرچمی که نشان می دهد آیا دستگاهی توسط هر یک از ارائه دهندگان اکتشاف مدیریت شده توسط این شی کشف شده است یا خیر. بیشتر...
BOOL  passiveScan
پرچمی که نشان می دهد آیا اکتشاف باید از اسکن "غیرفعال" استفاده کند یا خیر. بیشتر...
BOOL  discoveryActive
پرچمی که نشان می دهد اکتشاف فعال است یا نه. بیشتر...
NSUInteger  deviceCount
تعداد دستگاه هایی که در حال حاضر کشف شده اند. بیشتر...

جزئیات روش

- (instancetype) init

مقداردهی اولیه پیش فرض در دسترس نیست.

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

شنونده ای اضافه می کند که اعلان های کشف را دریافت می کند.

شنونده اضافه شده ضعیف نگه داشته می شود و برای جلوگیری از انتقال غیرمنتظره باید حفظ شود.

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

شنونده قبلا ثبت نام شده را حذف می کند.

Parameters
listenerThe listener to remove.
- (void) startDiscovery

فرآیند کشف را آغاز می کند.

- (void) stopDiscovery

فرآیند کشف را متوقف می کند.

- (BOOL) isDiscoveryActiveForDeviceCategory: (NSString *)  deviceCategory

آزمایش می کند که آیا کشف در حال حاضر برای دسته دستگاه داده شده فعال است یا خیر.

- ( GCKDevice *) deviceAtIndex: (NSUInteger)  index

دستگاه را در فهرست داده شده در لیست دستگاه های کشف شده مدیر برمی گرداند.

- (nullable GCKDevice *) deviceWithUniqueID: (NSString *)  uniqueID

دستگاه را با شناسه منحصر به فرد داده شده در لیست دستگاه های کشف شده مدیر برمی گرداند.

Parameters
uniqueIDThe device's unique ID.
برمی گرداند
شی منطبق GCKDevice ، یا اگر دستگاه منطبقی پیدا نشد nil .
- (void) findDeviceWithUniqueID: (NSString *)  uniqueID
timeout: (NSTimeInterval)  timeout
completion: (void(^)( GCKDevice *))  completion  

منتظر می ماند تا دستگاهی با شناسه منحصر به فرد داده شده کشف شود و بلوک تکمیل را فراخوانی می کند.

اگر یک دستگاه منطبق از قبل در لیست دستگاه کشف شده باشد، بلوک تکمیل بلافاصله فراخوانی می شود (اما پس از بازگشت این روش). تنها یک عملیات یافتن می تواند در هر زمان فعال باشد. شروع یک عملیات یافتن جدید در حالی که یک عملیات دیگر در حال انجام است، عملیات فعلی را لغو می کند.

Parameters
uniqueIDThe unique ID of the device.
timeoutThe maximum amount of time to wait for the device to be discovered.
completionThe 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:completion: آغاز شده را لغو می کند.

از آنجا که
4.0

جزئیات ملک

- (GCKDiscoveryState) discoveryState
read nonatomic assign

وضعیت کشف فعلی

- (BOOL) hasDiscoveredDevices
read nonatomic assign

پرچمی که نشان می دهد آیا دستگاهی توسط هر یک از ارائه دهندگان اکتشاف مدیریت شده توسط این شی کشف شده است یا خیر.

- (BOOL) passiveScan
read write nonatomic assign

پرچمی که نشان می دهد آیا اکتشاف باید از اسکن "غیرفعال" استفاده کند یا خیر.

اسکن‌های غیرفعال به منابع کمتری نیاز دارند، اما نتایجی به‌اندازه اسکن‌های فعال ارائه نمی‌دهند.

- (BOOL) discoveryActive
read nonatomic assign

پرچمی که نشان می دهد اکتشاف فعال است یا نه.

از آنجا که
3.4
- (NSUInteger) deviceCount
read nonatomic assign

تعداد دستگاه هایی که در حال حاضر کشف شده اند.