کلاس GCKDeviceProvider

مرجع کلاس GCKDeviceProvider

بررسی اجمالی

یک کلاس پایه انتزاعی برای انجام کشف دستگاه و ساخت جلسه.

پشتیبانی از انواع دستگاه های اضافی را می توان با گسترش این کلاس اضافه کرد. برای لیستی از روش های کمکی که برای استفاده توسط زیر کلاس ها در نظر گرفته شده است، به دسته GCKDeviceProvider(Protected) مراجعه کنید. ارائه دهندگان دستگاه جدید با استفاده از registerDeviceProvider: (GCKCastContext) با چارچوب ثبت می شوند.

از آنجا که
3.0

NSObject را به ارث می برد.

خلاصه روش نمونه

(instancetype) - initWithDeviceCategory:
مقداردهی اولیه تعیین شده بیشتر...
(void) - startDiscovery
یک اسکن کشف جدید را شروع می کند. بیشتر...
(void) - stopDiscovery
اسکن کشف را متوقف می کند. بیشتر...
( GCKSession *) - createSessionForDevice:sessionID:sessionOptions:
یک جلسه جدید برای دستگاه داده شده و به صورت اختیاری یک شناسه جلسه موجود می سازد. بیشتر...
( GCKSession *) - createSessionForDevice:sessionID:
یک جلسه جدید برای دستگاه داده شده و به صورت اختیاری یک شناسه جلسه موجود می سازد. بیشتر...
(void) - notifyDidStartDiscovery
به مدیر اکتشاف اطلاع می دهد که کشف شروع شده است. بیشتر...
(void) - notifyDidPublishDevice:
به مدیر اکتشاف اطلاع می دهد که دستگاه جدیدی منتشر شده است. بیشتر...
(void) - notifyDidUnpublishDevice:
به مدیر اکتشاف اطلاع می دهد که دستگاهی که قبلاً منتشر شده بود، منتشر نشده است، زیرا دیگر در دسترس نیست. بیشتر...
(void) - notifyDidUpdateDevice:
به مدیر اکتشاف اطلاع می دهد که یک یا چند ویژگی نمایشگر دستگاهی که قبلاً منتشر شده است (مانند نام دوستانه یا نمادها) تغییر کرده است. بیشتر...
( GCKDevice *) - createDeviceWithID:ipAddress:servicePort:
( GCKDevice *) - createDeviceWithID:networkAddress:servicePort:
روش کارخانه ای برای ساخت نمونه های جدید GCKDevice . بیشتر...

خلاصه اموال

NSString *  deviceCategory
رشته ای که به طور منحصر به فرد نوع دستگاهی را که توسط این ارائه دهنده کشف می شود، مشخص می کند. بیشتر...
BOOL  passiveScan
این که آیا اسکن باید یک اسکن غیرفعال باشد. بیشتر...
NSArray< GCKDevice * > *  devices
مجموعه ای از دستگاه های کشف شده بیشتر...

جزئیات روش

- (instancetype) initWithDeviceCategory: (NSString *)  deviceCategory

مقداردهی اولیه تعیین شده

یک GCKDeviceProvider جدید برای دستگاه هایی از نوع مشخص شده می سازد.

Parameters
deviceCategoryA string that uniquely identifies the type of device that is managed by by this provider.
- (void) startDiscovery

یک اسکن کشف جدید را شروع می کند.

این (معمولا) یک عملیات ناهمزمان است. اگر هر یک از دستگاه‌های کشف‌شده توسط اسکن قبلی دیگر معتبر نیستند، ارائه‌دهنده باید آن‌ها را در این زمان لغو انتشار کند. باید توسط زیر کلاس ها لغو شود.

ارائه‌دهنده باید با تماس با notifyDidStartDiscovery (GCKDeviceProvider(Protected)) پس از شروع اسکن (و دستگاه‌های قدیمی منتشر نشده) به مدیر اکتشاف اطلاع دهد. اگر اجرای خاصی از این روش هنگام شروع اسکن کار ناهمزمانی برای انجام نداشته باشد، می‌تواند قبل از بازگشت مستقیماً روش اعلان را فراخوانی کند.

- (void) stopDiscovery

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

باید توسط زیر کلاس ها لغو شود.

- ( GCKSession *) createSessionForDevice: ( GCKDevice *)  device
sessionID: (nullable NSString *)  sessionID
sessionOptions: (nullable GCKSessionOptions *)  sessionOptions  

یک جلسه جدید برای دستگاه داده شده و به صورت اختیاری یک شناسه جلسه موجود می سازد.

باید توسط زیر کلاس ها لغو شود.

Parameters
deviceThe device to connect to.
sessionIDThe ID of the session to resume; or nil to start a new session.
sessionOptionsThe session options, if any; otherwise nil .
از آنجا که
4.0
- ( GCKSession *) createSessionForDevice: ( GCKDevice *)  device
sessionID: (nullable NSString *)  sessionID  

یک جلسه جدید برای دستگاه داده شده و به صورت اختیاری یک شناسه جلسه موجود می سازد.

Parameters
deviceThe device to connect to.
sessionIDThe ID of the session to resume; or nil to start a new session.
Deprecated:
زیر کلاس‌ها باید createSessionForDevice:sessionID:sessionOptions را فراخوانی کنند.
- (void) notifyDidStartDiscovery

به مدیر اکتشاف اطلاع می دهد که کشف شروع شده است.

ارائه شده توسط دسته GCKDeviceProvider(Protected) .

- (void) notifyDidPublishDevice: ( GCKDevice *)  device

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

ارائه شده توسط دسته GCKDeviceProvider(Protected) .

- (void) notifyDidUnpublishDevice: ( GCKDevice *)  device

به مدیر اکتشاف اطلاع می دهد که دستگاهی که قبلاً منتشر شده بود، منتشر نشده است، زیرا دیگر در دسترس نیست.

ارائه شده توسط دسته GCKDeviceProvider(Protected) .

- (void) notifyDidUpdateDevice: ( GCKDevice *)  device

به مدیر اکتشاف اطلاع می دهد که یک یا چند ویژگی نمایشگر دستگاهی که قبلاً منتشر شده است (مانند نام دوستانه یا نمادها) تغییر کرده است.

ارائه شده توسط دسته GCKDeviceProvider(Protected) .

- ( GCKDevice *) createDeviceWithID: (NSString *)  deviceID
ipAddress: (NSString *)  ipAddress
servicePort: (uint16_t)  servicePort  
Deprecated:
از createDeviceWithID:networkAddress:servicePort: برای پشتیبانی IPv4 و IPv6 استفاده کنید

روش کارخانه ای برای ساخت نمونه های جدید GCKDevice . پارامترها با ویژگی های تغییرناپذیر یک GCKDevice مطابقت دارند.

Parameters
deviceIDThe unique ID identifying this device. This value must be unique among all GCKDevice objects that are created by this provider.
ipAddressThe IP address of the device, in numeric form (for example, @"10.0.0.10" ). May not be nil . Supports IPv4 only.
servicePortThe service port on which connections should be made to this device. May be 0 if a service port is not applicable.

ارائه شده توسط دسته GCKDeviceProvider(Protected) .

- ( GCKDevice *) createDeviceWithID: (NSString *)  deviceID
networkAddress: ( GCKNetworkAddress *)  networkAddress
servicePort: (uint16_t)  servicePort  

روش کارخانه ای برای ساخت نمونه های جدید GCKDevice .

پارامترها با ویژگی های تغییرناپذیر یک GCKDevice مطابقت دارند.

Parameters
deviceIDThe unique ID identifying this device. This value must be unique among all GCKDevice objects that are created by this provider.
networkAddressThe IP address of the device, either IPv4 or IPv6
servicePortThe service port on which connections should be made to this device. May be 0 if a service port is not applicable.
از آنجا که
4.2

ارائه شده توسط دسته GCKDeviceProvider(Protected) .

جزئیات ملک

- (NSString*) deviceCategory
read nonatomic copy

رشته ای که به طور منحصر به فرد نوع دستگاهی را که توسط این ارائه دهنده کشف می شود، مشخص می کند.

- (BOOL) passiveScan
read write nonatomic assign

این که آیا اسکن باید یک اسکن غیرفعال باشد.

اسکن غیرفعال پرس و جوهای اکتشافی را کمتر ارسال می کند، بنابراین کارآمدتر است، اما نتایج آنقدر تازه نخواهد بود. زمانی که کاربر به طور فعال هدف Cast را انتخاب نمی کند، اسکن غیرفعال انجام شود. همه پیاده سازی ها به این ویژگی احترام نمی گذارند.

- (NSArray< GCKDevice *>*) devices
read nonatomic copy

مجموعه ای از دستگاه های کشف شده