نظرة عامة
فئة أساسية مجرّدة تمثّل جلسة باستخدام جهاز استقبال.
ويجب أن تستخدم الفئات الفرعية الطريقتين start (GCKSession(Protected)) وendWithAction: (GCKSession(Protected))، كما يجب أن تستدعي طرق الإشعار المناسبة (مثل notifyDidStartWithSessionID: (GCKSession(Protected))) للإشارة إلى التغييرات المقابلة في حالة الجلسة. وقد تستخدم الفئات الفرعية أيضًا الترميزَين setDeviceVolume: (GCKSession) وsetDeviceMuted: (GCKSession) وremoteMediaClient إذا كان الجهاز يتوافق مع هذه العمليات.
يتم إنشاء جلسة والتحكّم فيها باستخدام طرق الجلسات في GCKSessionManager، والتي تستخدم GCKDeviceProvider المناسبة لإنشاء الجلسة، ثم تفوّض طلبات الجلسة إلى عنصر GCKSession هذا.
- منذ
- 3.0
تكتسب NSObject.
مكتسَب من قِبل GCKCastSession.
ملخّص طريقة المثيل | |
(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 |
تم إيقاف العمل به، يُرجى عدم استخدامه. يتم تنفيذه كميزة مستقلة. المزيد... | |
ملخّص الموقع | |
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 | |
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 nil
if 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 nil
if 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 nil
if 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)"
تفاصيل الموقع
|
readnonatomicstrong |
الجهاز المرتبط بهذه الجلسة
|
readnonatomiccopy |
رقم تعريف الجلسة الحالية، إن توفّر.
|
readnonatomicstrong |
خيارات الجلسة، إن توفّرت.
- منذ
- 4.0
|
readnonatomicassign |
حالة اتصال الجلسة الحالية.
|
readnonatomicassign |
علامة تشير إلى ما إذا كانت الجلسة معلّقة حاليًا أم لا.
- Deprecated:
- لم يعد GCKSession يدعم أن يكون في الحالة "معلّق". وإذا لزم الأمر، انقل هذه الوظيفة إلى فئة فرعية.
|
readnonatomiccopy |
نص حالة الجهاز الحالية.
|
readnonatomiccopy |
سمات الجلسة
|
readnonatomicassign |
مستوى الصوت الحالي للجهاز، في النطاق [0.0، 1.0].
|
readnonatomicassign |
حالة كتم صوت الجهاز الحالية
|
readnonatomicstrong |
الكائن GCKRemoteMediaClient الذي يمكن استخدامه للتحكم في تشغيل الوسائط في هذه الجلسة.
الوقت الحالي هو nil
قبل بدء الجلسة، أو إذا كانت الجلسة لا تتوافق مع GCKRemoteMediaClient API. يجب أن تلغي الفئات الفرعية التي توفّر واجهة GCKRemoteMediaClient طريقة getter.
|
readnonatomicstrong |
البيانات الوصفية الحالية للوسائط، إن توفّرت
سيصبح nil
إذا كانت الجلسة لا تتيح مساحة اسم الوسائط أو إذا لم يتم تحميل أي وسائط حاليًا على جهاز الاستقبال.