Firebase Cloud Messaging (FCM)

Firebase Cloud Messaging V1 anlık bildirimlerini Delphi'den gönderin. Hizmet hesabı JWT imzalama, OAuth 2.0 token değişimi ve tipli FCM mesaj oluşturma tek bir bileşende.

TsgcHTTPGoogleCloud_FCM_Client

FCM HTTP V1 istemcisi — Google hizmet hesabı JSON'unuzu yükler, bir RS256 JWT imzalar, bunu bir OAuth erişim token'ı ile değiştirir ve FCM mesajını fcm.googleapis.com/v1/projects/<id>/messages:send adresine POST eder.

Bileşen sınıfı

TsgcHTTPGoogleCloud_FCM_Client

Platformlar

Windows, macOS, Linux, iOS, Android

Sürüm

Standard / Professional / Enterprise

Hizmet hesabını yükleyin, push gönderin

Firebase hizmet hesabı JSON'unuzu yükleyin, proje kimliğini ayarlayın, ardından FCM yüküyle (token / topic / condition) SendMessage çağırın.

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");

İçeriğinde neler var

FCM HTTP v1 uç noktasını hedefler — eski fcm.googleapis.com/fcm/send uç noktası Google tarafından kullanımdan kaldırıldı.

Hizmet hesabı kimlik doğrulaması

Standart Firebase hizmet hesabı JSON'unu yükler, içerdiği özel anahtarla bir RS256 JWT imzalar, ardından bunu bir erişim token'ı için oauth2.googleapis.com/token adresinde değiştirir.

Token / konu / koşula gönderme

SendMessage aşırı yüklemeleri bir kayıt token'ı, bir konu adı (/topics/news) veya bir konu koşulu ifadesi kabul eder. SendBroadcast fan-out için bir konuyu hedefler.

Bildirim + veri yükleri

Hem notification nesnesi (title/body/image) hem de serbest biçimli data sözlüğü, platforma özgü geçersiz kılmalar dahil (Android android, iOS apns, Web webpush) sunulur.

Token önbellekleme

Erişim token'ları önbelleğe alınır ve yalnızca süresi dolduğunda yenilenir, böylece yüksek hacimli göndericiler OAuth uç noktasını yormaz.

HTTP taşıma

Projenin standart HTTP istemcisini kullanır — diğer herhangi bir HTTP isteğinde olduğu gibi proxy'ler, TLS ayarları ve hız sınırlayıcılarla eşleştirin.

Tipli hatalar

OnSendError HTTP ve FCM'ye özgü hataları (kayıtsız token, geçersiz argüman, kota aşıldı) bildirir, böylece ölü token'ları temizleyebilir veya geri çekilebilirsiniz.

Spesifikasyonlar ve referanslar

Bu bileşenin uyguladığı API için yetkili kaynaklar.

Belgeler ve Demolar

Bileşen referansına doğrudan bağlanın, kullanıma hazır demo projesini alın ve denemeyi indirin.

Çevrimiçi Yardım — FCM İstemcisi Bu bileşen için tam özellik, metot ve olay referansı.
Demo Projesi — Demos\20.HTTP_Protocol\03.Google Kullanıma hazır örnek proje. sgcWebSockets paketi içinde gelir — aşağıdan denemeyi indirin.
Teknik Belge (PDF) Delphi ve C++ Builder için özellikler, hızlı başlangıç, kod örnekleri ve birincil kaynak referansları — yalnızca bu bileşen.
Kullanıcı Kılavuzu (PDF) Kütüphanedeki her bileşeni kapsayan kapsamlı kılavuz.

Delphi'den FCM Push'ları Göndermeye Hazır mısınız?

Ücretsiz denemeyi indirin ve Firebase Cloud Messaging'i Delphi uygulamalarınıza entegre edin.