Unity के साथ डाइनैमिक लिंक बनाना

Firebase Dynamic Links एपीआई की मदद से, छोटे या बड़े Dynamic Links बनाए जा सकते हैं. लिंक बनाने के लिए, एपीआई में कई वैकल्पिक पैरामीटर स्ट्रक्चर इस्तेमाल किए जा सकते हैं. पहले से जनरेट किए गए बड़े लिंक से भी छोटे लिंक बनाए जा सकते हैं. डाइनैमिक लिंक एपीआई, यहां दिए गए यूआरएल की तरह कोई यूआरएल जनरेट करेगा:

https://example.page.link/aSDf

शुरू करने से पहले

Firebase डाइनैमिक लिंक का इस्तेमाल करने से पहले, Firebase Dynamic Links, आपको ये काम करने होंगे:

  • अपने यूनिटी प्रोजेक्ट को रजिस्टर करें और उसे Firebase का इस्तेमाल करने के लिए कॉन्फ़िगर करें.

    • अगर आपका यूनिटी प्रोजेक्ट पहले से Firebase का इस्तेमाल करता है, तो वह पहले से ही Firebase के लिए रजिस्टर और कॉन्फ़िगर किया गया है.

    • अगर आपके पास कोई यूनिटी प्रोजेक्ट नहीं है, तो आप एक सैंपल ऐप्लिकेशन डाउनलोड कर सकते हैं.

  • अपने यूनिटी प्रोजेक्ट में, Firebase Unity SDK टूल (खास तौर पर, FirebaseDynamicLinks.unitypackage) जोड़ें.

ध्यान दें कि अपने यूनिटी प्रोजेक्ट में Firebase जोड़ने के लिए, आपको Firebase कंसोल और खुले हुए यूनिटी प्रोजेक्ट, दोनों में टास्क पूरे करने होंगे. उदाहरण के लिए, आपको कंसोल से Firebase कॉन्फ़िगरेशन फ़ाइलें डाउनलोड करनी होंगी. इसके बाद, उन्हें अपने यूनिटी प्रोजेक्ट में ले जाना होगा.

Dynamic Links यूआरआई प्रीफ़िक्स सेट करना

  1. Firebase कंसोल में, Dynamic Links सेक्शन खोलें.

  2. अगर आपने सेवा की शर्तें स्वीकार नहीं की हैं और आपके Dynamic Links के लिए यूआरआई प्रीफ़िक्स सेट नहीं किया है, तो ऐसा करने के लिए कहे जाने पर, यह काम करें.

    अगर आपके पास पहले से कोई Dynamic Links यूआरआई प्रीफ़िक्स है, तो उसे नोट कर लें. प्रोग्राम के ज़रिए Dynamic Links बनाते समय, आपको Dynamic Links यूआरआई प्रीफ़िक्स देना होगा.

  3. हमारा सुझाव है: डीप लिंक और फ़ॉलबैक लिंक में, अनुमति वाले यूआरएल पैटर्न तय करें. ऐसा करने से, बिना अनुमति वाले पक्ष ऐसे Dynamic Links नहीं बना पाएंगे जो आपके डोमेन से, उन साइटों पर रीडायरेक्ट होते हैं जिन्हें आप कंट्रोल नहीं करते. अनुमति वाले खास यूआरएल पैटर्न लेख पढ़ें.

Firebase कंसोल का इस्तेमाल करना

अगर आपको सिर्फ़ एक Dynamic Link जनरेट करना है, तो ऐसा टेस्ट करने के लिए या अपनी मार्केटिंग टीम के लिए किया जा सकता है. इससे टीम आसानी से ऐसा लिंक बना सकती है जिसका इस्तेमाल सोशल मीडिया पोस्ट जैसी चीज़ों में किया जा सकता है. इसके लिए, Firebase कंसोल पर जाएं और चरण-दर-चरण फ़ॉर्म भरकर, मैन्युअल तरीके से लिंक बनाएं.

कस्टम डोमेन

Dynamic Link's की ब्रैंडिंग पर ज़्यादा कंट्रोल पाने के लिए, goo.gl या page.link सबडोमेन के बजाय, अपना डोमेन इस्तेमाल किया जा सकता है. अपने प्रोजेक्ट के लिए कस्टम डोमेन सेट अप करने के लिए, यह तरीका अपनाएं.

Firebase Dynamic Links एपीआई का इस्तेमाल करना

पैरामीटर से बड़ा Dynamic Link बनाना

डाइनैमिक लिंक बनाने के लिए, DynamicLinkComponents ऑब्जेक्ट बनाएं. इसमें, अतिरिक्त कॉन्फ़िगरेशन के लिए कोई भी वैकल्पिक सदस्य सेट करें. इसके बाद, लिंक का यूआरएल पाने के लिए, LongDynamicLink प्रॉपर्टी ऐक्सेस करें.

यहां दिया गया छोटा उदाहरण, https://www.example.com/ के लिए एक बड़ा डाइनैमिक लिंक बनाता है. यह लिंक, Android पर आपके Android ऐप्लिकेशन com.example.android और iOS पर ऐप्लिकेशन com.example.ios के साथ खुलता है:

var components = new Firebase.DynamicLinks.DynamicLinkComponents(
    // The base Link.
    new System.Uri("https://www.example.com/"),
    // The dynamic link URI prefix.
    "https://example.page.link") {
      IOSParameters = new Firebase.DynamicLinks.IOSParameters("com.example.ios"),
      AndroidParameters = new Firebase.DynamicLinks.AndroidParameters(
        "com.example.android.package_name"),
    };
// do something with: components.LongDynamicLink

छोटा Dynamic Link बनाना

छोटा डाइनैमिक लिंक बनाने के लिए, पहले से जनरेट किए गए बड़े लिंक को Firebase.DynamicLinks.GetShortLinkAsync में पास करें या ऊपर बताए गए तरीके से DynamicLinkComponents बनाएं.

GetShortLinkAsync में, PathLength प्रॉपर्टी के साथ एक और DynamicLinkOptions कॉन्फ़िगरेशन पैरामीटर भी इस्तेमाल किया जा सकता है. इससे यह कंट्रोल किया जा सकता है कि लिंक कैसे जनरेट होना चाहिए. छोटा लिंक जनरेट करने के लिए, Firebase बैकएंड पर नेटवर्क का अनुरोध भेजना ज़रूरी है. इसलिए, GetShortLinkAsync तरीका एसिंक्रोनस तरीके से काम करता है. GetShortLinkAsync दिखाता है Task<Firebase.DynamicLinks.ShortDynamicLink>.

उदाहरण के लिए:

var options = new Firebase.DynamicLinks.DynamicLinkOptions {
  PathLength = DynamicLinkPathLength.Unguessable
};

Firebase.DynamicLinks.DynamicLinks.GetShortLinkAsync(components, options).ContinueWith(task => {
  if (task.IsCanceled) {
    Debug.LogError("GetShortLinkAsync was canceled.");
    return;
  }
  if (task.IsFaulted) {
    Debug.LogError("GetShortLinkAsync encountered an error: " + task.Exception);
    return;
  }

  // Short Link has been created.
  Firebase.DynamicLinks.ShortDynamicLink link = task.Result;
  Debug.LogFormat("Generated short link {0}", link.Url);

  var warnings = new System.Collections.Generic.List<string>(link.Warnings);
  if (warnings.Count > 0) {
    // Debug logging for warnings generating the short link.
  }
});

ऊपर दिए गए उदाहरण में, Lambda एक्सप्रेशन का इस्तेमाल किया गया है. यह एक्सप्रेशन, टास्क पूरा होने पर ट्रिगर होता है.