شروع به کار با Cloud Storage برای Unity

‫Cloud Storage for Firebase به شما امکان می‌دهد محتوای تولیدشده توسط کاربر، مانند تصاویر و ویدیو، را بارگذاری و هم‌رسانی کنید، که به شما امکان می‌دهد محتوای رسانه‌ای غنی در برنامه‌هایتان بسازید. داده‌هایتان در Google Cloud Storage ظرف ذخیره‌سازی ذخیره می‌شود — راه‌حل ذخیره‌سازی شیء در مقیاس اگزابایت با دردسترس بودن بالا و افزونگی جهانی. ‫Cloud Storage for Firebase به شما امکان می‌دهد این فایل‌ها را به‌طور ایمن مستقیماً از دستگاه‌های همراه و مرورگرهای وب بارگذاری کنید و شبکه‌های ناپایدار را به‌راحتی مدیریت کنید.

قبل از شروع

پیش‌از اینکه بتوانید از Cloud Storage استفاده کنید، باید:

  • پروژه Unity خود را ثبت کنید و آن را برای استفاده از Firebase پیکربندی کنید.

    • اگر پروژه Unity شما ازقبل از Firebase استفاده می‌کند، پس ازقبل برای Firebase ثبت و پیکربندی شده است.

    • اگر پروژه Unity ندارید، می‌توانید برنامه نمونه‌ای را بارگیری کنید.

  • Firebase Unity SDK (به‌طور دقیق، FirebaseStorage.unitypackage) را به پروژه Unity خود اضافه کنید.

توجه داشته باشید که افزودن Firebase به پروژه Unity شما شامل وظایفی در هر دو Firebase کنسول و پروژه Unity باز شما است (برای مثال، فایل‌های پیکربندی Firebase را از کنسول بارگیری می‌کنید، سپس آن‌ها را به پروژه Unity خود منتقل می‌کنید).

همچنین مطمئن شوید که پروژه Firebase شما در طرح قیمت‌گذاری Blaze با پرداخت به اندازه استفاده باشد، که برای استفاده از Cloud Storage for Firebase الزامی است. اگر با Firebase و Google Cloud آشنایی ندارید، بررسی کنید که آیا واجدشرایط اعتبار «دوره آزمایشی رایگان» ۳۰۰ دلاری هستید یا نه.

ایجاد سطل پیش‌فرض Cloud Storage

  1. در کنسول Firebase، به پایگاه‌های داده و فضای ذخیره‌سازی > فضای ذخیره‌سازی پیمایش کنید.

    اگر پروژه شما هنوز در طرح قیمت‌گذاری Blaze براساس پرداخت به‌میزان مصرف نیست، از شما خواسته می‌شود پروژه‌تان را ارتقا دهید.

  2. روی شروع به کار کلیک کنید.

  3. مکان را برای انبار پیش‌فرض خود انتخاب کنید.

  4. ‫Firebase Security Rules را برای سبد پیش‌فرض خود پیکربندی کنید. درطول توسعه، راه‌اندازی قوانین دسترسی عمومی را درنظر بگیرید.

  5. روی تمام کلیک کنید.

اکنون می‌توانید این دسته‌بندی را در کنسول Firebase مشاهده کنید (به پایگاه‌های داده و فضای ذخیره‌سازی > فضای ذخیره‌سازی > برگه فایل‌ها بروید). قالب نام مخزن پیش‌فرض شما PROJECT_ID.firebasestorage.app است.

راه‌اندازی دسترسی عمومی

‫Cloud Storage for Firebase زبان قوانین بیانی‌ای ارائه می‌دهد که به شما امکان می‌دهد تعریف کنید داده‌هایتان چگونه ساختاردهی شود، چگونه نمایه‌گذاری شود، و چه زمانی داده‌هایتان می‌تواند خوانده شود و در آن نوشته شود. به‌طور پیش‌فرض، دسترسی خواندن و نوشتن به Cloud Storage محدود شده است تا فقط کاربران اصیل‌سازی‌شده بتوانند داده‌ها را بخوانند یا بنویسند. برای شروع بدون راه‌اندازی Authentication، می‌توانید قوانین خود را برای دسترسی عمومی پیکربندی کنید.

با این کار، Cloud Storage برای همه باز می‌شود، حتی افرادی که از برنامه شما استفاده نمی‌کنند، بنابراین حتماً پس‌از راه‌اندازی اصالت‌سنجی، Cloud Storage را دوباره محدود کنید.

دسترسی به کلاس FirebaseStorage

Firebase.Storage.FirebaseStorage نقطه ورود برای Cloud Storage کیت توسعه نرم‌افزار Unity است.

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

آماده‌اید از Cloud Storage استفاده کنید!

مرحله بعدی؟ با نحوه ایجاد مرجع Cloud Storage آشنا شوید.

راه‌اندازی پیشرفته

چند مورد استفاده وجود دارد که به راه‌اندازی اضافی نیاز دارند:

اولین مورد استفاده برای زمانی که کاربرانی در سراسر جهان دارید و می‌خواهید داده‌های آن‌ها را در نزدیکی‌شان ذخیره کنید عالی است. برای مثال، می‌توانید در ایالات متحده، اروپا، و آسیا دسته‌هایی ایجاد کنید تا داده‌های کاربران این مناطق را در آن‌ها ذخیره کنید و از این طریق تأخیر را کاهش دهید.

اگر داده‌هایی با الگوهای دسترسی متفاوت دارید، مورد استفاده دوم مفید است. برای مثال: می‌توانید یک مخزن چندمنطقه‌ای یا منطقه‌ای راه‌اندازی کنید که تصاویر یا محتوای دیگری را که اغلب به آن دسترسی دارید ذخیره می‌کند، و یک مخزن nearline یا coldline که پشتیبان‌گیری‌های کاربر یا محتوای دیگری را که به‌ندرت به آن دسترسی دارید ذخیره می‌کند.

در هریک از این موارد استفاده، می‌خواهید از چند Cloud Storage دسته‌بندی استفاده کنید.

سومین مورد استفاده زمانی مفید است که درحال ساختن برنامه‌ای مثل Google Drive هستید که به کاربران امکان می‌دهد چندین حساب واردشده داشته باشند (برای مثال، یک حساب شخصی و یک حساب کاری). می‌توانید از نمونه برنامه Firebase سفارشی برای اصالت‌سنجی هر حساب اضافی استفاده کنید.

استفاده از چند Cloud Storage دسته‌بندی

اگر می‌خواهید از Cloud Storage سطلی غیر از سطل پیش‌فرض ارائه‌شده در بالا استفاده کنید، یا از چند سطل Cloud Storage در یک برنامه استفاده کنید، می‌توانید نمونه‌ای از FirebaseStorage ایجاد کنید که به سطل سفارشی شما ارجاع دهد:

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

کار کردن با مخازن واردشده

هنگام وارد کردن یک مخزن Cloud Storage موجود به Firebase، باید به Firebase اجازه دهید بااستفاده از ابزار gsutil که در کیت توسعه نرم‌افزار Google Cloud گنجانده شده است به این فایل‌ها دسترسی داشته باشد:

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

شماره پروژه‌تان را می‌توانید همان‌طور که در مقدمه پروژه‌های Firebase توضیح داده شده است پیدا کنید.

این موضوع بر دسته‌های جدید ایجادشده تأثیر نمی‌گذارد، زیرا کنترل دسترسی پیش‌فرض آن‌ها روی «اجازه دادن به Firebase» تنظیم شده است. این اقدام موقتی است و در آینده به‌طور خودکار انجام خواهد شد.

استفاده از برنامه Firebase سفارشی

اگر بااستفاده از FirebaseApp سفارشی برنامه پیچیده‌تری می‌سازید، می‌توانید نمونه‌ای از FirebaseStorage ایجاد کنید که با آن برنامه مقداردهی اولیه شده باشد:

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

مراحل بعدی