Funkcja Firebase Wysyłanie wiadomości w aplikacji udostępnia przydatny zestaw wstępnie skonfigurowanych zachowań i typów wiadomości z domyślnym wyglądem i stylem, ale w niektórych przypadkach możesz rozszerzyć zachowanie i treść wiadomości. Funkcja Wysyłanie wiadomości w aplikacji pozwala dodawać działania do wiadomości i dostosowywać wygląd i styl wiadomości.
Dodaj działanie do wiadomości
Dzięki akcjom możesz wykorzystać wiadomości w aplikacji, aby kierować użytkowników na stronę lub na określony ekran w aplikacji.
Implementacja modułu obsługi precyzyjnych linków
Funkcja Wysyłania wiadomości w aplikacji Firebase używa modułów obsługi linków do przetwarzania działań. Pakiet SDK może używać wielu modułów obsługi, więc jeśli Twoja aplikacja już ma taki moduł, funkcja wysyłania wiadomości w aplikacji może z niego korzystać bez konieczności dodatkowej konfiguracji. Jeśli nie masz jeszcze modułu obsługi, możesz korzystać z Linków dynamicznych Firebase. Więcej informacji znajdziesz w artykule Tworzenie linków dynamicznych w iOS.
Dodaj działanie do wiadomości za pomocą konsoli Firebase
Gdy aplikacja ma moduł obsługi linków, możesz utworzyć kampanię z działaniem. W konsoli Firebase otwórz Wiadomości i rozpocznij nową kampanię lub edytuj już istniejącą. Podaj w niej kartę, tekst przycisku i działanie przycisku, działanie związane z obrazem lub działanie banera, które stanowią odpowiedni precyzyjny link.
Format czynności zależy od wybranego układu wiadomości. W oknach modalnych znajdują się przyciski poleceń z dostosowywanym tekstem przycisku, kolorem tekstu i kolorem tła. Obrazy i górne banery z kolei stają się interaktywne i po kliknięciu wywołują określone działanie.
Modyfikowanie wyglądu i stylu wiadomości
Funkcja Firebase Wysyłanie wiadomości w aplikacji umożliwia dostosowanie wyświetlania wiadomości przez zmianę sposobu renderowania układu wiadomości, stylów czcionek, kształtów przycisków oraz innych szczegółów. Istnieją 2 sposoby modyfikowania sposobu wyświetlania wiadomości: można zmienić domyślny sposób wyświetlania wiadomości w aplikacji Firebase lub utworzyć od podstaw własną bibliotekę wyświetlania wiadomości.
Zmodyfikuj wyświetlacze domyślne
Najprostszym sposobem dostosowania wiadomości jest wykorzystanie domyślnego kodu wyświetlania wiadomości w aplikacji Firebase.
Klonowanie repozytorium firebase-ios-sdk
Na początek skopiuj najnowszą wersję repozytorium firebase-ios-sdk
i otwórz katalog InAppMessaging.
Wybierz typy wiadomości do zmodyfikowania
W ramach sklonowania repozytorium możesz zmodyfikować dowolne lub wszystkie typy wiadomości Firebase Wysyłanie wiadomości w aplikacji: Card
, Modal
, Banner
i ImageOnly
. Każdy typ odpowiada układowi wiadomości w procesie tworzenia kampanii Firebase Wysyłanie wiadomości w aplikacji.
W związku z tym każdy typ ma dostęp do innego zbioru danych określonego przez opcje dostosowania kampanii w konsoli Firebase:
Typ | tytułTekst | Tekst główny | kolortekstu | backgroundColor | Dane_obrazów | Przycisk polecenia | Przycisk dodatkowego działania |
---|---|---|---|---|---|---|---|
Karta | |||||||
Okno modalne | |||||||
Baner | |||||||
Tylko obraz |
Modyfikowanie kodu renderowania wyświetlania wiadomości
Mając na uwadze ograniczenia dotyczące typów wiadomości, możesz dowolnie modyfikować te typy wiadomości. Możesz utworzyć baner, który będzie się wyświetlać u dołu aplikacji, poruszać się po przycisku polecenia w oknie, umieścić wiadomość w aplikacji w sekcji aktywności użytkownika i wprowadzić dowolną inną modyfikację, która dopasuje wygląd wiadomości do Twojej aplikacji.
Podczas modyfikowania wyświetlania wiadomości musisz zwrócić uwagę na 2 główne kwestie:
- Katalogi typów wiadomości: każdy typ wiadomości ma oddzielny katalog z plikami, które określają jego logikę:
- Storyboard: biblioteka
InAppMessaging
zawiera też plik.storyboard
, który pomaga zdefiniować interfejs dla wszystkich 3 typów wiadomości:
Zmodyfikuj pliki w katalogach preferowanych typów wiadomości i odpowiadających im sekcjach pliku .storyboard
, aby utworzyć komunikaty niestandardowe.
Zaktualizuj plik podfile, aby używał zmodyfikowanego kodu InAppMessaging
Jeśli chcesz, aby funkcja Firebase Wysyłanie wiadomości w aplikacji używała zmodyfikowanych widoków wiadomości zamiast domyślnych, zaktualizuj plik podfile, tak aby korzystał z dostosowanej biblioteki InAppMessaging
:
# Uncomment the next line to define a global platform for your project # platform :ios, '9.0' target 'YourProject' do # Comment the next line if you're not using Swift and don't want to use dynamic frameworks use_frameworks! # Pods for YourProject pod 'Firebase' # Remove the default InAppMessaging pod: # pod 'Firebase/InAppMessaging' # Overwrite it with a version that points to your local copy: pod `FirebaseInAppMessaging', :path => '~/Path/To/The/Cloned/Repo/' end
Utwórz własną bibliotekę wyświetlania wiadomości
Nie możesz tworzyć interfejsu do wyświetlania wiadomości przy użyciu biblioteki InAppMessaging
. Możesz też napisać własny kod od zera.
Tworzenie klasy implementującej protokół InAppMessagingDisplay
Funkcja Firebase Wysyłanie wiadomości w aplikacji używa klasy InAppMessaging
do obsługi komunikacji między serwerami Firebase a Twoją aplikacją. Ta klasa z kolei używa protokołu InAppMessagingDisplay
do wyświetlania odbieranych wiadomości.
Aby utworzyć własną bibliotekę wyświetlania, napisz klasę, która implementuje protokół.
Definicja protokołu i dokumentacja zgodności z nim znajduje się w pliku FIRInAppMessagingDisplay.h
w bibliotece InAppMessaging
.
Skonfiguruj aplikację messageDisplayComponent
tak, aby mogła korzystać z biblioteki wyświetlania wiadomości
InAppMessaging
używa właściwości messageDisplayComponent
do określenia, którego obiektu ma używać do wyświetlania wiadomości. Ustaw tę właściwość na obiekt klasy wyświetlania wiadomości, aby usługa Firebase Wiadomości w aplikacji wiedziała, że ma wykorzystać Twoją bibliotekę do renderowania wiadomości:
InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance