حصة GCKCastSession

ينشئ جلسة بث جديدة باستخدام خيارات البث المحددة.

Parameters

device	The receiver device.
sessionID	The session ID, if resuming; otherwise nil.
sessionOptions	The session options, if any; otherwise nil.
castOptions	The Cast options.

منذ

4.0

تسجيل قناة خلال الجلسة

إذا كانت الجلسة متصلة وكان تطبيق المُستلِم يتيح مساحة اسم القناة، سيتمّ ربط القناة تلقائيًا. إذا لم تكن الجلسة متصلة، ستظل القناة في حالة انقطاع إلى أن تبدأ الجلسة.

Parameters

channel

The channel to register.

المرتجعات

YES إذا تم تسجيل القناة بنجاح، NO بخلاف ذلك.

إزالة قناة مسجّلة سابقًا من الجلسة

Parameters

channel

The channel to unregister.

المرتجعات

YES إذا تم إلغاء تسجيل القناة بنجاح، NO.

تتم إضافة GCKCastDeviceStatusListener إلى قائمة المستمعين لهذا العنصر.

إنّ أداة معالجة الطلبات التي تمت إضافتها ضعيفة، ويجب الاحتفاظ بها لتجنُّب تخصيص العرض بشكل غير متوقّع.

Parameters

listener

The listener to add.

لإزالة GCKCastDeviceStatusListener من قائمة المستمعين لهذا العنصر.

Parameters

listener

The listener to remove.

لضبط مستوى صوت الجهاز الفردي في مجموعة متعددة المناطق.

هذه عملية غير متزامنة.

Parameters

volume	The new volume, in the range [0.0, 1.0].
device	The multizone device.

المرتجعات

عنصر GCKRequest لتتبع الطلب.

لضبط حالة كتم صوت الجهاز الفردي في مجموعة متعددة المناطق.

هذه عملية غير متزامنة.

Parameters

muted	The new muted state.
device	The multizone device.

المرتجعات

عنصر GCKRequest لتتبع الطلب.

طلب حالة متعددة المناطق من مجموعة متعددة المناطق.

هذه عملية غير متزامنة. عند تلقّي الحالة "متعدد المناطق"، سيتم إرسال رسالة إلى طريقة التفويض في "castSession:didReceiveMultizoneStatus: (GCKCastDeviceStatusListener-p)".

المرتجعات

عنصر GCKRequest لتتبع الطلب.

يقوم بإعداد كائن جلسة جديد للجهاز المعيّن، باستخدام الخيارات التلقائية.

Parameters

device	The device.
traits	The session traits.
sessionID	The session ID of an existing session, if this object will be used to resume a session; otherwise nil if it will be used to start a new session.

يقوم بإعداد كائن جلسة جديد للجهاز المحدد.

Parameters

device	The device.
traits	The session traits.
sessionID	The session ID of an existing session, if this object will be used to resume a session; otherwise nil if it will be used to start a new session.
sessionOptions	The session options, if any; otherwise nil.

منذ

4.0

لضبط مستوى صوت الجهاز.

هذه عملية غير متزامنة. والتنفيذ التلقائي هو إجراء بيئة مستقلة يفشل في الطلب مع ظهور الخطأ GCKErrorCodeSupportedFeature.

Parameters

volume

The new volume.

المرتجعات

عنصر GCKRequest لتتبع الطلب.

منذ

3.4؛ في إصدارات إطار العمل السابقة، عرضت هذه الطريقة void.

لضبط حالة كتم صوت الجهاز.

هذه عملية غير متزامنة. والتنفيذ التلقائي هو إجراء بيئة مستقلة يفشل في الطلب مع ظهور الخطأ GCKErrorCodeSupportedFeature.

Parameters

muted

The new mute state.

المرتجعات

عنصر GCKRequest لتتبع الطلب.

منذ

3.4؛ في إصدارات إطار العمل السابقة، عرضت هذه الطريقة void.

بدء الجلسة

هذه عملية غير متزامنة. يجب أن تلغي الفئات الفرعية.

متوفرة حسب الفئة "GCKSession(Protected)"

ينهي الجلسة بالإجراء المحدّد.

هذه عملية غير متزامنة. يجب أن تلغي الفئات الفرعية.

Parameters

action

The action to take when ending the session; see GCKSessionEndAction for more details.

متوفرة حسب الفئة "GCKSession(Protected)"

تطلب الفئات الفرعية إعلام إطار العمل ببدء الجلسة.

Parameters

sessionID

The session's unique ID.

متوفرة حسب الفئة "GCKSession(Protected)"

تستدعي الفئات الفرعية لإبلاغ إطار العمل بتعذُّر بدء الجلسة.

Parameters

error

The error that occurred.

متوفرة حسب الفئة "GCKSession(Protected)"

تطلب الفئات الفرعية إعلام إطار العمل بانتهاء الجلسة.

Parameters

error	The error that caused the session to end, if any. Should be nil if the session was ended intentionally.
willTryToResume	Whether the session will try to resume itself automatically.

متوفرة حسب الفئة "GCKSession(Protected)"

تطلب الفئات الفرعية من هذه الفئات إشعار إطار العمل الذي يفيد بتلقّي الجهاز المحدَّث لمستوى صوت الجهاز وحالة كتم الصوت فيه.

Parameters

volume	The device's current volume. Must be in the range [0, 1.0];
muted	The device's current mute state.

متوفرة حسب الفئة "GCKSession(Protected)"

تطلب الفئات الفرعية من هذه الفئات إشعار إطار العمل بأنّ الحالة المعدّلة قد تم تلقّيها من الجهاز.

Parameters

statusText

The new status.

متوفرة حسب الفئة "GCKSession(Protected)"

تم إيقاف العمل بها، يُرجى عدم استخدامها - يتم تنفيذها كميزة مستقلة.

Deprecated:

عدم الاتصال.

متوفرة حسب الفئة "GCKSession(Protected)"

تم إيقاف العمل بها، يُرجى عدم استخدامها - يتم تنفيذها كميزة مستقلة.

Deprecated:

عدم الاتصال.

متوفرة حسب الفئة "GCKSession(Protected)"

حالة "الإدخال النشط" للجهاز

حالة "وضع الاستعداد" الحالية للجهاز

البيانات الوصفية لتطبيق المُستلِم الذي يعمل حاليًا على جهاز المُستلِم، إن وجد، أو nil

الجهاز المرتبط بهذه الجلسة

رقم تعريف الجلسة الحالية، إن توفّر.

خيارات الجلسة، إن توفّرت.

منذ

4.0

حالة اتصال الجلسة الحالية.

علامة تشير إلى ما إذا كانت الجلسة معلّقة حاليًا أم لا.

Deprecated:

لم يعد GCKSession يدعم أن يكون في الحالة "معلّق". وإذا لزم الأمر، انقل هذه الوظيفة إلى فئة فرعية.

نص حالة الجهاز الحالية.

سمات الجلسة

مستوى الصوت الحالي للجهاز، في النطاق [0.0، 1.0].

حالة كتم صوت الجهاز الحالية

الكائن GCKRemoteMediaClient الذي يمكن استخدامه للتحكم في تشغيل الوسائط في هذه الجلسة.

الوقت الحالي هو nil قبل بدء الجلسة، أو إذا كانت الجلسة لا تتوافق مع GCKRemoteMediaClient API. يجب أن تلغي الفئات الفرعية التي توفّر واجهة GCKRemoteMediaClient طريقة getter.

البيانات الوصفية الحالية للوسائط، إن توفّرت

سيصبح nil إذا كانت الجلسة لا تتيح مساحة اسم الوسائط أو إذا لم يتم تحميل أي وسائط حاليًا على جهاز الاستقبال.