نظرة عامة

عنصر تحكّم في طرق عرض واجهة المستخدم المستخدَمة للتحكّم في حالة تشغيل الوسائط على جهاز استقبال Cast أو عرضها.

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

يمكنك الاطّلاع على GCKUIMediaControllerDelegate لمعرفة بروتوكول التفويض.

منذ: 3.0

تتضمّن NSObject.

ملخّص طرق المثيل
(instancetype)	- init
	تهيئة مثيل المزيد...

(void)	- bindLabel:toMetadataKey:
	يربط هذا العنصر UILabel بمفتاح بيانات وصفية. المزيد...

(void)	- bindLabel:toMetadataKey:withFormatter:
	يربط هذا العنصر UILabel بمفتاح بيانات وصفية. المزيد...

(void)	- bindTextView:toMetadataKey:
	يربط عنصر UITextView بمفتاح بيانات وصفية. المزيد...

(void)	- bindTextView:toMetadataKey:withFormatter:
	يربط عنصر UITextView بمفتاح بيانات وصفية. المزيد...

(void)	- bindImageView:toImageHints:
	يربط UIImageView بمثيل GCKUIImageHints. المزيد...

(void)	- unbindView:
	يزيل ربط العرض المحدّد. المزيد...

(void)	- unbindAllViews
	تؤدي هذه الطريقة إلى إلغاء ربط جميع طرق العرض المرتبطة. المزيد...

(GCKMediaRepeatMode)	- cycleRepeatMode
	تغيير وضع التكرار لقائمة الانتظار إلى الوضع التالي في الدورة: المزيد...

(void)	- selectTracks
	طريقة سهلة لعرض واجهة المستخدم الخاصة باختيار مقطع الوسائط. المزيد...

ملخّص الموقع
id< GCKUIMediaControllerDelegate >	delegate
	المفوّض بتلقّي الإشعارات من GCKUIMediaController. المزيد...

GCKSession *	session
	الجلسة المرتبطة بوحدة التحكّم هذه المزيد...

BOOL	mediaLoaded
	تُستخدَم لتحديد ما إذا كانت هناك وسائط محملة (أو قيد التحميل) حاليًا على جهاز الاستقبال. المزيد...

BOOL	hasCurrentQueueItem
	تُستخدَم لتحديد ما إذا كان هناك عنصر حالي في قائمة الانتظار. المزيد...

BOOL	hasLoadingQueueItem
	تُستخدَم لتحديد ما إذا كان هناك عنصر يتم تحميله مسبقًا في قائمة الانتظار. المزيد...

GCKMediaPlayerState	lastKnownPlayerState
	تعرض هذه السمة آخر حالة معروفة لمشغّل الوسائط. المزيد...

NSTimeInterval	lastKnownStreamPosition
	تمثّل هذه السمة آخر موضع معروف لتدفّق الوسائط. المزيد...

UIButton *	playButton
	زر "تشغيل" المزيد...

UIButton *	pauseButton
	زر "إيقاف مؤقت" المزيد...

GCKUIButton *	playPauseToggleButton
	زر تبديل "تشغيل/إيقاف مؤقت" المزيد...

GCKUIPlayPauseToggleController *	playPauseToggleController
	عنصر تحكّم للتبديل بين التشغيل والإيقاف المؤقت المزيد...

UIButton *	stopButton
	زر "إيقاف" المزيد...

GCKUIButton *	forward30SecondsButton
	زر لتقديم الوسائط التي يتم تشغيلها حاليًا بمقدار 30 ثانية المزيد...

GCKUIButton *	rewind30SecondsButton
	زر للرجوع بمقدار 30 ثانية في عنصر الوسائط الذي يتم تشغيله حاليًا المزيد...

UIButton *	pauseQueueButton
	زر لإيقاف تشغيل قائمة الانتظار مؤقتًا بعد انتهاء تشغيل العنصر الحالي المزيد...

UIButton *	nextButton
	زر "التالي" المزيد...

UIButton *	previousButton
	زر "السابق" المزيد...

GCKUIButton *	repeatModeButton
	زر للتنقل بين أوضاع تكرار قائمة الانتظار المتاحة المزيد...

UISlider *	streamPositionSlider
	شريط تمرير لعرض موضع البث الحالي وتغييره المزيد...

UIProgressView *	streamProgressView
	طريقة عرض لعرض مستوى تقدّم البث الحالي المزيد...

UILabel *	streamPositionLabel
	تصنيف لعرض موضع البث الحالي بالدقائق والثواني المزيد...

UILabel *	streamDurationLabel
	تصنيف لعرض مدة البث المباشر الحالية بالدقائق والثواني المزيد...

UILabel *	streamTimeRemainingLabel
	تصنيف لعرض الوقت المتبقي من البث (المدة ناقص الموضع)، بالدقائق والثواني المزيد...

GCKUIStreamPositionController *	streamPositionController
	أداة تحكّم في موضع البث المزيد...

BOOL	displayTimeRemainingAsNegativeValue
	تحديد ما إذا كان سيتم عرض وقت البث المتبقي كقيمة سالبة، مثلاً "1:23:45-" المزيد...

UIButton *	tracksButton
	زر لاختيار المقاطع الصوتية و/أو الترجمة والشرح المزيد...

UILabel *	smartSubtitleLabel
	تصنيف لعرض ترجمة وشرح للوسائط المحمَّلة حاليًا المزيد...

UIActivityIndicatorView *	mediaLoadingIndicator
	طريقة عرض مؤشر النشاط للإشارة إلى أنّ الوسائط في حالة تحميل المزيد...

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

- (instancetype) init

تهيئة مثيل

- (void) bindLabel:	(UILabel *)	label
toMetadataKey:	(NSString *)	key

يربط هذا العنصر UILabel بمفتاح بيانات وصفية.

سيعرض العرض القيمة الحالية لحقل البيانات الوصفية المقابل.

اطّلِع على GCKMediaMetadata للحصول على قائمة بمفاتيح البيانات الوصفية المحدّدة مسبقًا.

Parameters

label	The UILabel that will display the value.
key	The metadata key.

- (void) bindLabel:	(UILabel *)	label
toMetadataKey:	(NSString *)	key
withFormatter:	(GCKUIValueFormatter)	formatter

يربط هذا العنصر UILabel بمفتاح بيانات وصفية.

سيعرض العرض القيمة الحالية لحقل البيانات الوصفية المقابل.

اطّلِع على GCKMediaMetadata للحصول على قائمة بمفاتيح البيانات الوصفية المحدّدة مسبقًا.

Parameters

label	The UILabel that will display the value.
key	The metadata key.
formatter	A block that will produce the desired string representation of the value.

- (void) bindTextView:	(UITextView *)	textView
toMetadataKey:	(NSString *)	key

يربط عنصر UITextView بمفتاح بيانات وصفية.

سيعرض العرض القيمة الحالية لحقل البيانات الوصفية المقابل.

اطّلِع على GCKMediaMetadata للحصول على قائمة بمفاتيح البيانات الوصفية المحدّدة مسبقًا.

Parameters

textView	The UITextView that will display the value.
key	The metadata key.

- (void) bindTextView:	(UITextView *)	textView
toMetadataKey:	(NSString *)	key
withFormatter:	(GCKUIValueFormatter)	formatter

يربط عنصر UITextView بمفتاح بيانات وصفية.

سيعرض العرض القيمة الحالية لحقل البيانات الوصفية المقابل.

اطّلِع على GCKMediaMetadata للحصول على قائمة بمفاتيح البيانات الوصفية المحدّدة مسبقًا.

Parameters

textView	The UITextView that will display the value.
key	The metadata key.
formatter	A block that will produce the desired string representation of the value.

- (void) bindImageView:	(UIImageView *)	imageView
toImageHints:	(GCKUIImageHints *)	imageHints

يربط UIImageView بمثيل GCKUIImageHints.

سيتم استخدام UIImagePicker المثبَّت حاليًا لاختيار صورة من البيانات الوصفية للعرض.

Parameters

imageView	The UIImageView that will display the selected image.
imageHints	The image hints.

- (void) unbindView: (UIView *) view

يزيل ربط العرض المحدّد.

Parameters

view	The view to unbind.

- (void) unbindAllViews

تؤدي هذه الطريقة إلى إلغاء ربط جميع طرق العرض المرتبطة.

- (GCKMediaRepeatMode) cycleRepeatMode

يغيّر وضع التكرار لقائمة الانتظار إلى الوضع التالي في الدورة:

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

المرتجعات: وضع التكرار الجديد

- (void) selectTracks

طريقة سهلة لعرض واجهة المستخدم الخاصة باختيار مقطع الوسائط.

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

- (id<GCKUIMediaControllerDelegate>) delegate

readwritenonatomicweak

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

- (GCKSession*) session

readnonatomicstrong

الجلسة المرتبطة بوحدة التحكّم هذه

- (BOOL) mediaLoaded

readnonatomicassign

تُستخدَم لتحديد ما إذا كانت هناك وسائط محملة (أو قيد التحميل) حاليًا على جهاز الاستقبال.

إذا لم تكن هناك جلسة بث محتوى نشطة، ستكون القيمة NO.

- (BOOL) hasCurrentQueueItem

readnonatomicassign

تُستخدَم لتحديد ما إذا كان هناك عنصر حالي في قائمة الانتظار.

- (BOOL) hasLoadingQueueItem

readnonatomicassign

تُستخدَم لتحديد ما إذا كان هناك عنصر يتم تحميله مسبقًا في قائمة الانتظار.

- (GCKMediaPlayerState) lastKnownPlayerState

readnonatomicassign

تعرض هذه السمة آخر حالة معروفة لمشغّل الوسائط.

إذا لم تكن هناك جلسة Cast نشطة، ستكون هذه هي حالة المشغّل قبل انتهاء الجلسة الأخيرة مباشرةً. إذا لم تكن هناك جلسة سابقة، ستكون القيمة GCKMediaPlayerStateUnknown.

- (NSTimeInterval) lastKnownStreamPosition

readnonatomicassign

تمثّل هذه السمة آخر موضع معروف لتدفّق الوسائط.

إذا لم تكن هناك جلسة Cast نشطة، سيكون هذا هو موضع البث للوسائط قبل انتهاء الجلسة الأخيرة مباشرةً. إذا لم تكن هناك جلسة سابقة، ستكون القيمة kGCKInvalidTimeInterval.

- (UIButton*) playButton

readwritenonatomicweak

زر "تشغيل"

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

- (UIButton*) pauseButton

readwritenonatomicweak

زر "إيقاف مؤقت"

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

- (GCKUIButton*) playPauseToggleButton

readwritenonatomicweak

زر تبديل "تشغيل/إيقاف مؤقت"

على المتصل ضبط الرموز المناسبة لحالتَي الزر GCKUIControlStatePlay وGCKUIControlStatePause، أي رمز "إيقاف مؤقت" لحالة التشغيل ورمز "تشغيل" لحالة الإيقاف المؤقت. يتم تعديل حالة الزر تلقائيًا لتعكس حالة التشغيل الحالية على الجهاز المستقبِل. عند النقر على الزر، يتم إيقاف تشغيل الوسائط المحمَّلة حاليًا مؤقتًا أو استئنافه على جهاز الاستقبال. سيتم إيقاف الزر إذا كانت الوسائط التي تم تحميلها حاليًا لا تتيح الإيقاف المؤقت، أو إذا لم يكن التشغيل قيد التقدّم أو الإيقاف المؤقت حاليًا، أو إذا لم يتم تحميل أي وسائط حاليًا، أو إذا لم تكن هناك جلسة Cast نشطة حاليًا.

- (GCKUIPlayPauseToggleController*) playPauseToggleController

readwritenonatomicstrong

عنصر تحكّم للتبديل بين التشغيل والإيقاف المؤقت

يُستخدَم كبديل لواجهة مستخدم مخصّصة لتفعيل زر التشغيل/الإيقاف المؤقت يوفّرها التطبيق. ولمزيد من التفاصيل، يمكنك الاطّلاع على GCKUIPlayPauseToggleController.

منذ: 3.4

- (UIButton*) stopButton

readwritenonatomicweak

زر "إيقاف"

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

- (GCKUIButton*) forward30SecondsButton

readwritenonatomicweak

زر لتقديم الوسائط التي يتم تشغيلها حاليًا بمقدار 30 ثانية

سيتم إيقاف الزر إذا لم يتم تحميل أي وسائط حاليًا، أو إذا لم تكن هناك جلسة Cast نشطة حاليًا.

- (GCKUIButton*) rewind30SecondsButton

readwritenonatomicweak

زر للرجوع بمقدار 30 ثانية في عنصر الوسائط الذي يتم تشغيله حاليًا

سيتم إيقاف الزر إذا لم يتم تحميل أي وسائط حاليًا، أو إذا لم تكن هناك جلسة Cast نشطة حاليًا.

- (UIButton*) pauseQueueButton

readwritenonatomicweak

زر لإيقاف تشغيل قائمة الانتظار مؤقتًا بعد انتهاء تشغيل العنصر الحالي

- (UIButton*) nextButton

readwritenonatomicweak

زر "التالي"

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

- (UIButton*) previousButton

readwritenonatomicweak

زر "السابق"

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

- (GCKUIButton*) repeatModeButton

readwritenonatomicweak

زر للتنقل بين أوضاع تكرار قائمة الانتظار المتاحة

(راجِع GCKMediaRepeatMode.) على المتصل ضبط الرموز المناسبة لحالات الزر UIControlStateNormal (إيقاف التكرار) وGCKUIControlStateRepeatSingle وGCKUIControlStateRepeatAll وGCKUIControlStateShuffle. يتم تعديل حالة الزر تلقائيًا لتعكس وضع تكرار قائمة الانتظار الحالي على الجهاز المستقبِل. يؤدي النقر على الزر إلى الانتقال إلى وضع التكرار التالي، بالترتيب التالي:

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

سيتم إيقاف الزر إذا لم تكن هناك جلسة بث محتوى نشطة حاليًا.

- (UISlider*) streamPositionSlider

readwritenonatomicweak

شريط تمرير لعرض موضع البث الحالي وتغييره

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

- (UIProgressView*) streamProgressView

readwritenonatomicweak

طريقة عرض لعرض مستوى تقدّم البث الحالي

أثناء تشغيل الوسائط على جهاز الاستقبال، يتم تعديل قيمة المشاهدات في الوقت الفعلي لتعكس موضع البث الحالي. سيتم إيقاف العرض إذا كانت الوسائط المحمَّلة حاليًا عبارة عن بث مباشر، أو إذا لم يتم تحميل أي وسائط حاليًا، أو إذا لم تكن هناك جلسة Cast نشطة حاليًا.

- (UILabel*) streamPositionLabel

readwritenonatomicweak

تصنيف لعرض موضع البث الحالي بالدقائق والثواني

إذا لم يتم تحميل أي وسائط حاليًا، أو إذا لم تكن هناك جلسة Cast نشطة حاليًا، يعرض التصنيف نموذجًا مترجمًا من "--:--".

- (UILabel*) streamDurationLabel

readwritenonatomicweak

تصنيف لعرض مدة البث المباشر الحالية بالدقائق والثواني

إذا لم يكن للوسائط المحمَّلة حاليًا مدة (على سبيل المثال، إذا كانت بثًا مباشرًا)، أو إذا لم يتم تحميل أي وسائط حاليًا، أو إذا لم تكن هناك جلسة Cast نشطة حاليًا، يعرض التصنيف نموذجًا مترجمًا من "--:--".

- (UILabel*) streamTimeRemainingLabel

readwritenonatomicweak

تصنيف لعرض الوقت المتبقي من البث (المدة ناقص الموضع)، بالدقائق والثواني

إذا لم يكن للوسائط المحمَّلة حاليًا مدة (على سبيل المثال، إذا كانت بثًا مباشرًا)، أو إذا لم يتم تحميل أي وسائط حاليًا، أو إذا لم تكن هناك جلسة Cast نشطة حاليًا، يعرض التصنيف نموذجًا مترجمًا من "--:--".

- (GCKUIStreamPositionController*) streamPositionController

readwritenonatomicstrong

أداة تحكّم في موضع البث

يُستخدَم كبديل لموضع بث مخصّص و/أو واجهة مستخدم للبحث تقدّمهما التطبيقات. ولمزيد من التفاصيل، يمكنك الاطّلاع على GCKUIStreamPositionController.

منذ: 3.4

- (BOOL) displayTimeRemainingAsNegativeValue

readwritenonatomicassign

تحديد ما إذا كان سيتم عرض وقت البث المتبقي كقيمة سالبة، مثلاً "1:23:45-"

يتم ضبط هذه السمة تلقائيًا على YES.

- (UIButton*) tracksButton

readwritenonatomicweak

زر لاختيار المقاطع الصوتية و/أو الترجمة والشرح

عند النقر على الزر، ستظهر واجهة مستخدم اختيار مسارات الوسائط للمستخدم. سيتم إيقاف الزر إذا لم تتضمّن الوسائط المحمَّلة حاليًا أي مقاطع وسائط قابلة للتحديد، أو إذا لم يتم تحميل أي وسائط حاليًا، أو إذا لم تكن هناك جلسة Cast نشطة حاليًا.

- (UILabel*) smartSubtitleLabel

readwritenonatomicweak

تصنيف لعرض ترجمة وشرح للوسائط المحمَّلة حاليًا

إذا لم يتم ضبط حقل الترجمة والشرح بشكل صريح في البيانات الوصفية، ستعرض التصنيفات حقل البيانات الوصفية الأنسب استنادًا إلى نوع الوسائط، مثل اسم الاستوديو لفيلم أو اسم الفنان لمقطع موسيقي.

- (UIActivityIndicatorView*) mediaLoadingIndicator

readwritenonatomicweak

طريقة عرض مؤشر النشاط للإشارة إلى أنّ الوسائط في حالة تحميل

فئة وحدة التحكم في GCKUIMedia تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

نظرة عامة

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

ملخّص الموقع

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

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

فئة وحدة التحكم في GCKUIMedia