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ğıdakine benzer 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.

Firebase'i Unity projenize eklemek için hem Firebase konsolunda hem de açık Unity projenizde görevler gerçekleştirmeniz gerekir (ör. 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. Programatik olarak Dynamic Links oluştururken Dynamic Links URI öneki 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üne bakın.

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 formu 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/ adresine 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ıda açıklandığı ş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 için Firebase arka ucuna ağ isteği gönderilmesi gerektiğ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.