فئة GCKCastContext

نظرة عامة

يشير ذلك المصطلح إلى فئة تحتوي على كائنات عمومية وحالة إطار العمل.

يجب إعداد السياق في وقت مبكر من دورة حياة التطبيق من خلال طلب الرمز setSharedInstanceWithOptions: (GCKCastContext).

منذ
3.0

تكتسب NSObject.

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

(void) - registerDeviceProvider:
 تعمل هذه السياسة على تسجيل موفِّر الأجهزة، ما يوفّر توافقًا لنوع جديد من الأجهزة (غير المزوّدة بتكنولوجيا Google Cast). المزيد...
 
(void) - unregisterDeviceProviderForCategory:
 يؤدي هذا الخيار إلى إلغاء تسجيل موفّر الجهاز لفئة جهاز معيّنة. المزيد...
 
(void) - setLaunchCredentialsData:
 تحدِّد هذه السياسة بيانات الاعتماد للمستخدم الحالي. المزيد...
 
(void) - presentCastDialog
 يتم عرض مربع حوار البث. المزيد...
 
(GCKUICastContainerViewController *) - createCastContainerControllerForViewController:
 تنشئ هذه الدالة GCKUICastContainerViewController تضمّن وحدة التحكّم في طريقة العرض المحدّدة. المزيد...
 
(GCKUIMiniMediaControlsViewController *) - createMiniMediaControlsViewController
 إنشاء GCKUIMiniMediaControlsViewController المزيد...
 
(BOOL) - presentCastInstructionsViewControllerOnce
 تقدِّم وحدة تحكُّم في العرض بملء الشاشة تلفت الانتباه إلى زر البث وتعرض بعض النصوص الإرشادية الموجزة حول استخدامه، إذا لم يسبق أن تم عرضها. المزيد...
 
(BOOL) - presentCastInstructionsViewControllerOnceWithCastButton:
 إذا لم يكن هذا الزر ظاهرًا من قبل، يقدِّم وحدة تحكُّم في العرض بملء الشاشة تلفت الانتباه إلى زر البثّ الذي يتم تمرير العرض، وتعرض بعض النصوص الإرشادية الموجزة حول استخدامه. المزيد...
 
(void) - clearCastInstructionsShownFlag
 يؤدي هذا الخيار إلى محو العلامة الدائمة التي تتتبّع ما إذا كان قد تم عرض وحدة التحكّم في العرض المشروط لتعليمات البث. المزيد...
 
(void) - presentDefaultExpandedMediaControls
 يتم عرض عناصر التحكّم التلقائية في الوسائط الموسّعة للبث. المزيد...
 

ملخّص طريقة الفئة

(void) + setSharedInstanceWithOptions:
 لضبط المثيل المشترك، وتقديم كائن خيارات البث. المزيد...
 
(BOOL) + setSharedInstanceWithOptions:error:
 لضبط المثيل المشترك، وتقديم كائن خيارات البث. المزيد...
 
(instancetype) + sharedInstance
 لعرض مثيل سينغلتون. المزيد...
 
(BOOL) + isSharedInstanceInitialized
 لاختبار ما إذا تم إعداد مثيل سينغلتون حتى الآن. المزيد...
 

السمات العامة

NSString *const kGCKNotificationKeyCastState
 المفتاح userInfo لحالة البث الجديدة في إشعار تغيير حالة البث. المزيد...
 
NSString *const kGCKCastStateDidChangeNotification
 اسم الإشعار الذي سيتم نشره عند تغيير حالة البث المزيد...
 
NSString *const kGCKExpandedMediaControlsTriggeredNotification
 اسم الإشعار الذي سيتم نشره عند عرض عناصر التحكّم في الوسائط الموسّعة للمستخدمين. المزيد...
 
NSString *const kGCKUICastDialogWillShowNotification
 اسم الإشعار الذي سيتم نشره عندما يكون مربع حوار البث على وشك الظهور. المزيد...
 
NSString *const kGCKUICastDialogDidHideNotification
 اسم الإشعار الذي سيتم نشره عند إغلاق مربّع حوار البث المزيد...
 

ملخّص الموقع

GCKCastState castState
 حالة البث الحالية للتطبيق المزيد...
 
GCKDiscoveryManagerdiscoveryManager
 مدير عمليات الاكتشاف المزيد...
 
GCKSessionManagersessionManager
 مدير الجلسة المزيد...
 
id< GCKUIImageCacheimageCache
 يشير هذا المصطلح إلى تنفيذ ذاكرة التخزين المؤقت للصور الذي سيستخدمه إطار العمل لاسترجاع الصور المُشار إليها في البيانات الوصفية للوسائط. المزيد...
 
id< GCKUIImagePickerimagePicker
 أداة اختيار الصور التي سيتم استخدامها لاختيار صورة لغرض معيّن المزيد...
 
BOOL useDefaultExpandedMediaControls
 تحدِّد هذه السياسة سلوك إطار العمل عندما يكون هناك إجراء للمستخدِم يجب أن يؤدي إلى عرض عناصر التحكّم الموسّعة. المزيد...
 
GCKUIExpandedMediaControlsViewControllerdefaultExpandedMediaControlsViewController
 مثيل وحدة التحكّم التلقائية في عرض عناصر التحكّم في الوسائط الموسّعة الخاصة بالبث المزيد...
 

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

+ (void) setSharedInstanceWithOptions: (GCKCastOptions *)  options

لضبط المثيل المشترك، وتقديم كائن خيارات البث.

إذا سبق إعداد المثيل المشترك، سيتم طرح استثناء.

Parameters
optionsThe Cast options.
+ (BOOL) setSharedInstanceWithOptions: (GCKCastOptions *)  options
error: (GCKError *_Nullable *_Nullable)  error 

لضبط المثيل المشترك، وتقديم كائن خيارات البث.

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

Parameters
optionsThe Cast options.
errorA pointer at which to store the error in case of a failure.
المرتجعات
YES عند نجاح الإجراء، وNO عند تعذُّر التثبيت.
منذ
4.0
+ (instancetype) sharedInstance

لعرض مثيل سينغلتون.

إذا لم يتم إعداد مثيل مشترك بعد، فسيتم طرح استثناء.

+ (BOOL) isSharedInstanceInitialized

لاختبار ما إذا تم إعداد مثيل سينغلتون حتى الآن.

منذ
3.5.4
- (void) registerDeviceProvider: (GCKDeviceProvider *)  deviceProvider

تعمل هذه السياسة على تسجيل موفِّر الأجهزة، ما يوفّر توافقًا لنوع جديد من الأجهزة (غير المزوّدة بتكنولوجيا Google Cast).

Parameters
deviceProviderAn instance of a GCKDeviceProvider subclass for managing the devices.
- (void) unregisterDeviceProviderForCategory: (NSString *)  category

يؤدي هذا الخيار إلى إلغاء تسجيل موفّر الجهاز لفئة جهاز معيّنة.

Parameters
categoryA string that uniquely identifies the type of device.
- (void) setLaunchCredentialsData: (GCKCredentialsData *_Nullable)  credentialsData

تحدِّد هذه السياسة بيانات الاعتماد للمستخدم الحالي.

عليك طلب البيانات من واجهة برمجة التطبيقات هذه مع تضمين معلومات المستخدم الحالية قبل بدء جلسة البث ومتى يتم تغيير حساب المستخدم.

سيتم تضمين بيانات الاعتماد في طلب التشغيل. إذا كان سيتم تشغيل تطبيق Android TV، يمكن للتطبيق استخدام بيانات الاعتماد لتحديد ما إذا كان التطبيق يدعم هذا المستخدم المحدد أم لا. إذا لم يكن مثبتًا، سيتم تشغيل تطبيق البث بدلاً من ذلك.

إذا تم تشغيل تطبيق Android TV، سيتم تمرير بيانات الاعتماد إلى التطبيق ضمن الغرض من الإطلاق. يمكن للتطبيق استخدام هذه البيانات لتخصيص تجربة المستخدم.

Parameters
credentialsDataAn instance of GCKCredentialsData. May be nil.
- (void) presentCastDialog

يتم عرض مربع حوار البث.

متوفرة حسب الفئة "GCKCastContext(UI)"

- (GCKUICastContainerViewController *) createCastContainerControllerForViewController: (UIViewController *)  viewController

تنشئ هذه الدالة GCKUICastContainerViewController تضمّن وحدة التحكّم في طريقة العرض المحدّدة.

متوفرة حسب الفئة "GCKCastContext(UI)"

- (GCKUIMiniMediaControlsViewController *) createMiniMediaControlsViewController

إنشاء GCKUIMiniMediaControlsViewController

متوفرة حسب الفئة "GCKCastContext(UI)"

- (BOOL) presentCastInstructionsViewControllerOnce

تقدِّم وحدة تحكُّم في العرض بملء الشاشة تلفت الانتباه إلى زر البث وتعرض بعض النصوص الإرشادية الموجزة حول استخدامه، إذا لم يسبق أن تم عرضها.

المرتجعات
YES إذا تم عرض وحدة التحكّم في العرض، NO إذا لم يتم عرضها لأنّها سبق أن تم عرضها. وبدايةً من الإصدار 4.1، يتم عرض NO إذا لم يتم العثور على "زر البث".
Deprecated:
استخدام عنصرpresentCastinstructionsViewControllerWhenWithCastButton:

متوفرة حسب الفئة "GCKCastContext(UI)"

- (BOOL) presentCastInstructionsViewControllerOnceWithCastButton: (GCKUICastButton *)  castButton

إذا لم يكن هذا الزر ظاهرًا من قبل، يقدِّم وحدة تحكُّم في العرض بملء الشاشة تلفت الانتباه إلى زر البثّ الذي يتم تمرير العرض، وتعرض بعض النصوص الإرشادية الموجزة حول استخدامه.

المرتجعات
YES إذا تم عرض وحدة التحكّم في العرض، NO إذا لم يتم عرضها لأنّها سبق أن تم عرضها. ويتم أيضًا عرض NO إذا لم يتم العثور على "زر البث".
منذ
4.1

متوفرة حسب الفئة "GCKCastContext(UI)"

- (void) clearCastInstructionsShownFlag

يؤدي هذا الخيار إلى محو العلامة الدائمة التي تتتبّع ما إذا كان قد تم عرض وحدة التحكّم في العرض المشروط لتعليمات البث.

متوفرة حسب الفئة "GCKCastContext(UI)"

- (void) presentDefaultExpandedMediaControls

يتم عرض عناصر التحكّم التلقائية في الوسائط الموسّعة للبث.

متوفرة حسب الفئة "GCKCastContext(UI)"

وثائق بيانات الأعضاء

- (NSString* const) kGCKNotificationKeyCastState

المفتاح userInfo لحالة البث الجديدة في إشعار تغيير حالة البث.

- (NSString* const) kGCKCastStateDidChangeNotification

اسم الإشعار الذي سيتم نشره عند تغيير حالة البث

- (NSString* const) kGCKExpandedMediaControlsTriggeredNotification

اسم الإشعار الذي سيتم نشره عند عرض عناصر التحكّم في الوسائط الموسّعة للمستخدمين.

- (NSString* const) kGCKUICastDialogWillShowNotification

اسم الإشعار الذي سيتم نشره عندما يكون مربع حوار البث على وشك الظهور.

منذ
3.4
- (NSString* const) kGCKUICastDialogDidHideNotification

اسم الإشعار الذي سيتم نشره عند إغلاق مربّع حوار البث

منذ
3.4

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

- (GCKCastState) castState
readnonatomicassign

حالة البث الحالية للتطبيق

يمكن رصد التغييرات التي يتم إجراؤها على هذا الموقع من خلال KVO أو من خلال الاستماع إلى إشعارات kGCKCastStateDidChangeNotification.

- (GCKDiscoveryManager*) discoveryManager
readnonatomicstrong

مدير عمليات الاكتشاف

يعالج هذا الكائن عملية اكتشاف أجهزة الاستقبال.

- (GCKSessionManager*) sessionManager
readnonatomicstrong

مدير الجلسة

يدير هذا الكائن التفاعل مع أجهزة الاستقبال.

- (id<GCKUIImageCache>) imageCache
readwritenonatomicstrong

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

سيتم استخدام طريقة تنفيذ تلقائية في حال لم يوفّرها التطبيق. قد يتم الضبط على nil لاستعادة ذاكرة التخزين المؤقت التلقائية للصور.

متوفرة حسب الفئة "GCKCastContext(UI)"

- (id<GCKUIImagePicker>) imagePicker
readwritenonatomicstrong

أداة اختيار الصور التي سيتم استخدامها لاختيار صورة لغرض معيّن

سيتم استخدام طريقة تنفيذ تلقائية في حال لم يوفّرها التطبيق. قد يتم الضبط على nil لإعادة أداة اختيار الصور التلقائية.

متوفرة حسب الفئة "GCKCastContext(UI)"

- (BOOL) useDefaultExpandedMediaControls
readwritenonatomicassign

تحدِّد هذه السياسة سلوك إطار العمل عندما يكون هناك إجراء للمستخدِم يجب أن يؤدي إلى عرض عناصر التحكّم الموسّعة.

في حال YES، سيعرض إطار العمل طريقة العرض التلقائية لعناصر التحكّم الموسّعة. في حال NO، سيُشغِّل إطار العمل GCKCastContext::kGCKExpandedMediaControlsTriggeredNotification فقط.

متوفرة حسب الفئة "GCKCastContext(UI)"

- (GCKUIExpandedMediaControlsViewController*) defaultExpandedMediaControlsViewController
readnonatomicstrong

مثيل وحدة التحكّم التلقائية في عرض عناصر التحكّم في الوسائط الموسّعة الخاصة بالبث

متوفرة حسب الفئة "GCKCastContext(UI)"