Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Unity için Cloud Storage'ı kullanmaya başlayın

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Firebase için Bulut Depolama, uygulamalarınıza zengin medya içeriği oluşturmanıza olanak tanıyan resimler ve video gibi kullanıcı tarafından oluşturulan içeriği yüklemenize ve paylaşmanıza olanak tanır. Verileriniz, yüksek kullanılabilirliğe ve küresel yedekliliğe sahip, eksabayt ölçekli bir nesne depolama çözümü olan bir Google Cloud Storage paketinde depolanır. Firebase için Bulut Depolama, bu dosyaları doğrudan mobil cihazlardan ve web tarayıcılarından güvenli bir şekilde yüklemenize olanak tanıyarak düzensiz ağları kolaylıkla halleder.

Sen başlamadan önce

Cloud Storage'ı kullanmadan önce yapmanız gerekenler:

  • Unity projenizi kaydedin ve Firebase'i kullanacak şekilde yapılandırın.

    • Unity projeniz zaten Firebase kullanıyorsa Firebase için zaten kayıtlı ve yapılandırılmış demektir.

    • Bir Unity projeniz yoksa örnek bir uygulama indirebilirsiniz.

  • Firebase Unity SDK'sını (özellikle FirebaseStorage.unitypackage ) Unity projenize ekleyin.

Unity projenize Firebase eklemenin hem Firebase konsolunda hem de açık Unity projenizde görevler içerdiğini unutmayın (örneğin, Firebase yapılandırma dosyalarını konsoldan indirir ve ardından bunları Unity projenize taşırsınız).

Varsayılan bir Bulut Depolama paketi oluşturun

  1. Firebase konsolunun gezinme bölmesinden, Depolama'yı seçin ve ardından Başlayın'ı tıklayın.

  2. Güvenlik kurallarını kullanarak Bulut Depolama verilerinizin güvenliğini sağlamaya ilişkin mesajı inceleyin. Geliştirme sırasında, kurallarınızı genel erişim için ayarlamayı düşünün.

  3. Varsayılan Bulut Depolama grubunuz için bir konum seçin.

    • Bu konum ayarı, projenizin varsayılan Google Cloud Platform (GCP) kaynak konumudur . Bu konumun, projenizde konum ayarı gerektiren GCP hizmetleri, özellikle Cloud Firestore veritabanınız ve App Engine uygulamanız (Cloud Scheduler kullanıyorsanız gereklidir) için kullanılacağını unutmayın.

    • Bir konum seçemiyorsanız, projenizde zaten varsayılan bir GCP kaynak konumu vardır. Proje oluşturma sırasında veya konum ayarı gerektiren başka bir hizmet kurulurken ayarlandı.

    Blaze planını kullanıyorsanız, her biri kendi konumuna sahip birden çok grup oluşturabilirsiniz .

  4. Bitti'yi tıklayın.

Genel erişimi ayarla

Cloud Storage for Firebase, verilerinizin nasıl yapılandırılması gerektiğini, nasıl dizine eklenmesi gerektiğini ve verilerinizden ne zaman okunup yazılabileceğini tanımlamanıza olanak tanıyan bildirime dayalı bir kurallar dili sağlar. Varsayılan olarak, Cloud Storage'a okuma ve yazma erişimi kısıtlanmıştır, böylece yalnızca kimliği doğrulanmış kullanıcılar veri okuyabilir veya yazabilir. Kimlik Doğrulamayı kurmadan başlamak için, kurallarınızı genel erişim için yapılandırabilirsiniz .

Bu, Bulut Depolamayı uygulamanızı kullanmayan kişiler dahil herkese açık hale getirir, bu nedenle kimlik doğrulamayı ayarlarken Bulut Depolamanızı tekrar kısıtladığınızdan emin olun.

FirebaseStorage sınıfına erişin

Firebase.Storage.FirebaseStorage , Cloud Storage Unity SDK için giriş noktasıdır.

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

Bulut Depolamayı kullanmaya başlamaya hazırsınız!

Öncelikle Cloud Storage referansı oluşturmayı öğrenelim.

Gelişmiş kurulum

Ek kurulum gerektiren birkaç kullanım durumu vardır:

Dünyanın her yerinden kullanıcılarınız varsa ve verilerini onlara yakın bir yerde depolamak istiyorsanız, ilk kullanım durumu mükemmeldir. Örneğin, gecikmeyi azaltmak amacıyla bu bölgelerdeki kullanıcılara yönelik verileri depolamak için ABD, Avrupa ve Asya'da gruplar oluşturabilirsiniz.

Farklı erişim modellerine sahip verileriniz varsa, ikinci kullanım durumu yararlıdır. Örneğin: resimleri veya diğer sık ​​erişilen içeriği depolayan çok bölgeli veya bölgesel bir grup ve kullanıcı yedeklerini veya diğer seyrek erişilen içeriği depolayan bir yakın hat veya soğuk hat grubu oluşturabilirsiniz.

Bu kullanım durumlarından herhangi birinde, birden çok Cloud Storage grubu kullanmak isteyeceksiniz.

Üçüncü kullanım durumu, Google Drive gibi, kullanıcıların birden çok oturum açmış hesaba (örneğin, bir kişisel hesap ve bir iş hesabı) sahip olmasına izin veren bir uygulama oluşturuyorsanız kullanışlıdır. Her ek hesabın kimliğini doğrulamak için özel bir Firebase Uygulaması örneği kullanabilirsiniz.

Birden fazla Bulut Depolama paketi kullanın

Yukarıda sağlanan varsayılandan farklı bir Cloud Storage grubu kullanmak veya tek bir uygulamada birden çok Cloud Storage grubu kullanmak istiyorsanız, özel grubunuza başvuran bir FirebaseStorage örneği oluşturabilirsiniz:

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

İçe aktarılan paketlerle çalışma

Mevcut bir Cloud Storage paketini Firebase'e aktarırken, Google Cloud SDK'da bulunan gsutil aracını kullanarak Firebase'e bu dosyalara erişme yetkisi vermeniz gerekir :

gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>

Proje numaranızı Firebase projelerinin girişinde açıklandığı gibi bulabilirsiniz.

Bu, Firebase'e izin verecek varsayılan erişim kontrolüne sahip olduklarından, yeni oluşturulan grupları etkilemez. Bu geçici bir önlemdir ve gelecekte otomatik olarak gerçekleştirilecektir.

Özel bir Firebase Uygulaması kullanın

Özel bir FirebaseApp kullanarak daha karmaşık bir uygulama oluşturuyorsanız, bu uygulamayla başlatılan bir FirebaseStorage örneği oluşturabilirsiniz:

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

Sonraki adımlar

,

Firebase için Bulut Depolama, uygulamalarınıza zengin medya içeriği oluşturmanıza olanak tanıyan resimler ve video gibi kullanıcı tarafından oluşturulan içeriği yüklemenize ve paylaşmanıza olanak tanır. Verileriniz, yüksek kullanılabilirliğe ve küresel yedekliliğe sahip, eksabayt ölçekli bir nesne depolama çözümü olan bir Google Cloud Storage paketinde depolanır. Firebase için Bulut Depolama, bu dosyaları doğrudan mobil cihazlardan ve web tarayıcılarından güvenli bir şekilde yüklemenize olanak tanıyarak düzensiz ağları kolaylıkla halleder.

Sen başlamadan önce

Cloud Storage'ı kullanmadan önce yapmanız gerekenler:

  • Unity projenizi kaydedin ve Firebase'i kullanacak şekilde yapılandırın.

    • Unity projeniz zaten Firebase kullanıyorsa Firebase için zaten kayıtlı ve yapılandırılmış demektir.

    • Bir Unity projeniz yoksa örnek bir uygulama indirebilirsiniz.

  • Firebase Unity SDK'sını (özellikle FirebaseStorage.unitypackage ) Unity projenize ekleyin.

Unity projenize Firebase eklemenin hem Firebase konsolunda hem de açık Unity projenizde görevler içerdiğini unutmayın (örneğin, Firebase yapılandırma dosyalarını konsoldan indirir ve ardından bunları Unity projenize taşırsınız).

Varsayılan bir Bulut Depolama paketi oluşturun

  1. Firebase konsolunun gezinme bölmesinden, Depolama'yı seçin ve ardından Başlayın'ı tıklayın.

  2. Güvenlik kurallarını kullanarak Bulut Depolama verilerinizin güvenliğini sağlamaya ilişkin mesajı inceleyin. Geliştirme sırasında, kurallarınızı genel erişim için ayarlamayı düşünün.

  3. Varsayılan Bulut Depolama grubunuz için bir konum seçin.

    • Bu konum ayarı, projenizin varsayılan Google Cloud Platform (GCP) kaynak konumudur . Bu konumun, projenizde konum ayarı gerektiren GCP hizmetleri, özellikle Cloud Firestore veritabanınız ve App Engine uygulamanız (Cloud Scheduler kullanıyorsanız gereklidir) için kullanılacağını unutmayın.

    • Bir konum seçemiyorsanız, projenizde zaten varsayılan bir GCP kaynak konumu vardır. Proje oluşturma sırasında veya konum ayarı gerektiren başka bir hizmet kurulurken ayarlandı.

    Blaze planını kullanıyorsanız, her biri kendi konumuna sahip birden çok grup oluşturabilirsiniz .

  4. Bitti'yi tıklayın.

Genel erişimi ayarla

Cloud Storage for Firebase, verilerinizin nasıl yapılandırılması gerektiğini, nasıl dizine eklenmesi gerektiğini ve verilerinizden ne zaman okunup yazılabileceğini tanımlamanıza olanak tanıyan bildirime dayalı bir kurallar dili sağlar. Varsayılan olarak, Cloud Storage'a okuma ve yazma erişimi kısıtlanmıştır, böylece yalnızca kimliği doğrulanmış kullanıcılar veri okuyabilir veya yazabilir. Kimlik Doğrulamayı kurmadan başlamak için, kurallarınızı genel erişim için yapılandırabilirsiniz .

Bu, Bulut Depolamayı uygulamanızı kullanmayan kişiler dahil herkese açık hale getirir, bu nedenle kimlik doğrulamayı ayarlarken Bulut Depolamanızı tekrar kısıtladığınızdan emin olun.

FirebaseStorage sınıfına erişin

Firebase.Storage.FirebaseStorage , Cloud Storage Unity SDK için giriş noktasıdır.

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

Bulut Depolamayı kullanmaya başlamaya hazırsınız!

Öncelikle Cloud Storage referansı oluşturmayı öğrenelim.

Gelişmiş kurulum

Ek kurulum gerektiren birkaç kullanım durumu vardır:

Dünyanın her yerinden kullanıcılarınız varsa ve verilerini onlara yakın bir yerde depolamak istiyorsanız, ilk kullanım durumu mükemmeldir. Örneğin, gecikmeyi azaltmak amacıyla bu bölgelerdeki kullanıcılara yönelik verileri depolamak için ABD, Avrupa ve Asya'da gruplar oluşturabilirsiniz.

Farklı erişim modellerine sahip verileriniz varsa, ikinci kullanım durumu yararlıdır. Örneğin: resimleri veya diğer sık ​​erişilen içeriği depolayan çok bölgeli veya bölgesel bir grup ve kullanıcı yedeklerini veya diğer seyrek erişilen içeriği depolayan bir yakın hat veya soğuk hat grubu oluşturabilirsiniz.

Bu kullanım durumlarından herhangi birinde, birden çok Cloud Storage grubu kullanmak isteyeceksiniz.

Üçüncü kullanım durumu, Google Drive gibi, kullanıcıların birden çok oturum açmış hesaba (örneğin, bir kişisel hesap ve bir iş hesabı) sahip olmasına izin veren bir uygulama oluşturuyorsanız kullanışlıdır. Her ek hesabın kimliğini doğrulamak için özel bir Firebase Uygulaması örneği kullanabilirsiniz.

Birden fazla Bulut Depolama paketi kullanın

Yukarıda sağlanan varsayılandan farklı bir Cloud Storage grubu kullanmak veya tek bir uygulamada birden çok Cloud Storage grubu kullanmak istiyorsanız, özel grubunuza başvuran bir FirebaseStorage örneği oluşturabilirsiniz:

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

İçe aktarılan paketlerle çalışma

Mevcut bir Cloud Storage paketini Firebase'e aktarırken, Google Cloud SDK'da bulunan gsutil aracını kullanarak Firebase'e bu dosyalara erişme yetkisi vermeniz gerekir :

gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>

Proje numaranızı Firebase projelerinin girişinde açıklandığı gibi bulabilirsiniz.

Bu, Firebase'e izin verecek varsayılan erişim kontrolüne sahip olduklarından, yeni oluşturulan grupları etkilemez. Bu geçici bir önlemdir ve gelecekte otomatik olarak gerçekleştirilecektir.

Özel bir Firebase Uygulaması kullanın

Özel bir FirebaseApp kullanarak daha karmaşık bir uygulama oluşturuyorsanız, bu uygulamayla başlatılan bir FirebaseStorage örneği oluşturabilirsiniz:

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

Sonraki adımlar