يتيح لك Cloud Storage for Firebase تحميل المحتوى من إنشاء المستخدمين ومشاركته، مثل كصور ومقاطع فيديو، مما يتيح لك إنشاء محتوى وسائط متعددة تفاعلية في التطبيقات. يتم تخزين بياناتك في حزمة Google Cloud Storage: حل لتخزين العناصر على مقياس إكسابايت مع مدى التوفّر العالي وفي جميع أنحاء العالم التكرار. يتيح لك Cloud Storage for Firebase تحميل هذه الملفات بأمان. من الأجهزة المحمولة ومتصفحات الويب، مما يؤدي إلى التعامل مع الشبكات غير المستقرة والسهولة.
قبل البدء
لاستخدام Cloud Storage، عليك إجراء ما يلي:
سجِّل مشروع Unity وأعدّه لاستخدام Firebase.
إذا كان مشروعك في Unity يستخدم Firebase حاليًا، يكون تم تسجيلها وإعدادها لمنصة Firebase.
وإذا لم يكن لديك مشروع Unity، يمكنك تنزيل نموذج تطبيق.
أضِف حزمة تطوير البرامج (SDK) Firebase Unity (على وجه التحديد،
FirebaseStorage.unitypackage
) إلى مشروعك على Unity.
تجدر الإشارة إلى أنّ إضافة Firebase إلى مشروع Unity الخاص بك تتضمن مهامًا في كلٍّ من وحدة تحكُّم Firebase وفي مشروع Unity المفتوح (على سبيل المثال، يمكنك تنزيل ملفات إعدادات Firebase من وحدة التحكّم، ثم نقلها إلى مشروع Unity).
إنشاء حزمة Cloud Storage تلقائية
من مساحة الروابط في وحدة تحكّم Firebase، اختَر مساحة التخزين. ثم انقر على البدء.
راجِع الرسائل المتعلّقة بتأمين بياناتك على Cloud Storage باستخدام قواعد الأمان. أثناء التطوير، ننصحك بإعداد قواعد الوصول العلني.
اختَر موقعًا لحزمة Cloud Storage التلقائية.
يُعدّ إعداد الموقع الجغرافي هذا هو الموقع الجغرافي التلقائي لموارد Google Cloud Platform (GCP) في مشروعك. يُرجى العِلم أنّه سيتم استخدام هذا الموقع الجغرافي لخدمات Google Cloud Platform في مشروعك التي تتطلّب إعداد موقع جغرافي، وعلى وجه التحديد، قاعدة بيانات Cloud Firestore وتطبيق App Engine (وهو مطلوب في حال استخدام Cloud Scheduler).
إذا لم تتمكّن من اختيار موقع جغرافي، يعني ذلك أنّ مشروعك لديه موقع جغرافي تلقائي لمورد Google Cloud Platform. تم تعيينه إما أثناء المشروع الإنشاء أو عند إعداد خدمة أخرى تتطلب موقعًا الإعداد.
إذا كنت مشتركًا في خطة Blaze، يمكنك إنشاء حِزم بيانات متعددة، لكل منها حِزمها الخاصة الموقع الجغرافي.
انقر على تم.
إعداد إذن الوصول العلني
توفّر Cloud Storage for Firebase لغة قواعد تعريفية تتيح لك لتحديد كيف يجب تنظيم بياناتك، وكيف يجب فهرستها، ومتى يجب يمكن قراءة البيانات منها والكتابة إليها. يتم تلقائيًا حظر الوصول للقراءة والكتابة إلى Cloud Storage حتى لا يتمكّن سوى المستخدمين الذين تم مصادقة هويتهم من قراءة data أو كتابتها. للبدء بدون إعداد Authentication، يمكنك ضبط قواعدك للوصول العلني.
هذا يجعل Cloud Storage متاحًا لأي شخص، حتى الأشخاص الذين لا يستخدمون تطبيقك، لذا يُرجى التأكّد من تقييد Cloud Storage مرة أخرى عند إعداد المصادقة.
الوصول إلى الصف FirebaseStorage
Firebase.Storage.FirebaseStorage
هي نقطة دخول Cloud Storage Unity SDK.
// Get a reference to the storage service, using the default Firebase App FirebaseStorage storage = FirebaseStorage.DefaultInstance;
يمكنك الآن بدء استخدام Cloud Storage
لنتعرف أولاً على كيفية إنشاء Cloud Storage المرجع.
الإعداد المتقدّم
هناك بعض حالات الاستخدام التي تتطلب إعدادًا إضافيًا:
- استخدام Cloud Storage مجموعات في مناطق جغرافية متعددة
- استخدام Cloud Storage مجموعات في فئات تخزين مختلفة
- استخدام حِزم Cloud Storage مع مستخدمين مُعتمَدين متعدّدين في التطبيق نفسه
تعد حالة الاستخدام الأولى مثالية إذا كان لديك مستخدمون في جميع أنحاء العالم، وتريد وتخزين بياناتهم بالقرب منها. على سبيل المثال، يمكنك إنشاء حِزم في الولايات المتحدة وأوروبا وآسيا لتخزين بيانات المستخدمين في تلك المناطق من أجل تقليل وقت الاستجابة.
تكون حالة الاستخدام الثانية مفيدة إذا كانت لديك بيانات تتضمّن أنماط وصول مختلفة. على سبيل المثال: يمكنك إعداد حزمة متعدّدة المناطق أو إقليمية لتخزين والصور أو أي محتوى آخر يتم الوصول إليه بشكل متكرر، بالإضافة إلى حزمة تخزن النسخ الاحتياطية للمستخدمين أو غيره من المحتوى الذي يتم الوصول إليه بشكل غير متكرر.
في أيّ من حالات الاستخدام هذه، عليك استخدام حِزم 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
المضمّنة في
حزمة تطوير البرامج (SDK) لنظامGoogle Cloud:
gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>
يمكنك العثور على رقم مشروعك كما هو موضح في مقدمة إلى مشاريع 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");
الخطوات التالية
الاستعداد لإطلاق تطبيقك:
- إعداد تنبيهات الميزانية لمشروعك في وحدة تحكّم Google Cloud
- يمكنك مراقبة الاستخدام والفوترة لوحة البيانات في وحدة تحكم Firebase للحصول على صورة شاملة عبر خدمات Firebase المتعددة. يمكنك أيضًا الانتقال إلى قسم Cloud Storage الاستخدام لوحة التحكم للمزيد من معلومات الاستخدام التفصيلية.
- راجِع قائمة التحقّق من إطلاق Firebase.