Google si impegna a promuovere l'equità razziale per le comunità nere. Vedi come.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Crea collegamenti dinamici con Unity

Puoi creare collegamenti dinamici brevi o lunghi con l'API collegamenti dinamici Firebase. L'API accetta diverse strutture di parametri opzionali per creare collegamenti. I collegamenti brevi possono anche essere creati da un collegamento lungo precedentemente generato. L'API Dynamic Link genererà un URL come il seguente:

 https://example.page.link/aSDf
 

Prima di iniziare

Prima di poter utilizzare i collegamenti dinamici Firebase , è necessario:

  • Registra il tuo progetto Unity e configuralo per usare Firebase.

    • Se il tuo progetto Unity utilizza già Firebase, è già registrato e configurato per Firebase.

    • Se non si dispone di un progetto Unity, è possibile scaricare un'app di esempio .

  • Aggiungi l' SDK di Firebase Unity (in particolare, FirebaseDynamicLinks.unitypackage ) al tuo progetto Unity.

Si noti che l'aggiunta di Firebase al progetto Unity implica attività sia nella console Firebase che nel progetto Unity aperto (ad esempio, scaricare i file di configurazione di Firebase dalla console, quindi spostarli nel progetto Unity).

Imposta un prefisso URI Dynamic Links

  1. Nella console di Firebase, apri la sezione Collegamenti dinamici .

  2. Se non hai già accettato i termini di servizio e impostato un prefisso URI per i tuoi collegamenti dinamici, fallo quando richiesto.

    Se disponi già di un prefisso URI Dynamic Links, prendine nota. È necessario fornire un prefisso URI di Dynamic Link quando si crea a livello di codice Dynamic Link.

  3. Consigliato : specificare i pattern URL consentiti nei collegamenti diretti e nei collegamenti di fallback. In tal modo, impedisci alle parti non autorizzate di creare collegamenti dinamici che reindirizzano dal tuo dominio a siti che non controlli. Vedi Pattern URL whitelist .

Utilizzare la console di Firebase

Se si desidera generare un singolo collegamento dinamico, a scopo di test o affinché il team di marketing crei facilmente un collegamento che può essere utilizzato in qualcosa come un post sui social media, il modo più semplice sarebbe visitare la console di Firebase e crearne uno seguendo manualmente il modulo passo-passo.

Domini personalizzati

Puoi avere un maggiore controllo sul branding di Dynamic Link utilizzando il tuo dominio anziché un sottodominio goo.gl o page.link . Segui queste istruzioni per impostare un dominio personalizzato per il tuo progetto.

Utilizzo dell'API Firebase Dynamic Links

Creazione di un collegamento dinamico lungo dai parametri

Per creare un collegamento dinamico, creare un oggetto DynamicLinkComponents , impostare uno dei membri facoltativi per una configurazione aggiuntiva, quindi accedere alla proprietà LongDynamicLink per ottenere l'URL del collegamento.

Il seguente esempio minimo crea un lungo collegamento dinamico a https://www.example.com/ che si apre con l'app Android com.example.android su Android e l'app com.example.ios su 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

Creazione di un collegamento dinamico breve

Per creare un collegamento dinamico breve, passare un collegamento lungo precedentemente generato a Firebase.DynamicLinks.GetShortLinkAsync o creare DynamicLinkComponents come sopra.

GetShortLinkAsync prende opzionalmente un extra DynamicLinkOptions parametro di configurazione con la PathLength proprietà, che consente di controllare come il collegamento dovrebbe essere generato. La generazione di collegamenti brevi richiede una richiesta di rete al backend Firebase, quindi il metodo GetShortLinkAsync viene eseguito in modo asincrono. GetShortLinkAsync restituisce un'attività Task<Firebase.DynamicLinks.ShortDynamicLink> .

Per esempio:

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

L'esempio precedente utilizza un'espressione lambda che viene attivata al completamento dell'attività.