فئة GCKDeviceProvider

مرجع فئة GCKDeviceProvider

نظرة عامة

فئة أساسية مجرّدة لتنفيذ عملية البحث عن الأجهزة وإنشاء الجلسات

يمكن إضافة دعم لأنواع أجهزة إضافية من خلال توسيع نطاق هذه الفئة. راجِع فئة GCKDeviceProvider(Protected) للحصول على قائمة بطُرق المساعدة المخصّصة للاستخدام من قِبل الفئات الفرعية. يتم تسجيل موفّري الأجهزة الجدد في إطار العمل باستخدام registerDeviceProvider: (GCKCastContext).

منذ
3.0

تتضمّن NSObject.

ملخّص طرق المثيل

(instancetype) - initWithDeviceCategory:
 أداة تهيئة محدّدة المزيد...
 
(void) - startDiscovery
 يبدأ عملية فحص جديدة للعثور على الأجهزة. المزيد...
 
(void) - stopDiscovery
 توقِف عملية البحث عن الأجهزة. المزيد...
 
(GCKSession *) - createSessionForDevice:sessionID:
 تنشئ هذه الطريقة جلسة جديدة للجهاز المحدّد، ويمكنك اختياريًا إدخال معرّف جلسة حالية. المزيد...
 
(void) - notifyDidStartDiscovery
 يُعلم مدير البحث بأنّ عملية البحث قد بدأت. المزيد...
 
(void) - notifyDidPublishDevice:
 يُعلم مدير الاكتشاف بأنّه تم نشر جهاز جديد. المزيد...
 
(void) - notifyDidUnpublishDevice:
 يُعلم مدير البحث أنّ الجهاز الذي تم نشره سابقًا قد تم إلغاء نشره، لأنّه لم يعُد متاحًا. المزيد...
 
(void) - notifyDidUpdateDevice:
 يُعلم هذا الإجراء مدير الاكتشاف بأنّه تم تغيير واحد أو أكثر من سمات العرض الخاصة بجهاز تم نشره سابقًا (مثل الاسم المألوف أو الرموز). المزيد...
 
(GCKDevice *) - createDeviceWithID:ipAddress: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: (NSString *__nullable)  sessionID 

تنشئ هذه الطريقة جلسة جديدة للجهاز المحدّد، ويمكنك اختياريًا إدخال معرّف جلسة حالية.

يجب أن يتم إلغاؤها بواسطة الفئات الفرعية.

Parameters
deviceThe device to connect to.
sessionIDThe ID of the session to resume; or nil to start a new session.
- (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 

طريقة المصنع لإنشاء مثيلات 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.
servicePortThe service port on which connections should be made to this device. May be 0 if a service port is not applicable.

مقدَّم من الفئة GCKDeviceProvider(Protected).

تفاصيل الموقع

- (NSString*) deviceCategory
readnonatomiccopy

سلسلة تحدّد بشكل فريد نوع الجهاز الذي سيكتشفه هذا الموفّر.

- (BOOL) passiveScan
readwritenonatomicassign

تُحدِّد ما إذا كان يجب أن يكون الفحص فحصًا غير نشط.

يرسل الفحص غير النشط طلبات البحث عن الأجهزة بوتيرة أقل، لذا فهو أكثر كفاءة، ولكن لن تكون النتائج حديثة. من المناسب إجراء فحص سلبي عندما لا يختار المستخدم جهاز Cast مستهدفًا بشكل نشط. لن تقبل بعض عمليات التنفيذ هذه السمة.

- (NSArray<GCKDevice *>*) devices
readnonatomiccopy

مصفوفة الأجهزة التي تم اكتشافها