Firebase Cloud Messaging (FCM)

Wysyłaj powiadomienia push Firebase Cloud Messaging V1 z Delphi. Podpisywanie JWT konta usługi, wymiana tokenów OAuth 2.0 i typowana konstrukcja wiadomości FCM — wszystko w jednym komponencie.

TsgcHTTPGoogleCloud_FCM_Client

Klient FCM HTTP V1 — ładuje JSON konta usługi Google, podpisuje JWT RS256, wymienia go na token dostępu OAuth i wysyła wiadomość FCM do fcm.googleapis.com/v1/projects/<id>/messages:send.

Klasa komponentu

TsgcHTTPGoogleCloud_FCM_Client

Platformy

Windows, macOS, Linux, iOS, Android

Edycja

Standard / Professional / Enterprise

Załaduj konto usługi, wyślij push

Załaduj JSON konta usługi Firebase, ustaw identyfikator projektu, a następnie wywołaj SendMessage z ładunkiem FCM (token / temat / warunek).

uses
  sgcHTTP;

var
  FCM: TsgcHTTPGoogleCloud_FCM_Client;
begin
  FCM := TsgcHTTPGoogleCloud_FCM_Client.Create(nil);
  FCM.GoogleCloudOptions.ServiceAccountJSON.LoadFromFile('service-account.json');

  FCM.SendMessage(
    'fcm-device-token-here',
    'Hello from Delphi',
    'This is a test FCM push');
end;
// uses: sgcHTTP
TsgcHTTPGoogleCloud_FCM_Client *FCM = new TsgcHTTPGoogleCloud_FCM_Client(this);
FCM->GoogleCloudOptions->ServiceAccountJSON->LoadFromFile("service-account.json");

FCM->SendMessage(
  "fcm-device-token-here",
  "Hello from Delphi",
  "This is a test FCM push");

Co jest w środku

Używa punktu końcowego FCM HTTP v1 — starszy punkt końcowy fcm.googleapis.com/fcm/send został wycofany przez Google.

Uwierzytelnianie konta usługi

Ładuje standardowy JSON konta usługi Firebase, podpisuje JWT RS256 zawartym kluczem prywatnym, a następnie wymienia go w oauth2.googleapis.com/token na token dostępu.

Wysyłanie do tokenu / tematu / warunku

Przeciążenia SendMessage przyjmują token rejestracyjny, nazwę tematu (/topics/news) lub wyrażenie warunkowe tematu. SendBroadcast kieruje wiadomość do tematu dla wysyłki masowej.

Ładunki notification i data

Udostępnione są zarówno obiekt notification (title/body/image), jak i słownik data w dowolnej formie, wraz z nadpisaniami dla platform (Android android, iOS apns, Web webpush).

Buforowanie tokenów

Tokeny dostępu są buforowane i odświeżane tylko po wygaśnięciu, dzięki czemu nadawcy o dużym wolumenie nie przeciążają punktu końcowego OAuth.

Transport HTTP

Używa standardowego klienta HTTP projektu — łącz z serwerami proxy, ustawieniami TLS i ogranicznikami szybkości jak każde inne żądanie HTTP.

Typowane błędy

OnSendError raportuje błędy HTTP i specyficzne dla FCM (wyrejestrowany token, nieprawidłowy argument, przekroczony limit), abyś mógł usuwać martwe tokeny lub wycofać się.

Specyfikacje i źródła

Autorytatywne źródła API implementowanego przez ten komponent.

Dokumentacja i wersje demo

Przejdź do dokumentacji komponentu, pobierz gotowy projekt demonstracyjny i wersję próbną.

Pomoc online — klient FCM Pełna dokumentacja właściwości, metod i zdarzeń tego komponentu.
Projekt demonstracyjny — Demos\20.HTTP_Protocol\03.Google Gotowy do uruchomienia przykładowy projekt. Dołączony do pakietu sgcWebSockets — pobierz wersję próbną poniżej.
Dokument techniczny (PDF) Funkcje, szybki start, przykłady kodu dla Delphi i C++ Builder oraz odniesienia do źródeł pierwotnych — tylko ten komponent.
Podręcznik użytkownika (PDF) Kompleksowy podręcznik obejmujący każdy komponent biblioteki.

Gotowy, żeby wysyłać powiadomienia FCM z Delphi?

Pobierz bezpłatną wersję próbną i zintegruj Firebase Cloud Messaging ze swoimi aplikacjami Delphi.