نظرة عامة

وحدة تحكم لأجهزة البث.

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

يجب أن يظل المثيل GCKDeviceManager في النطاق طالما تم إنشاء اتصال بجهاز البث أو ما زال في مرحلة الإنشاء أو تفكيكه. من الآمن تحرير العنصر قبل بدء الاتصال بـ connect (GCKDeviceManager)، أو بعد استدعاء الاتصال بـ deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p) أو deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) أو deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p) تفويض المفوض.

Deprecated:: يمكنك استخدام GCKSessionManager وGCKCastSession للتفاعل مع أجهزة استقبال البث.

يكتسب NSObject.

ملخص طريقة المثيل
(instancetype)	- initWithDevice:clientPackageName:
	لإنشاء GCKDeviceManager جديدة باستخدام الجهاز المحدّد. المزيد...

(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	مُعَيِّن مُحدَّد. المزيد...

(void)	- connect
	يتصل بالجهاز. المزيد...

(void)	- disconnect
	قطع الاتصال بالجهاز. المزيد...

(void)	- disconnectWithLeave:
	قطع الاتصال بالجهاز. المزيد...

(BOOL)	- addChannel:
	لإضافة قناة يمكنها إرسال رسائل وتلقّيها لهذا الجهاز على مساحة اسم معيّنة المزيد...

(BOOL)	- removeChannel:
	لإزالة قناة سبقت إضافتها. المزيد...

(NSInteger)	- launchApplication:
	لتشغيل تطبيق. المزيد...

(NSInteger)	- launchApplication:withLaunchOptions:
	لتشغيل تطبيق باستخدام خيارات التشغيل المحددة. المزيد...

(NSInteger)	- launchApplication:relaunchIfRunning:
	لتشغيل تطبيق ما، وإعادة تشغيله اختياريًا إذا كان قيد التشغيل فعلاً. المزيد...

(NSInteger)	- joinApplication:
	الانضمام إلى تطبيق. المزيد...

(NSInteger)	- joinApplication:sessionID:
	الانضمام إلى تطبيق برقم تعريف جلسة تطبيق معين. المزيد...

(BOOL)	- leaveApplication
	مغادرة التطبيق الحالي. المزيد...

(NSInteger)	- stopApplication
	لإيقاف أي تطبيق(تطبيقات) قيد التشغيل. المزيد...

(NSInteger)	- stopApplicationWithSessionID:
	لإيقاف التطبيق برقم تعريف جلسة التطبيق المحدد. المزيد...

(NSInteger)	- setVolume:
	لتعيين مستوى صوت النظام. المزيد...

(NSInteger)	- setMuted:
	لتفعيل التجاهل أو إيقافه. المزيد...

(NSInteger)	- requestDeviceStatus
	لطلب الحالة الحالية للجهاز. المزيد...

ملخص الموقع
BOOL	ignoreAppStateNotifications
	ما إذا كان هذا الكائن سيستمع إلى إشعارات حالة التطبيق. المزيد...

GCKConnectionState	connectionState
	حالة الاتصال الحالية لمدير الجهاز المزيد...

GCKConnectionState	applicationConnectionState
	حالة اتصال التطبيق الحالي لمدير الجهاز. المزيد...

BOOL	isConnected
	صحيح إذا أنشأ مدير الجهاز اتصالاً بالجهاز. المزيد...

BOOL	isConnectedToApp
	صحيح إذا أنشأ مدير الجهاز اتصالاً بأحد التطبيقات على الجهاز. المزيد...

BOOL	isReconnecting
	صحيح إذا كان مدير الجهاز غير متصل بسبب حدث يُحتمل أن يكون عابرًا (على سبيل المثال، إذا كان التطبيق في الخلفية، أو كان هناك خطأ في الشبكة يمكن حله عن طريق إعادة الاتصال). المزيد...

NSTimeInterval	reconnectTimeout
	وستتم محاولة إعادة الاتصال لفترة طويلة في حالة انقطاع المقبس مع حدوث خطأ مؤقت. المزيد...

GCKDevice *	device
	الجهاز الذي يتم التحكم فيه من خلال GCKDeviceManager. المزيد...

id< GCKDeviceManagerDelegate >	delegate
	مفوّض لتلقي إشعارات من GCKDeviceManager. المزيد...

float	deviceVolume
	الحجم الحالي للجهاز في النطاق [0.0، 1.0]، في حال كان معروفًا؛ وبخلاف ذلك 0. المزيد...

BOOL	deviceMuted
	حالة كتم الصوت الحالية للجهاز، في حال كانت معروفة، وبخلاف ذلك `NO`. المزيد...

GCKActiveInputStatus	activeInputStatus
	الحالة الحالية "للإدخال النشط" للجهاز. المزيد...

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

NSString *	applicationSessionID
	معرِّف جلسة التطبيق لتطبيق المُستلِم المرتبط حاليًا، إن وُجد؛ وإلا `nil`. المزيد...

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

NSString *	applicationStatusText
	أحدث نص حالة تم الإبلاغ عنه من تطبيق المستلِم قيد التشغيل حاليًا، إن وجد، وإلا `nil`. المزيد...

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

- (instancetype) initWithDevice:	(GCKDevice *)	device
clientPackageName:	(NSString *)	clientPackageName

لإنشاء GCKDeviceManager جديدة باستخدام الجهاز المحدّد.

سيستمع الكائن إلى إشعارات حالة التطبيق، وسيتم إلغاء ربطه تلقائيًا بالجهاز عند انتقاله إلى الخلفية ومحاولة إعادة الاتصال بالجهاز عندما يعود التطبيق إلى المقدمة.

Parameters

device	The device to control.
clientPackageName	The client package name.

- (instancetype) initWithDevice:	(GCKDevice *)	device
clientPackageName:	(NSString *)	clientPackageName
ignoreAppStateNotifications:	(BOOL)	ignoreAppStateNotifications

مُعَيِّن مُحدَّد.

ينشئ GCKDeviceManager جديدًا للتحكم في الجهاز المحدد.

إذا كانت قيمة ignoreAppStateNotifications هي NO، سيستمع الكائن إلى التغييرات التي تطرأ على حالة التطبيق وسيتم إلغاء ربطه تلقائيًا بالجهاز عند انتقاله إلى الخلفية ومحاولة إعادة الاتصال بالجهاز عند عودة التطبيق إلى المقدمة.

إذا كانت قيمة ignoreAppStateNotifications هي YES، لن يستمع الكائن إلى هذه الإشعارات، وسيكون من مسؤولية التطبيق دورة إدارة الاتصال. لاحظ أنه بشكل عام، لا يمكن أن يستمر تطبيق iOS في الخلفية إلى أجل غير مسمى، وسيتم إغلاق اتصالات الشبكة النشطة في نهاية المطاف من قِبل نظام التشغيل.

Parameters

device	The device to control.
clientPackageName	The client package name.
ignoreAppStateNotifications	Whether this object will ignore app state notifications.

- (void) connect

يتصل بالجهاز.

- (void) disconnect

قطع الاتصال بالجهاز.

هذا قطع اتصال صريح.

يجب استدعاء إحدى طرق قطع الاتصال في مرحلة ما بعد استدعاء connect وقبل تحرير هذا الكائن بواسطة مالكه.

- (void) disconnectWithLeave: (BOOL) leaveApplication

قطع الاتصال بالجهاز.

يجب استدعاء إحدى طرق قطع الاتصال في مرحلة ما بعد استدعاء connect وقبل تحرير هذا الكائن بواسطة مالكه.

Parameters

leaveApplication YES if this is an explicit disconnect that should disconnect from ("leave") the receiver application before closing the connection; NO if this is an implicit disconnect that should just close the connection.

- (BOOL) addChannel: (GCKCastChannel *) channel

لإضافة قناة يمكنها إرسال رسائل وتلقّيها لهذا الجهاز على مساحة اسم معيّنة

Parameters

channel The channel.

المرتجعات: YES إذا تمت إضافة القناة، NO إذا لم تتم إضافتها بسبب وجود قناة مرفقة بمساحة الاسم هذه من قبل.

- (BOOL) removeChannel: (GCKCastChannel *) channel

لإزالة قناة سبقت إضافتها.

Parameters

channel The channel.

المرتجعات: YES إذا تمت إزالة القناة، NO إذا لم تتم إزالتها بسبب عدم إرفاق القناة المحدّدة سابقًا.

- (NSInteger) launchApplication: (NSString *) applicationID

لتشغيل تطبيق.

Parameters

applicationID The application ID.

المرتجعات: معرّف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الطلب.

- (NSInteger) launchApplication:	(NSString *)	applicationID
withLaunchOptions:	(GCKLaunchOptions *__nullable)	launchOptions

لتشغيل تطبيق باستخدام خيارات التشغيل المحددة.

Parameters

applicationID	The application ID.
launchOptions	The launch options for this request. If `nil`, defaults will be used.

المرتجعات: معرّف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الطلب.

- (NSInteger) launchApplication:	(NSString *)	applicationID
relaunchIfRunning:	(BOOL)	relaunchIfRunning

لتشغيل تطبيق ما، وإعادة تشغيله اختياريًا إذا كان قيد التشغيل فعلاً.

Deprecated:: يمكنك استخدام launchApplication:withLaunchOptions: بدلاً من ذلك.

Parameters

applicationID	The application ID.
relaunchIfRunning	If `YES`, relaunches the application if it is already running instead of joining the running application.

المرتجعات: معرّف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الطلب.

- (NSInteger) joinApplication: (NSString *__nullable) applicationID

الانضمام إلى تطبيق.

Parameters

applicationID The application ID. If nil, attempts to join whichever application is currently running; otherwise, attempts to join the specified application.

المرتجعات: معرّف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الطلب.

- (NSInteger) joinApplication:	(NSString *)	applicationID
sessionID:	(NSString *)	sessionID

الانضمام إلى تطبيق برقم تعريف جلسة تطبيق معين.

وسيتعذّر تنفيذ الطلب إذا لم يعد معرّف الجلسة المحدّد مفعّلاً على جهاز الاستقبال.

Parameters

applicationID	The application ID.
sessionID	The application session ID.

المرتجعات: معرّف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الطلب.

- (BOOL) leaveApplication

مغادرة التطبيق الحالي.

المرتجعات: NO إذا تعذر إرسال الرسالة.

- (NSInteger) stopApplication

لإيقاف أي تطبيق(تطبيقات) قيد التشغيل.

المرتجعات: معرّف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الطلب.

- (NSInteger) stopApplicationWithSessionID: (NSString *__nullable) sessionID

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

وسيتعذّر تنفيذ الطلب إذا لم يعد معرّف الجلسة المحدّد مفعّلاً على جهاز الاستقبال.

Parameters

sessionID The application session ID, which may not be nil.

المرتجعات: معرّف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الطلب.

- (NSInteger) setVolume: (float) volume

لتعيين مستوى صوت النظام.

Parameters

volume The new volume, in the range [0.0, 1.0]. Out of range values will be silently clipped.

المرتجعات: معرّف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الطلب.

- (NSInteger) setMuted: (BOOL) muted

لتشغيل التجاهل أو إيقافه.

Parameters

muted Whether audio should be muted or unmuted.

المرتجعات: معرّف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الطلب.

- (NSInteger) requestDeviceStatus

لطلب الحالة الحالية للجهاز.

سيؤدي هذا إلى استدعاء جميع طلبات استدعاء تحديث حالة التفويض بعد تلقي معلومات الحالة المحدثة.

المرتجعات: معرّف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الطلب.

تفاصيل العقار

- (BOOL) ignoreAppStateNotifications

readnonatomicassign

ما إذا كان هذا الكائن سيستمع إلى إشعارات حالة التطبيق.

يمكن تحديد هذه العلامة في المُنشئ. القيمة التلقائية هي NO.

- (GCKConnectionState) connectionState

readnonatomicassign

حالة الاتصال الحالية لمدير الجهاز

- (GCKConnectionState) applicationConnectionState

readnonatomicassign

حالة اتصال التطبيق الحالي لمدير الجهاز.

- (BOOL) isConnected

readnonatomicassign

صحيح إذا أنشأ مدير الجهاز اتصالاً بالجهاز.

Deprecated:: استخدم connectionState.

- (BOOL) isConnectedToApp

readnonatomicassign

صحيح إذا أنشأ مدير الجهاز اتصالاً بأحد التطبيقات على الجهاز.

Deprecated:: استخدم applicationConnectionState.

- (BOOL) isReconnecting

readnonatomicassign

صحيح إذا كان مدير الجهاز غير متصل بسبب حدث يُحتمل أن يكون عابرًا (على سبيل المثال، إذا كان التطبيق في الخلفية، أو كان هناك خطأ في الشبكة يمكن حله عن طريق إعادة الاتصال).

لاحظ أنه لن يتم استدعاء عمليات معاودة الاتصال/قطع الاتصال أثناء محاولة مدير الجهاز إعادة الاتصال بعد حدث يُحتمل أن يكون مؤقتًا، ولكن ستعكس الخصائص دائمًا الحالة الحالية الفعلية ويمكن ملاحظتها.

- (NSTimeInterval) reconnectTimeout

readwritenonatomicassign

وستتم محاولة إعادة الاتصال لفترة طويلة في حالة انقطاع المقبس مع حدوث خطأ مؤقت.

المهلة الافتراضية هي 15 ثانية.

- (GCKDevice*) device

readnonatomicassign

الجهاز الذي يتم التحكم فيه من خلال GCKDeviceManager.

- (id<GCKDeviceManagerDelegate>) delegate

readwritenonatomicweak

مفوّض لتلقي إشعارات من GCKDeviceManager.

- (float) deviceVolume

readnonatomicassign

الحجم الحالي للجهاز في النطاق [0.0، 1.0]، في حال كان معروفًا؛ وبخلاف ذلك 0.

- (BOOL) deviceMuted

readnonatomicassign

حالة كتم الصوت الحالية للجهاز، في حال كانت معروفة، وبخلاف ذلك NO.

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

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

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

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

- (NSString*) applicationSessionID

readnonatomiccopy

معرِّف جلسة التطبيق لتطبيق المُستلِم المرتبط حاليًا، إن وُجد؛ وإلا nil.

يتم إنشاء معرّف جلسة جديد وفريد في كل مرة يتم فيها تشغيل تطبيق جهاز الاستقبال (بما في ذلك عند إعادة تشغيل التطبيق نفسه) ويبقى ساريًا طالما استمر تطبيق المُستلِم في العمل.

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

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

- (NSString*) applicationStatusText

readnonatomiccopy

أحدث نص حالة تم الإبلاغ عنه من تطبيق المستلِم قيد التشغيل حاليًا، إن وجد، وإلا nil.

فئة GCKDeviceManager

نظرة عامة

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

ملخص الموقع

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

تفاصيل العقار