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