Unity istemci uygulamasından yukarı akış mesajları gönderme

Uygulama sunucunuz XMPP Bağlantı Sunucusu protokolünü uyguluyorsa kullanıcının cihazından buluta gelen iletileri alabilir. İstemci uygulaması, bir yukarı akış mesajı başlatmak için aşağıdakileri içeren bir istek gönderir:

• Alıcı uygulama sunucusunun SENDER_ID@fcm.googleapis.com biçimindeki adresi.
• Her gönderen kimliği için benzersiz olması gereken bir ileti kimliği.
• Mesajın yükü olan anahtar/değer çiftlerini içeren mesaj verileri.

FCM, bu verileri aldığında uygulama sunucusuna gönderilecek bir XMPP dizesi oluşturur ve gönderen cihaz ve uygulama hakkında bazı ek bilgiler ekler.

Unity istemci uygulamasından yayın mesajı gönderme

Sunucuya akış yönünde mesaj göndermek için bir Unity istemci uygulaması bir mesaj oluşturur ve gösterildiği gibi Send çağrısı yapar:

Firebase.Messaging.Message message;
message.To = SENDER_ID + "@fcm.googleapis.com";
message.MessageId = get_unique_message_id();
message.Data("my_message", "Hello World");
message.Data("my_action", "SAY HELLO");
message.TimeToLive = kTimetoLive;
Firebase.Messaging.FirebaseMessaging.Send(message);

Bu örnekte:

• message.To, alıcı uygulama sunucusunun SENDER_ID@fcm.googleapis.com biçimindeki adresidir.

• message.MessageId, benzersiz bir ileti tanımlayıcısıdır. Tüm mesaj alıcı geri çağırmaları bu mesaj kimliğine göre tanımlanır.

• message.Data, anahtarların ve değerlerin dize olarak eşlendiği bir haritadır.

• message.TimeToLive, cihaz çevrimdışıysa mesajın FCM depolama alanında ne kadar süre (saniye cinsinden) tutulacağını belirtir. FCM, bu süre dolmadan iletiyi teslim edemezse istemciye geri bildirim gönderir.

FCM istemci kitaplığı, mesajı istemci uygulamasında önbelleğe alır ve istemcinin etkin bir sunucu bağlantısı olduğunda gönderir. FCM, iletiyi aldıktan sonra uygulama sunucusuna gönderir.

Uygulama sunucusunda XMPP mesajları alma

FCM, bir istemci uygulamasından yukarı akış mesajlaşma çağrısı aldığında, yukarı yayın mesajını göndermek için gereken XMPP dizesini oluşturur. FCM, category ve from alanlarını ekledikten sonra uygulama sunucusuna aşağıdaki gibi bir dize gönderir:

<message id="">
  <gcm xmlns="google:mobile:data">
  {
      "category":"com.example.yourapp", // to know which app sent it
      "data":
      {
          "hello":"world",
      },
      "message_id":"m-123",
      "from":"REGID"
  }
  </gcm>
</message>

ACK mesajı gönderme

Yukarıdaki gibi bir yukarı akış mesajına yanıt olarak, uygulama sunucusunun benzersiz mesaj kimliğini içeren bir ACK mesajı göndermek için aynı bağlantıyı kullanması gerekir. FCM bir ACK almazsa iletiyi uygulama sunucusuna göndermeyi yeniden deneyebilir.

<message id="">
  <gcm xmlns="google:mobile:data">
  {
      "to":"REGID",
      "message_id":"m-123"
      "message_type":"ack"
  }
  </gcm>
</message>

Yukarı akış mesajı söz dizimi hakkında daha fazla bilgi için XMPP Bağlantı Sunucusu Referansı'na bakın.