نظرة عامة
قناة اتصال افتراضية لتبادل الرسائل بين مُرسِل البث وجهاز استقبال البث.
يتم وضع علامة على كل قناة بمساحة اسم فريدة، وبالتالي يمكن مضاعفة قنوات متعددة عبر اتصال شبكة واحد بين المُرسِل والمستلِم.
يجب أن تكون القناة مسجَّلة من خلال GCKCastSession قبل استخدامها. عند إنشاء الجلسة المرتبطة، سيتم ربط القناة تلقائيًا وبإمكانها بعد ذلك إرسال الرسائل واستلامها.
يجب أن تطبّق الفئات الفرعية طريقة didReceiveTextMessage: (GCKCastChannel) لمعالجة الرسائل الواردة، وستوفّر عادةً طرقًا إضافية لإرسال الرسائل الخاصة بمساحة اسم معيّنة.
تكتسب NSObject.
مكتسَب من قِبل GCKGameManagerChannel وGCKGenericChannel وGCKMediaControlChannel
ملخّص طريقة المثيل | |
| (instancetype) | - initWithNamespace: |
| المُهيئ المُعيّن. المزيد... | |
| (instancetype) | - init |
| أداة الإعداد التلقائية غير متوفّرة. المزيد... | |
| (void) | - didReceiveTextMessage: |
| يتم الاتصال به عند تلقّي رسالة نصية على هذه القناة. المزيد... | |
| (BOOL) | - sendTextMessage: |
| يرسل رسالة نصية على هذه القناة. المزيد... | |
| (BOOL) | - sendTextMessage:error: |
| يرسل رسالة نصية على هذه القناة. المزيد... | |
| (NSInteger) | - generateRequestID |
| ينشئ معرّف طلب لرسالة جديدة. المزيد... | |
| (NSNumber *__nullable) | - generateRequestNumber |
| طريقة مريحة تلفّ نتيجة generateRequestID في NSNumber. المزيد... | |
| (void) | - didConnect |
| يتم استدعاء هذا الإجراء عند ربط هذه القناة، للإشارة إلى أنّه يمكن الآن تبادل الرسائل مع جهاز البث من خلال هذه القناة. المزيد... | |
| (void) | - didDisconnect |
| يتم استدعاء هذا الإجراء عند انقطاع الاتصال بهذه القناة، للإشارة إلى أنّه لم يعُد من الممكن تبادل الرسائل مع جهاز البث من خلال هذه القناة. المزيد... | |
ملخّص الموقع | |
| NSString * | protocolNamespace |
| مساحة اسم القناة المزيد... | |
| BOOL | isConnected |
| علامة تشير إلى ما إذا كانت هذه القناة مرتبطة حاليًا المزيد... | |
| GCKDeviceManager * | deviceManager |
| مدير الجهاز الذي تم تسجيل هذه القناة معه، إن توفّر المزيد... | |
تفاصيل الطريقة
| - (instancetype) initWithNamespace: | (NSString *) | protocolNamespace |
المُهيئ المُعيّن.
تنشئ هذه الدالة GCKCastChannel جديدة باستخدام مساحة الاسم المحددة.
- Parameters
-
protocolNamespace The namespace.
تم التنفيذ في GCKGenericChannel.
| - (instancetype) init |
أداة الإعداد التلقائية غير متوفّرة.
تم تنفيذه في GCKMediaControlChannel وGCKGameManagerChannel.
| - (void) didReceiveTextMessage: | (NSString *) | message |
يتم الاتصال به عند تلقّي رسالة نصية على هذه القناة.
والتنفيذ التلقائي هو بيئة مستقلة.
- Parameters
-
message The message.
| - (BOOL) sendTextMessage: | (NSString *) | message |
يرسل رسالة نصية على هذه القناة.
- Parameters
-
message The message.
- المرتجعات
YESعند نجاح الإجراء أوNOإذا تعذّر إرسال الرسالة (لأن القناة غير متصلة أو لأن المخزن المؤقت للإرسال ممتلئ جدًا في الوقت الحالي).
- Deprecated:
- استخدام sendTextMessage:error: الذي يقدّم معلومات مفصّلة عن الخطأ
| - (BOOL) sendTextMessage: | (NSString *) | message | |
| error: | (GCKError *__nullable *__nullable) | error | |
يرسل رسالة نصية على هذه القناة.
- Parameters
-
message The message. error A pointer at which to store the error result. May be nil.
- المرتجعات
YESعند النجاح أوNOإذا تعذّر إرسال الرسالة.
| - (NSInteger) generateRequestID |
ينشئ معرّف طلب لرسالة جديدة.
- المرتجعات
- المعرّف الذي تم إنشاؤه أو kGCKInvalidRequestID إذا لم تكن القناة مرتبطة حاليًا
| - (NSNumber * __nullable) generateRequestNumber |
طريقة مريحة تلفّ نتيجة generateRequestID في NSNumber.
- المرتجعات
- المعرّف الذي تم إنشاؤه أو
nilإذا لم تكن القناة مرتبطة حاليًا
| - (void) didConnect |
يتم استدعاء هذا الإجراء عند ربط هذه القناة، للإشارة إلى أنّه يمكن الآن تبادل الرسائل مع جهاز البث من خلال هذه القناة.
والتنفيذ التلقائي هو بيئة مستقلة.
| - (void) didDisconnect |
يتم استدعاء هذا الإجراء عند انقطاع الاتصال بهذه القناة، للإشارة إلى أنّه لم يعُد من الممكن تبادل الرسائل مع جهاز البث من خلال هذه القناة.
والتنفيذ التلقائي هو بيئة مستقلة.
تفاصيل الموقع
|
readnonatomiccopy |
مساحة اسم القناة
|
readnonatomicassign |
علامة تشير إلى ما إذا كانت هذه القناة مرتبطة حاليًا
|
readnonatomicweak |
مدير الجهاز الذي تم تسجيل هذه القناة معه، إن توفّر
- Deprecated:
- إذا لم تكن هذه القناة مسجَّلة ضمن صف GCKDeviceManager المتوقّف نهائيًا، ستكون هذه القناة
nil.