دليل نقل البيانات بشأن إيقاف البث المباشر والقنوات التلقائية نهائيًا

نظرة عامة

هذا الدليل مخصّص لمطوّري تطبيقات عملاء واجهات برمجة التطبيقات التي تستخدم الموارد التلقائية liveStream وliveBroadcast الخاصة بقنوات YouTube لبث المحتوى المباشر. تهدف هذه الأداة إلى مساعدتك في ضمان تعامل تطبيقك بشكل سليم مع إيقاف البثود التلقائية والجداول التلقائية نهائيًا، وهي مهمة لك إذا كانت أي من العبارات التالية تنطبق على تطبيقك:

  • يتحقّق من قيمة السمة isDefaultBroadcast الخاصة بالمرجع liveBroadcast.
  • يتحقّق من قيمة السمة isDefaultStream الخاصة بالمرجع liveStream.

  • يستدعي الطريقة liveBroadcasts.list ويضبط قيمة المَعلمة broadcastType على persistent. اعتبارًا من تاريخ الإيقاف النهائي:

    • إذا كانت قيمة المَعلمة broadcastType هي persistent، لن تعرض الطريقة liveBroadcasts.list أي نتائج.
    • إذا كانت قيمة المَعلمة broadcastType هي all، لن تعرض الطريقة liveBroadcasts.list عمليات البث المستمرة التي كانت متاحة قبل ذلك الوقت.

إذا كان تطبيقك متأثرًا بهذا التغيير، يُرجى الرجوع إلى قسم تعديل تطبيقك الذي يوضّح التغييرات الإجرائية التي قد يحتاج تطبيقك إلى إجرائها نتيجةً لإيقاف هذه الميزة نهائيًا. يحدّد هذا القسم خطوات معيّنة في دليل مراحل البث قد لا يتّبعها عميل واجهة برمجة التطبيقات عادةً إذا كان يستخدم حاليًا البث المباشر والبث التلقائيين.

ما الذي يحدث؟

منذ العام 2015، أنشأ YouTube تلقائيًا بثًا تلقائيًا وبثًا تلقائيًا لقناة معيّنة عند تفعيل ميزة البث المباشر فيها. كانت مجموعة البث التلقائية متاحة إلى أجل غير مسمى ولا يمكن حذفها. وبالمثل، تم اعتبار البث الافتراضي مستمرًا. كانت هذه السمة موجودة دائمًا، ولم يكن لها وقت بدء أو انتهاء مرتبط بها، ولم تكن مرتبطة بحدث معيّن.

اعتبارًا من تاريخ إيقاف الميزة نهائيًا المذكور أعلاه، لن ينشئ YouTube أحداث بث مباشر وفيديوهات بث مباشر تلقائية. يؤثّر هذا التغيير في تطبيقات العملاء التي تعتمد على هذه الموارد لبث محتوى مباشر. سيؤثر ذلك أيضًا في التطبيقات التي يتم فيها تخصيص واجهة المستخدم للتمييز بين هذه الموارد التلقائية وغيرها من عمليات البث المباشر التي أنشأها مالكو القنوات.

بدلاً من الاعتماد على الموارد التلقائية، يجب أن تنشئ برامج API وتدير موارد liveBroadcast وliveStream وتربط هذه الموارد ببعضها.

تعديل طلبك

لإجراء مراجعة سريعة للمصطلحات، يشير مصطلح البث إلى حدث يمكن مشاهدته على YouTube أثناء حدوثه، أما البث المباشر فهو الآلية المستخدَمة لإرسال محتوى الفيديو الفعلي إلى YouTube. يمكن ربط البث المباشر بمصدر بيانات واحد فقط، ويجب ربطه بمصدر بيانات واحد.

نقل البيانات من عمليات البث التلقائية

قبل إيقاف هذه الميزة نهائيًا، كان بإمكان برامج API اختيار استخدام البث التلقائي الخاص بقناة أو إنشاء بث خاص بحدث معيّن. كان البث التلقائي عبارة عن مورد دائم يمكن إعادة استخدامه لأحداث متعددة، بينما مورد البث الخاص بالحدث هو مورد يُستخدم مرة واحدة ويتوافق مع فيديو واحد فقط على YouTube.

يستخدم تطبيق العميل البث التلقائي إذا استدعى الطريقة liveBroadcasts.list وقام بأي مما يلي:

  • يضبط قيمة المَعلمة broadcastType على persistent. لا يستردّ هذا الطلب سوى البث الافتراضي.
  • يتم ضبط قيمة المَعلمة broadcastType على all، ثم يتم تحديد المرجع liveBroadcast في استجابة واجهة برمجة التطبيقات الذي تكون قيمة السمة isDefaultBroadcast فيه هي true.

بعد إيقاف هذه الميزة نهائيًا، لن يتيح YouTube سوى البث المباشر الخاص بالفعاليات. وهذا يعني أنّه بدلاً من الاعتماد على البث التلقائي، يجب أن تنشئ تطبيقات العميل موارد liveBroadcast لكل حدث بث فردي.

لإنشاء مورد liveBroadcast، استخدِم الطريقة liveBroadcasts.insert. يتم شرح هذه العملية في الخطوة 1.1 من دليل "دورة حياة البث المباشر".

إذا لم تكن واجهة المستخدم توفّر هذه الآليات، يجب أن توفّرها ليتمكّن المستخدمون من التمييز بين عمليات البث الخاصة بالأحداث القادمة واختيارها.

نقل البيانات من مصادر البيانات التلقائية

يتيح لك البث نقل محتوى صوتي مرئي إلى YouTube، ويحدّد إعدادات طريقة بث المحتوى إلى YouTube. من الشائع أن يعيد المذيعون استخدام البث المباشر نفسه في العديد من عمليات البث المختلفة إذا كانت عمليات البث هذه تحدث في أوقات مختلفة.

على الرغم من أنّ تطبيقك لا يمكنه استخدام البث التلقائي، يمكنه إنشاء بث قابل لإعادة الاستخدام يمكن إعادة استخدامه لكل عملية بث. لإنشاء liveStream مورد، استخدِم طريقة liveStreams.insert باتّباع التعليمات الواردة في الخطوة 1.2 من دليل "دورة حياة البث". بشكل تلقائي، يمكن إعادة استخدام ساحات المشاركات التي تم إنشاؤها حديثًا. ومع ذلك، يمكنك ضبط قيمة السمة contentDetails.isReusable على false إذا كنت تفضّل ذلك، وذلك لإنشاء أحداث بث لمرة واحدة وإقامة علاقة فردية بين عمليات البث وأحداث البث.

تحتوي القائمة التالية على أربع سمات، بالإضافة إلى عنوان البث ووصف البث، يمكنك ضبطها عند إنشاء بث جديد. تعرض القائمة القيم التي تستخدمها مصادر البيانات التلقائية لكل سمة، وهي على الأرجح الإعدادات التي تريد استخدامها في تطبيق العميل إذا كنت بصدد التوقّف عن استخدام مصادر البيانات التلقائية.

ربط عمليات البث بمصادر البيانات

يجب ربط كل مصدر liveBroadcast ببث واحد فقط قبل أن يتمكّن المستخدم من بدء البث المباشر على YouTube. (لا يكون البث المباشر مرتبطًا بأي مصادر بيانات عند إنشائه).

تمت معالجة عملية الربط تلقائيًا للبث التلقائي الذي كان مرتبطًا بشكل وثيق بالبث التلقائي. ومع ذلك، بعد تاريخ الإيقاف النهائي، يجب أن تتولّى تطبيقات العميل إدارة هذه العملية لجميع عمليات البث.

لربط بث مباشر ببث، استخدِم طريقة liveBroadcasts.bind كما هو موضّح في الخطوة 1.3 من دليل "دورة حياة البث المباشر".

  • إذا كنت تستخدم بثًا قابلاً لإعادة الاستخدام، يمكنك إنشاء بث واحد ثم ربط كل بث مباشر بهذا البث.
  • إذا كنت لا تستخدم بثًا قابلاً لإعادة الاستخدام، عليك إنشاء بث مباشر وقناة بث، ثم ربط هذين العنصرين معًا.

اختبار البث

عندما لا تستخدم البث التلقائي، يمكنك اختبار البث. لإجراء اختبار، عليك تضمين مشغّل يتيح لك معاينة فيديو البث المباشر كما سيظهر لمشاهدي YouTube، ولكن لن يكون البث مرئيًا للمشاهدين الآخرين.

إذا كان برنامج واجهة برمجة التطبيقات يستخدِم البث المباشر والقناة التلقائيين، وأردت إضافة مرحلة اختبار إلى عملية البث المباشر، يمكنك الاطّلاع على المرحلة 3 من دليل "دورة حياة البث المباشر".

إذا أردت اختبار البث، عليك ضبط قيمة السمة contentDetails.monitorStream.enableMonitorStream على true وقيمة السمة contentDetails.enableAutoStart على false عند إدراج بث. هذه هي القيم التلقائية لكلتا السمتَين.

استخدام ميزتَي التشغيل والإيقاف التلقائي

كان يبدأ البث التلقائي تلقائيًا كلما بدأت ببث فيديو على قناة البث التلقائية. وبالمثل، انتهى البث التلقائي بعد أن توقفت عن بث الفيديو. أصبحت كل جلسة بث مباشر تستخدم هذه الموارد التلقائية فيديو في قناتك.

في حين أنّ ميزتَي البدء والإيقاف التلقائي كانتا السلوك التلقائي لعمليات البث التلقائي، إلا أنّ هاتين الميزتَين اختياريتان ويجب تفعيلهما لعمليات البث الأخرى. إذا أردت استخدام هذه الميزات، عليك ضبط قيمتَي السمتَين contentDetails.enableAutoStart وcontentDetails.enableAutoStop على true عند إدراج بث. هذه الميزات مستقلة، لذا يمكنك اختيار استخدام إحداها دون الأخرى.

إذا لم تفعّل ميزتَي البدء والإيقاف التلقائيَين للبث المباشر الجديد، على برنامج واجهة برمجة التطبيقات استدعاء طريقة liveBroadcasts.transition لتعديل حالة البث المباشر عند بدء بث الفيديو وإنهائه. في دليل "مراحل البث"، يمكنك الاطّلاع على الخطوة 4.3 والخطوة 5.2 للحصول على تعليمات حول إدارة عمليات الانتقال هذه في بداية البث ونهايته.