معالجة الأخطاء في 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 ألغى المستخدِم العملية.