HLS о миграции игрока Shaka

Обзор

SDK Cast Web Receiver поддерживает воспроизведение контента с использованием нескольких протоколов веб-трансляции . В зависимости от используемого протокола SDK загружает проигрыватель для обработки воспроизведения контента. В случае контента HLS загружается библиотека Media Player Library ( MPL ). В случае контента DASH загружается Shaka Player .

В дальнейшем команды разработчиков Cast SDK и Shaka Player объединяют усилия для расширения поддержки воспроизведения HLS-контента в Shaka Player. MPL больше не будет получать критически важные обновления . Мы рекомендуем вам выбрать Shaka Player для воспроизведения HLS-контента в вашем приложении.

Преимущества игрока Шака

При смене игроков приложения используют следующие преимущества:

  • Более надежная потоковая передача данных для пользователей, улучшена производительность при ошибках загрузки и снижена задержка.
  • Продолжается внедрение новейших функций HLS.
  • Благодаря открытому исходному коду Shaka Player , повышается ясность анализа первопричин проблем совместимости плеера и контента.
  • Открытый исходный код плеера позволяет партнерам вносить свой вклад в проект Shaka Player.
  • Значительное сокращение времени на разработку новых функций и исправление ошибок, поскольку Shaka Player выпускается часто и независимо от релизов SDK Web Receiver.
  • API shakaVersion обеспечивает более полный контроль над средой воспроизведения .
  • Компания Google расширила поддержку воспроизведения, сосредоточив инженерные ресурсы на воспроизведении HLS в Shaka Player, как это предусмотрено в плане развития проекта .

Хронология

В рамках перехода на использование Shaka Player в качестве проигрывателя по умолчанию для воспроизведения HLS-контента, SDK Web Receiver будет использоваться поэтапно, чтобы помочь партнерам в процессе миграции.

Фаза Дата начала Обзор
1 Октябрь 2022 г. В состав Cast Web Receiver SDK вошли API-интерфейсы, позволяющие включать воспроизведение HLS-контента на Shaka Player.
2 18 мая 2026 г. В SDK Cast Web Receiver для воспроизведения HLS-контента по умолчанию был изменен плеер на Shaka Player .

Команды разработчиков Web Receiver SDK придерживаются подхода, ориентированного на производительность, и перейдут к следующему этапу только тогда, когда производительность Shaka Player сравняется с базовой производительностью MPL. Об этих изменениях будет объявлено в группе Google cast-sdk-announcements, а также информация будет обновлена ​​в этом руководстве.

Согласиться

Начиная с версии CAF 3.0.0105 , появилась возможность настройки на уровне приложения для включения использования Shaka Player для воспроизведения HLS. В этой версии также представлен API для выбора поддерживаемого диапазона версий Shaka Player для загрузки. Эти флаги предоставляются в классе CastReceiverOptions через свойства useShakaForHls и shakaVersion и оцениваются при запуске CastReceiverContext . Любое приложение, включающее Shaka для HLS, должно установить версию Shaka Player не ниже 4.15.35 , чтобы воспользоваться преимуществами последних улучшений HLS. Для включения используйте приведенный ниже фрагмент кода:

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = true;

context.start(castReceiverOptions);

Проверить содержимое

Перед использованием Shaka Player в рабочем приложении партнерам следует проверить воспроизведение контента на Shaka Player. Мы рекомендуем протестировать каждый из перечисленных ниже вариантов контента:

  • Типы трансляции: прямая трансляция или видео по запросу.
  • Форматы контейнеров: TS, MP4 или элементарные потоки.
  • Контент с разрывами или встроенной рекламой.
  • Воспроизведение на следующих типах устройств: смарт-дисплеи, адаптеры Google Cast, устройства Android TV, телевизоры с Google Cast, умные колонки.

Если вы обнаружите какие-либо ошибки или неожиданное поведение, сообщите об ошибке . Как только вы убедитесь в отсутствии критических сбоев воспроизведения в вашем контенте, внесите изменения в рабочую среду.

Уклоняться

В соответствии с графиком , SDK Web Receiver перейдет к модели отказа от воспроизведения HLS-контента Shaka Player. Значение свойства useShakaForHls по умолчанию изменится с false на true . В это время приложения смогут выбрать использование MPL для воспроизведения HLS, вручную установив это свойство в значение false . При запуске CastReceiverContext SDK Web Receiver вернется к загрузке MPL вместо Shaka Player. Пример отказа от использования MPL приведен ниже:

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;

context.start(castReceiverOptions);

Сообщить о проблемах

Мы призываем наших партнеров сообщать о любых проблемах, которые они обнаружат при воспроизведении контента HLS. Как уже упоминалось, MPL больше не будет получать критические обновления. Если вы столкнулись с какими-либо проблемами в работе MPL, выполните действия, описанные в разделе «Подключение », чтобы проверить, решит ли переключение на Shaka Player вашу проблему. Выполните следующие действия, если проблема сохраняется или если вы столкнулись с другой проблемой при переключении плееров.

  1. Попробуйте установить значение параметра shakaVersion на версию другой ветки, чтобы решить проблему. Например, если проблема наблюдается в ветке 4.15 , попробуйте установить значение последней версии в другой ветке. Проверьте примечания к выпуску Shaka Player , чтобы найти релизы с наиболее актуальными обновлениями. Обратите внимание, что API shakaVersion имеет минимальную и максимальную поддерживаемые версии, как подробно описано в справочной документации. Если вы обнаружите регрессию, сообщите о проблеме в системе отслеживания ошибок Shaka Player .
  2. Попробуйте изменить параметры конфигурации проигрывателя. Shaka Player настраивается через объект PlayerConfiguration . SDK Web Receiver определяет набор значений по умолчанию и позволяет приложениям изменять эту конфигурацию через свойство shakaConfig в объекте PlaybackConfig . Это оценивается во время загрузки при создании экземпляра проигрывателя. Подробнее см. в разделе «Конфигурация и параметры приложения» . Рекомендуемыми являются значения по умолчанию, установленные SDK Web Receiver.
  3. Проверьте, сообщалось ли о проблеме в системе отслеживания ошибок Shaka Player или Cast . Оставьте комментарий к ошибке и добавьте любую соответствующую информацию, если она также описывает вашу проблему.
  4. Протестируйте свой контент на демонстрационном сайте Shaka Player . Если вы обнаружите, что проблема воспроизводится на демонстрационном сайте для вашего контента, сообщите об ошибке в проект Shaka Player.
  5. Сообщите об ошибке в систему отслеживания ошибок Cast Issue Tracker, если у вас возникла проблема, уникальная для Shaka Player на конечных точках трансляции.

Часто задаваемые вопросы

Смена игроков может вызвать множество вопросов. Ниже вы найдете ответы на наиболее часто задаваемые вопросы, которые помогут вам в процессе миграции.

Стоит ли мне перейти на Shaka Player?

Мы рекомендуем нашим партнерам, использующим контент HLS, начать процесс миграции как можно скорее. В результате ваше приложение обеспечит более качественное потоковое воспроизведение для ваших пользователей. Дополнительные преимущества описаны в разделе «Преимущества Shaka Player» этого руководства. Партнерам следует убедиться в корректной работе своих приложений с Shaka Player для обеспечения плавного перехода. Некоторые приложения могут оказаться под угрозой при переходе SDK Web Receiver на модель с возможностью отказа от использования, если партнеры заранее не убедятся в корректном воспроизведении своего контента в Shaka Player.

Какой уровень усилий ожидается при смене игроков?

Партнерам потребуется протестировать свои приложения и контент в тестовой среде, чтобы убедиться, что пользовательский опыт аналогичен или улучшен по сравнению с HLS. Для этого партнерам необходимо включить эту функцию во внутренней среде и тщательно протестировать возможность воспроизведения контента с помощью Shaka Player. Подробную информацию о том, на какие аспекты контента следует обратить внимание, см. в разделе « Проверка контента» . После проверки партнерам необходимо добавить соответствующий флаг в свою рабочую среду приложения, чтобы начать пользоваться преимуществами Shaka Player. В целом, для успешной миграции партнеров потребуются минимальные изменения в разработке программного обеспечения и в основном требования к контролю качества.

В моём приложении скоро появится возможность использовать HLS для потоковой передачи контента, что мне следует сделать?

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

Мой контент или приложение не работает с Shaka Player, что делать дальше?

Вам следует сообщить об ошибке либо в проект Shaka Player, либо в проект Cast (см. раздел «Сообщить о проблемах »). Команда разработчиков Cast SDK активно отслеживает эти трекеры и будет сотрудничать с вами для решения любых возникших проблем. Чем раньше будут обнаружены проблемы, тем больше времени у них будет на их исправление.

MPL больше не получает критически важных обновлений. Что это значит?

Исторически сложилось так, что MPL внедрял новые функции HLS и исправлял основные ошибки посредством критических обновлений. Теперь, когда MPL больше не будет получать обновления, новые функции HLS в плеер добавляться не будут. Аналогично, любые сообщенные проблемы с воспроизведением HLS в MPL не будут исправлены в MPL. Эти проблемы следует решать, переключившись на Shaka Player для воспроизведения. Если проблемы сохраняются, следует сообщить об ошибке , указав соответствующие проблемы, возникшие в Shaka Player. Партнерам следует отказаться от использования MPL.

В моём контенте используется протокол Smooth Streaming. Как это повлияет на моё приложение?

Бинарные файлы MPL по-прежнему будут размещены и доступны для вашего приложения-приемника. Однако запросы на добавление новых функций и исправления ошибок, связанных с Smooth Streaming, не будут поддерживаться, поскольку спецификация Smooth Streaming не обновлялась более четырех лет. Мы рекомендуем перевести ваш контент на использование протокола потоковой передачи DASH или HLS, чтобы продолжать получать обновления производительности и поддержку вашего контента.

В моём контенте не используются протоколы HLS или Smooth Stream. Как это повлияет на моё приложение?

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

Назад
Основные особенности
Далее
Стиль игрока