Wprowadzenie do Cloud Storage dla Unity

Cloud Storage for Firebase umożliwia przesyłanie i udostępnianie treści użytkowników, takich jak obrazy i filmy, co pozwala na tworzenie w aplikacjach treści multimedialnych. Twoje dane są przechowywane w zasobniku Google Cloud Storage – rozwiązaniu do przechowywania obiektów o rozmiarze exabajtów z wysoką dostępnością i globalną redundancją. Cloud Storage for Firebase umożliwia bezpieczne przesyłanie tych plików bezpośrednio z urządzeń mobilnych i przeglądarek internetowych, a także sprawne działanie w przypadku niestabilnych sieci.

Zanim zaczniesz

Zanim zaczniesz korzystać z Cloud Storage, musisz:

  • Zarejestruj projekt Unity i skonfiguruj go tak, aby używał Firebase.

    • Jeśli Twój projekt w Unity korzysta już z Firebase, jest już zarejestrowany i skonfigurowany pod kątem tej usługi.

    • Jeśli nie masz projektu Unity, możesz pobrać próbną aplikację.

  • Dodaj pakiet SDK Firebase Unity (szczególnie plik FirebaseStorage.unitypackage) do projektu Unity.

Pamiętaj, że dodanie Firebase do projektu w Unity wymaga wykonania zadań zarówno w konsoli Firebase, jak i w otwartym projekcie w Unity (np. pobieranie plików konfiguracji Firebase z konsoli i przenoszenie ich do projektu w Unity).

Upewnij się też, że Twój projekt Firebase jest objęty abonamentem Blaze (płatność według zużycia zasobów). Jeśli nie korzystasz jeszcze z Firebase i Google Cloud, sprawdź, czy możesz otrzymać 300 USD w postaci środków.

Tworzenie domyślnego zasobnika Cloud Storage

  1. W panelu nawigacyjnym konsoli Firebase wybierz Przechowywanie danych.

    Jeśli Twój projekt nie jest jeszcze objęty cennikiem Blaze, pojawi się prośba o zaktualizowanie projektu.

  2. Kliknij Rozpocznij.

  3. Wybierz lokalizację domyślnego zasobnika.

  4. Skonfiguruj Firebase Security Rules dla domyślnego zasobnika. Podczas tworzenia aplikacji rozważ skonfigurowanie reguł dostępu publicznego.

  5. Kliknij Gotowe.

Zasobnik możesz teraz wyświetlić na karcie Cloud Storage Pliki konsoli Firebase. Domyślny format nazwy zasobnika to PROJECT_ID.firebasestorage.app.

Konfigurowanie dostępu publicznego

Cloud Storage for Firebase udostępnia język deklaratywny, który pozwala zdefiniować, jak powinny być ustrukturyzowane dane, jak je posortować i kiedy można je odczytywać i zapisywać. Domyślnie dostęp do odczytu i zapisu w folderze Cloud Storage jest ograniczony, więc tylko uwierzytelnieni użytkownicy mogą odczytywać i zapisywać dane. Aby zacząć korzystać z Authentication bez konfigurowania, możesz skonfigurować reguły dostępu publicznego.

W ten sposób Cloud Storage będzie dostępne dla wszystkich, nawet dla osób, które nie korzystają z Twojej aplikacji. Pamiętaj, aby po skonfigurowaniu uwierzytelniania ponownie ograniczyć dostęp do Cloud Storage.

Dostęp do zajęć FirebaseStorage

Firebase.Storage.FirebaseStorageto punkt początkowy pakietu SDK Cloud Storage Unity.

// Get a reference to the storage service, using the default Firebase App
FirebaseStorage storage = FirebaseStorage.DefaultInstance;

Możesz już zacząć używać Cloud Storage.

Co dalej? Dowiedz się, jak utworzyć odwołanie Cloud Storage.

Konfiguracja zaawansowana

Niektóre przypadki użycia wymagają dodatkowej konfiguracji:

Pierwszy przypadek użycia jest idealny, jeśli masz użytkowników na całym świecie i chcesz przechowywać ich dane w pobliżu. Możesz na przykład utworzyć zbiory w Stanach Zjednoczonych, Europie i Azji, aby przechowywać dane użytkowników z tych regionów i w ten sposób zmniejszyć opóźnienia.

Drugi przypadek użycia jest przydatny, jeśli masz dane z różnymi wzorcami dostępu. Możesz na przykład skonfigurować zasobnik wieloregionalny lub regionalny, w którym będą przechowywane zdjęcia lub inne często używane treści, oraz zasobnik nearline lub coldline, w którym będą przechowywane kopie zapasowe użytkowników lub inne rzadko używane treści.

W obu przypadkach warto użyć kilku zbiorników Cloud Storage.

Trzeci przypadek użycia jest przydatny, jeśli tworzysz aplikację, taką jak Dysk Google, która umożliwia użytkownikom logowanie się na wiele kont (np. na konto osobiste i służbowe). Aby uwierzytelnić każde dodatkowe konto, możesz użyć niestandardowej aplikacji Firebase.

Używanie wielu grup Cloud Storage

Jeśli chcesz użyć zasobnika Cloud Storage innego niż domyślny podany powyżej lub użyć kilku zasobników Cloud Storage w jednej aplikacji, możesz utworzyć instancję FirebaseStorage, która odwołuje się do niestandardowego zasobnika:

// Get a non-default Storage bucket
var storage = FirebaseStorage.GetInstance("gs://my-custom-bucket");

Praca z zaimportowanymi zasobnikami

Podczas importowania istniejącego zasobnika Cloud Storage do Firebase musisz przyznać Firebase uprawnienia dostępu do tych plików za pomocą narzędzia gsutil, które jest częścią pakietu Google Cloud SDK:

gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://BUCKET_NAME

Numer projektu znajdziesz w sposób opisany w artykule Wprowadzenie do projektów Firebase.

Nie ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślnie ustawioną kontrolę dostępu, która zezwala na Firebase. Jest to środek tymczasowy, który w przyszłości będzie wykonywany automatycznie.

Używanie niestandardowej aplikacji Firebase

Jeśli tworzysz bardziej skomplikowaną aplikację za pomocą niestandardowego obiektu FirebaseApp, możesz utworzyć instancję obiektu FirebaseStorage zainicjalizowanego za pomocą tej aplikacji:

// 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");

Dalsze kroki