Configuration Issues for LiveStream Resources
في مورد liveStream
، يحتوي الكائن status.healthStatus.configurationIssues[]
على قائمة بمشاكل الضبط التي تؤثر على البث. وتهدف هذه المعلومات إلى مساعدتك في تحديد المشاكل التي تؤثر في جودة بث الفيديو المباشر وتشخيصها وحلّها.
يسرد هذا المستند أنواع مشاكل التهيئة التي قد تتم الإشارة إليها في استجابة واجهة برمجة التطبيقات. تحدد كل مشكلة نوع المشكلة، ووصفًا موجزًا للخطأ، ووصفًا أطول يحتوي غالبًا على معلومات توضح كيفية إصلاح الخطأ.
مشكلات التهيئة
يعرض الجدول أدناه مشاكل الضبط التي يمكن أن تؤثر في فيديوهات البث المباشر. يحدد العمود الأيمن نوع المشكلة ويقدم العمود الأيسر تفاصيل إضافية حول كيفية حلها.
يُرجى العِلم أنّ بعض الأوصاف تتضمّن متغيرات ستتمّ تعبئتها لتعكس البيانات المتعلّقة بالبث المباشر الفعلي. في الأوصاف أدناه، يحدد نص في نمط <code>
، مثل %(actual_gop).1f
، جزءًا من رسالة خطأ يتم تخصيصها لكل بث مباشر. يجب أن تكون الشفرة بعيدة عن أنواع المشاكل، الموجودة في العمود الأيمن.
مشكلات التهيئة |
audioBitrateHigh |
السبب: | تحقق من إعدادات الصوت |
الوصف: | يبلغ معدل البت الحالي للبث الصوتي %(actual) أعلى من معدل البت الموصى به. ننصحك باستخدام معدل نقل بيانات للبث الصوتي يبلغ %(expected)s . |
|
audioBitrateLow |
السبب: | تحقق من إعدادات الصوت |
الوصف: | إنّ معدل البت الحالي للبث الصوتي (%(actual)s) أقل من المعدل الموصى به. ننصحك باستخدام معدل نقل بيانات للبث الصوتي يبلغ %(expected)s . |
|
audioBitrateMismatch |
السبب: | تحقق من البث الثانوي |
الوصف: | في التكوين الحالي، تختلف معدلات بت الصوت لبث الفيديو الأساسي عن معدلات بت الصوت لبث الفيديو الاحتياطي. يجب إعداد مجموعات البث وتعيين معدل البت للصوت نفسه. |
|
audioCodec |
السبب: | تحقق من إعدادات الصوت |
الوصف: | تمّ ترميز البث الصوتي باستخدام برنامج ترميز غير متوافق. يُرجى ضبط برنامج متوافق لترميز البث الصوتي (مثلاً AAC أو MP3). |
|
audioCodecMismatch |
السبب: | البث الثانوي سيئ |
الوصف: | في التكوين الحالي، يستخدم بث الفيديو الأساسي وبث الفيديو الاحتياطي برامج مختلفة لترميز الصوت. يجب تهيئة مجموعات البث لاستخدام برنامج ترميز الصوت نفسه. |
|
audioSampleRate |
السبب: | تحقق من إعدادات الصوت |
الوصف: | يبلغ معدل العينة الحالي %(actual) . ويُذكر أن معدلات العينات الموصى بها هي 44,1 كيلو هرتز و48 كيلو هرتز. |
|
audioSampleRateMismatch |
السبب: | البث الثانوي سيئ |
الوصف: | في التكوين الحالي، تختلف معدلات عينة الصوت لبث الفيديو الأساسي عن معدلات عينة الصوت لبث الفيديو المباشر. يجب إعداد مجموعات البث وتعيين معدل عينة الصوت نفسه. |
|
audioStereoMismatch |
السبب: | البث الثانوي سيئ |
الوصف: | في تهيئة الإعدادات الحالية، يستخدم بث الفيديو الأساسي وبث الفيديو الاحتياطي قنوات صوتية مختلفة. عليك تعيين القناة الصوتية نفسها لمجموعات البث. |
|
audioTooManyChannels |
السبب: | تحقق من إعدادات الصوت |
الوصف: | يحتوي المقطع الصوتي على أكثر من قناتين، ولكن تتوفر قناة واحدة (أحادية) أو قناتين (استريو) فقط. يُرجى تصحيح عدد القنوات الصوتيّة. |
|
badContainer |
السبب: | إعدادات الفيديو غير صحيحة |
الوصف: | يُرجى تغيير تنسيق حاوية الفيديو. تنسيق الحاوية الحالي غير صحيح لهذه التهيئة. |
|
bitrateHigh |
السبب: | تحقق من إعدادات الفيديو |
الوصف: | إنّ معدل البت الحالي للبث (%(actual)s) أعلى من معدل البت الموصى به. ننصحك باستخدام معدل نقل بيانات للبث يبلغ %(expected)s . |
|
bitrateLow |
السبب: | إخراج الفيديو منخفض |
الوصف: | إنّ معدل البت الحالي للبث (%(actual)s) أقل من معدل البت الموصى به. ننصحك باستخدام معدل نقل بيانات للبث يبلغ %(expected)s . |
|
framerateMismatch |
السبب: | تحقق من البث الثانوي |
الوصف: | في التكوين الحالي، تختلف معدلات عرض الإطارات لبث الفيديو الأساسي عن معدلات عرض الإطارات الاحتياطية. يجب تكوين مجموعات البث وتعيين معدل عرض الإطارات نفسه. |
|
frameRateHigh |
السبب: | عدد اللقطات مرتفع |
الوصف: | معدل عرض الإطارات الحالي مرتفع جدًا. يُرجى ضبط معدل عرض الإطارات على %(framerate)s إطار في الثانية أو أقل. |
|
gopMismatch |
السبب: | البث الثانوي سيئ |
الوصف: | في التكوين الحالي، تختلف أوقات عرض الإطارات الأساسية لبث الفيديو الاحتياطي عن معدل عرض الإطارات الأساسية. يجب ضبط مجموعات البث على فترة تكرار الإطارات الأساسية نفسها. |
|
gopSizeLong |
السبب: | إعدادات الفيديو غير صحيحة |
الوصف: | يُرجى ضبط فترة تكرار الإطارات الرئيسية على أربع ثوانٍ أو أقل. إنّ فترة تكرار إرسال الإطارات الأساسيّة أقل من اللازم حاليًا، ما سيؤدي إلى حدوث تخزين مؤقت. يبلغ معدل تكرار الإطارات الأساسية الحالي %(actual_gop).1f ثانية. يُرجى العِلم أنّ أخطاء العرض قد تؤدي إلى إنشاء مجموعة صور (GOP) بأحجام غير صحيحة. |
|
gopSizeOver |
السبب: | تحقق من إعدادات الفيديو |
الوصف: | يُرجى ضبط فترة تكرار الإطارات الرئيسية على أربع ثوانٍ أو أقل. إنّ فترة تكرار إرسال الإطارات الرئيسية أقلّ من اللازم، ما قد يؤدي إلى حدوث تخزين مؤقت. يبلغ معدل تكرار الإطارات الأساسية الحالي %(actual_gop).1f ثانية. يُرجى العِلم أنّ أخطاء العرض قد تؤدي إلى إنشاء مجموعة صور (GOP) بأحجام غير صحيحة. |
|
gopSizeShort |
السبب: | تحقق من إعدادات الفيديو |
الوصف: | إنّ حجم مجموعة الصور صغير جدًا ما قد يؤدي إلى خفض جودة الصورة. تبلغ فترة تكرار الإطارات الرئيسية المقترحة أربع ثوانٍ. يبلغ معدل تكرار الإطارات الأساسية الحالي %(actual_gop).1f ثانية. ويمكن أن تؤدي أخطاء العرض إلى إنشاء GOP بأحجام غير صحيحة. |
|
multipleAudioStreams |
السبب: | تحقق من إعدادات الصوت |
الوصف: | تتضمن مجموعة البث مقاطع صوتية متعددة في حين يجب أن تتضمن بثًا صوتيًا واحدًا فقط. |
|
multipleVideoStreams |
السبب: | إعدادات الفيديو غير صحيحة |
الوصف: | تتضمن مجموعة البث فيديوهات متعددة في حين يجب أن تتضمن بث فيديو واحدًا فقط. |
|
noAudioStream |
السبب: | عدم توفُّر صوت |
الوصف: | لا تتضمن مجموعة البث أي بث صوتي في حين يجب أن تتضمن بثًا صوتيًا واحدًا بالضبط. |
|
noVideoStream |
السبب: | لا يتوفر فيديو |
الوصف: | لا تتضمن مجموعة البث أي بث فيديو في حين يجب أن تتضمن بث فيديو واحدًا بالضبط. |
|
openGop |
السبب: | إعدادات الفيديو غير صحيحة |
الوصف: | يُرجى تغيير إعدادات برنامج ترميز الفيديو إلى "مجموعة صور (GOP) مغلقة". يبدو أنها معيّنة إلى مجموعة صور "GOP" مفتوحة ولا يدعمها YouTube. |
|
resolutionMismatch |
السبب: | البث الثانوي سيئ |
الوصف: | في التكوين الحالي، تختلف درجة دقة البث لبث الفيديو الأساسي عن درجة دقة بث الفيديو الاحتياطي. يجب تهيئة مجموعات البث للحصول على الدقة نفسها. |
|
videoBitrateMismatch |
السبب: | تحقق من البث الثانوي |
الوصف: | في التكوين الحالي، تختلف معدلات بت الفيديو لبث الفيديو الأساسي عن معدلات البت لبث الفيديو الاحتياطي. يجب إعداد مجموعات البث وتعيين معدل نقل البيانات نفسه للفيديو. |
|
videoCodec |
السبب: | إعدادات الفيديو غير صحيحة |
الوصف: | تم ترميز الفيديو باستخدام برنامج ترميز غير معتمد. يرجى تعيين برنامج ترميز معتمد لترميز بث الفيديو (مثلاً H.264). |
|
videoCodecMismatch |
السبب: | البث الثانوي سيئ |
الوصف: | في التكوين الحالي، يستخدم بث الفيديو الأساسي وبث الفيديو الاحتياطي برامج مختلفة لترميز الفيديو. يجب تكوين مجموعات البث وتعيين برامج ترميز الفيديو نفسها. |
|
videoIngestionStarved |
السبب: | إخراج الفيديو منخفض |
الوصف: | لا يتلقى YouTube ما يكفي من الفيديو للحفاظ على سلاسة البث. وبالتالي، سيتم تخزين الفيديو مؤقتًا لدى المشاهدين. |
|
videoInterlaceMismatch |
السبب: | البث الثانوي سيئ |
الوصف: | في التكوين الحالي، يختلف تداخل الفيديو الأساسي عن بث الفيديو الاحتياطي. يجب تهيئة مجموعات البث للحصول على التداخل نفسه. |
|
videoProfileMismatch |
السبب: | البث الثانوي سيئ |
الوصف: | في التكوين الحالي، يختلف الملف الشخصي لبث الفيديو الأساسي عن بث الفيديو الاحتياطي. يجب تهيئة ساحات المشاركات للحصول على الملف الشخصي نفسه. |
|
videoResolutionSuboptimal |
السبب: | تحقق من درجة الدقة |
الوصف: | يُرجى التحقّق من درجة دقة الفيديو. تبلغ درجة الدقة الحالية (%(actual_w)dx%(actual_h)d) ، وهي ليست درجة الدقة المثالية. |
|
videoResolutionUnsupported |
السبب: | درجة دقة غير معتمدة |
الوصف: | عليك تغيير درجة دقة الفيديو. تبلغ درجة الدقة الحالية (%(actual_w)dx%(actual_h)d) ، وهي غير معتمدة لهذه التهيئة. تبلغ درجة دقة الفيديو المتوقعة (%(expected_w)dx%(expected_h)d) . |
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2023-02-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2023-02-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The `status.healthStatus.configurationIssues[]` object in a liveStream resource identifies configuration problems affecting the quality of live video streams, and is used for troubleshooting."],["The document lists various configuration issues that can affect live video streams, detailing the issue type, a brief error description, and an explanation of how to rectify it."],["Configuration issues are categorized into different types, including problems with audio, video, bitrate, framerate, codecs, keyframe frequencies, and inconsistencies between primary and backup streams."],["Many descriptions of the configuration issues include variables, like `%(actual)` or `%(expected)s`, which are customized to reflect the specific details of each live stream's errors."],["Resolutions are based on the \"issue type\", for example: `audioBitrateLow`, `bitrateHigh`, `gopSizeLong`, allowing developers to build solutions based on these type of errors."]]],["Live streams may have configuration issues that impact quality. The `configurationIssues` object lists these problems, detailing the issue type, a short description, and a longer explanation for resolution. Issues include bitrate, codec, sample rate, and channel problems for audio; and bitrate, framerate, GOP, resolution, and codec issues for video. Mismatches between primary and backup streams are also noted. Actions to take involve checking settings, ensuring correct formats, and matching properties between streams.\n"]]