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

कहां:

• 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 कनेक्शन सर्वर रेफ़रंस देखें.