نظرة عامة

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

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

يُرجى الاطِّلاع على 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

أحدث حالة معروفة لمشغّل الوسائط.

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

- (NSTimeInterval) lastKnownStreamPosition

readnonatomicassign

أحدث موضع معروف لساحة مشاركات الوسائط.

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

- (UIButton*) playButton

readwritenonatomicweak

الزر "تشغيل".

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

- (UIButton*) pauseButton

readwritenonatomicweak

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

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

- (GCKUIButton*) playPauseToggleButton

readwritenonatomicweak

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

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

- (GCKUIPlayPauseToggleController*) playPauseToggleController

readwritenonatomicstrong

وحدة تحكم التبديل "تشغيل/إيقاف مؤقت".

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

سينسي: 3.4

- (UIButton*) stopButton

readwritenonatomicweak

زر "إيقاف".

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

- (GCKUIButton*) forward30SecondsButton

readwritenonatomicweak

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

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

- (GCKUIButton*) rewind30SecondsButton

readwritenonatomicweak

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

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

- (UIButton*) pauseQueueButton

readwritenonatomicweak

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

- (UIButton*) nextButton

readwritenonatomicweak

زر "التالي".

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

- (UIButton*) previousButton

readwritenonatomicweak

الزر "السابق".

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

- (GCKUIButton*) repeatModeButton

readwritenonatomicweak

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

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

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

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

- (UISlider*) streamPositionSlider

readwritenonatomicweak

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

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

- (UIProgressView*) streamProgressView

readwritenonatomicweak

طريقة عرض تعرض تقدم البث الحالي.

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

- (UILabel*) streamPositionLabel

readwritenonatomicweak

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

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

- (UILabel*) streamDurationLabel

readwritenonatomicweak

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

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

- (UILabel*) streamTimeRemainingLabel

readwritenonatomicweak

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

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

- (GCKUIStreamPositionController*) streamPositionController

readwritenonatomicstrong

وحدة تحكُّم بالبث

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

سينسي: 3.4

- (BOOL) displayTimeRemainingAsNegativeValue

readwritenonatomicassign

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

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

- (UIButton*) tracksButton

readwritenonatomicweak

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

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

- (UILabel*) smartSubtitleLabel

readwritenonatomicweak

علامة لعرض ترجمة مصاحبة للوسائط التي تم تحميلها حاليًا.

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

- (UIActivityIndicatorView*) mediaLoadingIndicator

readwritenonatomicweak

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

فئة GCKUIMediaController

نظرة عامة

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

ملخص الموقع

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

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