نظرة عامة
هي وحدة تحكّم في طرق عرض واجهة المستخدم التي تُستخدَم للتحكم في حالة تشغيل الوسائط على جهاز استقبال البث أو عرضها.
يسجِّل تطبيق الاتصال عناصر التحكّم في واجهة المستخدم المتعلّقة بالوسائط مع وحدة التحكّم من خلال ضبط الخصائص المناسبة. تستجيب وحدة التحكّم بعد ذلك لأحداث اللمس على عناصر التحكّم من خلال إصدار أوامر الوسائط المناسبة إلى المُستلِم، وتُحدِّث عناصر التحكّم بناءً على معلومات الحالة والبيانات الوصفية للوسائط التي يتم استلامها من المُستلِم. تعمل وحدة التحكّم على تفعيل وإيقاف عناصر التحكّم في واجهة المستخدم تلقائيًا على النحو المناسب للجلسة الحالية وحالة مشغّل الوسائط. بالإضافة إلى ذلك، يتم إيقاف جميع عناصر التحكّم عندما يكون الطلب قيد التنفيذ.
يمكنك الاطّلاع على 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) | - bindControlView:toRewindForTime: |
لربط UIControl لإرجاع تشغيل العنصر الحالي من خلال القيمة التي تم تمريرها بالثواني. المزيد... | |
(void) | - bindControlView:toForwardForTime: |
لربط UIControl لإعادة تشغيل العنصر الحالي من خلال القيمة التي تم تمريرها كثوانٍ المزيد... | |
(void) | - unbindView: |
إلغاء ربط العرض المحدّد. المزيد... | |
(void) | - unbindAllViews |
إلغاء ربط جميع طرق العرض المرتبطة. المزيد... | |
(GCKMediaRepeatMode) | - cycleRepeatMode |
لتغيير وضع التكرار في قائمة الانتظار إلى الوضع التالي في الدورة: المزيد... | |
(void) | - selectTracks |
طريقة سهلة لعرض واجهة المستخدم الخاصة باختيار مسار الوسائط. المزيد... | |
(void) | - skipAd |
إرسال طلب تخطّي الإعلان ومراقبته. المزيد... | |
ملخّص الموقع | |
id< GCKUIMediaControllerDelegate > | delegate |
الجهة المفوَّضة بتلقّي الإشعارات من "GCKUIMediaController" المزيد... | |
GCKSession * | session |
الجلسة المرتبطة بوحدة التحكّم هذه. المزيد... | |
BOOL | mediaLoaded |
ما إذا كانت هناك وسائط يتم تحميلها (أو تحميلها) حاليًا على جهاز الاستقبال المزيد... | |
BOOL | hasCurrentQueueItem |
ما إذا كان هناك عنصر حالي في قائمة الانتظار المزيد... | |
BOOL | hasLoadingQueueItem |
ما إذا كان هناك عنصر يتم تحميله مسبقًا في قائمة الانتظار المزيد... | |
GCKMediaPlayerState | lastKnownPlayerState |
حالة مشغّل الوسائط المعروفة الأخيرة. المزيد... | |
NSTimeInterval | lastKnownStreamPosition |
آخر موضع بث وسائط معروف. المزيد... | |
UIButton * | playButton |
زر "تشغيل". المزيد... | |
UIButton * | pauseButton |
زر "إيقاف مؤقت". المزيد... | |
GCKUIMultistateButton * | playPauseToggleButton |
زر تبديل "تشغيل/إيقاف مؤقت". المزيد... | |
GCKUIPlayPauseToggleController * | playPauseToggleController |
وحدة تحكّم بالتبديل تؤدي إلى وضع "التشغيل/الإيقاف المؤقت" المزيد... | |
UIButton * | stopButton |
زر "إيقاف". المزيد... | |
UIButton * | forward30SecondsButton |
زر لتقديم الفيديو بمقدار 30 ثانية في ملف الوسائط الذي يتم تشغيله حاليًا المزيد... | |
UIButton * | rewind30SecondsButton |
زر للرجوع بمقدار 30 ثانية في ملف الوسائط الذي يتم تشغيله حاليًا المزيد... | |
UIButton * | pauseQueueButton |
زر لإيقاف تشغيل قائمة المحتوى التالي مؤقتًا بعد انتهاء تشغيل العنصر الحالي. المزيد... | |
UIButton * | nextButton |
زر "التالي". المزيد... | |
UIButton * | previousButton |
زر "السابق". المزيد... | |
GCKUIMultistateButton * | repeatModeButton |
زر لركوب الدراجات عبر أوضاع التكرار المتاحة في قائمة الانتظار. المزيد... | |
UISlider * | streamPositionSlider |
شريط تمرير لعرض موضع البث الحالي وتغييره المزيد... | |
UIProgressView * | streamProgressView |
طريقة عرض تعرض مستوى تقدُّم البث الحالي المزيد... | |
UILabel * | streamPositionLabel |
تصنيف لعرض موضع البث الحالي بالدقائق والثواني المزيد... | |
UILabel * | streamDurationLabel |
تصنيف لعرض مدة البث الحالية بالدقائق والثواني المزيد... | |
UILabel * | streamTimeRemainingLabel |
تصنيف لعرض الوقت المتبقّي للبث (المدة مطروحًا منه الموضع) بالدقائق والثواني المزيد... | |
GCKUIStreamPositionController * | streamPositionController |
وحدة التحكّم في موضع البث المزيد... | |
GCKUIPlaybackRateController * | playbackRateController |
وحدة تحكّم في معدّل تشغيل البث المزيد... | |
BOOL | displayTimeRemainingAsNegativeValue |
ما إذا كان سيتم عرض وقت البث المتبقّي كقيمة سالبة، على سبيل المثال " -1:23:45". المزيد... | |
BOOL | hideStreamPositionControlsForLiveContent |
يمكنك اختيار إخفاء عناصر التحكم في موضع البث المباشر (بما في ذلك شريط التمرير الخاص بموضع البث وتصنيف موضع البث وتصنيف مدة البث وعرض مستوى تقدّم البث) في المحتوى المباشر. المزيد... | |
UIButton * | tracksButton |
زر لاختيار المقاطع الصوتية و/أو الترجمة والشرح. المزيد... | |
UILabel * | smartSubtitleLabel |
تصنيف لعرض عنوان فرعي للوسائط المحملة حاليًا. المزيد... | |
UIActivityIndicatorView * | mediaLoadingIndicator |
عرض مؤشر النشاط للإشارة إلى أنّ الوسائط في حالة تحميل. المزيد... | |
UILabel * | skipAdLabel |
تصنيف لعرض مقدار الوقت المتبقّي حتى يمكن تخطّي الإعلان. المزيد... | |
UIButton * | skipAdButton |
زر لتخطّي الإعلان الحالي المزيد... | |
تفاصيل الطريقة
- (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.
سيتم استخدام GCKUIImagePicker المثبَّت حاليًا لاختيار صورة من البيانات الوصفية للعرض.
- Parameters
-
imageView The UIImageView that will display the selected image. imageHints The image hints.
- (void) bindControlView: | (UIControl *) | control | |
toRewindForTime: | (NSTimeInterval) | rewindSeconds | |
لربط UIControl
لإرجاع تشغيل العنصر الحالي من خلال القيمة التي تم تمريرها بالثواني.
سيتم تعديل طريقة العرض استنادًا إلى حالة GCKCastSession
وحالة التشغيل عن بُعد وما إذا كان بثًا مباشرًا. وتتم أيضًا إضافة هدف إلى UIControl
لتسجيل حدث UIControlEventTouchUpInside
. عدم إضافة هدف من هذا النوع على UIControl
. ولتسجيل الحدث، استخدِم طرق GCKUIMediaControllerDelegate
بدلاً من ذلك.
- Parameters
-
control The UI element that the user interacts with. Typically this would be an instance of UIButton
.rewindSeconds The number of seconds to rewind the media.
- (void) bindControlView: | (UIControl *) | control | |
toForwardForTime: | (NSTimeInterval) | forwardSeconds | |
لربط UIControl
لإعادة تشغيل العنصر الحالي من خلال القيمة التي تم تمريرها كثوانٍ
سيتم تعديل طريقة العرض استنادًا إلى حالة GCKCastSession
وحالة التشغيل عن بُعد وما إذا كان بثًا مباشرًا. وتتم أيضًا إضافة هدف إلى UIControl
لتسجيل حدث UIControlEventTouchUpInside
. عدم إضافة هدف من هذا النوع على UIControl
. ولتسجيل الحدث، استخدِم طرق GCKUIMediaControllerDelegate
بدلاً من ذلك.
- Parameters
-
control The UI element that the user interacts with. Typically this would be an instance of UIButton
.forwardSeconds The number of seconds to skip the media.
- (void) unbindView: | (UIView *) | view |
إلغاء ربط العرض المحدّد.
- Parameters
-
view The view to unbind.
- (void) unbindAllViews |
إلغاء ربط جميع طرق العرض المرتبطة.
- (GCKMediaRepeatMode) cycleRepeatMode |
لتغيير وضع التكرار في قائمة الانتظار إلى الوضع التالي في الدورة:
GCKMediaRepeatModeOff ← GCKMediaRepeatModeAll ← GCKMediaRepeatModeSingle ← GCKMediaRepeatModeAllAndShuffle
- المرتجعات
- وضع التكرار الجديد
- (void) selectTracks |
طريقة سهلة لعرض واجهة المستخدم الخاصة باختيار مسار الوسائط.
- (void) skipAd |
إرسال طلب تخطّي الإعلان ومراقبته.
- منذ
- 4.3
تفاصيل الموقع
|
readwritenonatomicweak |
الجهة المفوَّضة بتلقّي الإشعارات من "GCKUIMediaController"
|
readnonatomicstrong |
الجلسة المرتبطة بوحدة التحكّم هذه.
|
readnonatomicassign |
ما إذا كانت هناك وسائط يتم تحميلها (أو تحميلها) حاليًا على جهاز الاستقبال
إذا لم تكن هناك جلسة بث نشطة، ستكون NO
.
|
readnonatomicassign |
ما إذا كان هناك عنصر حالي في قائمة الانتظار
|
readnonatomicassign |
ما إذا كان هناك عنصر يتم تحميله مسبقًا في قائمة الانتظار
|
readnonatomicassign |
حالة مشغّل الوسائط المعروفة الأخيرة.
إذا لم تكن جلسة البث نشطة، ستكون حالة اللاعب هذه قبل انتهاء الجلسة الأخيرة مباشرةً. إذا لم تكن هناك جلسة سابقة، ستكون GCKMediaPlayerStateUnknown.
|
readnonatomicassign |
آخر موضع بث وسائط معروف.
إذا لم تكن جلسة البث نشطة، سيكون هذا هو موضع بث الوسائط قبل انتهاء الجلسة الأخيرة مباشرةً. إذا لم تكن هناك جلسة سابقة، ستكون هذه الجلسة kGCKInvalidTimeInterval.
|
readwritenonatomicweak |
زر "تشغيل".
عند النقر على الزر، يتم بدء تشغيل الوسائط المحمّلة حاليًا أو استئنافها على جهاز الاستقبال. سيتم إيقاف الزر إذا كان التشغيل قيد التقدم أو إذا لم يتم تحميل أي وسائط حاليًا أو إذا لم تكن هناك جلسة بث نشطة حاليًا.
|
readwritenonatomicweak |
زر "إيقاف مؤقت".
عند النقر على الزر، يتم إيقاف تشغيل الوسائط المحملة حاليًا مؤقتًا على جهاز الاستقبال. سيتم إيقاف الزر إذا كانت الوسائط المحملة حاليًا لا تتيح الإيقاف المؤقت، أو إذا لم يكن التشغيل قيد التقدم حاليًا، أو إذا لم يتم تحميل أي وسائط حاليًا، أو إذا لم تكن هناك جلسة بث نشطة حاليًا.
|
readwritenonatomicweak |
زر تبديل "تشغيل/إيقاف مؤقت".
يجب أن يضبط المتصل الرموز المناسبة لحالات الأزرار GCKUIButtonStatePlay وGCKUIButtonStatePlayLive وGCKUIButtonStatePause، أي رمز "إيقاف مؤقت" لحالة التشغيل ورمز "إيقاف" لحالة التشغيل المباشرة ورمز "تشغيل" لحالة الإيقاف المؤقت. يتم تعديل حالة الزر تلقائيًا لتعكس حالة التشغيل الحالية على جهاز الاستقبال. عند النقر على الزر، يتم إيقاف تشغيل الوسائط المحملة حاليًا مؤقتًا أو استئنافها على جهاز الاستقبال. سيتم إيقاف الزر إذا كانت الوسائط المحملة حاليًا لا تتيح الإيقاف المؤقت، أو إذا لم يكن التشغيل قيد التقدم حاليًا أو متوقِّفًا مؤقتًا، أو إذا لم تكن هناك وسائط محملة حاليًا، أو إذا لم تكن هناك جلسة بث نشطة حاليًا.
|
readwritenonatomicstrong |
وحدة تحكّم بالتبديل تؤدي إلى وضع "التشغيل/الإيقاف المؤقت"
تُستخدم كاحتياطية لواجهة مستخدم مخصصة تتيح التشغيل/الإيقاف المؤقت وتعمل على التبديل. ولمزيد من التفاصيل، يمكنك الاطّلاع على GCKUIPlayPauseToggleController.
- منذ
- 3.4
|
readwritenonatomicweak |
زر "إيقاف".
عند النقر على الزر، يتوقّف تشغيل الوسائط المحمّلة حاليًا على جهاز الاستقبال. سيتم إيقاف الزر إذا لم يتم تحميل أي وسائط حاليًا أو إذا لم تكن هناك جلسة بث نشطة حاليًا.
|
readwritenonatomicweak |
زر لتقديم الفيديو بمقدار 30 ثانية في ملف الوسائط الذي يتم تشغيله حاليًا
سيتم إيقاف الزر إذا لم يتم تحميل أي وسائط حاليًا أو إذا لم تكن هناك جلسة بث نشطة حاليًا.
|
readwritenonatomicweak |
زر للرجوع بمقدار 30 ثانية في ملف الوسائط الذي يتم تشغيله حاليًا
سيتم إيقاف الزر إذا لم يتم تحميل أي وسائط حاليًا أو إذا لم تكن هناك جلسة بث نشطة حاليًا.
|
readwritenonatomicweak |
زر لإيقاف تشغيل قائمة المحتوى التالي مؤقتًا بعد انتهاء تشغيل العنصر الحالي.
|
readwritenonatomicweak |
زر "التالي".
عند النقر على الزر، ينتقل تشغيل الفيديو إلى عنصر الوسائط التالي في قائمة الانتظار. سيتم إيقاف الزر إذا لم تكن العملية متوافقة، أو إذا لم يتم تحميل أي وسائط حاليًا، أو إذا لم تكن هناك جلسة بث نشطة حاليًا.
|
readwritenonatomicweak |
زر "السابق".
عند النقر على الزر، ينتقل "التشغيل" إلى عنصر الوسائط السابق في قائمة الانتظار. سيتم إيقاف الزر إذا لم تكن العملية متوافقة، أو إذا لم يتم تحميل أي وسائط حاليًا، أو إذا لم تكن هناك جلسة بث نشطة حاليًا.
|
readwritenonatomicweak |
زر لركوب الدراجات عبر أوضاع التكرار المتاحة في قائمة الانتظار.
(يُرجى الاطّلاع على GCKMediaRepeatMode.) يجب أن يضبط المتصل الرموز المناسبة لحالات الأزرار GCKUIButtonStateRepeatOff وGCKUIButtonStateRepeatSingle وGCKUIButtonStateRepeatAll وGCKUIButtonStateShuffle للزر. يتم تعديل حالة الزر تلقائيًا لتعكس وضع التكرار الحالي لقائمة الانتظار على جهاز الاستقبال. يؤدي النقر على الزر إلى الانتقال إلى وضع التكرار التالي، بالترتيب:
GCKMediaRepeatModeOff ← GCKMediaRepeatModeAll ← GCKMediaRepeatModeSingle ← GCKMediaRepeatModeAllAndShuffle
سيتم إيقاف الزر إذا لم تكن جلسة بث نشطة حاليًا.
|
readwritenonatomicweak |
شريط تمرير لعرض موضع البث الحالي وتغييره
عند تغيير قيمة شريط التمرير من قِبل المستخدم، يتم تعديل موضع البث للوسائط المُحمَّلة حاليًا على جهاز الاستقبال. أثناء تشغيل الوسائط قيد التقدم على جهاز الاستقبال، يتم تعديل قيمة شريط التمرير في الوقت الفعلي لتعكس موضع البث الحالي. سيتم إيقاف شريط التمرير إذا كانت الوسائط المحمَّلة حاليًا لا تتيح وضع التقديم/الترجيع أو إذا لم تكن هناك وسائط محمَّلة حاليًا أو إذا لم تكن هناك جلسة بث نشطة حاليًا.
|
readwritenonatomicweak |
طريقة عرض تعرض مستوى تقدُّم البث الحالي
أثناء تشغيل الوسائط قيد التقدم على جهاز الاستقبال، يتم تعديل قيمة المشاهدات في الوقت الفعلي لتعكس موضع البث الحالي. سيتم إيقاف العرض إذا كانت الوسائط المحمَّلة حاليًا عبارة عن بث مباشر أو إذا لم تكن هناك وسائط محمَّلة حاليًا أو إذا لم تكن هناك جلسة بث نشطة حاليًا.
|
readwritenonatomicweak |
تصنيف لعرض موضع البث الحالي بالدقائق والثواني
إذا لم يتم تحميل أي وسائط حاليًا، أو إذا لم تكن هناك جلسة بث نشطة حاليًا، سيعرض التصنيف شكلاً مترجمًا من "--:--".
|
readwritenonatomicweak |
تصنيف لعرض مدة البث الحالية بالدقائق والثواني
إذا لم تتوفّر مدة للوسائط المحمَّلة حاليًا (على سبيل المثال، إذا كان البث مباشرًا)، أو إذا لم تكن هناك وسائط محمَّلة حاليًا، أو إذا لم تكن هناك جلسة بث نشطة حاليًا، يعرض التصنيف شكلاً مترجمًا من "--:--".
|
readwritenonatomicweak |
تصنيف لعرض الوقت المتبقّي للبث (المدة مطروحًا منه الموضع) بالدقائق والثواني
إذا لم تتوفّر مدة للوسائط المحمَّلة حاليًا (على سبيل المثال، إذا كان البث مباشرًا)، أو إذا لم تكن هناك وسائط محمَّلة حاليًا، أو إذا لم تكن هناك جلسة بث نشطة حاليًا، يعرض التصنيف شكلاً مترجمًا من "--:--".
|
readwritenonatomicstrong |
وحدة التحكّم في موضع البث
يتم استخدامها كوضع أساسي لموضع بث مخصّص يوفّره التطبيق و/أو واجهة مستخدم شريطية. ولمزيد من التفاصيل، يمكنك الاطّلاع على GCKUIStreamPositionController.
- منذ
- 3.4
|
readwritenonatomicstrong |
وحدة تحكّم في معدّل تشغيل البث
ولمزيد من التفاصيل، يمكنك الاطّلاع على GCKUIPlaybackRateController.
- منذ
- 4.0
|
readwritenonatomicassign |
ما إذا كان سيتم عرض وقت البث المتبقّي كقيمة سالبة، على سبيل المثال " -1:23:45".
يتم ضبط هذه السمة تلقائيًا على YES
.
|
readwritenonatomicassign |
يمكنك اختيار إخفاء عناصر التحكم في موضع البث المباشر (بما في ذلك شريط التمرير الخاص بموضع البث وتصنيف موضع البث وتصنيف مدة البث وعرض مستوى تقدّم البث) في المحتوى المباشر.
ستكون القيمة التلقائية NO
.
- منذ
- 4.0
|
readwritenonatomicweak |
زر لاختيار المقاطع الصوتية و/أو الترجمة والشرح.
عند النقر على الزر، يتم عرض واجهة مستخدم اختيار تتبُّع الوسائط للمستخدم. سيتم إيقاف الزر إذا لم تكن الوسائط المحملة حاليًا تحتوي على أي مسارات وسائط يمكن اختيارها، أو إذا لم تكن هناك وسائط محمَّلة حاليًا، أو إذا لم تكن هناك جلسة بث نشطة حاليًا.
|
readwritenonatomicweak |
تصنيف لعرض عنوان فرعي للوسائط المحملة حاليًا.
إذا لم يتم ضبط حقل الترجمة بشكل واضح في البيانات الوصفية، ستعرض شركة الإنتاج حقل البيانات الوصفية الأنسب استنادًا إلى نوع الوسائط، مثل اسم الاستوديو لفيلم أو اسم الفنّان لمقطع موسيقي.
|
readwritenonatomicweak |
عرض مؤشر النشاط للإشارة إلى أنّ الوسائط في حالة تحميل.
|
readwritenonatomicweak |
تصنيف لعرض مقدار الوقت المتبقّي حتى يمكن تخطّي الإعلان.
- منذ
- 4.3
|
readwritenonatomicweak |
زر لتخطّي الإعلان الحالي
- منذ
- 4.3