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

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

https://example.page.link/aSDf

قبل البدء

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

• سجِّل مشروعك على Unity واضبطه لاستخدام Firebase.

  • إذا كان مشروعك في Unity يستخدم Firebase حاليًا، يكون تسجيلها وإعدادها لمنصة Firebase

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

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

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

إعداد بادئة معرّف الموارد المنتظم (URI) للروابط الديناميكية

1. في "وحدة تحكُّم Firebase"، افتح قسم الروابط الديناميكية.

2. إذا لم تكن قد قبلت بنود الخدمة مسبقًا وقمت بتعيين بادئة معرف موارد منتظم (URI) الروابط الديناميكية، فقم بذلك عندما يُطلب منك ذلك.

   إذا كان لديك بادئة معرّف الموارد المنتظم (URI) للروابط الديناميكية من قبل، يُرجى أخذها في الاعتبار. عليك إجراء ما يلي: توفير بادئة معرف الموارد المنتظم (URI) للروابط الديناميكية عند إنشاء الروابط الديناميكية آليًا.

   

3. إجراء مقترَح: تحديد أنماط عناوين URL المسموح بها في الروابط لصفحات في التطبيق روابط احتياطية. فمن خلال إجراء ذلك، تمنع الجهات غير المصرّح بها من إنشاء روابط ديناميكية تعيد توجيه المستخدمين من نطاقك إلى مواقع إلكترونية غير مسموح بها. والتحكم المستمر. يُرجى الاطّلاع على أنماط عناوين URL في القائمة البيضاء.

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

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

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

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

استخدام واجهة برمجة تطبيقات الروابط الديناميكية في Firebase

إنشاء رابط ديناميكي طويل من المعلمات

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

إنشاء رابط ديناميكي قصير

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