Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

צור קישורים דינמיים עם אחדות

ניתן ליצור קישורים דינמיים קצרים או ארוכים באמצעות ממשק ה- API של קישורים דינמיים של Firebase. ה- API לוקח כמה מבני פרמטר אופציונליים לבניית קישורים. ניתן ליצור קישורים קצרים גם מקישור ארוך שנוצר בעבר. ממשק ה- API של קישורים דינמיים ייצור כתובת URL כמו הבאה:

https://example.page.link/aSDf

לפני שאתה מתחיל

לפני שתוכל להשתמש בקישורים דינמיים של Firebase , עליך:

  • רשום את פרויקט Unity שלך והגדר אותו לשימוש ב- Firebase.

    • אם פרויקט האחדות שלך כבר משתמש ב- Firebase, הוא כבר רשום ומוגדר ל- Firebase.

    • אם אין לך פרויקט Unity, תוכל להוריד אפליקציה לדוגמה .

  • הוסף את SDK Firebase Unity (במיוחד FirebaseDynamicLinks.unitypackage ) לפרויקט Unity שלך.

שים לב שהוספת Firebase לפרויקט Unity שלך כוללת משימות הן במסוף Firebase והן בפרויקט Unity הפתוח שלך (לדוגמה, אתה מוריד קבצי תצורה של Firebase מהקונסולה ואז מעביר אותם לפרויקט Unity שלך).

הגדר קידומת URI של קישורים דינמיים

  1. במסוף Firebase, פתח את הקטע קישורים דינמיים .

  2. אם עדיין לא קיבלת את תנאי השירות והגדרת קידומת URI לקישורים הדינמיים שלך, עשה זאת כשתתבקש לעשות זאת.

    אם כבר יש לך קידומת URI של קישורים דינמיים, שים לב אליה. עליך לספק קידומת URI של קישורים דינמיים בעת יצירת תכנית קישורים דינמיים.

  3. מומלץ : ציין את דפוסי ה- URL המותרים בקישורים העמוקים ובקישורי ה- fallback. בכך אתה מונע מגורמים בלתי מורשים ליצור קישורים דינמיים המפנים מהדומיין שלך לאתרים שאינך שולט בהם. ראה דפוסי כתובות אתרים לרשימת היתרים .

השתמש במסוף Firebase

אם ברצונך ליצור קישור דינמי יחיד, למטרות בדיקה, או כדי שצוות השיווק שלך ייצור קישור שיכול לשמש במשהו כמו פוסט ברשתות חברתיות, הדרך הפשוטה ביותר תהיה לבקר במסוף Firebase וליצור קישור כזה. באופן ידני בעקבות הטופס שלב אחר שלב.

דומיינים מותאמים אישית

תוכל לקבל שליטה רבה יותר על המיתוג של הקישור הדינמי שלך באמצעות דומיין משלך במקום תת-דומיין goo.gl או page.link . פעל לפי הוראות אלה להגדרת דומיין מותאם אישית לפרויקט שלך.

באמצעות ממשק ה- API של קישורים דינמיים של Firebase

יצירת קישור דינמי ארוך מפרמטרים

כדי ליצור קישור דינמי, צור אובייקט DynamicLinkComponents , DynamicLinkComponents כל אחד מהחברים האופציונליים לתצורה נוספת, ואז גש LongDynamicLink כדי לקבל את כתובת ה- קישור.

הדוגמה המינימלית הבאה יוצרת קישור דינמי ארוך ל- https://www.example.com/ שנפתח עם אפליקציית Android שלך com.example.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.
  }
});

הדוגמה שלמעלה משתמשת בביטוי למבדה המופעל לאחר השלמת המשימה.