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

يمكنك إنشاء Dynamic Links قصيرة أو طويلة باستخدام واجهة برمجة التطبيقات Firebase Dynamic Links. تتلقّى واجهة برمجة التطبيقات عدة بنى مَعلمات اختيارية لإنشاء الروابط. يمكن أيضًا إنشاء روابط مختصرة من رابط طويل تم إنشاؤه سابقًا. ستنشئ واجهة برمجة التطبيقات Dynamic Links عنوان 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).

ضبط بادئة Dynamic Links URI

  1. في وحدة تحكّم Firebase، افتح القسم Dynamic Links.

  2. إذا لم يسبق لك قبول بنود الخدمة وتحديد بادئة URI لـ Dynamic Links، عليك إجراء ذلك عند مطالبتك بذلك.

    إذا كان لديك Dynamic Links بادئة معرّف الموارد المنتظم (URI)، دوِّنها. يجب تقديم بادئة معرّف الموارد المنتظم Dynamic Links عند إنشاء Dynamic Links آليًا.

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

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

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

النطاقات الخاصة

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

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

إنشاء أغنية Dynamic Link طويلة من المَعلمات

لإنشاء رابط ديناميكي، أنشئ عنصر 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

إنشاء فيديو Shorts Dynamic Link

لإنشاء رابط قصير من روابط Dynamic Link، مرِّر رابطًا طويلاً تم إنشاؤه سابقًا إلى 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 يتم تشغيله عند اكتمال المهمة.