Wprowadzenie do Cloud Storage dla Unity

Cloud Storage for Firebase umożliwia przesyłanie i udostępnianie treści generowanych przez użytkowników, takich jak obrazy i filmy, co pozwala tworzyć w aplikacjach treści multimedialne. Twoje dane są przechowywane w Google Cloud Storage zasobniku, czyli rozwiązaniu do przechowywania obiektów o skali eksabajtów, które zapewnia wysoką dostępność i globalną redundancję. Cloud Storage for Firebase umożliwia bezpieczne przesyłanie tych plików bezpośrednio z urządzeń mobilnych i przeglądarek, a także łatwe radzenie sobie z niestabilnymi sieciami.

Zanim zaczniesz

Zanim zaczniesz korzystać z Cloud Storage, musisz:

  • Zarejestruj projekt Unity i skonfiguruj go tak, aby korzystał z Firebase.

    • Jeśli Twój projekt 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ć przykładową aplikację.

  • Dodaj do projektu w Unity Firebase Unity SDK (a konkretnie FirebaseStorage.unitypackage).

Pamiętaj, że dodanie Firebase do projektu Unity wymaga wykonania czynności zarówno w Firebasekonsoli, jak i w otwartym projekcie Unity (np. pobierasz z konsoli pliki konfiguracyjne Firebase, a następnie przenosisz je do projektu Unity).

Upewnij się też, że Twój projekt w Firebase jest objęty abonamentem Blaze z płatnością według wykorzystania, który jest wymagany do korzystania z Cloud Storage for Firebase. Jeśli dopiero zaczynasz korzystać z Firebase i Google Cloud, sprawdź, czy możesz skorzystać z bezpłatnego okresu próbnego o wartości 300 USD.

Utwórz domyślny zasobnik Cloud Storage

  1. W konsoli Firebase kliknij Bazy danych i miejsce na dane > Miejsce na dane.

    Jeśli Twój projekt nie korzysta jeszcze z abonamentu Blaze z płatnością według wykorzystania, pojawi się prośba o przejście na wyższy pakiet.

  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ć w konsoli Firebase (otwórz kolejno Bazy danych i miejsce na dane > Miejsce na dane > karta Pliki). Domyślny format nazwy zasobnika to PROJECT_ID.firebasestorage.app.

Konfigurowanie dostępu publicznego

Cloud Storage for Firebase udostępnia deklaratywny język reguł, który umożliwia określanie struktury danych, sposobu ich indeksowania oraz czasu, w którym można je odczytywać i zapisywać. Domyślnie dostęp do odczytu i zapisu w Cloud Storage jest ograniczony, więc tylko uwierzytelnieni użytkownicy mogą odczytywać i zapisywać dane. Aby rozpocząć bez konfigurowania Authentication, możesz skonfigurować reguły dostępu publicznego.

Sprawia to, że Cloud Storage jest otwarty dla wszystkich, nawet dla osób, które nie korzystają z Twojej aplikacji. Pamiętaj, aby ponownie ograniczyć dostęp do Cloud Storage po skonfigurowaniu uwierzytelniania.

Otwórz zajęcia FirebaseStorage.

Firebase.Storage.FirebaseStorage to punkt wejścia do 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ąć korzystać z Cloud Storage.

Co dalej? Dowiedz się, jak utworzyć Cloud Storage referencję.

Konfiguracja zaawansowana

Istnieje kilka przypadków użycia, które 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 ich lokalizacji. Możesz na przykład utworzyć zasobniki w Stanach Zjednoczonych, Europie i Azji, aby przechowywać dane użytkowników z tych regionów i zmniejszyć opóźnienia.

Drugi przypadek użycia jest przydatny, jeśli masz dane o różnych wzorcach dostępu. Możesz na przykład skonfigurować zasobnik wieloregionowy 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 tych przypadkach warto użyć wielu Cloud Storagezasobników.

Trzeci przypadek użycia jest przydatny, jeśli tworzysz aplikację, taką jak Dysk Google, która umożliwia użytkownikom korzystanie z kilku zalogowanych kont (np. konta osobistego i konta służbowego). Do uwierzytelniania każdego dodatkowego konta możesz używać niestandardowej instancji aplikacji Firebase.

Używanie wielu zasobników Cloud Storage

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

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

Praca z zaimportowanymi zasobnikami

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

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

Numer projektu znajdziesz w wprowadzeniu do projektów Firebase.

Nie ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślną kontrolę dostępu ustawioną na zezwalanie 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 elementu FirebaseApp, możesz utworzyć instancję elementu FirebaseStorage zainicjowaną 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