Unity ile Dinamik Bağlantılar Oluşturma

Firebase Dynamic Links API ile kısa veya uzun Dynamic Links oluşturabilirsiniz. API, bağlantı oluşturmak için isteğe bağlı birkaç parametre yapısı alır. Kısa bağlantılar, daha önce oluşturulmuş uzun bir bağlantıdan da oluşturulabilir. Dynamic Links API, aşağıdaki gibi bir URL oluşturur:

https://example.page.link/aSDf

Başlamadan önce

Firebase Dynamic Links kullanmaya başlamak için şunları yapmanız gerekir:

  • Unity projenizi kaydedin ve Firebase'i kullanacak şekilde yapılandırın.

    • Unity projeniz Firebase'i kullanıyorsa Firebase için zaten kayıtlı ve yapılandırılmış demektir.

    • Unity projeniz yoksa örnek uygulama indirebilirsiniz.

  • Firebase Unity SDK'sını (özellikle FirebaseDynamicLinks.unitypackage) Unity projenize ekleyin.

Unity projenize Firebase eklemek için hem Firebase konsolunda hem de açık Unity projenizde görevler gerçekleştirmeniz gerekir (örneğin, Firebase yapılandırma dosyalarını konsoldan indirip Unity projenize taşımanız gerekir).

Dynamic Links URI öneki ayarlama

  1. Firebase konsolunda Dynamic Links bölümünü açın.

  2. Hizmet Şartları'nı henüz kabul etmediyseniz ve Dynamic Links için bir URI ön eki ayarlamadıysanız istendiğinde bu işlemleri yapın.

    Zaten bir Dynamic Links URI ön ekiniz varsa bunu not edin. Dynamic Links'i programatik olarak oluştururken bir Dynamic Links URI ön eki sağlamanız gerekir.

  3. Önerilen: Derin bağlantılarınızda ve yedek bağlantılarınızda izin verilen URL kalıplarını belirtin. Bunu yaparak yetkisiz tarafların alanınızdan kontrol etmediğiniz sitelere yönlendiren Dynamic Links oluşturmasını engellersiniz. Belirli URL kalıplarına izin verme bölümünü inceleyin.

Firebase konsolunu kullanma

Test amacıyla veya pazarlama ekibinizin sosyal medya gönderisi gibi bir yerde kullanılabilecek bir bağlantıyı kolayca oluşturması için tek bir Dynamic Link oluşturmak istiyorsanız en basit yöntem, Firebase konsolunu ziyaret etmek ve adım adım formunu takip ederek manuel olarak bir tane oluşturmaktır.

Özel alanlar

goo.gl veya page.link alt alan adı yerine kendi alan adınızı kullanarak Dynamic Link markanız üzerinde daha fazla kontrol sahibi olabilirsiniz. Projeniz için özel alan ayarlamak üzere bu talimatları uygulayın.

Firebase Dynamic Links API'yi kullanma

Parametrelerden uzun Dynamic Link oluşturuluyor

Dinamik Bağlantı oluşturmak için bir DynamicLinkComponents nesnesi oluşturun, ek yapılandırma için isteğe bağlı üyelerden herhangi birini ayarlayın ve ardından bağlantı URL'sini almak için LongDynamicLink özelliğine erişin.

Aşağıdaki minimal örnek, Android'de com.example.android Android uygulamanızla ve iOS'te com.example.ios uygulamasıyla açılan https://www.example.com/ için uzun bir Dynamic Link oluşturur:

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 videosu oluşturma Dynamic Link

Kısa bir Dynamic Link oluşturmak için önceden oluşturulmuş uzun bir bağlantıyı Firebase.DynamicLinks.GetShortLinkAsync yöntemine iletin veya yukarıdakiyle aynı şekilde DynamicLinkComponents oluşturun.

GetShortLinkAsync, isteğe bağlı olarak PathLength özelliğiyle birlikte ek bir DynamicLinkOptions yapılandırma parametresi alır. Bu sayede, bağlantının nasıl oluşturulacağını kontrol edebilirsiniz. Kısa bağlantı oluşturma işlemi, Firebase arka ucuna ağ isteği gönderilmesini gerektirdiğinden GetShortLinkAsync yöntemi eşzamansız olarak yürütülür. GetShortLinkAsync, Task<Firebase.DynamicLinks.ShortDynamicLink> döndürür.

Örneğin:

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.
  }
});

Yukarıdaki örnekte, görev tamamlandığında tetiklenen bir lambda ifadesi kullanılmıştır.