Możesz dostosować widżety przesyłania, ustawiając kolory, styl przycisków, tekst i wygląd miniatur, a także wybierając typy wyświetlanych przycisków.
Dostosuj motyw widżetu
Widżety platformy Cast obsługują protokół Apple UILook Protocol w UIKit, aby zmieniać wygląd widżetów w aplikacji, na przykład ich położenie lub obramowanie. Używaj tego protokołu, aby dostosować styl widżetów platformy Cast do stylu istniejących aplikacji.
Przykład przycisku Cast
GCKUICastButton.appearance().tintColor = UIColor.gray
[GCKUICastButton appearance].tintColor = [UIColor grayColor];
Dostosuj widżet bezpośrednio
Dostosuj widżet bezpośrednio za pomocą właściwości jego klasy nadrzędnej. Na przykład często dostosowuje się kolor GCKUICastButton
za pomocą właściwości tintColor:
.
Przykład przycisku Cast
castButton.tintColor = UIColor.gray
castButton.tintColor = [UIColor grayColor];
Wybieranie przycisków kontrolera
Zarówno klasa rozwiniętego kontrolera (GCKUIExpandedMediaControlsViewController
), jak i klasa minikontrolera (GCKUIMiniMediaControlsViewController
) zawierają pasek przycisków. Klienci mogą określić, które przyciski mają się na nich pojawiać. Jest to osiągane przez obie klasy zgodne ze standardem GCKUIMediaButtonBarProtocol
.
Na minipasku kontrolera są 3 gniazda na przyciski, które można skonfigurować:
SLOT SLOT SLOT
1 2 3
Na środku rozwiniętego paska kontrolera znajdują się stały przycisk przełączania odtwarzania/wstrzymywania i 4 gniazda do konfiguracji:
SLOT SLOT PLAY/PAUSE SLOT SLOT
1 2 BUTTON 3 4
Aplikacja może uzyskać odniesienie do rozwiniętego kontrolera za pomocą właściwości -[defaultExpandedMediaControlsViewController]
o wartości GCKCastContext
i utworzyć minikontroler za pomocą -[createMiniMediaControlsViewController]
.
Każdy boks może zawierać przycisk platformy lub przycisk niestandardowy albo być pusty. Lista przycisków sterujących platformy jest określona jako:
Typ przycisku | Opis |
---|---|
GCKUIMediaButtonTypeNone |
Nie umieszczaj przycisku w tym miejscu |
GCKUIMediaButtonTypeCustom |
Przycisk niestandardowy |
GCKUIMediaButtonTypePlayPauseToggle |
Przełącza między odtwarzaniem i wstrzymywaniem |
GCKUIMediaButtonTypeSkipPrevious |
Przechodzi do poprzedniego elementu w kolejce |
GCKUIMediaButtonTypeSkipNext |
Przechodzi do następnego elementu w kolejce |
GCKUIMediaButtonTypeRewind30Seconds |
Przewija odtwarzanie do tyłu o 30 sekund |
GCKUIMediaButtonTypeForward30Seconds |
Przewija odtwarzanie do przodu o 30 sekund |
GCKUIMediaButtonTypeMuteToggle |
Wycisza i wyłącza wyciszenie zdalnego odbiornika internetowego |
GCKUIMediaButtonTypeClosedCaptions |
Otwiera okno wyboru ścieżek tekstowych i audio |
Szczegółowy opis działania każdego przycisku znajdziesz w GCKUIMediaButtonBarProtocol.h
Dodaj przycisk w ten sposób, korzystając z metod na GCKUIMediaButtonBarProtocol
:
Aby dodać przycisk platformy do paska, wystarczy wywołanie
-[setButtonType:atIndex:]
.Aby dodać przycisk niestandardowy do paska, aplikacja musi wywołać metodę
-[setButtonType:atIndex:]
z wartościąbuttonType
ustawioną naGCKUIMediaButtonTypeCustom
, a następnie wywołać-[setCustomButton:atIndex:]
, przekazującUIButton
z tym samym indeksem.
Stosowanie stylów niestandardowych w aplikacji na iOS
Pakiet SDK Cast na iOS pozwala dostosować styl czcionki, kolor i obrazy elementów interfejsu domyślnych widżetów w aplikacji na iOS, aby nadać widokom wygląd i styl dostosowany do reszty aplikacji.
W tej sekcji dowiesz się, jak stosować style niestandardowe do dowolnych widżetów Cast lub ich grup.
Zastosowanie stylu do elementu interfejsu widżetu
W tej procedurze pokazano, jak ustawić kolor tekstu głównego na minikontrolerze aplikacji na czerwony.
W tabeli widoków i stylów znajdź nazwę widoku widżetu lub grupy widżetów, których styl chcesz określić. Nazwy grup są oznaczone symbolem ▼.
Przykład: widok widżetu
miniController
Na liście właściwości w odpowiedniej klasie stylu wymienionej w tej tabeli znajdź nazwy atrybutów, które chcesz zmienić.
Przykład:
bodyTextColor
to właściwość klasyGCKUIStyleAttributesMiniController
.Napisz kod.
Przykład:
// Get the shared instance of GCKUIStyle let castStyle = GCKUIStyle.sharedInstance() // Set the property of the desired cast widget. castStyle.castViews.mediaControl.miniController.bodyTextColor = UIColor.red // Refresh all currently visible views with the assigned styles. castStyle.apply()
// Get the shared instance of GCKUIStyle. GCKUIStyle *castStyle = [GCKUIStyle sharedInstance]; // Set the property of the desired cast widget. castStyle.castViews.mediaControl.miniController.bodyTextColor = [UIColor redColor]; // Refresh all currently visible views with the assigned styles. [castStyle applyStyle];
Za pomocą tego wzorca możesz stosować dowolny styl do dowolnego elementu interfejsu użytkownika widżetu.
Tabela widoków i stylów
Ta tabela zawiera 7 widoków widżetów i 3 grupy (oznaczone ikoną ▼), do których można stosować style.
Nazwa widoku | Typ | Klasa stylu |
---|---|---|
▼ castViews |
Grupa | GCKUIStyleAttributesCastViews |
▼ deviceControl |
Grupa | GCKUIStyleAttributesDeviceControl |
deviceChooser |
Widżet | GCKUIStyleAttributesDeviceChooser |
noDevicesAvailableController |
Widżet | GCKUIStyleAttributesNoDevicesAvailableController |
▼ connectionController |
Grupa | GCKUIStyleAttributesConnectionController |
navigation |
Widżet | GCKUIStyleAttributesConnectionNavigation |
toolbar |
Widżet | GCKUIStyleAttributesConnectionToolbar |
▼ mediaControl |
Grupa | GCKUIStyleAttributesMediaControl |
miniController |
Widżet | GCKUIStyleAttributesMiniController |
expandedController |
Widżet | GCKUIStyleAttributesExpandedController |
trackSelector |
Widżet | GCKUIStyleAttributesTrackSelector |
instructions |
Widżet | GCKUIStyleAttributesInstructions |
Hierarchia stylów
Singiel GCKUIStyle
to punkt wejścia interfejsu API wszystkich ustawień stylu. Ma właściwość castViews
, która stanowi poziom główny hierarchii stylów, jak pokazano poniżej. Ten diagram przedstawia inny sposób patrzenia na te same widoki i grupy co w poprzedniej tabeli.
Styl możesz zastosować do pojedynczego widżetu lub grupy widżetów. Hierarchia stylów składa się z 3 grup widżetów: castViews, deviceControl i mediaControl. Prostokąt każdej grupy obejmuje widżety. Zastosowanie stylu do grupy spowoduje zastosowanie go do wszystkich widżetów w tej grupie.
Na przykład grupa castViews
umożliwia zastosowanie stylu do wszystkich widżetów, a grupa deviceControl
– do 3 widżetów sterujących urządzeniami. Widżet instructions
nie należy do żadnej grupy.
castViews | ||||||||||
deviceControl | mediaControl | |||||||||
instrukcje |
urządzenie Selektor |
Ekran noDeviceAvailable |
połączenie Sterownik |
mini Kontroler |
rozszerzony Kontroler |
ścieżka Selektor |
||||
nawigacja / pasek narzędzi |
||||||||||
Przypis: nazwy widżetów na tym diagramie wyświetlane w 2 wierszach powinny być zapisane w kodzie jako jedno słowo, w jednym wierszu, bez spacji. np. pole device Chooser
powinno być zapisane deviceChooser
. Najedź kursorem na obrazy,
aby je powiększyć.