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< GCKUIMediaControllerDelegate > | delegate |
Osoba, której przekazano dostęp do powiadomień z GCKUIMediaController. Więcej... | |
GCKSession * | session |
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... | |
GCKUIMultistateButton * | playPauseToggleButton |
Przycisk przełączania „odtwórz/wstrzymaj”. Więcej... | |
GCKUIPlayPauseToggleController * | playPauseToggleController |
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... | |
GCKUIMultistateButton * | repeatModeButton |
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... | |
GCKUIStreamPositionController * | streamPositionController |
Kontroler pozycji strumienia. Więcej... | |
GCKUIPlaybackRateController * | playbackRateController |
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
-
label The UILabel that will display the value. key The 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
-
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 | |
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
-
textView The UITextView that will display the value. key The 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
-
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 | |
Wiąże UIImageView z instancją GCKUIImageHints.
Do wybrania obrazu z metadanych widoku zostanie użyty aktualnie zainstalowany GCKUIImagePicker.
- Parameters
-
imageView The UIImageView that will display the selected image. imageHints The 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
-
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 | |
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
-
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 |
Powoduje usunięcie powiązania określonego widoku danych.
- Parameters
-
view The 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:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
- 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
|
readwritenonatomicweak |
Osoba, której przekazano dostęp do powiadomień z GCKUIMediaController.
|
readnonatomicstrong |
Sesja powiązana z tym kontrolerem.
|
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
.
|
readnonatomicassign |
Wskazuje, czy w kolejce znajduje się bieżący element.
|
readnonatomicassign |
Informacja, czy w kolejce jest wstępnie wczytywany element.
|
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.
|
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.
|
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.
|
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.
|
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.
|
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
|
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.
|
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.
|
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.
|
readwritenonatomicweak |
Przycisk do wstrzymywania odtwarzania w kolejce po zakończeniu odtwarzania bieżącego elementu.
|
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.
|
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.
|
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:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
Przycisk będzie nieaktywny, jeśli żadna sesja przesyłania nie będzie aktywna.
|
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.
|
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.
|
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ć „--:--”.
|
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ć „--:--”.
|
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ć „--:--”.
|
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
|
readwritenonatomicstrong |
Kontroler szybkości odtwarzania strumienia.
Aby dowiedzieć się więcej, zobacz GCKUIPlaybackRateController.
- Od
- 4,0
|
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
.
|
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
|
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.
|
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.
|
readwritenonatomicweak |
Widok wskaźnika aktywności wskazujący, że multimedia są wczytywane.
|
readwritenonatomicweak |
Etykieta informująca, ile czasu pozostało do pominięcia reklamy.
- Od
- 4,3
|
readwritenonatomicweak |
Przycisk umożliwiający pominięcie bieżącej reklamy.
- Od
- 4,3