Dostosowywanie wiadomości Firebase w aplikacji

Funkcja Firebase Wysyłanie wiadomości w aplikacji zapewnia przydatny zestaw wstępnie skonfigurowanych zachowań wiadomości z domyślnym wyglądem i stylem, ale w niektórych przypadkach możesz i zwiększania zasięgu działań i treści wiadomości. Wysyłanie wiadomości w aplikacji umożliwia dodawanie działań a także dostosować wygląd i styl wiadomości.

Dodaj działanie do wiadomości

Dzięki akcjom możesz wykorzystać wiadomości w aplikacji do kierowania użytkowników lub na konkretnym ekranie w aplikacji.

Funkcja Wysyłania wiadomości w aplikacji Firebase używa modułów obsługi linków do przetwarzania działań. Pakiet SDK może korzystać z wielu modułów obsługi, więc jeśli Twoja aplikacja już go ma, funkcja Wysyłanie wiadomości w aplikacji z niego można korzystać bez dodatkowej konfiguracji. Jeśli jeszcze tego nie zrobiłeś modułu obsługi, możesz używać Linków dynamicznych Firebase. Więcej informacji: Tworzenie linków dynamicznych w iOS.

Dodaj działanie do wiadomości za pomocą konsoli Firebase

Gdy aplikacja ma już moduł obsługi linków, możesz przygotować kampanię działanie. Otwórz konsolę Firebase, aby: Wiadomości, i utworzyć nową kampanię lub edytować istniejącą. W tej kampanii podaj Karta, Tekst przycisku i Działanie przycisku, Działanie dotyczące obrazu lub Baner action, gdzie działanie jest odpowiednim precyzyjnym linkiem.

Format czynności zależy od wybranego układu wiadomości. Mody: przyciski poleceń z dostosowywaną treścią przycisku, kolorem tekstu i tłem; koloru. Obrazy i górne banery z kolei stają się interaktywne i wywołują określone działanie po kliknięciu.

Modyfikowanie wyglądu i stylu wiadomości

Funkcja Firebase Wysyłanie wiadomości w aplikacji umożliwia dostosowanie wyświetlania wiadomości w celu zmiany sposobu renderowania aplikacji wiadomości układ, style czcionek, kształty przycisków i inne szczegóły. Dostępne są 2 sposoby modyfikacji wyświetlania wiadomości: modyfikacja domyślnego ustawienia funkcji Wysyłania wiadomości w aplikacji za pomocą Firebase lub utwórz od podstaw własną bibliotekę wyświetlania wiadomości.

Uwaga: ta usługa nie jest dostępna na urządzeniach z systemem macOS, Mac Catalyst, App Clip i WatchOS.

Zmodyfikuj wyświetlacze domyślne

Najprostszym sposobem na dostosowanie komunikatów jest tworzenie Domyślny kod wyświetlania wiadomości w funkcji Firebase Wysyłanie wiadomości w aplikacji.

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ład wiadomości w procesie tworzenia kampanii Wysyłania wiadomości w aplikacji Firebase.

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 je swobodnie modyfikować. w dowolnym momencie. Możesz utworzyć baner wyświetlany u dołu aplikacji, poruszać się po przycisku polecenia w oknie, umieścić wiadomość w aplikacji kanału ani żadnych innych modyfikacji, które powodują, że komunikaty wygląd i styl do 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. za pomocą plików, które określają logikę tego typu:
  • Scenorys: biblioteka InAppMessaging zawiera też element .storyboard który pozwala zdefiniować interfejs dla wszystkich 3 typów wiadomości:

Zmodyfikuj pliki w preferowanych typach wiadomości i odpowiadające im katalogi .storyboard, aby utworzyć niestandardowe ekrany z komunikatami.

Zaktualizuj plik podfile, aby używał zmodyfikowanego kodu InAppMessaging

Aby funkcja Firebase Wysyłanie wiadomości w aplikacji używała zmodyfikowanych komunikatów zamiast domyślnych zaktualizuj plik podfile, 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
Gdy to zrobisz, możesz zaktualizować pody, przebudować aplikację i wyświetlać nowe, wyświetlany komunikat.

Utwórz własną bibliotekę wyświetlania wiadomości

Nie musisz ograniczać się do pracy z biblioteki InAppMessaging, aby tworzyć UI do wyświetlania wiadomości. 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 serwerów Firebase i aplikacji. Klasa z kolei korzysta z funkcji 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 znajdują się w Plik FIRInAppMessagingDisplay.h z biblioteki InAppMessaging.

Skonfiguruj aplikację messageDisplayComponent tak, aby mogła korzystać z biblioteki wyświetlania wiadomości

Aplikacja InAppMessaging używa: messageDisplayComponent do określania, który obiekt do wyświetlania wiadomości. Ustaw tę właściwość na obiekt niestandardowy tak aby funkcja wyświetlania wiadomości w aplikacji Firebase używała Twojej biblioteki do renderowania wiadomości:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance