اگر مشکلی دارید که این صفحه به آن رسیدگی نمی کند، به صفحه پشتیبانی Google Cast مراجعه کنید تا پاسخ سوالات خود را دریافت کنید.
کدهای خطای Cast SDK
کدهای خطا مربوط به Cast SDK ارسال شده توسط رویدادهای خطا یا پیام های خطای رسانه.
| نام | کد | شرح | راه حل |
|---|---|---|---|
| برنامه | 900 | هنگامی که یک خطا در خارج از چارچوب رخ می دهد، برگردانده می شود (به عنوان مثال، اگر یک کنترل کننده رویداد یک خطا ایجاد کند). | خطای خارج از چارچوب بازیگران را بررسی کنید. |
| BREAK_CLIP_LOADING_ERROR | 901 | هنگامی که رهگیر بار گیره شکسته از کار بیفتد، برگردانده می شود. | محتویات کلیپ های استراحت را بررسی کنید. |
| BREAK_SEEK_INTERCEPTOR_ خطا | 902 | هنگامی که رهگیر جستجوی شکست شکست خورد، برگردانده می شود. | بررسی کنید تا مطمئن شوید رهگیر جستجوی شکست درست است. |
| IMAGE_ERROR | 903 | هنگامی که یک تصویر بارگیری نمی شود، برگردانده می شود. | بررسی کنید که نشانی اینترنتی تصویر به مکان صحیح اشاره دارد. |
| LOAD_INTERRUPTED | 904 | یک بار توسط یک توقف یا بار دیگر قطع شد. | بررسی کنید که آیا عمل دیگری باعث قطع بار شده است یا خیر. |
| LOAD_FAILED | 905 | یک فرمان بارگیری انجام نشد. | بررسی کنید که درخواست بارگذاری به درستی تنظیم شده است و رسانه قادر به پخش است. |
| MEDIA_ERROR_MESSAGE | 906 | یک پیام خطا برای فرستنده ارسال شد. | برای اطلاعات مربوط به خطا، گیرنده وب یا فرستنده را بررسی کنید. |
| ژنریک | 909 | هنگامی که یک خطای ناشناخته رخ می دهد برگردانده می شود. | اتفاق غیرمنتظره ای رخ داده است. این باید نادر باشد. |
کدهای خطا کتابخانه Media Player
پیام‌های خطای مربوط به پخش از MPL توسط رویدادهای خطا یا پیام‌های خطای رسانه ارسال می‌شوند.
| نام | کد | شرح | راه حل |
|---|---|---|---|
| MEDIA_UNKNOWN | 100 | عنصر رسانه با خطای ناشناخته‌ای مواجه شد که از پلتفرم شلیک شد. | عنصر رسانه با خطایی مواجه شد که نشان نمی داد یکی از MediaError است. MEDIA_ERR_* . این باید نادر باشد. |
| MEDIA_ABORTED | 101 | عنصر رسانه MediaError را فعال کرد. خطای MEDIA_ ERR_ ABORTED . | فرآیند واکشی برای منبع رسانه به درخواست کاربر لغو شد. این معمولاً به دلیل سقط بازی است. |
| MEDIA_DECODE | 102 | عنصر رسانه MediaError را فعال کرد. خطای MEDIA_ ERR_ DECODE . | برنامه‌نویس باید پارامترهای رمزگذاری جریان خود را تأیید کند. |
| MEDIA_NETWORK | 103 | عنصر رسانه MediaError را فعال کرد. خطای MEDIA_ ERR_ NETWORK | دانلود داده‌های رسانه انجام نشد زیرا Cast از عنصر رسانه برای دانلود استفاده نمی‌کند. این مشکل می تواند مربوط به برنامه شما باشد. در صورت لزوم، از طریق ردیاب مسئله Cast گزارش دهید. |
| MEDIA_SRC_NOT_ پشتیبانی می شود | 104 | عنصر رسانه MediaError را فعال کرد. خطای MEDIA_ERR_ SRC_ NOT_ SUPPORTED . | بخش داده‌های توسعه‌دهنده را اعتبارسنجی کنید، مطمئن شوید که کدک‌ها در قالب‌های پشتیبانی‌شده Cast گنجانده شده‌اند. |
| SOURCE_BUFFER_ FAILURE | 110 | Cast قادر به افزودن بافر منبع به منبع رسانه موجود نیست. Web Crypto را ببینید. | اغلب اوقات این ممکن است کدک های نادرستی باشد که در جریان کدک ها در مانیفست در برنامه شما مشخص شده است. اگر نه، از طریق ردیاب مشکل Cast گزارش دهید. |
| MEDIAKEYS_NETWORK | 201 | هنگام استفاده از XhrIo در Media Keys برای ارسال درخواست مجوز ، با یک خطای شبکه مواجه شدیم. | توسعه دهنده سرور مجوز خود را تأیید می کند. |
| MEDIAKEYS_ بدون پشتیبانی | 202 | این دو مورد را شامل می شود:
| دانلود داده‌های رسانه انجام نشد، اما چون Cast از عنصر رسانه برای دانلود استفاده نمی‌کند، لطفاً از طریق ردیاب مشکل Cast گزارش دهید. |
| MEDIAKEYS_WEBCRYPTO | 203 | هنگام استفاده از Web Crypto داخلی که توسط مرورگر پشتیبانی می شود، در رمزگشایی با خطا مواجه شدیم. Web Crypto API را ببینید. | لطفاً از طریق ردیاب مشکل Cast گزارش دهید. |
| NETWORK_UNKNOWN | 300 | هنگام واکشی منبعی که در محدوده پوشش داده نشده است با یک خطای شبکه عمومی مواجه شد [301-399] | توسعه دهندگان باید اطمینان حاصل کنند که محتوای واکشی شده قابل دسترسی است و پاسخ سرور به درستی شکل گرفته است. |
| SEGMENT_NETWORK | 301* | بازیابی هر بخش از هر میزان بیت (با سه بار تکرار نمایی پس‌آف) انجام نشد. | توسعه دهندگان باید تأیید کنند که بخش های آنها واقعاً در دسترس هستند. ممکن است کاربری که نتواند به این بخش‌ها دسترسی پیدا کند نیز وجود دارد. |
| HLS_NETWORK_MASTER_ PLAYLIST | 311* | بازیابی فایل فهرست پخش اصلی m3u8 با سه تلاش مجدد انجام نشد. | توسعه دهندگان باید تأیید کنند که لیست پخش آنها واقعاً در دسترس است. ممکن است کاربری که نتواند به لیست پخش دسترسی پیدا کند نیز وجود دارد. |
| HLS_NETWORK_PLAYLIST | 312* | بازیابی فایل فهرست پخش رسانه (بیتره شده) m3u8 با سه بار تکرار ناموفق بود. | توسعه دهندگان باید تأیید کنند که لیست پخش آنها واقعاً در دسترس است. ممکن است کاربری که نتواند به لیست پخش دسترسی پیدا کند نیز وجود دارد. |
| HLS_NETWORK_NO_KEY_ RESPONSE | 313 | درخواست کلید رمزگشایی پاسخی نداد. | توسعه دهندگان باید سرویس کلید رمزگشایی خود را تأیید کنند. |
| HLS_NETWORK_KEY_ LOAD | 314* | XhrIO مورد استفاده برای درخواست کلید رمزگشایی HLS ناموفق بود. | توسعه دهندگان باید سرویس کلید رمزگشایی خود را تأیید کنند. |
| HLS_NETWORK_INVALID_ SEGMENT | 315 | بخش HLS دریافت شده برای پردازش نه یک بخش TS و نه یک بخش mp4 AAC است. ممکن است اشکال MPL یا پیکربندی اشکال برنامه گیرنده وب باشد. | توسعه دهندگان باید تأیید کنند که بخش های آنها TS یا AAC است. |
| HLS_SEGMENT_PARSING | 316 | هنگامی که یک بخش HLS نتواند تجزیه شود، برگردانده می شود. | توسعه دهندگان باید تأیید کنند که بخش های آنها به درستی شکل گرفته است. |
| DASH_NETWORK | 321* | درخواست XHR برای دریافت مانیفست DASH بدون پاسخ شکست خورد. | برای تشخیص خطاهای مربوط به شبکه به بخش ستاره مراجعه کنید. |
| DASH_NO_INIT | 322 | ما نمی توانیم داده های اولیه را از اولین بخش اولیه DASH استخراج کنیم. | توسعه دهندگان باید بخش اولیه DASH خود را تأیید کنند. |
| SMOOTH_NETWORK | 331* | درخواست XHR برای دریافت مانیفست DASH بدون پاسخ شکست خورد. | برای تشخیص خطاهای مربوط به شبکه به بخش ستاره مراجعه کنید. |
| SMOOTH_NO_MEDIA_ DATA | 332 | بخش دانلود شده برای پردازش حاوی هیچ داده رسانه ای نیست. | توسعه‌دهندگان باید بخش‌های Smooth خود را تأیید کنند. |
| HLS_MANIFEST_MASTER | 411 | تجزیه فایل مانیفست HLS انجام نشد. یا چیزی که MPL هنوز در m3u8 متوجه نشده است | محتوای url مانیفست را بررسی کنید. |
| HLS_MANIFEST_PLAYLIST | 412 | تجزیه فایل فهرست پخش رسانه انجام نشد. یا چیزی که MPL هنوز در m3u8 متوجه نشده است | محتوای URL لیست پخش رسانه را بررسی کنید. |
| DASH_MANIFEST_NO_ PERIODS | 421 | هنگام عادی سازی مانیفست Dash، نقطه در آن پیدا نکردیم. این غیر طبیعی است. | توسعه دهندگان باید مانیفست DASH خود را تأیید کنند. |
| DASH_MANIFEST_NO_ MIMETYPE | 422 | هیچ mimetype برای نمایش در مانیفست وجود ندارد. | توسعه دهندگان باید نوع mime صوتی/تصویری/متن را برای نمایش های خود مشخص کنند. |
| اطلاعات DASH_INVALID_SEGMENT_ | 423 | MPL یک نمایه بخش درخواست می کند که فراتر از طول بخش های موجود باشد که توسط نمایش در مانیفست مشخص شده است. | با استفاده از پیوندهای موجود در صفحه پشتیبانی Google Cast گزارش دهید. |
| SMOOTH_MANIFEST | 431 | مانیفست صاف با استاندارد مطابقت ندارد. | توسعه دهنده باید هر یک از مشکلات زیر را حل کند:
|
کدهای خطای پخش کننده Shaka
برای کدهای خطای مربوط به Shaka Player، به مستندات کلاس خطای Shaka Player مراجعه کنید.
خطاهای رایج شبکه
| خطای HTTP | کد وضعیت | شرح | راه حل |
|---|---|---|---|
| درخواست بد | 400 | درخواست به دلیل نحو نادرست توسط سرور قابل درک نیست. مشتری نباید درخواست را بدون تغییرات تکرار کند. | مشکلی در آدرس اینترنتی وجود دارد. با توسعه دهندگان برنامه چک کنید |
| غیرمجاز | 401 | درخواست نیاز به احراز هویت کاربر دارد | برنامه را بررسی کنید تا ببینید آیا اطلاعات احراز هویت مناسب وجود دارد یا خیر. |
| پیدا نشد | 404 | کلاینت می تواند با سرور ارتباط برقرار کند اما سرور نمی تواند آنچه را که درخواست شده است پیدا کند | توسعه دهندگان منابع url را بررسی می کنند و از وجود آنها اطمینان می یابند. |
| REQUEST_TIMEOUT | 408 | مشتری در مدت زمانی که سرور آماده منتظر ماندن بود درخواستی ارائه نکرد. مشتری ممکن است درخواست را بدون تغییر در هر زمان بعدی تکرار کند. | این می تواند یک منبع (مقیاس پذیری سرور) یا مشکل واقعی شبکه باشد. |
| خطای INTERNAL_SERVER_ | 500 | سرور با یک وضعیت غیرمنتظره مواجه شد که مانع از انجام درخواست شد. | توسعه دهندگان مشکل سرور خود را بررسی می کنند. |
| BAD_GATEWAY | 502 | سرور، در حالی که به عنوان یک دروازه یا پروکسی عمل می کند، یک پاسخ نامعتبر از سرور بالادستی که در تلاش برای انجام درخواست به آن دسترسی داشت، دریافت کرد. | توسعه دهندگان پیکربندی سرور خود را بررسی می کنند. |
| SERVICE_UNAVAILABLE | 503 | سرور در حال حاضر به دلیل بارگذاری بیش از حد موقت یا نگهداری سرور قادر به رسیدگی به درخواست نیست. مفهوم این است که این یک حالت موقتی است که پس از مدتی تأخیر برطرف می شود. | توسعه دهندگان پیکربندی سرور خود را بررسی می کنند، به خصوص مقیاس پذیری خدمات خود را. |
| GATEWAY_TIMEOUT | 504 | سرور، در حالی که به عنوان یک دروازه یا پروکسی عمل می کند، پاسخی به موقع از سرور بالادستی مشخص شده توسط URI دریافت نمی کند. | توسعه دهندگان پیکربندی سرور و اتصال بین سرورهای لبه خود و گره های مبدا را بررسی می کنند. |
یادداشت
یک کد خطا به دنبال ستاره (*) می تواند کدهای خطای بیشتری به آن اضافه شود. قالب این است:
{Error Code}{Closure Network Error Code}{HTTP Status Code}
برای اطلاعات بیشتر، کد وضعیت HTTP را ببینید.
مثال 3016404 دارای سه بخش است:
| 301 | خطای بخش بندی شبکه |
| 6 | خطای HTTP. |
| 404 | وضعیت HTTP یافت نشد. |
ماهیت خطاهای شبکه - دلیل اینکه برخی از این خطاها قابل اجرا هستند در حالی که برخی دیگر قابل اجرا نیستند به دلیل ماهیت عملیات شبکه است. به عنوان مثال، خطای 3018408 که نشان‌دهنده مهلت زمانی است می‌تواند به معنای اتصال بد برای کاربر باشد، جایی که نه تیم Cast و نه توسعه‌دهندگان نمی‌توانند کار زیادی در مورد آن انجام دهند. مراقب باشید این می تواند به این معنی باشد که CDN توسعه دهنده نیز مشکل دارد. از طرف دیگر، خطای 3116403 به این معنی است که درخواست مانیفست با موفقیت انجام شده است اما سرور از ارائه آن خودداری می کند. این می تواند CORS، auth یا هر مشکل دیگری در سرور یا یکپارچه سازی باشد که توسعه دهندگان باید به آن نگاه کنند.