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

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

ضبط بادئة معرّف الموارد المنتظم (URI) لـ Dynamic Links

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

  2. إذا لم تكن قد قبلت بنود الخدمة وضبطت بادئة معرّف الموارد المنتظم (URI) لـ Dynamic Links، عليك إجراء ذلك عند ظهور الطلب.

    إذا كانت لديك بادئة معرّف الموارد المنتظم (URI) لـ 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 API

إنشاء 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

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

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