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

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

https://example.page.link/aSDf

قبل البدء

قبل أن تتمكّن من استخدام Firebase Dynamic Links، عليك إجراء ما يلي:

تجدر الإشارة إلى أنّ إضافة منصة Firebase إلى مشروع Unity تتضمّن مهامًا في كلّ من وحدة تحكّم Firebase وفي مشروع 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

إنشاء 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.
  }
});

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