Klasa GCKUIMediaController

Odniesienie do klasy GCKUIMediaController

Opis

Kontroler widoków interfejsu służący do sterowania i wyświetlania stanu odtwarzania multimediów w odbiorniku.

Aplikacja wywołująca rejestruje w kontrolerze swoje elementy sterujące związane z multimediami, ustawiając odpowiednie właściwości. Następnie kontroler reaguje na zdarzenia dotknięcia elementów sterujących, wydają odpowiednie polecenia multimedialne do odbiornika i aktualizuje je na podstawie informacji o stanie i metadanych multimediów otrzymanych od odbiornika. Kontroler automatycznie włącza i wyłącza elementy sterujące interfejsu odpowiednio do bieżącej sesji i stanu odtwarzacza. Wyłącza też wszystkie opcje, gdy trwa przetwarzanie żądania.

Informacje o protokole delegowania znajdziesz w sekcji GCKUIMediaControllerDelegate.

Od
3,0

Dziedziczy NSObject.

Podsumowanie metody instancji

(instancetype) - init
 Inicjuje instancję. Więcej...
 
(void) - bindLabel:toMetadataKey:
 Wiąże UILabel z kluczem metadanych. Więcej...
 
(void) - bindLabel:toMetadataKey:withFormatter:
 Wiąże UILabel z kluczem metadanych. Więcej...
 
(void) - bindTextView:toMetadataKey:
 Wiąże UITextView z kluczem metadanych. Więcej...
 
(void) - bindTextView:toMetadataKey:withFormatter:
 Wiąże UITextView z kluczem metadanych. Więcej...
 
(void) - bindImageView:toImageHints:
 Wiąże UIImageView z instancją GCKUIImageHints. Więcej...
 
(void) - bindControlView:toRewindForTime:
 Wiąże UIControl, aby przewinąć odtwarzanie bieżącego elementu do tyłu o przekazaną wartość w sekundach. Więcej...
 
(void) - bindControlView:toForwardForTime:
 Wiąże UIControl, aby umożliwić odtwarzanie bieżącego elementu dalej o przekazanej wartości w sekundach. Więcej...
 
(void) - unbindView:
 Powoduje usunięcie powiązania określonego widoku danych. Więcej...
 
(void) - unbindAllViews
 Usuwanie powiązań wszystkich powiązanych widoków. Więcej...
 
(GCKMediaRepeatMode- cycleRepeatMode
 Zmienia tryb powtarzania kolejki na następny tryb w cyklu: Więcej...
 
(void) - selectTracks
 Wygodna metoda wyświetlania interfejsu wyboru ścieżki multimediów. Więcej...
 
(void) - skipAd
 Wysyła i monitoruje żądanie pominięcia reklamy. Więcej...
 

Podsumowanie usługi

id< GCKUIMediaControllerDelegatedelegate
 Osoba, której przekazano dostęp do powiadomień z GCKUIMediaController. Więcej...
 
GCKSessionsession
 Sesja powiązana z tym kontrolerem. Więcej...
 
BOOL mediaLoaded
 Określa, czy na odbiorniku są obecnie załadowane (lub wczytywane) multimedia. Więcej...
 
BOOL hasCurrentQueueItem
 Wskazuje, czy w kolejce znajduje się bieżący element. Więcej...
 
BOOL hasLoadingQueueItem
 Informacja, czy w kolejce jest wstępnie wczytywany element. Więcej...
 
GCKMediaPlayerState lastKnownPlayerState
 Najnowszy znany stan odtwarzacza. Więcej...
 
NSTimeInterval lastKnownStreamPosition
 Najnowsza znana pozycja strumienia multimediów. Więcej...
 
UIButton * playButton
 Przycisk „Odtwórz”. Więcej...
 
UIButton * pauseButton
 Przycisk „Pauza”. Więcej...
 
GCKUIMultistateButtonplayPauseToggleButton
 Przycisk przełączania „odtwórz/wstrzymaj”. Więcej...
 
GCKUIPlayPauseToggleControllerplayPauseToggleController
 Kontroler przełączania odtwarzania/wstrzymywania. Więcej...
 
UIButton * stopButton
 Przycisk „Zatrzymaj”. Więcej...
 
UIButton * forward30SecondsButton
 Przycisk do przewijania aktualnie odtwarzanego elementu multimedialnego do przodu o 30 sekund do przodu. Więcej...
 
UIButton * rewind30SecondsButton
 Przycisk do przechodzenia 30 sekund do tyłu aktualnie odtwarzanego elementu multimedialnego. Więcej...
 
UIButton * pauseQueueButton
 Przycisk do wstrzymywania odtwarzania w kolejce po zakończeniu odtwarzania bieżącego elementu. Więcej...
 
UIButton * nextButton
 Przycisk „Dalej”. Więcej...
 
UIButton * previousButton
 Przycisk „Wstecz”. Więcej...
 
GCKUIMultistateButtonrepeatModeButton
 Przycisk do przełączania się między dostępnymi trybami powtarzania kolejki. Więcej...
 
UISlider * streamPositionSlider
 Suwak do wyświetlania i zmiany bieżącej pozycji strumienia. Więcej...
 
UIProgressView * streamProgressView
 Widok, w którym można zobaczyć postęp bieżącej transmisji. Więcej...
 
UILabel * streamPositionLabel
 Etykieta, która pokazuje bieżącą pozycję strumienia w minutach i sekundach. Więcej...
 
UILabel * streamDurationLabel
 Etykieta wyświetlająca czas trwania bieżącej transmisji w minutach i sekundach. Więcej...
 
UILabel * streamTimeRemainingLabel
 Etykieta, która pokazuje pozostały czas transmisji (czas trwania minus pozycję) w minutach i sekundach. Więcej...
 
GCKUIStreamPositionControllerstreamPositionController
 Kontroler pozycji strumienia. Więcej...
 
GCKUIPlaybackRateControllerplaybackRateController
 Kontroler szybkości odtwarzania strumienia. Więcej...
 
BOOL displayTimeRemainingAsNegativeValue
 Określa, czy pozostały czas transmisji będzie wyświetlany jako wartość ujemna, np. „-1:23:45”. Więcej...
 
BOOL hideStreamPositionControlsForLiveContent
 Określa, czy w przypadku treści na żywo elementy sterujące pozycji strumienia (w tym suwak pozycji strumienia, etykieta pozycji strumienia, etykieta czasu trwania transmisji i widok postępu transmisji) powinny być ukryte. Więcej...
 
UIButton * tracksButton
 Przycisk do wybierania ścieżek audio lub napisów. Więcej...
 
UILabel * smartSubtitleLabel
 Etykieta służąca do wyświetlania podtytułu aktualnie wczytanych multimediów. Więcej...
 
UIActivityIndicatorView * mediaLoadingIndicator
 Widok wskaźnika aktywności wskazujący, że multimedia są wczytywane. Więcej...
 
UILabel * skipAdLabel
 Etykieta informująca, ile czasu pozostało do pominięcia reklamy. Więcej...
 
UIButton * skipAdButton
 Przycisk umożliwiający pominięcie bieżącej reklamy. Więcej...
 

Szczegóły metody

- (instancetype) init

Inicjuje instancję.

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

Wiąże UILabel z kluczem metadanych.

W widoku wyświetli się aktualna wartość odpowiedniego pola metadanych.

Listę wstępnie zdefiniowanych kluczy metadanych znajdziesz na stronie GCKMediaMetadata.

Parameters
labelThe UILabel that will display the value.
keyThe metadata key.
- (void) bindLabel: (UILabel *)  label
toMetadataKey: (NSString *)  key
withFormatter: (GCKUIValueFormatter formatter 

Wiąże UILabel z kluczem metadanych.

W widoku wyświetli się aktualna wartość odpowiedniego pola metadanych.

Listę wstępnie zdefiniowanych kluczy metadanych znajdziesz na stronie GCKMediaMetadata.

Parameters
labelThe UILabel that will display the value.
keyThe metadata key.
formatterA block that will produce the desired string representation of the value.
- (void) bindTextView: (UITextView *)  textView
toMetadataKey: (NSString *)  key 

Wiąże UITextView z kluczem metadanych.

W widoku wyświetli się aktualna wartość odpowiedniego pola metadanych.

Listę wstępnie zdefiniowanych kluczy metadanych znajdziesz na stronie GCKMediaMetadata.

Parameters
textViewThe UITextView that will display the value.
keyThe metadata key.
- (void) bindTextView: (UITextView *)  textView
toMetadataKey: (NSString *)  key
withFormatter: (GCKUIValueFormatter formatter 

Wiąże UITextView z kluczem metadanych.

W widoku wyświetli się aktualna wartość odpowiedniego pola metadanych.

Listę wstępnie zdefiniowanych kluczy metadanych znajdziesz na stronie GCKMediaMetadata.

Parameters
textViewThe UITextView that will display the value.
keyThe metadata key.
formatterA block that will produce the desired string representation of the value.
- (void) bindImageView: (UIImageView *)  imageView
toImageHints: (GCKUIImageHints *)  imageHints 

Wiąże UIImageView z instancją GCKUIImageHints.

Do wybrania obrazu z metadanych widoku zostanie użyty aktualnie zainstalowany GCKUIImagePicker.

Parameters
imageViewThe UIImageView that will display the selected image.
imageHintsThe image hints.
- (void) bindControlView: (UIControl *)  control
toRewindForTime: (NSTimeInterval)  rewindSeconds 

Wiąże UIControl, aby przewinąć odtwarzanie bieżącego elementu do tyłu o przekazaną wartość w sekundach.

Widok zostanie zaktualizowany na podstawie stanu GCKCastSession, stanu zdalnego odtwarzania oraz tego, czy jest to transmisja na żywo. Do zdarzenia UIControl dodawany jest też cel, który umożliwia przechwytywanie zdarzenia UIControlEventTouchUpInside. Nie dodawaj miejsca docelowego tego typu w: UIControl. Aby przechwycić zdarzenie, użyj metod GCKUIMediaControllerDelegate.

Parameters
controlThe UI element that the user interacts with. Typically this would be an instance of UIButton.
rewindSecondsThe number of seconds to rewind the media.
- (void) bindControlView: (UIControl *)  control
toForwardForTime: (NSTimeInterval)  forwardSeconds 

Wiąże UIControl, aby umożliwić odtwarzanie bieżącego elementu dalej o przekazanej wartości w sekundach.

Widok zostanie zaktualizowany na podstawie stanu GCKCastSession, stanu zdalnego odtwarzania oraz tego, czy jest to transmisja na żywo. Do zdarzenia UIControl dodawany jest też cel, który umożliwia przechwytywanie zdarzenia UIControlEventTouchUpInside. Nie dodawaj miejsca docelowego tego typu w: UIControl. Aby przechwycić zdarzenie, użyj metod GCKUIMediaControllerDelegate.

Parameters
controlThe UI element that the user interacts with. Typically this would be an instance of UIButton.
forwardSecondsThe number of seconds to skip the media.
- (void) unbindView: (UIView *)  view

Powoduje usunięcie powiązania określonego widoku danych.

Parameters
viewThe view to unbind.
- (void) unbindAllViews

Usuwanie powiązań wszystkich powiązanych widoków.

- (GCKMediaRepeatMode) cycleRepeatMode

Zmienia tryb powtarzania kolejki na następny tryb w cyklu:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

Akcje powrotne
Nowy tryb powtarzania.
- (void) selectTracks

Wygodna metoda wyświetlania interfejsu wyboru ścieżki multimediów.

- (void) skipAd

Wysyła i monitoruje żądanie pominięcia reklamy.

Od
4,3

Szczegóły nieruchomości

- (id<GCKUIMediaControllerDelegate>) delegate
readwritenonatomicweak

Osoba, której przekazano dostęp do powiadomień z GCKUIMediaController.

- (GCKSession*) session
readnonatomicstrong

Sesja powiązana z tym kontrolerem.

- (BOOL) mediaLoaded
readnonatomicassign

Określa, czy na odbiorniku są obecnie załadowane (lub wczytywane) multimedia.

Jeśli żadna sesja przesyłania nie jest aktywna, wartość to NO.

- (BOOL) hasCurrentQueueItem
readnonatomicassign

Wskazuje, czy w kolejce znajduje się bieżący element.

- (BOOL) hasLoadingQueueItem
readnonatomicassign

Informacja, czy w kolejce jest wstępnie wczytywany element.

- (GCKMediaPlayerState) lastKnownPlayerState
readnonatomicassign

Najnowszy znany stan odtwarzacza.

Jeśli żadna sesja przesyłania nie jest aktywna, ten stan odtwarzacza pojawia się tuż przed zakończeniem ostatniej sesji. Jeśli wcześniej nie było żadnej sesji, wartość będzie określona jako GCKMediaPlayerStateUnknown.

- (NSTimeInterval) lastKnownStreamPosition
readnonatomicassign

Najnowsza znana pozycja strumienia multimediów.

Jeśli nie jest aktywna żadna sesja przesyłania, będzie to pozycja strumienia multimediów tuż przed zakończeniem ostatniej sesji. Jeśli wcześniej nie było żadnej sesji, będzie to kGCKInvalidTimeInterval.

- (UIButton*) playButton
readwritenonatomicweak

Przycisk „Odtwórz”.

Po dotknięciu przycisku odtwarzanie aktualnie wczytanych multimediów rozpoczyna się lub jest wznawiane na odbiorniku. Przycisk będzie nieaktywny, jeśli odtwarzanie już trwa, nie ma wczytanych multimediów lub gdy nie jest aktywna żadna sesja przesyłania.

- (UIButton*) pauseButton
readwritenonatomicweak

Przycisk „Pauza”.

Po dotknięciu przycisku odtwarzanie aktualnie wczytanych multimediów na odbiorniku jest wstrzymane. Przycisk będzie nieaktywny, jeśli aktualnie wczytane multimedia nie obsługują wstrzymywania, odtwarzanie obecnie nie jest w toku, nie ma obecnie załadowanych multimediów lub aktualnie nie jest aktywna żadna sesja przesyłania.

- (GCKUIMultistateButton*) playPauseToggleButton
readwritenonatomicweak

Przycisk przełączania „odtwórz/wstrzymaj”.

Rozmówca powinien ustawić odpowiednie ikony dla stanów przycisku GCKUIButtonStatePlay, GCKUIButtonStatePlayLive i GCKUIButtonStatePause: ikonę „wstrzymania” dla stanu odtwarzania, ikonę „stop” do stanu odtwarzania oraz ikonę „odtwórz” do stanu wstrzymania. Stan przycisku jest automatycznie aktualizowany o obecny stan odtwarzania na odbiorniku. Po dotknięciu przycisku odtwarzanie aktualnie wczytanych multimediów jest wstrzymane lub wznowione na odbiorniku. Przycisk będzie nieaktywny, jeśli aktualnie wczytane multimedia nie obsługują wstrzymywania, odtwarzanie obecnie nie jest w toku lub wstrzymane lub gdy nie ma obecnie załadowanych multimediów albo aktualnie nie jest aktywna żadna sesja przesyłania.

- (GCKUIPlayPauseToggleController*) playPauseToggleController
readwritenonatomicstrong

Kontroler przełączania odtwarzania/wstrzymywania.

Używana jako wstępna wersja interfejsu użytkownika umożliwiającego przełączanie odtwarzania/wstrzymywania odtwarzania. Aby dowiedzieć się więcej, zobacz GCKUIPlayPauseToggleController.

Od
3,4
- (UIButton*) stopButton
readwritenonatomicweak

Przycisk „Zatrzymaj”.

Po dotknięciu przycisku odtwarzanie aktualnie wczytanych multimediów na odbiorniku jest zatrzymane. Przycisk jest wyłączony, jeśli nie są w tej chwili wczytane żadne multimedia lub nie jest aktywna żadna sesja przesyłania.

- (UIButton*) forward30SecondsButton
readwritenonatomicweak

Przycisk do przewijania aktualnie odtwarzanego elementu multimedialnego do przodu o 30 sekund do przodu.

Przycisk jest wyłączony, jeśli nie są w tej chwili wczytane żadne multimedia lub nie jest aktywna żadna sesja przesyłania.

- (UIButton*) rewind30SecondsButton
readwritenonatomicweak

Przycisk do przechodzenia 30 sekund do tyłu aktualnie odtwarzanego elementu multimedialnego.

Przycisk jest wyłączony, jeśli nie są w tej chwili wczytane żadne multimedia lub nie jest aktywna żadna sesja przesyłania.

- (UIButton*) pauseQueueButton
readwritenonatomicweak

Przycisk do wstrzymywania odtwarzania w kolejce po zakończeniu odtwarzania bieżącego elementu.

- (UIButton*) nextButton
readwritenonatomicweak

Przycisk „Dalej”.

Po kliknięciu przycisku odtwarzanie przesuwa się do następnego elementu multimedialnego w kolejce. Przycisk będzie nieaktywny, jeśli ta operacja nie będzie obsługiwana, nie załadowano żadnych multimediów lub gdy nie będzie aktualnie aktywna sesja przesyłania.

- (UIButton*) previousButton
readwritenonatomicweak

Przycisk „Wstecz”.

Po kliknięciu przycisku odtwarzanie przesuwa się do poprzedniego elementu multimedialnego w kolejce. Przycisk będzie nieaktywny, jeśli ta operacja nie będzie obsługiwana, nie załadowano żadnych multimediów lub gdy nie będzie aktualnie aktywna sesja przesyłania.

- (GCKUIMultistateButton*) repeatModeButton
readwritenonatomicweak

Przycisk do przełączania się między dostępnymi trybami powtarzania kolejki.

(Patrz GCKMediaRepeatMode). Rozmówca powinien ustawić odpowiednie ikony dla stanów przycisku GCKUIButtonStateRepeatOff, GCKUIButtonStateRepeatSingle, GCKUIButtonStateRepeatAll i GCKUIButtonStateShuffle. Stan przycisku jest automatycznie aktualizowany, aby odzwierciedlić bieżący tryb powtarzania kolejki na odbiorniku. Dotknięcie przycisku powoduje przejście do następnego trybu powtarzania w kolejności:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

Przycisk będzie nieaktywny, jeśli żadna sesja przesyłania nie będzie aktywna.

- (UISlider*) streamPositionSlider
readwritenonatomicweak

Suwak do wyświetlania i zmiany bieżącej pozycji strumienia.

Gdy użytkownik zmieni wartość suwaka, pozycja strumienia aktualnie wczytanych multimediów na odbiorniku zostanie zaktualizowana. Gdy trwa odtwarzanie multimediów na odbiorniku, wartość suwaka jest aktualizowana w czasie rzeczywistym, aby odzwierciedlać aktualną pozycję strumienia. Suwak jest wyłączony, jeśli obecnie wczytane multimedia nie obsługują przewijania, gdy nie są w tej chwili wczytane żadne multimedia lub nie jest aktywna żadna sesja przesyłania.

- (UIProgressView*) streamProgressView
readwritenonatomicweak

Widok, w którym można zobaczyć postęp bieżącej transmisji.

Gdy trwa odtwarzanie multimediów na odbiorniku, wartość wyświetleń jest aktualizowana w czasie rzeczywistym, aby odzwierciedlać aktualną pozycję strumienia. Wyświetlanie zostanie wyłączone, jeśli wczytane aktualnie multimedia są transmisją na żywo, gdy nie ma wczytanych multimediów lub gdy nie jest aktywna żadna sesja przesyłania.

- (UILabel*) streamPositionLabel
readwritenonatomicweak

Etykieta, która pokazuje bieżącą pozycję strumienia w minutach i sekundach.

Jeśli w tej chwili nie ma żadnych multimediów lub nie jest aktywna żadna sesja przesyłania, etykieta wyświetla zlokalizowaną postać „--:--”.

- (UILabel*) streamDurationLabel
readwritenonatomicweak

Etykieta wyświetlająca czas trwania bieżącej transmisji w minutach i sekundach.

Jeśli obecnie wczytane multimedia nie mają określonego czasu trwania (np. jest to transmisja na żywo), aktualnie nie są wczytywane żadne multimedia lub żadna sesja przesyłania nie jest w tej chwili aktywna, etykieta ma zlokalizowaną postać „--:--”.

- (UILabel*) streamTimeRemainingLabel
readwritenonatomicweak

Etykieta, która pokazuje pozostały czas transmisji (czas trwania minus pozycję) w minutach i sekundach.

Jeśli obecnie wczytane multimedia nie mają określonego czasu trwania (np. jest to transmisja na żywo), aktualnie nie są wczytywane żadne multimedia lub żadna sesja przesyłania nie jest w tej chwili aktywna, etykieta ma zlokalizowaną postać „--:--”.

- (GCKUIStreamPositionController*) streamPositionController
readwritenonatomicstrong

Kontroler pozycji strumienia.

Używany jako wstępna wersja interfejsu niestandardowego, dostarczonego przez aplikację elementu strumienia lub wyszukiwania. Aby dowiedzieć się więcej, zobacz GCKUIStreamPositionController.

Od
3,4
- (GCKUIPlaybackRateController*) playbackRateController
readwritenonatomicstrong

Kontroler szybkości odtwarzania strumienia.

Aby dowiedzieć się więcej, zobacz GCKUIPlaybackRateController.

Od
4,0
- (BOOL) displayTimeRemainingAsNegativeValue
readwritenonatomicassign

Określa, czy pozostały czas transmisji będzie wyświetlany jako wartość ujemna, np. „-1:23:45”.

Domyślnie ta właściwość ma wartość YES.

- (BOOL) hideStreamPositionControlsForLiveContent
readwritenonatomicassign

Określa, czy w przypadku treści na żywo elementy sterujące pozycji strumienia (w tym suwak pozycji strumienia, etykieta pozycji strumienia, etykieta czasu trwania transmisji i widok postępu transmisji) powinny być ukryte.

Wartością domyślną jest NO.

Od
4,0
- (UIButton*) tracksButton
readwritenonatomicweak

Przycisk do wybierania ścieżek audio lub napisów.

Po kliknięciu przycisku pojawia się interfejs wyboru ścieżek multimediów. Przycisk jest nieaktywny, jeśli na wczytanych multimediach nie ma żadnych ścieżek multimedialnych, nie załadowano żadnych multimediów lub aktualnie nie jest aktywna żadna sesja przesyłania.

- (UILabel*) smartSubtitleLabel
readwritenonatomicweak

Etykieta służąca do wyświetlania podtytułu aktualnie wczytanych multimediów.

Jeśli w metadanych nie zostanie jasno ustawione pole napisów, wytwórnia wyświetli najbardziej odpowiednie pole metadanych na podstawie typu nośnika, na przykład nazwę studia filmu lub nazwę wykonawcy utworu muzycznego.

- (UIActivityIndicatorView*) mediaLoadingIndicator
readwritenonatomicweak

Widok wskaźnika aktywności wskazujący, że multimedia są wczytywane.

- (UILabel*) skipAdLabel
readwritenonatomicweak

Etykieta informująca, ile czasu pozostało do pominięcia reklamy.

Od
4,3
- (UIButton*) skipAdButton
readwritenonatomicweak

Przycisk umożliwiający pominięcie bieżącej reklamy.

Od
4,3