فئة 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

deviceCategory

A 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

device	The device to connect to.
sessionID	The 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

deviceID	The unique ID identifying this device. This value must be unique among all GCKDevice objects that are created by this provider.
ipAddress	The IP address of the device, in numeric form (for example, @"10.0.0.10"). May not be nil.
servicePort	The 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

لتحديد ما إذا كان الفحص فحصًا سلبيًا أم لا.

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

- (NSArray<GCKDevice *>*) devices

readnonatomiccopy

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