Omówienie

Kontroler do wyświetlania widoków UI używanych do kontrolowania lub wyświetlania stanu odtwarzania multimediów na odbiorniku Cast.

Aplikacja wywołująca rejestruje elementy sterujące związane z multimediami za pomocą kontrolera, ustawiając odpowiednie właściwości. Następnie kontroler odpowiada na zdarzenia dotyku na elementach sterujących, wydając odpowiednie polecenia multimedialne do odbiornika, a następnie aktualizuje elementy sterujące 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. Dodatkowo w trakcie przetwarzania żądania wyłącza ono wszystkie opcje.

Więcej informacji znajdziesz na stronie GCKUIMediaControllerDelegate dotyczącej protokołu przekazywania dostępu.

Sincé: 3,0

Dziedziczy NSObject.

Podsumowanie metody instancji
(instancetype)	- init
	Inicjuje instancję. Więcej...

(void)	- bindLabel:toMetadataKey:
	Wiąże etykietę UILabel z kluczem metadanych. Więcej...

(void)	- bindLabel:toMetadataKey:withFormatter:
	Wiąże etykietę UILabel z kluczem metadanych. Więcej...

(void)	- bindTextView:toMetadataKey:
	Powiązanie elementu UITextView z kluczem metadanych. Więcej...

(void)	- bindTextView:toMetadataKey:withFormatter:
	Powiązanie elementu UITextView z kluczem metadanych. Więcej...

(void)	- bindImageView:toImageHints:
	Powiązanie elementu UIImageView z instancją GCKUIImageHints. Więcej...

(void)	- unbindView:
	Usuwanie powiązania określonego widoku. Więcej...

(void)	- unbindAllViews
	Usuń powiązania wszystkich widoków. Więcej...

(GCKMediaRepeatMode)	- cycleRepeatMode
	Zmienia tryb powtarzania kolejki na następny tryb cyklu: Więcej...

(void)	- selectTracks
	Wygodna metoda wyświetlania interfejsu wyboru ścieżki audio. Więcej...

Podsumowanie usługi
id< GCKUIMediaControllerDelegate >	delegate
	Delegat do otrzymywania powiadomień od firmy GCKUIMediaController. Więcej...

GCKSession *	session
	Sesja powiązana z tym kontrolerem. Więcej...

BOOL	mediaLoaded
	Określa, czy na odbiorniku są obecnie wczytywane (lub wczytywane) multimedia. Więcej...

BOOL	hasCurrentQueueItem
	Określa, czy w kolejce znajduje się bieżący element. Więcej...

BOOL	hasLoadingQueueItem
	Czy element jest wstępnie wczytywany w kolejce. Więcej...

GCKMediaPlayerState	lastKnownPlayerState
	Najnowszy znany stan odtwarzacza multimediów. Więcej...

NSTimeInterval	lastKnownStreamPosition
	Najnowsza znana pozycja strumienia multimediów. Więcej...

UIButton *	playButton
	przycisk „Odtwórz”. Więcej...

UIButton *	pauseButton
	przycisk „Wstrzymaj”. Więcej...

GCKUIButton *	playPauseToggleButton
	Przycisk „Odtwórz/wstrzymaj”. Więcej...

GCKUIPlayPauseToggleController *	playPauseToggleController
	Przełącznik „Odtwórz/wstrzymaj”. Więcej...

UIButton *	stopButton
	przycisk „Zatrzymaj”. Więcej...

GCKUIButton *	forward30SecondsButton
	Przycisk do przewijania treści o 30 sekund do przodu. Więcej...

GCKUIButton *	rewind30SecondsButton
	Przycisk umożliwiający wyświetlenie 30 sekund wstecz odtwarzanego elementu multimedialnego. Więcej...

UIButton *	pauseQueueButton
	Przycisk do wstrzymywania odtwarzania kolejki po zakończeniu bieżącego elementu. Więcej...

UIButton *	nextButton
	Przycisk „Dalej”. Więcej...

UIButton *	previousButton
	przycisk „Wstecz”. Więcej...

GCKUIButton *	repeatModeButton
	Przycisk do przełączania się między dostępnymi trybami powtarzania kolejki. Więcej...

UISlider *	streamPositionSlider
	Suwak umożliwiający wyświetlanie i zmianę bieżącej pozycji strumienia. Więcej...

UIProgressView *	streamProgressView
	Widok pokazujący bieżący postęp transmisji. Więcej...

UILabel *	streamPositionLabel
	Etykieta służąca do wyświetlania bieżącej pozycji strumienia w minutach i sekundach. Więcej...

UILabel *	streamDurationLabel
	Etykieta wyświetlania bieżącego czasu trwania transmisji w minutach i sekundach. Więcej...

UILabel *	streamTimeRemainingLabel
	Etykieta pokazująca pozostały czas transmisji (czas trwania pomniejszony o pozycję), podany w minutach i sekundach. Więcej...

GCKUIStreamPositionController *	streamPositionController
	Kontroler własności strumienia. Więcej...

BOOL	displayTimeRemainingAsNegativeValue
	Określa, czy pozostały czas transmisji jest wyświetlany jako wartość ujemna, np. „-1:23:45”. Więcej...

UIButton *	tracksButton
	Przycisk umożliwiający wybór ścieżek audio lub napisów. Więcej...

UILabel *	smartSubtitleLabel
	Etykieta wyświetlania podtytułu obecnie wczytanych multimediów. Więcej...

UIActivityIndicatorView *	mediaLoadingIndicator
	Widok wskaźnika aktywności informujący o stanie multimediów. Więcej...

Szczegóły metody

- (instancetype) init

Inicjuje instancję.

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

Wiąże etykietę UILabel z kluczem metadanych.

W widoku pojawi się bieżąca wartość odpowiedniego pola metadanych.

Lista wstępnie zdefiniowanych kluczy metadanych znajduje się w sekcji 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 etykietę UILabel z kluczem metadanych.

W widoku pojawi się bieżąca wartość odpowiedniego pola metadanych.

Lista wstępnie zdefiniowanych kluczy metadanych znajduje się w sekcji 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

Powiązanie elementu UITextView z kluczem metadanych.

W widoku pojawi się bieżąca wartość odpowiedniego pola metadanych.

Lista wstępnie zdefiniowanych kluczy metadanych znajduje się w sekcji GCKMediaMetadata.

Parameters

textView	The UITextView that will display the value.
key	The metadata key.

- (void) bindTextView:	(UITextView *)	textView
toMetadataKey:	(NSString *)	key
withFormatter:	(GCKUIValueFormatter)	formatter

Powiązanie elementu UITextView z kluczem metadanych.

W widoku pojawi się bieżąca wartość odpowiedniego pola metadanych.

Lista wstępnie zdefiniowanych kluczy metadanych znajduje się w sekcji 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

Powiązanie elementu UIImageView z instancją GCKUIImageHints.

Obecnie używany interfejs UIImagePicker służy do wybierania obrazu z metadanych widoku.

Parameters

imageView	The UIImageView that will display the selected image.
imageHints	The image hints.

- (void) unbindView: (UIView *) view

Usuwanie powiązania określonego widoku.

Parameters

view	The view to unbind.

- (void) unbindAllViews

Usuń powiązania wszystkich widoków.

- (GCKMediaRepeatMode) cycleRepeatMode

Zmienia tryb powtarzania kolejki na następny tryb cyklu:

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

Zwraca: Nowy tryb powtarzania.

- (void) selectTracks

Wygodna metoda wyświetlania interfejsu wyboru ścieżki audio.

Szczegóły usługi

- (id<GCKUIMediaControllerDelegate>) delegate

readwritenonatomicweak

Delegat do otrzymywania powiadomień od firmy GCKUIMediaController.

- (GCKSession*) session

readnonatomicstrong

Sesja powiązana z tym kontrolerem.

- (BOOL) mediaLoaded

readnonatomicassign

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

Jeśli żadna sesja Cast nie jest aktywna, będzie to NO.

- (BOOL) hasCurrentQueueItem

readnonatomicassign

Określa, czy w kolejce znajduje się bieżący element.

- (BOOL) hasLoadingQueueItem

readnonatomicassign

Czy element jest wstępnie wczytywany w kolejce.

- (GCKMediaPlayerState) lastKnownPlayerState

readnonatomicassign

Najnowszy 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 poprzedniej sesji, będzie to GCKMediaPlayerStateUnknown.

- (NSTimeInterval) lastKnownStreamPosition

readnonatomicassign

Najnowsza 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 poprzedniej sesji, będzie to kGCKInvalidTimeInterval.

- (UIButton*) playButton

readwritenonatomicweak

przycisk „Odtwórz”.

Po naciśnięciu przycisku rozpocznie się odtwarzanie lub wznowienie odtwarzania aktualnie wczytanych multimediów na odbiorniku. Przycisk jest nieaktywny, jeśli trwa już odtwarzanie, nie ma obecnie żadnych multimediów lub nie ma obecnie aktywnej sesji przesyłania.

- (UIButton*) pauseButton

readwritenonatomicweak

przycisk „Wstrzymaj”.

Po kliknięciu przycisku odtwarzanie aktualnie wczytanych multimediów jest wstrzymane na odbiorniku. Przycisk jest wyłączony, jeśli obecnie wczytane multimedia nie obsługują wstrzymywania, gdy odtwarzanie nie jest w toku, jeśli obecnie nie ma żadnych załadowanych multimediów albo sesja Cast nie jest obecnie aktywna.

- (GCKUIButton*) playPauseToggleButton

readwritenonatomicweak

Przycisk „Odtwórz/wstrzymaj”.

Rozmówca powinien ustawić odpowiednie ikony stanu GCKUIControlStatePlay i GCKUIControlStatePause przycisku, na przykład ikonę „wstrzymana” i „stan odtwarzania”. Stan przycisku zmienia się automatycznie w związku z bieżącym stanem odtwarzania na odbiorniku. Po kliknięciu przycisku odtwarzanie aktualnie wczytanych multimediów zostanie wstrzymane lub wznowione na odbiorniku. Przycisk jest wyłączony, jeśli obecnie wczytane multimedia nie obsługują wstrzymywania, gdy odtwarzanie nie jest w toku lub wstrzymane, jeśli obecnie nie ma załadowanych multimediów albo brak aktywnej sesji przesyłania.

- (GCKUIPlayPauseToggleController*) playPauseToggleController

readwritenonatomicstrong

Przełącznik „Odtwórz/wstrzymaj”.

Jest używany jako niezależny interfejs przełącznika odtwarzania/wstrzymywania aplikacji. Aby dowiedzieć się więcej, zobacz GCKUIPlayPauseToggleController.

Sincé: 3,4

- (UIButton*) stopButton

readwritenonatomicweak

przycisk „Zatrzymaj”.

Kliknięcie tego przycisku powoduje zatrzymanie odtwarzania aktualnie wczytanych multimediów na odbiorniku. Przycisk jest nieaktywny, jeśli nie masz obecnie załadowanych multimediów lub nie jest aktywna żadna sesja przesyłania.

- (GCKUIButton*) forward30SecondsButton

readwritenonatomicweak

Przycisk do przewijania treści o 30 sekund do przodu.

Przycisk jest nieaktywny, jeśli nie masz obecnie załadowanych multimediów lub nie jest aktywna żadna sesja przesyłania.

- (GCKUIButton*) rewind30SecondsButton

readwritenonatomicweak

Przycisk umożliwiający wyświetlenie 30 sekund wstecz odtwarzanego elementu multimedialnego.

Przycisk jest nieaktywny, jeśli nie masz obecnie załadowanych multimediów lub nie jest aktywna żadna sesja przesyłania.

- (UIButton*) pauseQueueButton

readwritenonatomicweak

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

- (UIButton*) nextButton

readwritenonatomicweak

Przycisk „Dalej”.

Po kliknięciu przycisku odtwarzanie przechodzi do następnego elementu multimedialnego w kolejce. Jeśli przycisk nie jest obsługiwany lub obecnie nie są wczytywane żadne media albo sesja Cast nie jest obecnie aktywna, przycisk zostanie wyłączony.

- (UIButton*) previousButton

readwritenonatomicweak

przycisk „Wstecz”.

Po kliknięciu przycisku odtwarzanie przechodzi do poprzedniego elementu multimedialnego w kolejce. Jeśli przycisk nie jest obsługiwany lub obecnie nie są wczytywane żadne media albo sesja Cast nie jest obecnie aktywna, przycisk zostanie wyłączony.

- (GCKUIButton*) repeatModeButton

readwritenonatomicweak

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

(patrz GCKMediaRepeatMode). Rozmówca powinien ustawić odpowiednie ikony UIControlStateNormal (powtarzanie wyłączone), GCKUIControlStateRepeatSingle, GCKUIControlStateRepeatAll i GCKUIControlStateShuffle. Stan przycisku jest automatycznie aktualizowany, aby odzwierciedlić aktualny tryb powtarzania kolejki na odbiorniku. Kliknięcie przycisku powoduje przejście do następnego trybu powtarzania:

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

Jeśli obecnie nie jest aktywna żadna sesja przesyłania, przycisk zostanie wyłączony.

- (UISlider*) streamPositionSlider

readwritenonatomicweak

Suwak umożliwiający wyświetlanie i zmianę bieżącej pozycji strumienia.

Gdy użytkownik zmieni wartość suwaka, pozycja strumienia obecnie wczytanych multimediów zostanie zaktualizowana na odbiorniku. Podczas odtwarzania multimediów na odbiorniku wartość suwaka jest aktualizowana w czasie rzeczywistym, aby odpowiadała bieżącej pozycji w strumieniu. Suwak zostanie wyłączony, jeśli obecnie wczytane multimedia nie obsługują wyszukiwania, gdy żadne nośniki nie są obecnie wczytane lub sesja Cast nie jest obecnie aktywna.

- (UIProgressView*) streamProgressView

readwritenonatomicweak

Widok pokazujący bieżący postęp transmisji.

Podczas odtwarzania multimediów na odbiorniku wartość wyświetleń jest aktualizowana w czasie rzeczywistym tak, aby odpowiadała bieżącej pozycji w strumieniu. Widok zostanie wyłączony, jeśli obecnie wczytane multimedia są transmisją na żywo, jeśli obecnie nie ma żadnych załadowanych multimediów lub sesja przesyłania nie jest aktywna.

- (UILabel*) streamPositionLabel

readwritenonatomicweak

Etykieta służąca do wyświetlania bieżącej pozycji strumienia w minutach i sekundach.

Jeśli obecnie nie wczytano żadnych multimediów lub nie jest aktywna żadna sesja Cast, etykieta wyświetla zlokalizowaną formę „--:---”.

- (UILabel*) streamDurationLabel

readwritenonatomicweak

Etykieta wyświetlania bieżącego czasu trwania transmisji w minutach i sekundach.

Jeśli obecnie wczytane multimedia nie mają czasu trwania (np. transmisja na żywo), brak mediów lub obecnie nie jest aktywna żadna sesja, etykieta wyświetla zlokalizowaną formę „--:--”.

- (UILabel*) streamTimeRemainingLabel

readwritenonatomicweak

Etykieta pokazująca pozostały czas transmisji (czas trwania pomniejszony o pozycję), podany w minutach i sekundach.

Jeśli obecnie wczytane multimedia nie mają czasu trwania (np. transmisja na żywo), brak mediów lub obecnie nie jest aktywna żadna sesja, etykieta wyświetla zlokalizowaną formę „--:--”.

- (GCKUIStreamPositionController*) streamPositionController

readwritenonatomicstrong

Kontroler własności strumienia.

Używane jako podstawa dla niestandardowego położenia strumienia danych z aplikacji i/lub interfejsu przewijania. Aby dowiedzieć się więcej, zobacz GCKUIStreamPositionController.

Sincé: 3,4

- (BOOL) displayTimeRemainingAsNegativeValue

readwritenonatomicassign

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

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

- (UIButton*) tracksButton

readwritenonatomicweak

Przycisk umożliwiający wybór ścieżek audio lub napisów.

Po kliknięciu tego przycisku wyświetli się interfejs wyboru utworów. Przycisk jest nieaktywny, jeśli obecnie wczytane pliki multimedialne nie mają żadnych możliwych do wyboru ścieżek audio, nie ma obecnie żadnych załadowanych multimediów lub nie ma obecnie aktywnej sesji przesyłania.

- (UILabel*) smartSubtitleLabel

readwritenonatomicweak

Etykieta wyświetlania podtytułu obecnie wczytanych multimediów.

Jeśli w metadanych nie ma jawnie ustawionego pola z napisami, wytwórnia wyświetli najodpowiedniejsze pole na podstawie typu mediów, np. nazwę studia w przypadku filmu lub nazwę wykonawcy utworu audio.

- (UIActivityIndicatorView*) mediaLoadingIndicator

readwritenonatomicweak

Widok wskaźnika aktywności informujący o stanie multimediów.

Klasa GCKUIMediaController

Omówienie

Podsumowanie metody instancji

Podsumowanie usługi

Szczegóły metody

Szczegóły usługi