Unity क्लाइंट ऐप्लिकेशन से अपस्ट्रीम मैसेज भेजें

चेतावनी: FCM XMPP और एचटीटीपी के पुराने वर्शन वाले एपीआई का इस्तेमाल करके मैसेज भेजने की सुविधा 20 जून, 2023 से बंद कर दी गई है. इसमें अपस्ट्रीम मैसेज भी शामिल हैं. साथ ही, जून 2024 से यह सुविधा हटा दी जाएगी. अगर लेगसी FCM भेजने वाले एपीआई का इस्तेमाल किया जा रहा है, तो हमारा सुझाव है कि आप एचटीटीपी v1 एपीआई पर माइग्रेट करें या भेजने के अनुरोध बनाने के लिए, एडमिन एसडीके टूल का इस्तेमाल करें.

अगर आपका ऐप्लिकेशन सर्वर, XMPP कनेक्शन सर्वर प्रोटोकॉल को लागू करता है, तो वह उपयोगकर्ता के डिवाइस से क्लाउड पर अपस्ट्रीम मैसेज पा सकता है. अपस्ट्रीम मैसेज शुरू करने के लिए, क्लाइंट ऐप्लिकेशन एक अनुरोध भेजता है. इस अनुरोध में ये चीज़ें शामिल होती हैं:

• [e-mail] फ़ॉर्मैट में, ईमेल पाने वाले ऐप्लिकेशन सर्वर का पता.
• मैसेज आईडी, जो हर भेजने वाले आईडी के लिए यूनीक होना चाहिए.
• मैसेज का डेटा, जिसमें मैसेज के पेलोड के की-वैल्यू पेयर शामिल होते हैं.

यह डेटा मिलने पर, 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, [e-mail] फ़ॉर्मैट में, ईमेल पाने वाले ऐप्लिकेशन सर्वर का पता है.

• 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>

हमारा सुझाव है कि हर सेकंड 500 मैसेज के लिए, कम से कम एक कनेक्शन होना चाहिए. अगर ऐप्लिकेशन सर्वर अपने पूरे ट्रैफ़िक को मैनेज करने के लिए ज़रूरत के मुताबिक कनेक्शन नहीं खोलता है, तो FCM अतिरिक्त अपस्ट्रीम मैसेज को छोड़ देता है.

ACK मैसेज भेजना

ऊपर दिए गए अपस्ट्रीम मैसेज के जवाब में, ऐप्लिकेशन सर्वर को यूनीक मैसेज आईडी वाला एक ACK मैसेज भेजने के लिए, उसी कनेक्शन का इस्तेमाल करना होगा. अगर FCM को ACK नहीं मिलता है, तो वह ऐप्लिकेशन सर्वर को मैसेज भेजने की कोशिश फिर से कर सकता है.

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

अपस्ट्रीम मैसेज सिंटैक्स के बारे में ज़्यादा जानकारी के लिए, XMPP कनेक्शन सर्वर रेफ़रंस देखें.