अगर आपका ऐप्लिकेशन सर्वर, XMPP कनेक्शन सर्वर प्रोटोकॉल को लागू करता है, तो वह उपयोगकर्ता के डिवाइस से क्लाउड पर अपस्ट्रीम मैसेज पा सकता है. अपस्ट्रीम मैसेज शुरू करने के लिए, क्लाइंट ऐप्लिकेशन एक अनुरोध भेजता है. इस अनुरोध में ये चीज़ें शामिल होती हैं:
SENDER_ID@fcm.googleapis.comफ़ॉर्मैट में, ईमेल पाने वाले ऐप्लिकेशन सर्वर का पता.- मैसेज आईडी, जो हर भेजने वाले आईडी के लिए यूनीक होना चाहिए.
- मैसेज का डेटा, जिसमें मैसेज के पेलोड के की-वैल्यू पेयर शामिल होते हैं.
यह डेटा मिलने पर, FCM ऐप्लिकेशन सर्वर पर भेजने के लिए एक XMPP स्टैंश बनाता है. इसमें, डिवाइस और ऐप्लिकेशन के बारे में कुछ अतिरिक्त जानकारी जोड़ी जाती है.
Unity क्लाइंट ऐप्लिकेशन से अपस्ट्रीम मैसेज भेजना
सर्वर पर अपस्ट्रीम मैसेज भेजने के लिए, Unity क्लाइंट ऐप्लिकेशन एक मैसेज बनाता है और Send को कॉल करता है, जैसा कि दिखाया गया है:
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);
where:
message.To,SENDER_ID@fcm.googleapis.comफ़ॉर्मैट में, ईमेल पाने वाले ऐप्लिकेशन सर्वर का पता है.message.MessageId, मैसेज का यूनीक आइडेंटिफ़ायर है. मैसेज पाने वाले सभी कॉलबैक की पहचान, इस मैसेज आईडी के आधार पर की जाती है.message.Data, स्ट्रिंग के तौर पर की और वैल्यू का मैप है.message.TimeToLiveसे यह पता चलता है कि डिवाइस के ऑफ़लाइन होने पर, संदेश को FCM स्टोरेज में कितनी देर (सेकंड में) तक रखा जाना चाहिए. अगर FCM, मैसेज को समयसीमा खत्म होने से पहले डिलीवर नहीं कर पाता है, तो वह क्लाइंट को सूचना भेजता है.
FCM क्लाइंट लाइब्रेरी, क्लाइंट ऐप्लिकेशन पर मैसेज को कैश मेमोरी में सेव करती है और क्लाइंट के पास ऐक्टिव सर्वर कनेक्शन होने पर उसे भेजती है. मैसेज मिलने पर, FCM उसे ऐप्लिकेशन सर्वर पर भेजता है.
ऐप्लिकेशन सर्वर पर XMPP मैसेज पाना
जब FCM को किसी क्लाइंट ऐप्लिकेशन से अपस्ट्रीम मैसेजिंग कॉल मिलता है, तो वह अपस्ट्रीम मैसेज भेजने के लिए ज़रूरी XMPP स्टैंश जनरेट करता है.
FCM, category और from फ़ील्ड जोड़ता है. इसके बाद, ऐप्लिकेशन सर्वर को इस तरह का स्टैंश भेजता है:
<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 मैसेज भेजना
ऊपर दिए गए अपस्ट्रीम मैसेज के जवाब में, ऐप्लिकेशन सर्वर को एक ही कनेक्शन का इस्तेमाल करके, यूनीक मैसेज आईडी वाला एक ACK मैसेज भेजना होगा. अगर FCM को ACK नहीं मिलता है, तो हो सकता है कि वह ऐप्लिकेशन सर्वर को मैसेज भेजने की कोशिश फिर से करे.
<message id="">
<gcm xmlns="google:mobile:data">
{
"to":"REGID",
"message_id":"m-123"
"message_type":"ack"
}
</gcm>
</message>
अपस्ट्रीम मैसेज सिंटैक्स के बारे में ज़्यादा जानकारी के लिए, XMPP कनेक्शन सर्वर रेफ़रंस देखें.