Руководство по миграции для прекращения поддержки широковещательных передач и потоков по умолчанию,Руководство по миграции для прекращения поддержки широковещательных передач и потоков по умолчанию

Обзор

Это руководство предназначено для разработчиков клиентских приложений API, которые используют ресурсы liveStream и liveBroadcast каналов YouTube по умолчанию для прямой трансляции контента. Он направлен на то, чтобы помочь вам убедиться, что ваше приложение изящно обрабатывает устаревшие широковещательные рассылки и потоки по умолчанию, и для вас важно, применимо ли к вашему приложению какое-либо из следующих утверждений:

  • Он проверяет значение свойства isDefaultBroadcast ресурса liveBroadcast .
  • Он проверяет значение свойства isDefaultStream ресурса liveStream .
  • Он вызывает метод liveBroadcasts.list и устанавливает для параметра broadcastType значение persistent . На дату устаревания:

    • Если значение параметра broadcastType является persistent , то метод liveBroadcasts.list не вернет никаких результатов.
    • Если значением параметра broadcastType является all , метод liveBroadcasts.list не будет возвращать постоянные трансляции, существовавшие до этого времени.

Если ваше приложение затронуто, обратитесь к разделу Обновление вашего приложения , в котором объясняются процедурные изменения, которые может потребоваться внести в ваше приложение в результате этого устаревания. В этом разделе указаны конкретные шаги в руководстве Life of a Broadcast , которым обычно не следует следовать вашему клиенту API, если он в настоящее время использует широковещательную рассылку и поток по умолчанию.

Что происходит?

С 2015 года YouTube автоматически создает поток по умолчанию и трансляцию по умолчанию для канала, когда этот канал включен для прямой трансляции. Поток по умолчанию существовал бесконечно долго и не мог быть удален. Точно так же широковещательная рассылка по умолчанию считалась постоянной . Он существовал всегда, не имел времени начала или окончания, связанного с ним, и не был привязан к конкретному событию.

Начиная с даты устаревания, упомянутой выше, YouTube больше не будет создавать потоки и трансляции по умолчанию. Это изменение затрагивает клиентские приложения, использующие эти ресурсы для прямой трансляции контента. Это также повлияет на приложения, в которых пользовательский интерфейс настроен так, чтобы различать эти ресурсы по умолчанию и другие трансляции и потоки, созданные владельцами каналов.

Вместо того чтобы полагаться на ресурсы по умолчанию, клиентам API необходимо создавать и управлять ресурсами liveBroadcast и liveStream , а также связывать эти ресурсы вместе.

Обновление вашего приложения

Чтобы быстро просмотреть терминологию, трансляция представляет собой событие, которое можно наблюдать на YouTube в момент его возникновения, а поток — это механизм отправки фактического видеоконтента на YouTube. Трансляция может и должна быть привязана ровно к одному потоку.

Миграция с широковещательных передач по умолчанию

До этого устаревания клиенты API могли выбирать между использованием трансляции канала по умолчанию или созданием трансляции для конкретного события. Трансляция по умолчанию была постоянным ресурсом, который можно было повторно использовать для нескольких событий, в то время как ресурс трансляции для конкретного события — это одноразовый ресурс, который соответствует ровно одному видео YouTube.

Ваше клиентское приложение использует широковещательную рассылку по умолчанию, если оно вызывает метод liveBroadcasts.list и выполняет одно из следующих действий:

  • Он устанавливает для параметра broadcastType значение persistent . Этот запрос извлекает только широковещательную рассылку по умолчанию.
  • Он устанавливает для параметра broadcastType значение all , а затем идентифицирует ресурс liveBroadcast в ответе API, для которого значение свойства 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, но трансляция не будет видна другим зрителям.

Если ваш API-клиент ранее использовал широковещательную и потоковую передачу по умолчанию, и вы хотите добавить этап тестирования в процесс потоковой передачи, см. этап 3 руководства «Жизнь трансляции» .

Если вы хотите протестировать свой поток, то при вставке трансляции вам необходимо установить для свойства contentDetails.monitorStream.enableMonitorStream значение true , а для свойства contentDetails.enableAutoStart — значение false . Это значения по умолчанию для обоих свойств.

Использование функций автозапуска и автоостановки

Трансляция по умолчанию автоматически запускается всякий раз, когда вы запускаете потоковое видео в потоке по умолчанию. Точно так же трансляция по умолчанию закончилась после того, как вы остановили потоковое видео. Каждый сеанс потоковой передачи с использованием этих ресурсов по умолчанию впоследствии становится видео на вашем канале.

Хотя функции автозапуска и автоостановки были стандартным поведением для широковещательных передач по умолчанию, эти функции являются необязательными и должны быть включены для других широковещательных передач. Если вы хотите использовать эти функции, то при вставке трансляции вам необходимо установить для свойств contentDetails.enableAutoStart и contentDetails.enableAutoStop значения true . Эти функции независимы, поэтому вы можете использовать одну из них, а не другую.

Если вы не включаете функции автоматического запуска и автоматической остановки для новых трансляций, ваш клиент API должен вызывать метод liveBroadcasts.transition для обновления статуса трансляции при запуске и завершении потокового видео. В руководстве «Жизнь трансляции» см. шаги 4.3 и 5.2 для получения инструкций по управлению этими переходами в начале и конце трансляции.

,

Обзор

Это руководство предназначено для разработчиков клиентских приложений API, которые используют ресурсы liveStream и liveBroadcast каналов YouTube по умолчанию для прямой трансляции контента. Он направлен на то, чтобы помочь вам убедиться, что ваше приложение изящно обрабатывает устаревшие широковещательные рассылки и потоки по умолчанию, и для вас важно, применимо ли к вашему приложению какое-либо из следующих утверждений:

  • Он проверяет значение свойства isDefaultBroadcast ресурса liveBroadcast .
  • Он проверяет значение свойства isDefaultStream ресурса liveStream .
  • Он вызывает метод liveBroadcasts.list и устанавливает для параметра broadcastType значение persistent . На дату устаревания:

    • Если значение параметра broadcastType является persistent , то метод liveBroadcasts.list не вернет никаких результатов.
    • Если значением параметра broadcastType является all , метод liveBroadcasts.list не будет возвращать постоянные трансляции, существовавшие до этого времени.

Если ваше приложение затронуто, обратитесь к разделу Обновление вашего приложения , в котором объясняются процедурные изменения, которые может потребоваться внести в ваше приложение в результате этого устаревания. В этом разделе указаны конкретные шаги в руководстве Life of a Broadcast , которым обычно не следует следовать вашему клиенту API, если он в настоящее время использует широковещательную рассылку и поток по умолчанию.

Что происходит?

С 2015 года YouTube автоматически создает поток по умолчанию и трансляцию по умолчанию для канала, когда этот канал включен для прямой трансляции. Поток по умолчанию существовал бесконечно долго и не мог быть удален. Точно так же широковещательная рассылка по умолчанию считалась постоянной . Он существовал всегда, не имел времени начала или окончания, связанного с ним, и не был привязан к конкретному событию.

Начиная с даты устаревания, упомянутой выше, YouTube больше не будет создавать потоки и трансляции по умолчанию. Это изменение затрагивает клиентские приложения, использующие эти ресурсы для прямой трансляции контента. Это также повлияет на приложения, в которых пользовательский интерфейс настроен так, чтобы различать эти ресурсы по умолчанию и другие трансляции и потоки, созданные владельцами каналов.

Вместо того чтобы полагаться на ресурсы по умолчанию, клиентам API необходимо создавать и управлять ресурсами liveBroadcast и liveStream , а также связывать эти ресурсы вместе.

Обновление вашего приложения

Чтобы быстро просмотреть терминологию, трансляция представляет собой событие, которое можно наблюдать на YouTube в момент его возникновения, а поток — это механизм отправки фактического видеоконтента на YouTube. Трансляция может и должна быть привязана ровно к одному потоку.

Миграция с широковещательных передач по умолчанию

До этого устаревания клиенты API могли выбирать между использованием трансляции канала по умолчанию или созданием трансляции для конкретного события. Трансляция по умолчанию была постоянным ресурсом, который можно было повторно использовать для нескольких событий, в то время как ресурс трансляции для конкретного события — это одноразовый ресурс, который соответствует ровно одному видео YouTube.

Ваше клиентское приложение использует широковещательную рассылку по умолчанию, если оно вызывает метод liveBroadcasts.list и выполняет одно из следующих действий:

  • Он устанавливает для параметра broadcastType значение persistent . Этот запрос извлекает только широковещательную рассылку по умолчанию.
  • Он устанавливает для параметра broadcastType значение all , а затем идентифицирует ресурс liveBroadcast в ответе API, для которого значение свойства 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, но трансляция не будет видна другим зрителям.

Если ваш API-клиент ранее использовал широковещательную и потоковую передачу по умолчанию, и вы хотите добавить этап тестирования в процесс потоковой передачи, см. этап 3 руководства «Жизнь трансляции» .

Если вы хотите протестировать свой поток, то при вставке трансляции вам необходимо установить для свойства contentDetails.monitorStream.enableMonitorStream значение true , а для свойства contentDetails.enableAutoStart — значение false . Это значения по умолчанию для обоих свойств.

Использование функций автозапуска и автоостановки

Трансляция по умолчанию автоматически запускается всякий раз, когда вы запускаете потоковое видео в потоке по умолчанию. Точно так же трансляция по умолчанию закончилась после того, как вы остановили потоковое видео. Каждый сеанс потоковой передачи с использованием этих ресурсов по умолчанию впоследствии становится видео на вашем канале.

Хотя функции автозапуска и автоостановки были стандартным поведением для широковещательных передач по умолчанию, эти функции являются необязательными и должны быть включены для других широковещательных передач. Если вы хотите использовать эти функции, то при вставке трансляции вам необходимо установить для свойств contentDetails.enableAutoStart и contentDetails.enableAutoStop значения true . Эти функции независимы, поэтому вы можете использовать одну из них, а не другую.

Если вы не включаете функции автоматического запуска и автоматической остановки для новых трансляций, ваш клиент API должен вызывать метод liveBroadcasts.transition для обновления статуса трансляции при запуске и завершении потоковой передачи видео. В руководстве «Жизнь трансляции» см. шаги 4.3 и 5.2 для получения инструкций по управлению этими переходами в начале и конце трансляции.