Cloud Storage for Firebase ti consente di caricare e condividere contenuti generati dagli utenti, come immagini e video, in modo da creare contenuti multimediali nelle tue app. I tuoi dati vengono archiviati in un Google Cloud Storage: un soluzione di archiviazione di oggetti con scalabilità in exabyte ad alta disponibilità e ridondanza. Cloud Storage for Firebase ti consente di caricare questi file in modo sicuro direttamente dai dispositivi mobili e dai browser web, gestendo le reti instabile con e la semplicità d'uso.
Prima di iniziare
Prima di poter utilizzare Cloud Storage, devi:
Registra il tuo progetto Unity e configuralo per utilizzare Firebase.
Se il tuo progetto Unity utilizza già Firebase, è già registrati e configurati per Firebase.
Se non hai un progetto Unity, puoi scaricare un app di esempio.
Aggiungi l'SDK Firebase Unity (nello specifico,
FirebaseStorage.unitypackage
) a del tuo progetto Unity.
Tieni presente che l'aggiunta di Firebase al progetto Unity comporta attività sia nel Nella console Firebase e nel progetto Unity aperto Ad esempio, scarichi dalla console i file di configurazione di Firebase, quindi li sposti nel tuo progetto Unity).
Crea un bucket Cloud Storage predefinito
Nel riquadro di navigazione della console Firebase, seleziona Storage, quindi fai clic su Inizia.
Leggi i messaggi sulla protezione dei tuoi dati di Cloud Storage tramite le funzionalità di sicurezza le regole del caso. Durante lo sviluppo, considera configurando le regole per l'accesso pubblico.
Seleziona una posizione per il bucket Cloud Storage predefinito.
Questa impostazione di geolocalizzazione corrisponde a quella del progetto località Google Cloud Platform Cloud. Tieni presente che questa località verrà utilizzata per i servizi Google Cloud nel tuo progetto che richiedono un'impostazione di località, in particolare il database Cloud Firestore e l'app App Engine (obbligatoria se utilizzi Cloud Scheduler).
Se non riesci a selezionare una località, significa che il progetto ha una località delle risorse Google Cloud predefinita. È stato impostato durante il progetto creazione o configurazione di un altro servizio che richiede una posizione dell'ambientazione.
Se hai scelto il piano Blaze, puoi crea più bucket, ognuno con il proprio località.
Fai clic su Fine.
Configurare l'accesso pubblico
Cloud Storage for Firebase offre un linguaggio con regole dichiarative che ti consente per definire come strutturare i dati, come indicizzare e quando i dati possono essere letti e scritti. Per impostazione predefinita, l'accesso in lettura e scrittura Cloud Storage è limitato, quindi solo gli utenti autenticati possono leggere o scrivere e i dati di Google Cloud. Per iniziare senza configurare Authentication, puoi: configurare le regole per l'accesso pubblico.
In questo modo Cloud Storage è disponibile per tutti, anche per le persone che non utilizzano il tuo quindi assicurati di limitare nuovamente Cloud Storage durante la configurazione autenticazione.
Accedi al corso FirebaseStorage
La Firebase.Storage.FirebaseStorage
è il punto di ingresso per l'SDK Unity di Cloud Storage.
// Get a reference to the storage service, using the default Firebase App FirebaseStorage storage = FirebaseStorage.DefaultInstance;
Puoi iniziare a usare Cloud Storage.
Per prima cosa, scopriamo come creare una Cloud Storage riferimento.
Configurazione avanzata
Esistono alcuni casi d'uso che richiedono una configurazione aggiuntiva:
- Utilizzo di Cloud Storage bucket in più regioni geografiche
- Utilizzo di Cloud Storage bucket in diverse classi di archiviazione
- Utilizzo di Cloud Storage bucket con più utenti autenticati nella stessa app
Il primo caso d'uso è perfetto se hai utenti in tutto il mondo e vuoi archiviare i propri dati accanto a loro. Ad esempio, puoi creare bucket negli Stati Uniti, in Europa e in Asia per archiviare i dati per gli utenti di quelle regioni al fine di ridurre la latenza.
Il secondo caso d'uso è utile se hai dati con pattern di accesso diversi. Ad esempio, puoi configurare un bucket multiregionale o regionale in cui archiviare immagini o altri contenuti a cui si accede frequentemente e un bucket Nearline o Coldline in cui vengono archiviati backup degli utenti o altri contenuti a cui si accede raramente.
In entrambi i casi d'uso, ti consigliamo usa più bucket Cloud Storage.
Il terzo caso d'uso è utile se stai creando un'app, come Google Drive, che consente agli utenti di avere più account a cui hanno eseguito l'accesso (ad esempio, un account personale e un account di lavoro). Puoi utilizzare un'app Firebase personalizzata per autenticare ogni account aggiuntivo.
Utilizza più bucket Cloud Storage
Se vuoi utilizzare un bucket Cloud Storage diverso da quello predefinito fornito sopra,
o utilizzare più bucket Cloud Storage in una singola app, puoi creare un'istanza
di FirebaseStorage
che fa riferimento al tuo bucket personalizzato:
// Get a non-default Storage bucket var storage = FirebaseStorage.GetInstance("gs://my-custom-bucket");
Utilizzo dei bucket importati
Quando importi un bucket Cloud Storage esistente in Firebase, devi grant Firebase la possibilità di accedere a questi file utilizzando lo strumento gsutil
, incluso nell'SDK Google Cloud:
gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>
Puoi trovare il numero del tuo progetto come descritto nell'introduzione alle progetti Firebase.
Ciò non influisce sui bucket appena creati, poiché hanno l'accesso predefinito per consentire a Firebase. Si tratta di una misura temporanea e verrà eseguite automaticamente in futuro.
Utilizza un'app Firebase personalizzata
Se stai creando un'app più complessa utilizzando un FirebaseApp
personalizzato, puoi creare un'istanza di FirebaseStorage
inizializzata con quell'app:
// Get the default bucket from a custom FirebaseApp FirebaseStorage storage = FirebaseStorage.GetInstance(customApp); // Get a non-default bucket from a custom FirebaseApp FirebaseStorage storageCustom = FirebaseStorage.GetInstance(customApp, "gs://my-custom-bucket");
Passaggi successivi
Preparati a lanciare l'app:
- Configura gli avvisi sul budget per il tuo progetto nella console Google Cloud.
- Monitorare l'utilizzo e la fatturazione dashboard nella console Firebase per avere un quadro generale per l'utilizzo in più servizi Firebase. Puoi anche visitare la pagina Cloud Storage Utilizzo dashboard per saperne di più informazioni dettagliate sull'utilizzo.
- Esamina l'elenco di controllo per il lancio di Firebase.