إذا كانت لديك مشكلة لا تعالجها هذه الصفحة، يمكنك الاطّلاع على صفحة دعم Google Cast للحصول على إجابات عن أسئلتك.
رموز خطأ حزمة SDK للبث
رموز الخطأ المتعلقة بحزمة تطوير البرامج (SDK) الخاصة بـ Google Cast والتي يتم إرسالها بواسطة أحداث الخطأ أو رسائل خطأ الوسائط.
الاسم | Code | الوصف | الحل |
---|---|---|---|
التطبيقات | 900 | يتم عرضه عند حدوث خطأ خارج إطار العمل (على سبيل المثال، إذا عرض معالج الحدث خطأ). | تحقَّق من الخطأ الذي يقع خارج إطار عمل البث. |
BREAK_CLIP_LOADING_ERROR | 901 | يُعرَض عند فشل أداة اعتراض تحميل المقطع. | تحقّق من محتوى مقاطع الفاصل. |
BREAK_SeeK_INTERCEPTOR_ |
902 | يُعرَض عندما يتعذّر تشغيل اعتراض وضع التقديم/الترجيع. | تحقق من صحة فاصل التقديم/الترجيع. |
خطأ في الصورة | 903 | يتم عرض هذه الرسالة عندما يتعذّر تحميل صورة. | تحقَّق من أنّ عنوان URL للصورة يوجِّه المستخدمين إلى الموقع الجغرافي الصحيح. |
متقطّع | 904 | تمت مقاطعة التحميل عن طريق محطة أو من خلال تحميل آخر. | تحقّق لمعرفة ما إذا كان هناك إجراء آخر تسبب في مقاطعة التحميل. |
فشل | 905 | تعذّر تنفيذ أمر التحميل. | تأكّد من إعداد طلب التحميل بشكل صحيح ومن إمكانية تشغيل الوسائط. |
رسالة خطأ | 906 | تم إرسال رسالة خطأ إلى المُرسِل. | تحقَّق من "مستلِم الويب" أو المُرسِل للحصول على معلومات عن الخطأ. |
عام | 909 | يُعرَض عند حدوث خطأ غير معروف. | حدث خطأ غير متوقع. من المفترض أن تكون هذه الحالات نادرة. |
رموز خطأ في مكتبة مشغّل الوسائط
رسائل الخطأ المتعلقة بتشغيل الفيديو من MPL التي تم إرسالها بواسطة أحداث الخطأ أو رسائل خطأ الوسائط.
الاسم | Code | الوصف | الحل |
---|---|---|---|
وسائط غير معروفة | 100 | واجه عنصر الوسائط خطأً غير معروف تم تنشيطه من النظام الأساسي. | واجه عنصر الوسائط خطأً لا يشير إلى أنه أحد
MediaError. |
تم تصديره إلى الوسائط | 101 | تم تنشيط عنصر MediaError. |
وتم إلغاء عملية الجلب لمورد الوسائط بناءً على طلب المستخدم. ويرجع هذا عادةً إلى إلغاء اللعب. |
رمز الوسائط | 102 | تم تنشيط عنصر MediaError. |
على مطوّر البرامج التحقّق من صحة معلمات ترميز مصادر البيانات. |
وسائط متعددة | 103 | تم تنشيط عنصر MediaError. |
تعذّر تنزيل بيانات الوسائط لأنّ ميزة البث لا تستخدم عنصر التنزيل. يمكن أن تكون هذه المشكلة متعلقة بتطبيقك، وإذا لزم الأمر، يمكنك الإبلاغ عنها من خلال أداة تتبُّع مشاكل البث. |
الوسائط المتوافقة: MEDIA_SRC_NOT_ |
104 | تم تنشيط عنصر الوسائط MediaError. |
تحقَّق من صحة شريحة بيانات المطوّر، وتأكّد من تضمين برامج الترميز في التنسيقات المتوافقة. |
SOURCE_BUFFER_ |
110 | يتعذّر على ميزة "البث" إضافة المخزن المؤقت للمصدر إلى مصدر الوسائط الحالي. اطّلِع على تشفير الويب. | وغالبًا ما تكون هذه الترميزات غير صحيحة محدّدة في مصدر بيانات برامج الترميز في البيان داخل التطبيق، أو يمكنك الإبلاغ عنها من خلال أداة تتبّع مشاكل البث في حال عدم ظهورها. |
شبكة الوسائط | 201 | عند استخدام XhrIo في Media Keys لنشر طلب ترخيص، واجهنا خطأ في الشبكة. | يتحقق مطوّر البرامج من خادم الترخيص. |
مفاتيح الوسائط |
202 | ويشمل ذلك حالتَين:
|
تعذّر تنزيل بيانات الوسائط، ولكن لأن ميزة البث لا تستخدم عنصر الوسائط لتنزيلها، يُرجى الإبلاغ عنها من خلال أداة تتبّع مشاكل البث. |
وسائط الإعلام | 203 | عند استخدام تشفير الويب المدمج المتوافق مع المتصفح، واجهنا خطأً في فك التشفير. اطّلِع على Web Crypto API. | يُرجى الإبلاغ عنها من خلال أداة تتبُّع مشاكل البث. |
الشبكة_غير المعروفة | 300 | حدث خطأ عام في الشبكة عند جلب مورد غير مشمول ضِمن النطاق [301-399] | وعلى مطوّري البرامج التأكّد من إمكانية الوصول إلى المحتوى الذي يتم جلبه وصياغة استجابة الخادم بشكل صحيح. |
شريحة_الشبكة | *301 | تعذّر استرداد أي شريحة من أي معدل نقل بيانات (مع إعادة محاولة إجراء ثلاث عمليات رجوع أسيّة). | على مطوّري البرامج التحقّق من أنّ شرائحهم متوفّرة بالفعل. وقد يتعذّر على المستخدم الوصول إلى هذه الشرائح أيضًا. |
قائمة تشغيل HLS_NETWORK_MASTER_ |
*311 | تعذّر استرداد ملف m3u8 قائمة التشغيل الرئيسية مع ثلاث محاولات لإعادة المحاولة. | على مطوّري البرامج التحقّق من أنّ قوائم التشغيل هذه متوفّرة بالفعل. وقد يتعذّر على المستخدم أيضًا الوصول إلى قائمة التشغيل. |
HLS_NETWORK_PLAYLIST | *312* | تعذّر استرداد ملف m3u8 قائمة تشغيل الوسائط (المعدّلة) مع ثلاث محاولات لإعادة المحاولة. | على مطوّري البرامج التحقّق من أنّ قوائم التشغيل هذه متوفّرة بالفعل. وقد يتعذّر على المستخدم أيضًا الوصول إلى قائمة التشغيل. |
HLS_NETWORK_NO_KEY_ |
313 | لم يعرض طلب فك تشفير الرسالة ردًا. | على مطوّري البرامج التحقّق من خدمة إدارة مفاتيح التشفير. |
شعار HLS_NETWORK_KEY_ |
*314 | تعذّر على جهاز XhrIO المستخدَم لطلب مفتاح فك تشفير HLS. | على مطوّري البرامج التحقّق من خدمة إدارة مفاتيح التشفير. |
شريحة HLS_NETWORK_INVALID_ |
315 | شريحة HLS التي تم استلامها للمعالجة ليست TS أو شريحة mp4 AAC. قد يكون خطأ في ملف MPL أو إعداداته في خلل تطبيق مستقبِل الويب. | ويحتاج مطوّرو البرامج إلى التحقّق من أن شرائحهم هي TS أو AAC. |
HLS_SEGMENT_PARSING | 316 | يتم عرضه عند تعذّر تحليل شريحة HLS. | على مطوّري البرامج التحقّق من تكوين شرائحهم بشكلٍ صحيح. |
لوحة البيانات | *321 | تعذّر تنفيذ طلب XHR للحصول على بيان DASH. | يمكنك الاطّلاع على قسم النجوم لتشخيص الأخطاء المتعلقة بالشبكة. |
دالة DASH_NO_INIT | 322 | لا يمكننا استخراج بيانات الإعداد من أول شريحة DASH. | وعلى مطوّري البرامج التحقّق من صحّة شريحة DASH. |
شبكة مترابطة | 331* | تعذّر تنفيذ طلب XHR للحصول على بيان DASH. | يمكنك الاطّلاع على قسم النجوم لتشخيص الأخطاء المتعلقة بالشبكة. |
SMOOTH_NO_MEDIA_ |
332 | لا تحتوي الشريحة التي تم تنزيلها للمعالجة على أي بيانات وسائط. | على مطوّري البرامج التحقّق من صحة الشرائح السلسة. |
HLS_MANIFEST_MASTER | 411 | تعذّر تحليل ملف بيان HLS. أو شيء ما لا تفهمه منصة MPL حتى الآن في الإصدار M3u8 | افحص محتوى عنوان URL للبيان. |
HLS_MANIFEST_PLAYLIST | 412 | تعذّر تحليل ملف قائمة التشغيل للوسائط. أو شيء ما لا تفهمه منصة MPL حتى الآن في الإصدار M3u8 | افحص محتوى عنوان URL لقائمة تشغيل الوسائط. |
DASH_MANIFEST_NO_ |
421 | عند تعديل بيان الشرطة، لم نعثر على فترات زمنية. وهذا غير طبيعي. | على مطوّري البرامج التحقّق من صحة بيان DASH. |
DASH_MANIFEST_NO_ |
422 | ليس هناك نوع mime لتمثيل في البيان. | يحتاج مطوّرو البرامج إلى تحديد نوع mime للصوت/الفيديو/النص لتمثيلهم. |
DASH_INVALID_SEGMENT_ |
423 | يطلب MPL فهرسًا يتجاوز طول الشرائح المتاحة على النحو المحدد في التمثيل في البيان. | الإبلاغ باستخدام روابط في صفحة دعم Google Cast |
SMOOTH_MANIFEST | 431 | لا يتوافق البيان السلس مع المعيار. | يحتاج مطوّر البرامج إلى حل أي من المشاكل التالية:
|
رموز خطأ مشغِّل Shaka
لمعرفة رموز الخطأ المتعلقة بـ Shaka Player، يُرجى الاطّلاع على مستندات فئات الخطأ.
الأخطاء الشائعة في الشبكة
خطأ في بروتوكول نقل الروابط النصية (HTTP) | رمز الحالة | الوصف | الحل |
---|---|---|---|
طلب سيئ | 400 | تعذّر على الخادم فهم الطلب بسبب البنية غير الصحيحة. يجب ألا يكرّر العميل الطلب بدون إجراء تعديلات. | حدث خطأ في عنوان URL. التحقّق من مطوّري التطبيقات |
غير مرخّص | 401 | يتطلب الطلب مصادقة المستخدم | تحقق من التطبيق لمعرفة ما إذا كانت معلومات المصادقة الصحيحة موجودة أم لا. |
لم يتم العثور عليه | 404 | يمكن للعميل الاتصال بالخادم لكن لم يتمكّن الخادم من العثور على ما تم طلبه. | يتحقّق مطوّرو البرامج من موارد عناوين URL ويتأكّدون من توفّر تلك الموارد. |
طلب | 408 | ولم يقدّم العميل طلبًا خلال الفترة التي كان فيها الخادم جاهزًا للانتظار. ويجوز للعميل تكرار الطلب بدون إجراء تعديلات في أي وقت لاحق. | قد يكون هذا مشكلة بسبب مورد (قابلية تطور الخادم) أو مشكلة حقيقية في الشبكة. |
INTERNAL_SERVER_ |
500 | واجه الخادم شرطًا غير متوقّع منعه من تنفيذ الطلب. | يتحقّق مطوّرو البرامج من مشكلة الخادم. |
طريق سيئة | 502 | أثناء تلقّي الخادم كبوابة أو خادم وكيل، تلقّى استجابة غير صالحة من خادم البث الذي تم الوصول إليه في محاولة لتنفيذ الطلب. | يتحقّق مطوّرو البرامج من إعدادات الخادم. |
الخدمة غير متوفّرة | 503 | يتعذّر على الخادم حاليًا معالجة الطلب بسبب زيادة مؤقتة في التحميل أو صيانة الخادم. وتتمثّل التداعيات في أنّ هذا الشرط مؤقت، ويمكن تخفيفه بعد بعض التأخير. | يتحقّق مطوّرو البرامج من إعدادات الخادم، خاصةً قابلية التوسّع لخدماتهم. |
نافذة GATEway_WINDOW | 504 | أثناء تلقّي الخادم كبوابة أو خادم وكيل، لم يتلقَّ ردًّا في الوقت المناسب من خادم استلام البيانات المحدّد من خلال معرّف الموارد المنتظم (URI). | يتحقّق مطوّرو البرامج من إعدادات الخادم والاتصال بين خوادم الحافة وعُقد المصدر. |
ملاحظات
ويمكن أن يتم إلحاق رموز أخطاء إضافية برمز خطأ متبوعًا بعلامة النجمة (*). يكون التنسيق على النحو التالي:
{Error Code}{Closure Network Error Code}{HTTP Status Code}
ولمزيد من المعلومات، يمكنك الاطّلاع على رمز حالة HTTP.
يتضمن 3016404
مثلاً ثلاثة أجزاء:
301 | حدث خطأ في شريحة الشبكة. |
6 | خطأ HTTP: |
404 | لم يتم العثور على حالة HTTP. |
طبيعة أخطاء الشبكة - يكون سبب بعض هذه الأخطاء قابلاً للتنفيذ، في حين أنّ البعض الآخر لا يرجع إلى طبيعة عمليات الشبكة. على سبيل المثال، يشير الخطأ 3018408 الذي يشير إلى انتهاء المهلة إلى حدوث مشكلة في اتصال المستخدم، حيث لا يستطيع أي من فريق البث أو مطوّري البرامج تنفيذ الكثير من الإجراءات، ويجب توخي الحذر أيضًا أن شبكة توصيل المحتوى (CDN) تواجه مشاكل أيضًا. من ناحية أخرى، يشير الخطأ 3116403 إلى أنّ طلب البيان قد تم بنجاح، ولكنّ الخادم يرفض تقديمه. قد يكون هذا هو سياسة مشاركة الموارد متعددة المصادر (CORS) أو المصادقة أو أي مشاكل أخرى تتعلق بالخادم أو الدمج يجب أن يفحصها مطوّرو البرامج.