Wprowadzenie do Cloud Storage dla Unity

Cloud Storage for Firebase umożliwia przesyłanie i udostępnianie treści użytkowników, takich jak w postaci obrazów i filmów, co umożliwia umieszczanie w witrynie treści multimedialnych aplikacji. 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, co pozwala na obsługę niestabilnych sieci łatwość użycia.

Zanim zaczniesz

Zanim będzie można użyć 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 w Unity, możesz pobrać przykładowej aplikacji.

  • Dodaj pakiet SDK Firebase Unity (w szczególności FirebaseStorage.unitypackage) do w Twoim projekcie Unity.

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

Tworzenie domyślnego zasobnika Cloud Storage

  1. W panelu nawigacyjnym konsoli Firebase wybierz Przechowywanie danych, a następnie kliknij Rozpocznij.

  2. Zapoznaj się z informacjami na temat zabezpieczania danych Cloud Storage przy użyciu zabezpieczeń reguł. Podczas tworzenia aplikacji rozważ ustawienie reguł dostępu publicznego.

  3. Wybierz lokalizację domyślnego zasobnika Cloud Storage.

    • To ustawienie lokalizacji jest powiązane z ustawieniami domyślna lokalizacja zasobów Google Cloud Platform (GCP). Pamiętaj, że ta lokalizacja będzie używana w usługach GCP w Twoim projekcie, które wymagają ustawienia lokalizacji, w szczególności bazy danych Cloud Firestore i aplikacji App Engine (wymagane, jeśli używasz Cloud Scheduler).

    • Jeśli nie możesz wybrać lokalizacji, Twój projekt ma już domyślną lokalizację zasobu GCP. Została ona ustawiona podczas tworzenia projektu lub konfigurowania innej usługi, która wymaga ustawienia lokalizacji.

    Jeśli korzystasz z abonamentu Blaze, możesz utworzyć wiele zasobników, z których każdy będzie mieć swoją własną lokalizację.

  4. Kliknij Gotowe.

Konfigurowanie dostępu publicznego

Cloud Storage for Firebase udostępnia język reguł deklaratywnych, który pozwala aby zdefiniować, jak powinny wyglądać dane strukturalne, jak powinny być indeksowane i kiedy gdzie dane mogą być odczytywane i zapisywane. 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 usługa Cloud Storage będzie dostępna dla wszystkich, nawet osób, które nie korzystają z Twojego Aplikacja, więc ponownie ogranicz dostęp do Cloud Storage, gdy ją skonfigurujesz. uwierzytelnianie.

Uzyskaj dostęp do zajęć FirebaseStorage

Firebase.Storage.FirebaseStorage to punkt wejścia pakietu SDK Unity w wersji Cloud Storage.

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

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

Najpierw dowiedz się, jak utworzyć odwołanie Cloud Storage.

Konfiguracja zaawansowana

W kilku przypadkach dodatkowa konfiguracja może być wymagana:

Pierwszy przypadek użycia jest idealny, jeśli masz użytkowników na całym świecie i chcesz i przechowywanie danych 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, gdy masz dane o różnych wzorcach 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 każdym z tych przypadków warto wykonać korzystają z kilku zasobnikó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). Możesz użyć niestandardowej aplikacji Firebase. do uwierzytelniania każdego dodatkowego konta.

Użyj wielu zasobników 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://<your-cloud-storage-bucket>

Numer projektu można znaleźć, tak jak to opisano we wprowadzeniu do Projekty Firebase.

Nie ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślny dostęp aby zezwolić na używanie Firebase. Jest to rozwiązanie tymczasowe i w sposób nie będzie odbywać się automatycznie.

Użyj niestandardowej aplikacji Firebase

Jeśli chcesz utworzyć bardziej złożoną aplikację, korzystając z niestandardowego interfejsu FirebaseApp, może utworzyć instancję FirebaseStorage zainicjowaną z użyciem tego aplikacja:

// 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