Wiadomości w aplikacji Firebase zapewniają przydatny zestaw wstępnie skonfigurowanych zachowań i typów wiadomości z domyślnym wyglądem i sposobem działania, ale w niektórych przypadkach możesz chcieć rozszerzyć zachowania i treść wiadomości. Funkcja Wiadomości w aplikacji umożliwia dodawanie działań do wiadomości oraz dostosowywanie wyglądu i sposobu działania wiadomości.
Dodaj akcję do swojej wiadomości
Dzięki akcjom możesz używać wiadomości w aplikacji do kierowania użytkowników do witryny internetowej lub określonego ekranu w aplikacji.
Zaimplementuj procedurę obsługi głębokich linków
Firebase In-App Messaging wykorzystuje procedury obsługi linków do przetwarzania działań. SDK może korzystać z wielu procedur obsługi, więc jeśli Twoja aplikacja już je ma, Firebase In-App Messaging może z nich korzystać bez dalszej konfiguracji. Jeśli nie masz jeszcze modułu obsługi, możesz użyć linków dynamicznych Firebase. Aby dowiedzieć się więcej, przeczytaj artykuł Tworzenie linków dynamicznych na iOS .
Dodaj akcję do swojej wiadomości za pomocą konsoli Firebase
Gdy Twoja aplikacja będzie mieć moduł obsługi linków, możesz stworzyć kampanię zawierającą działanie. Otwórz konsolę Firebase w aplikacji Messaging i rozpocznij nową kampanię lub edytuj istniejącą kampanię. W tej kampanii podaj kartę , tekst przycisku i akcję przycisku , akcję obrazu lub akcję banera , gdzie akcja jest odpowiednim precyzyjnym linkiem.
Format akcji zależy od wybranego układu wiadomości. Modale otrzymują przyciski akcji z konfigurowalną treścią tekstu przycisku, kolorem tekstu i kolorem tła. Z drugiej strony obrazy i górne banery stają się interaktywne i po dotknięciu wywołują określoną akcję.
Zmodyfikuj wygląd i styl wiadomości
Funkcja przesyłania wiadomości w aplikacji Firebase umożliwia dostosowywanie wyświetlanych wiadomości w celu zmiany sposobu, w jaki aplikacja renderuje układ wiadomości, style czcionek, kształty przycisków i inne szczegóły. Istnieją dwa sposoby modyfikowania wyświetlanych komunikatów: modyfikowanie domyślnych komunikatów Firebase w aplikacji lub tworzenie od podstaw własnej biblioteki wyświetlania komunikatów.
Zmodyfikuj domyślne wyświetlacze
Najprostszym sposobem dostosowywania wiadomości jest zbudowanie domyślnego kodu wyświetlania wiadomości Firebase In-App Messaging.
Sklonuj repozytorium firebase-ios-sdk
Aby rozpocząć, sklonuj najnowszą wersję repozytorium firebase-ios-sdk
i otwórz katalog InAppMessaging .
Wybierz typy wiadomości, które chcesz zmodyfikować
Po sklonowaniu repozytorium możesz modyfikować dowolny lub wszystkie typy wiadomości Firebase In-App Messaging: Card
, Modal
, Banner
i ImageOnly
. Każdy typ odpowiada układowi wiadomości w procesie tworzenia kampanii Firebase In-App Messaging.
W związku z tym każdy typ ma dostęp do innego zestawu danych, określanego opcjami dostosowywania kampanii w konsoli Firebase:
Typ | tytułTekst | treść | kolor tekstu | kolor tła | Dane obrazu | Przycisk akcji | dodatkowy przycisk akcji |
---|---|---|---|---|---|---|---|
Karta | |||||||
Modalny | |||||||
Transparent | |||||||
Tylko obraz |
Zmodyfikuj kod renderowania wyświetlania komunikatów
Mając na uwadze ograniczenia typów wiadomości, możesz je dowolnie modyfikować. Możesz utworzyć baner wyświetlany na dole aplikacji, poruszać się po przycisku akcji w trybie modalnym, osadzić wiadomość w aplikacji w kanale użytkownika lub wprowadzić dowolną inną modyfikację, która sprawi, że komunikaty będą wyglądać i pasować do Twojej aplikacji .
Modyfikując wyświetlane komunikaty, należy zwrócić uwagę na dwie główne rzeczy:
- Katalogi typów wiadomości: każdy typ wiadomości ma oddzielny katalog z plikami określającymi logikę tego typu:
- Storyboard: Biblioteka
InAppMessaging
zawiera również plik.storyboard
, który pomaga zdefiniować interfejs użytkownika dla wszystkich trzech typów wiadomości:
Zmodyfikuj pliki w katalogach preferowanych typów wiadomości i odpowiednich sekcjach .storyboard
, aby utworzyć niestandardowe wyświetlacze wiadomości.
Zaktualizuj swój plik podfile, aby używać zmodyfikowanego kodu InAppMessaging
Aby funkcja Firebase In-App Messaging korzystała ze zmodyfikowanych komunikatów zamiast domyślnych, zaktualizuj swój plik pod, 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 komunikatów
Tworzenie interfejsu użytkownika do wyświetlania wiadomości nie jest ograniczone do pracy z biblioteką InAppMessaging
. Możesz także napisać własny kod od zera.
Zbuduj klasę, która implementuje protokół InAppMessagingDisplay
Firebase In-App Messaging 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 otrzymywanych wiadomości. Aby zbudować własną bibliotekę wyświetlania, napisz klasę implementującą protokół.
Definicja protokołu i dokumentacja dotycząca sposobu jego zgodności znajdują się w pliku FIRInAppMessagingDisplay.h
biblioteki InAppMessaging
.
Ustaw messageDisplayComponent
tak, aby korzystał z biblioteki wyświetlania wiadomości
InAppMessaging
używa swojej właściwości messageDisplayComponent
do określenia obiektu, który ma być używany podczas wyświetlania wiadomości. Ustaw tę właściwość na obiekt niestandardowej klasy wyświetlania komunikatów, aby funkcja Firebase In-App Messaging wiedziała, że może używać Twojej biblioteki do renderowania wiadomości:
InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance