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

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

https://example.page.link/aSDf

לפני שמתחילים

לפני שמשתמשים Firebase Dynamic Links צריך:

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

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

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

  • מוסיפים את ה-SDK Firebase Unity (באופן ספציפי, FirebaseDynamicLinks.unitypackage) אל בפרויקט ב-Unity.

חשוב לזכור שההוספה של 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. פועלים לפי ההוראות האלה כדי להגדיר דומיין בהתאמה אישית לפרויקט.

באמצעות ה-API של 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 או build של 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 שמופעל כשהמשימה הושלמה.