نظرة عامة

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

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

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

Deprecated:: استخدِم GCKSessionManager وGCKCastSession للتفاعل مع أجهزة استقبال Cast.

تتضمّن 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 تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

نظرة عامة

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

ملخّص الموقع

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

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

فئة GCKDeviceManager