نظرة عامة

فئة تدير جلسة البث باستخدام جهاز استقبال.

يتم إنشاء الجلسات وإدارتها تلقائيًا بواسطة "GCKSessionManager". يجب ألا يستدعي التطبيق طرق مراحل نشاط الجلسة مباشرةً، مثل start (GCKSession(Protected)) أو endAndStopCasting: (GCKSession(Protected)).

منذ: 3.0

يكتسب GCKSession.

ملخّص طريقة المثيل
(instancetype)	- initWithDevice:sessionID:castOptions:
	المُهيئ المُعيّن. المزيد...

(BOOL)	- addChannel:
	تسجيل قناة خلال الجلسة المزيد...

(BOOL)	- removeChannel:
	إزالة قناة مسجّلة سابقًا من الجلسة المزيد...

(void)	- addDeviceStatusListener:
	تتم إضافة GCKCastDeviceStatusListener إلى قائمة المستمعين لهذا العنصر. المزيد...

(void)	- removeDeviceStatusListener:
	لإزالة GCKCastDeviceStatusListener من قائمة المستمعين لهذا العنصر. المزيد...

(GCKRequest *)	- setDeviceVolume:forMultizoneDevice:
	لضبط مستوى صوت الجهاز الفردي في مجموعة متعددة المناطق. المزيد...

(GCKRequest *)	- setDeviceMuted:forMultizoneDevice:
	لضبط حالة كتم صوت الجهاز الفردي في مجموعة متعددة المناطق. المزيد...

(GCKRequest *)	- requestMultizoneStatus
	طلب حالة متعددة المناطق من مجموعة متعددة المناطق. المزيد...

(instancetype)	- initWithDevice:traits:sessionID:
	يقوم بإعداد كائن جلسة جديد للجهاز المحدد. المزيد...

(GCKRequest *)	- setDeviceVolume:
	لضبط مستوى صوت الجهاز. المزيد...

(GCKRequest *)	- setDeviceMuted:
	لضبط حالة كتم صوت الجهاز. المزيد...

(void)	- start
	بدء الجلسة المزيد...

(void)	- endAndStopCasting:
	ينهي الجلسة. المزيد...

(void)	- suspendWithReason:
	تعليق الجلسة للسبب المحدَّد المزيد...

(void)	- resume
	يتم استئناف الجلسة. المزيد...

(void)	- notifyDidStartWithSessionID:
	تطلب الفئات الفرعية إعلام إطار العمل ببدء الجلسة. المزيد...

(void)	- notifyDidFailToStartWithError:
	تستدعي الفئات الفرعية لإبلاغ إطار العمل بتعذُّر بدء الجلسة. المزيد...

(void)	- notifyDidResume
	تطلب الفئات الفرعية إبلاغ إطار العمل باستئناف الجلسة. المزيد...

(void)	- notifyDidSuspendWithReason:
	تطلب الفئات الفرعية إبلاغ إطار العمل بأنّه قد تم تعليق الجلسة. المزيد...

(void)	- notifyDidEndWithError:
	تطلب الفئات الفرعية إعلام إطار العمل بانتهاء الجلسة. المزيد...

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

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

ملخّص الموقع
GCKActiveInputStatus	activeInputStatus
	حالة "الإدخال النشط" للجهاز المزيد...

GCKStandbyStatus	standbyStatus
	حالة "وضع الاستعداد" الحالية للجهاز المزيد...

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

GCKDevice *	device
	الجهاز المرتبط بهذه الجلسة المزيد...

NSString *	sessionID
	رقم تعريف الجلسة الحالية، إن توفّر. المزيد...

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:	(NSString *__nullable)	sessionID
castOptions:	(GCKCastOptions *)	castOptions

المُهيئ المُعيّن.

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

Parameters

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

- (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:	(GCKSessionTraits *)	traits
sessionID:	(NSString *__nullable)	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.

- (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) endAndStopCasting: (BOOL) stopCasting

ينهي الجلسة.

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

Parameters

stopCasting Whether to stop casting content to the receiver.

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

- (void) suspendWithReason: (GCKConnectionSuspendReason) reason

تعليق الجلسة للسبب المحدَّد

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

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

- (void) resume

يتم استئناف الجلسة.

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

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

- (void) notifyDidStartWithSessionID: (NSString *) sessionID

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

Parameters

sessionID The session's unique ID.

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

- (void) notifyDidFailToStartWithError: (NSError *) error

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

Parameters

error The error that occurred.

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

- (void) notifyDidResume

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

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

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason) reason

تطلب الفئات الفرعية إبلاغ إطار العمل بأنّه قد تم تعليق الجلسة.

Parameters

reason The reason for the suspension.

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

- (void) notifyDidEndWithError: (NSError *__nullable) error

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

Parameters

error The error that caused the session to end, if any. Should be nil if the session was ended intentionally.

متوفرة حسب الفئة "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: (NSString *__nullable) statusText

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

Parameters

statusText The new status.

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

تفاصيل الموقع

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

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

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

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

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

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

- (GCKDevice*) device

readnonatomicstronginherited

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

- (NSString*) sessionID

readnonatomiccopyinherited

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

- (GCKConnectionState) connectionState

readnonatomicassigninherited

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

- (BOOL) suspended

readnonatomicassigninherited

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

- (NSString*) deviceStatusText

readnonatomiccopyinherited

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

- (GCKSessionTraits*) traits

readnonatomiccopyinherited

سمات الجلسة

- (float) currentDeviceVolume

readnonatomicassigninherited

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

- (BOOL) currentDeviceMuted

readnonatomicassigninherited

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

- (GCKRemoteMediaClient*) remoteMediaClient

readnonatomicstronginherited

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

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

- (GCKMediaMetadata*) mediaMetadata

readnonatomicstronginherited

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

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

حصة GCKCastSession

نظرة عامة

ملخّص طريقة المثيل

ملخّص الموقع

تفاصيل الطريقة

تفاصيل الموقع