معالجة الأخطاء في Cloud Storage for Unity

في بعض الأحيان، عند إنشاء تطبيق، لا تسير الأمور كما هو مخطّط لها ويحدث خطأ.

عند الشك، تحقَّق من الخطأ الذي تم إرجاعه واطّلِع على ما تقوله رسالة الخطأ.

إذا راجعت رسالة الخطأ وتأكّدت من توفّر Cloud Storage Security Rules التي تسمح لك بتنفيذ الإجراء، ولكنك لا تزال تواجه صعوبة في حلّ الخطأ، يُرجى الانتقال إلى صفحة الدعم وإعلامنا بكيفية مساعدتك.

التعامل مع رسائل الخطأ

هناك عدة أسباب قد تؤدي إلى حدوث أخطاء، بما في ذلك عدم توفّر الملف أو عدم توفّر إذن للمستخدم بالوصول إلى الملف المطلوب أو إلغاء المستخدم لعملية تحميل الملف.

لتشخيص المشكلة ومعالجة الخطأ بشكل صحيح، إليك قائمة كاملة بجميع أخطاء Firebase.Storage.StorageException التي سيبلغ عنها عميلنا، وكيفية حدوثها.

الاسم السبب
ErrorUnknown حدث خطأ غير معروف.
ErrorObjectNotFound لا يتوفّر أي عنصر في المرجع المحدّد.
ErrorBucketNotFound لم يتم إعداد أي حزمة لـ Cloud Storage.
ErrorProjectNotFound لم يتم ضبط أي مشروع للغة Cloud Storage.
ErrorQuotaExceeded تم تجاوز الحصة المخصّصة لحزمة Cloud Storage. إذا كنت تستخدم خطة أسعار Spark، ننصحك بالترقية إلى خطة أسعار Blaze بنظام الدفع حسب الاستخدام. إذا كنت مشتركًا في خطة أسعار Blaze، يُرجى التواصل مع فريق دعم Firebase.

ملاحظة مهمة: اعتبارًا من 1 أكتوبر 2025، يجب الاشتراك في خطة أسعار Blaze لاستخدام Cloud Storage، حتى الحِزم التلقائية.
ErrorNotAuthenticated لم يتم إثبات هوية المستخدم. يُرجى إكمال عملية المصادقة والمحاولة مجددًا.
ErrorNotAuthorized لا يُسمح للمستخدم بتنفيذ الإجراء المطلوب. تحقَّق من قواعدك للتأكّد من صحتها.
ErrorRetryLimitExceeded تم تجاوز الحدّ الأقصى للوقت المسموح به لإجراء عملية (تحميل أو تنزيل أو حذف أو غير ذلك). يُرجى محاولة التحميل مرة أخرى.
ErrorInvalidChecksum لا يتطابق الملف على الجهاز مع المجموع الاختباري للملف الذي تلقّاه الخادم. يُرجى محاولة التحميل مرة أخرى.
ErrorCanceled ألغى المستخدِم العملية.