نظرة عامة
فئة تدير جلسة البث باستخدام جهاز استقبال.
يتم إنشاء الجلسات وإدارتها تلقائيًا بواسطة "GCKSessionManager". يجب ألا يستدعي التطبيق طرق مراحل نشاط الجلسة مباشرةً، مثل start (GCKSession(Protected)) أو endWithAction: (GCKSession(Protected)).
- منذ
- 3.0
يكتسب GCKSession.
ملخّص طريقة المثيل | |
| (instancetype) | - initWithDevice:sessionID:sessionOptions:castOptions: |
| ينشئ جلسة بث جديدة باستخدام خيارات البث المحددة. المزيد... | |
| (BOOL) | - addChannel: |
| تسجيل قناة خلال الجلسة المزيد... | |
| (BOOL) | - removeChannel: |
| إزالة قناة مسجّلة سابقًا من الجلسة المزيد... | |
| (void) | - addDeviceStatusListener: |
| تتم إضافة GCKCastDeviceStatusListener إلى قائمة المستمعين لهذا العنصر. المزيد... | |
| (void) | - removeDeviceStatusListener: |
| لإزالة GCKCastDeviceStatusListener من قائمة المستمعين لهذا العنصر. المزيد... | |
| (GCKRequest *) | - setDeviceVolume:forMultizoneDevice: |
| لضبط مستوى صوت الجهاز الفردي في مجموعة متعددة المناطق. المزيد... | |
| (GCKRequest *) | - setDeviceMuted:forMultizoneDevice: |
| لضبط حالة كتم صوت الجهاز الفردي في مجموعة متعددة المناطق. المزيد... | |
| (GCKRequest *) | - requestMultizoneStatus |
| طلب حالة متعددة المناطق من مجموعة متعددة المناطق. المزيد... | |
| (instancetype) | - initWithDevice:traits:sessionID: |
| يقوم بإعداد كائن جلسة جديد للجهاز المعيّن، باستخدام الخيارات التلقائية. المزيد... | |
| (instancetype) | - initWithDevice:traits:sessionID:sessionOptions: |
| يقوم بإعداد كائن جلسة جديد للجهاز المحدد. المزيد... | |
| (GCKRequest *) | - setDeviceVolume: |
| لضبط مستوى صوت الجهاز. المزيد... | |
| (GCKRequest *) | - setDeviceMuted: |
| لضبط حالة كتم صوت الجهاز. المزيد... | |
| (void) | - start |
| بدء الجلسة المزيد... | |
| (void) | - endWithAction: |
| ينهي الجلسة بالإجراء المحدّد. المزيد... | |
| (void) | - notifyDidStartWithSessionID: |
| تطلب الفئات الفرعية إعلام إطار العمل ببدء الجلسة. المزيد... | |
| (void) | - notifyDidFailToStartWithError: |
| تستدعي الفئات الفرعية لإبلاغ إطار العمل بتعذُّر بدء الجلسة. المزيد... | |
| (void) | - notifyDidEndWithError:willTryToResume: |
| تطلب الفئات الفرعية إعلام إطار العمل بانتهاء الجلسة. المزيد... | |
| (void) | - notifyDidReceiveDeviceVolume:muted: |
| تطلب الفئات الفرعية من هذه الفئات إشعار إطار العمل الذي يفيد بتلقّي الجهاز المحدَّث لمستوى صوت الجهاز وحالة كتم الصوت فيه. المزيد... | |
| (void) | - notifyDidReceiveDeviceStatus: |
| تطلب الفئات الفرعية من هذه الفئات إشعار إطار العمل بأنّ الحالة المعدّلة قد تم تلقّيها من الجهاز. المزيد... | |
| (void) | - notifyDidSuspendWithReason: |
| تم إيقاف العمل به، يُرجى عدم استخدامه. يتم تنفيذه كميزة مستقلة. المزيد... | |
| (void) | - notifyDidResume |
| تم إيقاف العمل به، يُرجى عدم استخدامه. يتم تنفيذه كميزة مستقلة. المزيد... | |
ملخّص الموقع | |
| GCKActiveInputStatus | activeInputStatus |
| حالة "الإدخال النشط" للجهاز المزيد... | |
| GCKStandbyStatus | standbyStatus |
| حالة "وضع الاستعداد" الحالية للجهاز المزيد... | |
| GCKApplicationMetadata * | applicationMetadata |
البيانات الوصفية لتطبيق المُستلِم الذي يعمل حاليًا على جهاز المُستلِم، إن وجد، أو nil المزيد... | |
| GCKDevice * | device |
| الجهاز المرتبط بهذه الجلسة المزيد... | |
| NSString * | sessionID |
| رقم تعريف الجلسة الحالية، إن توفّر. المزيد... | |
| GCKSessionOptions * | sessionOptions |
| خيارات الجلسة، إن توفّرت. المزيد... | |
| GCKConnectionState | connectionState |
| حالة اتصال الجلسة الحالية. المزيد... | |
| BOOL | suspended |
| علامة تشير إلى ما إذا كانت الجلسة معلّقة حاليًا أم لا. المزيد... | |
| NSString * | deviceStatusText |
| نص حالة الجهاز الحالية. المزيد... | |
| GCKSessionTraits * | traits |
| سمات الجلسة المزيد... | |
| float | currentDeviceVolume |
| مستوى الصوت الحالي للجهاز، في النطاق [0.0، 1.0]. المزيد... | |
| BOOL | currentDeviceMuted |
| حالة كتم صوت الجهاز الحالية المزيد... | |
| GCKRemoteMediaClient * | remoteMediaClient |
| الكائن GCKRemoteMediaClient الذي يمكن استخدامه للتحكم في تشغيل الوسائط في هذه الجلسة. المزيد... | |
| GCKMediaMetadata * | mediaMetadata |
| البيانات الوصفية الحالية للوسائط، إن توفّرت المزيد... | |
تفاصيل الطريقة
| - (instancetype) initWithDevice: | (GCKDevice *) | device | |
| sessionID: | (nullable NSString *) | sessionID | |
| sessionOptions: | (nullable GCKSessionOptions *) | sessionOptions | |
| castOptions: | (GCKCastOptions *) | castOptions | |
ينشئ جلسة بث جديدة باستخدام خيارات البث المحددة.
- 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
| - (BOOL) addChannel: | (GCKCastChannel *) | channel |
تسجيل قناة خلال الجلسة
إذا كانت الجلسة متصلة وكان تطبيق المُستلِم يتيح مساحة اسم القناة، سيتمّ ربط القناة تلقائيًا. إذا لم تكن الجلسة متصلة، ستظل القناة في حالة انقطاع إلى أن تبدأ الجلسة.
- Parameters
-
channel The channel to register.
- المرتجعات
YESإذا تم تسجيل القناة بنجاح،NOبخلاف ذلك.
| - (BOOL) removeChannel: | (GCKCastChannel *) | channel |
إزالة قناة مسجّلة سابقًا من الجلسة
- Parameters
-
channel The channel to unregister.
- المرتجعات
YESإذا تم إلغاء تسجيل القناة بنجاح،NO.
| - (void) addDeviceStatusListener: | (id< GCKCastDeviceStatusListener >) | listener |
تتم إضافة GCKCastDeviceStatusListener إلى قائمة المستمعين لهذا العنصر.
إنّ أداة معالجة الطلبات التي تمت إضافتها ضعيفة، ويجب الاحتفاظ بها لتجنُّب تخصيص العرض بشكل غير متوقّع.
- Parameters
-
listener The listener to add.
| - (void) removeDeviceStatusListener: | (id< GCKCastDeviceStatusListener >) | listener |
لإزالة GCKCastDeviceStatusListener من قائمة المستمعين لهذا العنصر.
- Parameters
-
listener The listener to remove.
| - (GCKRequest *) setDeviceVolume: | (float) | volume | |
| forMultizoneDevice: | (GCKMultizoneDevice *) | device | |
لضبط مستوى صوت الجهاز الفردي في مجموعة متعددة المناطق.
هذه عملية غير متزامنة.
- Parameters
-
volume The new volume, in the range [0.0, 1.0]. device The multizone device.
- المرتجعات
- عنصر GCKRequest لتتبع الطلب.
| - (GCKRequest *) setDeviceMuted: | (BOOL) | muted | |
| forMultizoneDevice: | (GCKMultizoneDevice *) | device | |
لضبط حالة كتم صوت الجهاز الفردي في مجموعة متعددة المناطق.
هذه عملية غير متزامنة.
- Parameters
-
muted The new muted state. device The multizone device.
- المرتجعات
- عنصر GCKRequest لتتبع الطلب.
| - (GCKRequest *) requestMultizoneStatus |
طلب حالة متعددة المناطق من مجموعة متعددة المناطق.
هذه عملية غير متزامنة. عند تلقّي الحالة "متعدد المناطق"، سيتم إرسال رسالة إلى طريقة التفويض في "castSession:didReceiveMultizoneStatus: (GCKCastDeviceStatusListener-p)".
- المرتجعات
- عنصر GCKRequest لتتبع الطلب.
| - (instancetype) initWithDevice: | (GCKDevice *) | device | |
| traits: | (nullable GCKSessionTraits *) | traits | |
| sessionID: | (nullable NSString *) | sessionID | |
يقوم بإعداد كائن جلسة جديد للجهاز المعيّن، باستخدام الخيارات التلقائية.
- 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 nilif it will be used to start a new session.
| - (instancetype) initWithDevice: | (GCKDevice *) | device | |
| traits: | (nullable GCKSessionTraits *) | traits | |
| sessionID: | (nullable NSString *) | sessionID | |
| sessionOptions: | (nullable GCKSessionOptions *) | sessionOptions | |
يقوم بإعداد كائن جلسة جديد للجهاز المحدد.
- 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 nilif it will be used to start a new session.sessionOptions The session options, if any; otherwise nil.
- منذ
- 4.0
| - (GCKRequest *) setDeviceVolume: | (float) | volume |
لضبط مستوى صوت الجهاز.
هذه عملية غير متزامنة. والتنفيذ التلقائي هو إجراء بيئة مستقلة يفشل في الطلب مع ظهور الخطأ GCKErrorCodeSupportedFeature.
- Parameters
-
volume The new volume.
- المرتجعات
- عنصر GCKRequest لتتبع الطلب.
- منذ
- 3.4؛ في إصدارات إطار العمل السابقة، عرضت هذه الطريقة
void.
| - (GCKRequest *) setDeviceMuted: | (BOOL) | muted |
لضبط حالة كتم صوت الجهاز.
هذه عملية غير متزامنة. والتنفيذ التلقائي هو إجراء بيئة مستقلة يفشل في الطلب مع ظهور الخطأ GCKErrorCodeSupportedFeature.
- Parameters
-
muted The new mute state.
- المرتجعات
- عنصر GCKRequest لتتبع الطلب.
- منذ
- 3.4؛ في إصدارات إطار العمل السابقة، عرضت هذه الطريقة
void.
| - (void) start |
بدء الجلسة
هذه عملية غير متزامنة. يجب أن تلغي الفئات الفرعية.
متوفرة حسب الفئة "GCKSession(Protected)"
| - (void) endWithAction: | (GCKSessionEndAction) | action |
ينهي الجلسة بالإجراء المحدّد.
هذه عملية غير متزامنة. يجب أن تلغي الفئات الفرعية.
- Parameters
-
action The action to take when ending the session; see GCKSessionEndAction for more details.
متوفرة حسب الفئة "GCKSession(Protected)"
| - (void) notifyDidStartWithSessionID: | (NSString *) | sessionID |
تطلب الفئات الفرعية إعلام إطار العمل ببدء الجلسة.
- Parameters
-
sessionID The session's unique ID.
متوفرة حسب الفئة "GCKSession(Protected)"
| - (void) notifyDidFailToStartWithError: | (GCKError *) | error |
تستدعي الفئات الفرعية لإبلاغ إطار العمل بتعذُّر بدء الجلسة.
- Parameters
-
error The error that occurred.
متوفرة حسب الفئة "GCKSession(Protected)"
| - (void) notifyDidEndWithError: | (nullable NSError *) | error | |
| willTryToResume: | (BOOL) | willTryToResume | |
تطلب الفئات الفرعية إعلام إطار العمل بانتهاء الجلسة.
- Parameters
-
error The error that caused the session to end, if any. Should be nilif the session was ended intentionally.willTryToResume Whether the session will try to resume itself automatically.
متوفرة حسب الفئة "GCKSession(Protected)"
| - (void) notifyDidReceiveDeviceVolume: | (float) | volume | |
| muted: | (BOOL) | muted | |
تطلب الفئات الفرعية من هذه الفئات إشعار إطار العمل الذي يفيد بتلقّي الجهاز المحدَّث لمستوى صوت الجهاز وحالة كتم الصوت فيه.
- Parameters
-
volume The device's current volume. Must be in the range [0, 1.0]; muted The device's current mute state.
متوفرة حسب الفئة "GCKSession(Protected)"
| - (void) notifyDidReceiveDeviceStatus: | (nullable NSString *) | statusText |
تطلب الفئات الفرعية من هذه الفئات إشعار إطار العمل بأنّ الحالة المعدّلة قد تم تلقّيها من الجهاز.
- Parameters
-
statusText The new status.
متوفرة حسب الفئة "GCKSession(Protected)"
| - (void) notifyDidSuspendWithReason: | (GCKConnectionSuspendReason) | reason |
تم إيقاف العمل بها، يُرجى عدم استخدامها - يتم تنفيذها كميزة مستقلة.
- Deprecated:
- عدم الاتصال.
متوفرة حسب الفئة "GCKSession(Protected)"
| - (void) notifyDidResume |
تم إيقاف العمل بها، يُرجى عدم استخدامها - يتم تنفيذها كميزة مستقلة.
- Deprecated:
- عدم الاتصال.
متوفرة حسب الفئة "GCKSession(Protected)"
تفاصيل الموقع
|
readnonatomicassign |
حالة "الإدخال النشط" للجهاز
|
readnonatomicassign |
حالة "وضع الاستعداد" الحالية للجهاز
|
readnonatomiccopy |
البيانات الوصفية لتطبيق المُستلِم الذي يعمل حاليًا على جهاز المُستلِم، إن وجد، أو nil
|
readnonatomicstronginherited |
الجهاز المرتبط بهذه الجلسة
|
readnonatomiccopyinherited |
رقم تعريف الجلسة الحالية، إن توفّر.
|
readnonatomicstronginherited |
خيارات الجلسة، إن توفّرت.
- منذ
- 4.0
|
readnonatomicassigninherited |
حالة اتصال الجلسة الحالية.
|
readnonatomicassigninherited |
علامة تشير إلى ما إذا كانت الجلسة معلّقة حاليًا أم لا.
- Deprecated:
- لم يعد GCKSession يدعم أن يكون في الحالة "معلّق". وإذا لزم الأمر، انقل هذه الوظيفة إلى فئة فرعية.
|
readnonatomiccopyinherited |
نص حالة الجهاز الحالية.
|
readnonatomiccopyinherited |
سمات الجلسة
|
readnonatomicassigninherited |
مستوى الصوت الحالي للجهاز، في النطاق [0.0، 1.0].
|
readnonatomicassigninherited |
حالة كتم صوت الجهاز الحالية
|
readnonatomicstronginherited |
الكائن GCKRemoteMediaClient الذي يمكن استخدامه للتحكم في تشغيل الوسائط في هذه الجلسة.
الوقت الحالي هو nil قبل بدء الجلسة، أو إذا كانت الجلسة لا تتوافق مع GCKRemoteMediaClient API. يجب أن تلغي الفئات الفرعية التي توفّر واجهة GCKRemoteMediaClient طريقة getter.
|
readnonatomicstronginherited |
البيانات الوصفية الحالية للوسائط، إن توفّرت
سيصبح nil إذا كانت الجلسة لا تتيح مساحة اسم الوسائط أو إذا لم يتم تحميل أي وسائط حاليًا على جهاز الاستقبال.