Przegląd
Kontroler widoków interfejsu, które służą do sterowania odtwarzaniem multimediów na odbiorniku Cast lub wyświetlania jego stanu.
Aplikacja wywołująca rejestruje w kontrolerze elementy interfejsu związane z multimediami, ustawiając odpowiednie właściwości. Następnie kontroler reaguje na zdarzenia dotknięcia elementów sterujących, wysyłając do odbiornika odpowiednie polecenia multimedialne, i aktualizuje elementy sterujące na podstawie informacji o stanie i metadanych multimediów otrzymanych z odbiornika. Kontroler automatycznie włącza i wyłącza elementy interfejsu zgodnie z bieżącą sesją i stanem odtwarzacza multimediów. Dodatkowo wyłącza wszystkie elementy sterujące, gdy żądanie jest w trakcie przetwarzania.
Protokół delegowania znajdziesz na stronie GCKUIMediaControllerDelegate.
- Od
- 3,0
Dziedziczy z klasy NSObject.
Podsumowanie metod instancji | |
| (instancetype) | - init |
| Inicjuje instancję. Więcej… | |
| (void) | - bindLabel:toMetadataKey: |
| Wiąże element UILabel z kluczem metadanych. Więcej… | |
| (void) | - bindLabel:toMetadataKey:withFormatter: |
| Wiąże element UILabel z kluczem metadanych. Więcej… | |
| (void) | - bindTextView:toMetadataKey: |
| Wiąże element UITextView z kluczem metadanych. Więcej… | |
| (void) | - bindTextView:toMetadataKey:withFormatter: |
| Wiąże element UITextView z kluczem metadanych. Więcej… | |
| (void) | - bindImageView:toImageHints: |
| Wiąże element UIImageView z instancją GCKUIImageHints. Więcej… | |
| (void) | - unbindView: |
| Odłącza określony widok. Więcej… | |
| (void) | - unbindAllViews |
| Usuwa powiązanie wszystkich powiązanych widoków. Więcej… | |
| (GCKMediaRepeatMode) | - cycleRepeatMode |
| Zmienia tryb powtarzania kolejki na następny w cyklu: Więcej... | |
| (void) | - selectTracks |
| Wygodna metoda wyświetlania interfejsu wyboru ścieżki multimedialnej. Więcej… | |
Podsumowanie usługi | |
| id< GCKUIMediaControllerDelegate > | delegate |
| Osoba upoważniona do otrzymywania powiadomień z usługi GCKUIMediaController. Więcej… | |
| GCKSession * | session |
| Sesja powiązana z tym kontrolerem. Więcej… | |
| BOOL | mediaLoaded |
| Czy na odbiorniku są obecnie załadowane (lub wczytywane) multimedia. Więcej… | |
| BOOL | hasCurrentQueueItem |
| Określa, czy w kolejce znajduje się bieżący element. Więcej… | |
| BOOL | hasLoadingQueueItem |
| Określa, czy w kolejce jest wstępnie wczytywany element. Więcej… | |
| GCKMediaPlayerState | lastKnownPlayerState |
| Ostatni znany stan odtwarzacza multimediów. Więcej… | |
| NSTimeInterval | lastKnownStreamPosition |
| Ostatnia znana pozycja strumienia multimediów. Więcej… | |
| UIButton * | playButton |
| przycisk „Odtwórz”; Więcej… | |
| UIButton * | pauseButton |
| przycisk „wstrzymaj”; Więcej… | |
| GCKUIButton * | playPauseToggleButton |
| przycisk odtwarzania/wstrzymywania; Więcej… | |
| GCKUIPlayPauseToggleController * | playPauseToggleController |
| Przełącznik „odtwarzanie/wstrzymywanie”. Więcej… | |
| UIButton * | stopButton |
| przycisk „zatrzymaj”; Więcej… | |
| GCKUIButton * | forward30SecondsButton |
| Przycisk przewijania o 30 sekund do przodu w odtwarzanym obecnie elemencie multimedialnym. Więcej… | |
| GCKUIButton * | rewind30SecondsButton |
| Przycisk przewijania o 30 sekund do tyłu w obecnie odtwarzanym elemencie multimedialnym. Więcej… | |
| UIButton * | pauseQueueButton |
| przycisk wstrzymania odtwarzania kolejki po zakończeniu odtwarzania bieżącego elementu; Więcej… | |
| UIButton * | nextButton |
| przycisk „Dalej”; Więcej… | |
| UIButton * | previousButton |
| przycisk „Wstecz”; Więcej… | |
| GCKUIButton * | repeatModeButton |
| Przycisk przełączania dostępnych trybów powtarzania kolejki. Więcej… | |
| UISlider * | streamPositionSlider |
| Suwak do wyświetlania i zmiany bieżącej pozycji strumienia. Więcej… | |
| UIProgressView * | streamProgressView |
| Widok wyświetlający bieżący postęp strumienia. Więcej… | |
| UILabel * | streamPositionLabel |
| Etykieta wyświetlająca bieżącą pozycję transmisji w minutach i sekundach. Więcej… | |
| UILabel * | streamDurationLabel |
| Etykieta wyświetlająca bieżący czas trwania transmisji w minutach i sekundach. Więcej… | |
| UILabel * | streamTimeRemainingLabel |
| Etykieta wyświetlająca pozostały czas transmisji (czas trwania minus pozycja) w minutach i sekundach. Więcej… | |
| GCKUIStreamPositionController * | streamPositionController |
| kontroler pozycji strumienia, Więcej… | |
| BOOL | displayTimeRemainingAsNegativeValue |
| Czy pozostały czas transmisji będzie wyświetlany jako wartość ujemna, np. „-1:23:45”. Więcej… | |
| UIButton * | tracksButton |
| Przycisk do wybierania ścieżek audio lub napisów standardowych bądź dla niesłyszących. Więcej… | |
| UILabel * | smartSubtitleLabel |
| Etykieta do wyświetlania napisów do aktualnie wczytanych multimediów. Więcej… | |
| UIActivityIndicatorView * | mediaLoadingIndicator |
| Widok wskaźnika aktywności informujący, że media są w stanie ładowania. Więcej… | |
Szczegóły metody
| - (instancetype) init |
Inicjuje instancję.
| - (void) bindLabel: | (UILabel *) | label | |
| toMetadataKey: | (NSString *) | key | |
Wiąże element UILabel z kluczem metadanych.
W widoku będzie wyświetlana bieżąca wartość odpowiedniego pola metadanych.
Listę wstępnie zdefiniowanych kluczy metadanych znajdziesz na 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 element UILabel z kluczem metadanych.
W widoku będzie wyświetlana bieżąca wartość odpowiedniego pola metadanych.
Listę wstępnie zdefiniowanych kluczy metadanych znajdziesz na 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 element UITextView z kluczem metadanych.
W widoku będzie wyświetlana bieżąca wartość odpowiedniego pola metadanych.
Listę wstępnie zdefiniowanych kluczy metadanych znajdziesz na 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 element UITextView z kluczem metadanych.
W widoku będzie wyświetlana bieżąca wartość odpowiedniego pola metadanych.
Listę wstępnie zdefiniowanych kluczy metadanych znajdziesz na 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 element UIImageView z instancją GCKUIImageHints.
Obecnie zainstalowany selektor UIImagePicker zostanie użyty do wybrania obrazu z metadanych widoku.
- Parameters
-
imageView The UIImageView that will display the selected image. imageHints The image hints.
| - (void) unbindView: | (UIView *) | view |
Odłącza określony widok.
- Parameters
-
view The view to unbind.
| - (void) unbindAllViews |
Usuwa powiązanie wszystkich powiązanych widoków.
| - (GCKMediaRepeatMode) cycleRepeatMode |
Zmienia tryb powtarzania kolejki na następny w cyklu:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
- Zwroty
- Nowy tryb powtarzania.
| - (void) selectTracks |
Wygodna metoda wyświetlania interfejsu wyboru ścieżki multimedialnej.
Szczegóły usługi
|
readwritenonatomicweak |
Osoba upoważniona do otrzymywania powiadomień z usługi GCKUIMediaController.
|
readnonatomicstrong |
Sesja powiązana z tym kontrolerem.
|
readnonatomicassign |
Czy na odbiorniku są obecnie załadowane (lub wczytywane) multimedia.
Jeśli żadna sesja przesyłania nie jest aktywna, będzie to NO.
|
readnonatomicassign |
Określa, czy w kolejce znajduje się bieżący element.
|
readnonatomicassign |
Określa, czy w kolejce jest wstępnie wczytywany element.
|
readnonatomicassign |
Ostatni znany stan odtwarzacza multimediów.
Jeśli żadna sesja Cast nie jest aktywna, będzie to stan odtwarzacza tuż przed zakończeniem ostatniej sesji. Jeśli nie było wcześniejszej sesji, wartość tego parametru to GCKMediaPlayerStateUnknown.
|
readnonatomicassign |
Ostatnia znana pozycja strumienia multimediów.
Jeśli żadna sesja Cast nie jest aktywna, będzie to pozycja strumienia multimediów tuż przed zakończeniem ostatniej sesji. Jeśli nie było wcześniejszej sesji, wartość tego parametru to kGCKInvalidTimeInterval.
|
readwritenonatomicweak |
przycisk „Odtwórz”;
Po kliknięciu przycisku odtwarzanie aktualnie załadowanych multimediów jest rozpoczynane lub wznawiane na odbiorniku. Przycisk będzie nieaktywny, jeśli odtwarzanie jest już w toku, nie ma załadowanych multimediów lub nie jest aktywna żadna sesja Cast.
|
readwritenonatomicweak |
przycisk „wstrzymaj”;
Gdy naciśniesz ten przycisk, odtwarzanie aktualnie załadowanych multimediów na odbiorniku zostanie wstrzymane. Przycisk będzie nieaktywny, jeśli aktualnie załadowane multimedia nie obsługują wstrzymywania, odtwarzanie nie jest w toku, nie ma załadowanych multimediów lub nie ma aktywnej sesji Cast.
|
readwritenonatomicweak |
przycisk odtwarzania/wstrzymywania;
Wywołujący powinien ustawić odpowiednie ikony dla stanów GCKUIControlStatePlay i GCKUIControlStatePause przycisku, czyli ikonę „wstrzymaj” dla stanu odtwarzania i ikonę „odtwarzaj” dla stanu wstrzymania. Stan przycisku jest automatycznie aktualizowany, aby odzwierciedlać bieżący stan odtwarzania na odbiorniku. Gdy naciśniesz przycisk, odtwarzanie aktualnie załadowanych multimediów zostanie wstrzymane lub wznowione na odbiorniku. Przycisk będzie nieaktywny, jeśli aktualnie załadowane multimedia nie obsługują wstrzymywania, odtwarzanie nie jest w toku lub nie jest wstrzymane, nie ma aktualnie załadowanych multimediów lub nie ma aktywnej sesji Cast.
|
readwritenonatomicstrong |
Przełącznik „odtwarzanie/wstrzymywanie”.
Używany jako zamiennik niestandardowego interfejsu przełącznika odtwarzania/wstrzymywania dostarczanego przez aplikację. Aby dowiedzieć się więcej, zobacz GCKUIPlayPauseToggleController.
- Od
- 3.4
|
readwritenonatomicweak |
przycisk „zatrzymaj”;
Po kliknięciu tego przycisku odtwarzanie aktualnie załadowanych multimediów na odbiorniku zostanie zatrzymane. Przycisk będzie nieaktywny, jeśli nie ma obecnie załadowanych multimediów lub nie jest aktywna żadna sesja Cast.
|
readwritenonatomicweak |
Przycisk przewijania o 30 sekund do przodu w odtwarzanym obecnie elemencie multimedialnym.
Przycisk będzie nieaktywny, jeśli nie ma obecnie załadowanych multimediów lub nie jest aktywna żadna sesja Cast.
|
readwritenonatomicweak |
Przycisk przewijania o 30 sekund do tyłu w obecnie odtwarzanym elemencie multimedialnym.
Przycisk będzie nieaktywny, jeśli nie ma obecnie załadowanych multimediów lub nie jest aktywna żadna sesja Cast.
|
readwritenonatomicweak |
przycisk wstrzymania odtwarzania kolejki po zakończeniu odtwarzania bieżącego elementu;
|
readwritenonatomicweak |
przycisk „Dalej”;
Po kliknięciu tego przycisku odtwarzanie przechodzi do następnego elementu multimedialnego w kolejce. Przycisk będzie nieaktywny, jeśli operacja nie jest obsługiwana, nie ma obecnie załadowanych multimediów lub nie ma aktywnej sesji Cast.
|
readwritenonatomicweak |
przycisk „Wstecz”;
Po kliknięciu tego przycisku odtwarzanie przechodzi do poprzedniego elementu multimedialnego w kolejce. Przycisk będzie nieaktywny, jeśli operacja nie jest obsługiwana, nie ma obecnie załadowanych multimediów lub nie ma aktywnej sesji Cast.
|
readwritenonatomicweak |
Przycisk przełączania dostępnych trybów powtarzania kolejki.
(Patrz GCKMediaRepeatMode). Wywołujący powinien ustawić odpowiednie ikony dla stanów przycisku UIControlStateNormal (powtarzanie wyłączone), GCKUIControlStateRepeatSingle, GCKUIControlStateRepeatAll i GCKUIControlStateShuffle. Stan przycisku jest automatycznie aktualizowany, aby odzwierciedlać bieżący tryb powtarzania kolejki na odbiorniku. Kliknięcie przycisku powoduje przejście do następnego trybu powtarzania w kolejności:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
Przycisk będzie nieaktywny, jeśli nie ma obecnie aktywnej sesji Cast.
|
readwritenonatomicweak |
Suwak do wyświetlania i zmiany bieżącej pozycji strumienia.
Gdy użytkownik zmieni wartość suwaka, pozycja strumienia aktualnie załadowanego pliku multimedialnego zostanie zaktualizowana na urządzeniu odbierającym. Podczas odtwarzania multimediów na odbiorniku wartość suwaka jest aktualizowana w czasie rzeczywistym, aby odzwierciedlać bieżącą pozycję strumienia. Suwak będzie wyłączony, jeśli aktualnie załadowane multimedia nie obsługują przewijania, jeśli nie są załadowane żadne multimedia lub jeśli nie jest aktywna żadna sesja Cast.
|
readwritenonatomicweak |
Widok wyświetlający bieżący postęp strumienia.
Podczas odtwarzania multimediów na odbiorniku wartość widoku jest aktualizowana w czasie rzeczywistym, aby odzwierciedlać bieżącą pozycję strumienia. Widok zostanie wyłączony, jeśli aktualnie wczytane multimedia to transmisja na żywo, jeśli nie są wczytane żadne multimedia lub jeśli nie jest aktywna żadna sesja Cast.
|
readwritenonatomicweak |
Etykieta wyświetlająca bieżącą pozycję transmisji w minutach i sekundach.
Jeśli nie ma obecnie załadowanych multimediów lub nie jest aktywna żadna sesja przesyłania, etykieta wyświetla zlokalizowaną formę „--:--”.
|
readwritenonatomicweak |
Etykieta wyświetlająca bieżący czas trwania transmisji w minutach i sekundach.
Jeśli aktualnie załadowane multimedia nie mają czasu trwania (np. transmisja na żywo), nie są załadowane żadne multimedia lub nie jest aktywna żadna sesja Cast, etykieta wyświetla zlokalizowaną formę „--:--”.
|
readwritenonatomicweak |
Etykieta wyświetlająca pozostały czas transmisji (czas trwania minus pozycja) w minutach i sekundach.
Jeśli aktualnie załadowane multimedia nie mają czasu trwania (np. transmisja na żywo), nie są załadowane żadne multimedia lub nie jest aktywna żadna sesja Cast, etykieta wyświetla zlokalizowaną formę „--:--”.
|
readwritenonatomicstrong |
kontroler pozycji strumienia,
Używany jako zastępczy element interfejsu niestandardowej pozycji strumienia lub interfejsu przewijania dostarczanego przez aplikację. Aby dowiedzieć się więcej, zobacz GCKUIStreamPositionController.
- Od
- 3.4
|
readwritenonatomicassign |
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.
|
readwritenonatomicweak |
Przycisk do wybierania ścieżek audio lub napisów standardowych bądź dla niesłyszących.
Gdy użytkownik kliknie przycisk, wyświetli się interfejs wyboru ścieżek multimedialnych. Przycisk będzie nieaktywny, jeśli aktualnie załadowane multimedia nie mają żadnych ścieżek multimedialnych, które można wybrać, lub jeśli nie są załadowane żadne multimedia, lub jeśli nie ma aktywnej sesji Cast.
|
readwritenonatomicweak |
Etykieta do wyświetlania napisów do aktualnie wczytanych multimediów.
Jeśli w metadanych nie ma pola napisów, etykieta wyświetli najbardziej odpowiednie pole metadanych na podstawie typu treści, np. nazwę studia w przypadku filmu lub nazwę wykonawcy w przypadku utworu muzycznego.
|
readwritenonatomicweak |
Widok wskaźnika aktywności informujący, że media są w stanie ładowania.