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 ثانية. تجدر الإشارة إلى أنّ أخطاء العرض قد تؤدي إلى إنشاء مجموعة صور بأحجام غير صحيحة.
gopSizeOver	السبب: تحقق من إعدادات الفيديو الوصف: يرجى ضبط فترة تكرار الإطارات الأساسية إلى أربع ثوانٍ أو أقل. إنّ فترة تكرار إرسال الإطارات الرئيسية أقلّ من اللازم، ما قد يؤدي إلى حدوث تخزين مؤقت. إنّ الفاصل الحالي بين الإطارات الرئيسية هو %(actual_gop).1f ثانية. تجدر الإشارة إلى أنّ أخطاء العرض قد تؤدي إلى إنشاء مجموعة صور بأحجام غير صحيحة.
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).