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

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

https://example.page.link/aSDf

قبل البدء

لاستخدام Firebase Dynamic Links، عليك إجراء ما يلي:

  • سجِّل مشروع Unity وأعدّه لاستخدام Firebase.

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

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

  • أضِف Firebase حزمة SDK لنظام التشغيل Unity (على وجه التحديد، FirebaseDynamicLinks.unitypackage) إلى مشروعك على Unity.

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

ضبط بادئة Dynamic Links URI

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

  2. إذا لم يسبق لك قبول بنود الخدمة وضبط بادئة عنوان URL لDynamic Links، عليك إجراء ذلك عندما يُطلب منك ذلك.

    إذا كان لديك بادئة Dynamic Links URI، عليك تدوينها. عليك تقديم بادئة عنوان URI‏ Dynamic Links عند إنشاء Dynamic Links آليًا.

  3. إجراء مقترَح: حدِّد أنماط عناوين URL المسموح بها في الروابط لصفحات في التطبيق وال links الاحتياطية. وبهذا الإجراء، يمكنك منع الجهات غير المصرّح لها من إنشاء 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

لإنشاء رابط ديناميكي قصير، أرسِل رابطًا طويلاً تم إنشاؤه سابقًا إلى 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.
  }
});

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