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

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

- (BOOL) passiveScan
readwritenonatomicassign

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

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

- (NSArray<GCKDevice *>*) devices
readnonatomiccopy

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