إنشاء روابط ديناميكية مع الوحدة

يمكنك إنشاء روابط ديناميكية قصيرة أو طويلة باستخدام Firebase Dynamic Links API. تأخذ API العديد من هياكل المعلمات الاختيارية لبناء الروابط. يمكن أيضًا إنشاء روابط قصيرة من رابط طويل تم إنشاؤه مسبقًا. ستنشئ واجهة برمجة تطبيقات الروابط الديناميكية عنوان URL مثل ما يلي:

https://example.page.link/aSDf

قبل ان تبدأ

قبل أن تتمكن من استخدام Firebase دينامية سريعة ، تحتاج إلى:

  • سجل مشروع Unity الخاص بك وقم بتكوينه لاستخدام Firebase.

    • إذا كان مشروع Unity الخاص بك يستخدم Firebase بالفعل ، فهذا يعني أنه تم تسجيله وتهيئته بالفعل لـ Firebase.

    • إذا لم يكن لديك مشروع الوحدة، يمكنك تحميل التطبيق عينة .

  • إضافة Firebase الوحدة SDK (على وجه التحديد، FirebaseDynamicLinks.unitypackage ) لمشروع الوحدة الخاصة بك.

ملاحظة أن إضافة Firebase لمشروع الوحدة ديك تتضمن المهام سواء في وحدة التحكم Firebase وفي مشروع الوحدة مفتوحة (على سبيل المثال، يمكنك تحميل ملفات التكوين Firebase من وحدة التحكم، ثم نقلها إلى مشروع الوحدة الخاصة بك).

قم بتعيين بادئة URI للروابط الديناميكية

  1. في وحدة تحكم Firebase، فتح الباب الحيوي الوصلات.

  2. إذا لم تكن قد وافقت بالفعل على شروط الخدمة وقمت بتعيين بادئة URI للارتباطات الديناميكية الخاصة بك ، فقم بذلك عندما يُطلب منك ذلك.

    إذا كان لديك بالفعل بادئة URI للروابط الديناميكية ، فقم بتدوينها. تحتاج إلى توفير بادئة URI للارتباطات الديناميكية عند إنشاء روابط ديناميكية برمجيًا.

  3. الموصى بها: تحديد أنماط URL المسموح بها في الروابط العميقة والروابط تراجعية. من خلال القيام بذلك ، فإنك تمنع الأطراف غير المصرح لها من إنشاء روابط ديناميكية تعيد التوجيه من نطاقك إلى مواقع لا تتحكم فيها. رؤية أنماط البيضاء URL .

استخدم وحدة تحكم Firebase

إذا كنت تريد أن تولد ارتباط ديناميكي واحد، سواء لأغراض الاختبار، أو لفريق التسويق الخاص بك بسهولة لإنشاء ارتباط التي يمكن استخدامها في شيء من هذا القبيل وظيفة وسائل الإعلام الاجتماعية، فإن أبسط طريقة أن يكون لزيارة وحدة Firebase وإنشاء واحد يدويًا باتباع النموذج خطوة بخطوة.

المجالات المخصصة

هل يمكن أن يكون سيطرة أكبر على الخاص بك العلامة التجارية الارتباط الحيوي باستخدام اسم النطاق الخاص بك بدلا من goo.gl أو page.link فرعي. اتبع هذه التعليمات لإعداد نطاق مخصص للمشروع الخاص بك.

استخدام Firebase Dynamic Links API

إنشاء ارتباط ديناميكي طويل من المعلمات

لإنشاء ارتباط ديناميكي، إنشاء DynamicLinkComponents الاعتراض، وتحديد أي من أعضاء اختياري لتكوين إضافي، ومن ثم الوصول إلى LongDynamicLink الخاصية للحصول على URL الارتباط.

يُنشئ المثال الأدنى التالي رابطًا ديناميكيًا طويلاً إلى https://www.example.com/ يفتح مع تطبيق Android الخاص بك com.example.android على Android وتطبيق com.example.ios على 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

إنشاء ارتباط ديناميكي قصير

لإنشاء الارتباط الحيوي قصيرة، وتمرير وصلة طويلة إنشاؤه مسبقا ل Firebase.DynamicLinks.GetShortLinkAsync أو بناء DynamicLinkComponents بنفس الطريقة المذكورة أعلاه.

GetShortLinkAsync يأخذ اختياريا اضافية DynamicLinkOptions المعلمة التكوين مع PathLength الملكية، مما يسمح لك للسيطرة على الكيفية التي ينبغي أن إنشاء الارتباط. يتطلب الجيل رابط قصير طلب الشبكة إلى الواجهة الخلفية 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 الذي يتم تشغيله عند اكتمال المهمة.