إنشاء روابط ديناميكية باستخدام Unity

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

https://example.page.link/aSDf

قبل ان تبدأ

قبل أن تتمكن من استخدام Firebase Dynamic Links ، تحتاج إلى:

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

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

    • إذا لم يكن لديك مشروع Unity، فيمكنك تنزيل تطبيق نموذجي .

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

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

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

  1. في وحدة تحكم Firebase، افتح قسم الروابط الديناميكية .

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

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

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

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

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

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

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

استخدام واجهة برمجة تطبيقات Firebase Dynamic Links

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

لإنشاء ارتباط ديناميكي، قم بإنشاء كائن 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.
  }
});

يستخدم المثال أعلاه تعبير لامدا الذي يتم تشغيله عند اكتمال المهمة.