إنشاء روابط ديناميكية من خلال 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 console وإنشاء رابط يدويًا باتّباع النموذج المفصّل.

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

يمكنك التحكّم بشكل أكبر في العلامة التجارية لـ Dynamic Link's من خلال استخدام نطاقك الخاص بدلاً من نطاق فرعي 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.
  }
});

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