بررسی اجمالی
کلاسی که فرآیند کشف دستگاه را مدیریت می کند.
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
-
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:completion: آغاز شده را لغو می کند.
- از آنجا که
- 4.0
جزئیات ملک
|
read nonatomic assign |
وضعیت کشف فعلی
|
read nonatomic assign |
پرچمی که نشان می دهد آیا دستگاهی توسط هر یک از ارائه دهندگان اکتشاف مدیریت شده توسط این شی کشف شده است یا خیر.
|
read write nonatomic assign |
پرچمی که نشان می دهد آیا اکتشاف باید از اسکن "غیرفعال" استفاده کند یا خیر.
اسکن‌های غیرفعال به منابع کمتری نیاز دارند، اما نتایجی به‌اندازه اسکن‌های فعال ارائه نمی‌دهند.
|
read nonatomic assign |
پرچمی که نشان می دهد اکتشاف فعال است یا نه.
- از آنجا که
- 3.4
|
read nonatomic assign |
تعداد دستگاه هایی که در حال حاضر کشف شده اند.