Dostosowanie interfejsu nadawcy w iOS

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

Swift
GCKUICastButton.appearance().tintColor = UIColor.gray
Objective-C
[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

Swift
castButton.tintColor = UIColor.gray
Objective-C
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ą na GCKUIMediaButtonTypeCustom, a następnie wywołać -[setCustomButton:atIndex:], przekazując UIButton 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.

  1. 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

  2. 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ść klasy GCKUIStyleAttributesMiniController.

  3. Napisz kod.

    Przykład:

Swift
// 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()
Objective-C
// 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ć.