Обзор функциональных возможностей YouTube Embedded RU версий 2018*/2019*.
Подробное описание основных и дополнительных настроек. Сервисные функции.

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

Для изучения настроек текущих версий читаем статью YouTube Embedded RU : Настройки и управление.

В этой статье:

• Основные возможности и способ применения
• Дополнительные настройки и сервисные функции
• Примеры корректно распознаваемых ссылок
• Работа с контекстным меню страницы
• Описание опций меню настроек

Основные возможности и способ применения

YouTube Embedded RU – это контекстный "микро-комбайн", заточенный на удобный просмотр, обход блокировок и загрузку медиа-файлов. Расширение является универсальной "открывашкой" ссылок на видео-ролики и видео-фреймов YouTube в режиме "только плейер" (embedded-видео).

Основная функция аддона – быстрый просмотр видео без загрузки описания, "рекомендованного", "каментов" и других элементов дизайна. Функция работает как переключатель режима страниц на YouTube в режим embedded-плейера и обратно, доступна только на страницах роликов с адресами (www|m).youtube.com/watch* или www.youtube.com/embed/*. Целевая страница в режиме плейера может быть открыта в отдельной или в текущей вкладке.

Вызов – щелчок по кнопке в омнибоксе* или через контекстное меню (доступ ко всем функциям и настройкам).

* Значок в омнибоксе (для браузеров версий до 63) появляется только на страницах роликов YouTube и вызывает переключение режима страницы. В браузерах версий 63+ отображается как кнопка на тулбаре.

На страницах самих видео-роликов переключение в режим "embedded-плейер" доступно и через контекстное меню.

Контекстное меню для фрейма или видео-объекта вызывается двойным щелчком ПКМ на нём (следует повторно щёлкнуть ПКМ при появлении "штатного" меню стандартного плейера). В версиях 49+ можно отключить контекстное меню страницы, оставив только переключатель в омнибоксе (пункт в настройках "Использовать контекстное меню").

В отдельных* версиях на этих же страницах доступно* переключение по горячей клавише (по умолчанию – Alt+Shift+Y).

* Из практических соображений поддержка горячей клавиши удалена с версии 2019.10.8. Основные причины удаления – невостребованность вызова по хоткею и некоторые (рандомные) проблемы при работе аддона в браузерах версий 72+. Тем не менее, в актуальных версия при желании можно самостоятельно задать этот хоткей с помощью штатной функции браузера "Быстрые клавиши".

С помощью контекстного меню можно открывать любые ссылки на видео-ролики и YouTube-фреймы с любых страниц в режиме embedded-плейера. Например, можно открыть ссылку на ролик, данную в какой-нибудь статье или на форуме, либо открыть в новой вкладке видео-фрейм со страницы какого-либо сайта.

Кроме прямых ссылок, YouTube Embedded RU умеет находить ссылки на видео-ролики в выделенном тексте и также открывает их в режиме "только плейер". Эта функция может использоваться для распознавания текстовых ссылок (в том числе – неполных) на видео-ролики (по умолчанию функция выключена, включить её можно в настройках, пункт "Искать ссылки в выделенном тексте").

Управления всеми настройками аддона осуществляется через контекстное меню:

Текущие изменения настроек автоматически сохраняются в локальном хранилище аддона и вступают в силу сразу же.

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

Дополнительные настройки и сервисные функции

При использовании дополнительных функций или при изменении настроек следует помнить, что:

1. Для перехода к просмотру видео в текущей вкладке следует отключить в настройках пункт "Открывать ссылки в новой вкладке" (по умолчанию включен).
2. Все дополнительные сервисы, связанные с переходами на сторонние сайты, в том числе – для загрузки файлов, всегда открываются в новой вкладке.
3. Все дополнительные функции, связанные с использованием сторонних сервисов, целиком и полностью зависят от работоспособности этих сервисов.
4. Настройки, влияющие на режим отображения страниц сервиса, сохраняются в куках непосредственно на сайте (в локальном хранилище браузера).
5. При очистке куков или локального хранилища сайтов для восстановления своих настроек используем пункт "Восстановить настройки в куки…"
6. При изменении настроек, влияющих на просмотр, производится автоматическая перезагрузка страницы для немедленного применения текущих настроек.

С версии 2018.5.27 доступна функция автоматической остановки воспроизведения видео-роликов:

• Работает только на страницах содержащих видео и только при их первой загрузке (при навигации отключена).
• Автостоп не работает для ссылок с указанным временем перемотки (напр., с ключом "#t=NN" в URL, сек.).
• С версии 2018.5.30 автостоп можно временно отключить, зажав при загрузке страницы клавишу Shift.
• С версии 2019.10.8 автостоп можно отключить в настройках (пункт "Авто-стоп плейера при загрузке").

С версии 2018.6.2 добавлена "кнопка" вызова панели загрузки (сервис DetUrl, отображается на страницах роликов):

• Кнопка отображается в виде полосы красного цвета в верхней части видео (5рх, только при наведении курсора).
• Все доступные действия для этой кнопки указаны во всплывающей подсказке (пример на скриншоте выше).
• В панели отображаются доступные форматы файлов, набор этих форматов зависит от конкретного ролика.
• Для загрузки следует щёлкнуть по выбранной ссылке ПКМ и выбрать в меню пункт "Сохранить ссылку как…".
• При некорректной работе панели загрузки её можно перезапустить, щёлкнув по "кнопке" с зажатой клавишей Shift.
• С версии 2018.6.7 к этой "кнопке" добавлены ещё два переключателя, работающие на страницах роликов:
  • открепление проигрывателя – "плавающий* плейер", всегда виден при прокрутке (Ctrl+щелчок);

    * "Плавание" сохраняется до перезагрузки страницы, при этом панель загрузок также "плавает" синхронно.

  • переход на embedded-плейер c автозапуском воспроизведения с текущей позиции видео (Ctrl+Shift+щелчок).
• Для лучшего восприятие цвет "кнопки" меняется в зависимости от зажатых клавиш (синий/жёлтый/оранжевый).

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

Кроме указанного выше, YouTube Embedded RU можно использовать для:

• Просмотра без проверки возраста (в том числе – на внешних сервисах и без необходимости входа на YouTube).
• Просмотра видео с региональными ограничениями (напрямую на сторонних сервисах либо через прокси).
• Загрузки или конвертирования роликов через внешние сервисы (сразу отдаются прямые ссылки на файлы).
• Прямой загрузки медиа-файлов в доступных аудио и видео форматах (через опциональный скрипт-загрузчик).
• Управления внешним видом страниц и отключения отдельных "мешающих" элементов (комментарии и пр.).
• Управления режимом отображения плейера в мобильной или desktop-версиях (режим "кинотеатр").
• Принудительного переключения используемых кодеков и фреймрейта видео-потока (MP4@30fps).

Расширение также содержит ряд других сервисных функций, доступных через контекстное меню. Подробнее по этим функциям, их настройке и особенностям применения читаем в подразделе "Описание опций меню настроек".

Для изучения изменений функционала в конкретных версиях расширения можно воспользоваться ссылками, указанными в разделе "История версий" в отдельной статье YouTube Embedded RU : Ресурсы и ссылки. В этой же статье приведены и другие полезные ссылки, которые позволят лучше понять общий механизм работы расширения и изучить все его возможности.

Примеры корректно распознаваемых ссылок

Аддон "понимает" только URL домена .com (.ru и иные вариации не предусмотрены – конечная ссылка ведёт на .com).

Корректно распознаются ссылки на YouTube-ролики с основного и некоторых других доменов:

• (www.|m.)youtube.com/watch*, youtu.be/* – основной/мобильный домен и домен коротких ссылок на ролики;
• (www.)youtube.com/embed/*, www.youtube-nocookie.com/embed/*, youtube.googleapis.com/embed/*;
• (www.)youtube.com/v/*, www.youtube-nocookie.com/v/*, youtube.googleapis.com/v/* – "старый" формат ссылок;
• кроме указанных корректно распознаются "урезанные" ссылки на ролики (только домен, без указания 'www.').

Все дополнительные функции производят вычисление ID видео-ролика и выполняют редирект на соответствующий сервис. Для текстовых ссылок протокол (http(s)://) может и отсутствовать, главное – корректный идентификатор* видео.

* В любом случае, после получения или распознавания URL видео-ролика перед непосредственным запуском любой из функций проверяется корректность его ID (длина = 11 символов из набора [a-zA-Z0-9-_]). Сообщения об ошибках обработки "неправильных" URL ссылок выдаются в виде стандартных "алертов".

Допустимые URL:

• стандартная ссылка на страницу с видео-роликом
• ссылка на страницу с видео-роликом для мобильной версии
• ссылка на embedded-фрейм с видео-роликом
• ссылка на страницу с видео-роликом ("старая")
• https://youtube.googleapis.com/v/XRCIzZHpFtY?version=3
• https://www.youtube.com/watch?feature=g-vrec&v=XRCIzZHpFtY
• http://youtube.com/watch?feature=player_embedded&v=XRCIzZHpFtY#
• http://youtu.be/XRCIzZHpFtY
• http://www.youtube.com/watch?v=XRCIzZHpFtY
• http://www.youtube.com/embed/XRCIzZHpFtY
• http://www.youtube-nocookie.com/v/XRCIzZHpFtY?version=3&hl=en_US

Допустимые текстовые URL (выделить и нажать ПКМ):

• youtu.be/XRCIzZHpFtY
• youtube.com/watch?v=XRCIzZHpFtY
• //www.youtube.com/embed/XRCIzZHpFtY

Некорректные URL:

• https://youtube.com/v=BXRCIzZHpFtY – неверный шаблон, меню не появится
• https://youtube.ru/watch?v=XRCIzZHpFtY – национальный домен, меню не будет
• http://www.youtube.com/watch?v=BXRCIzZH_pFtY&feature=g-all-xit – длина >11
• https://www.youtube.com/embed/XRCIzZHp=FtY – недопустимый символ
• yuotu.be/XRCIzZHpFtY – неправильное имя домена
• youtubе.cоm/wаtсh?v=XRCIzZHpFtY – подмена символов…)

Работа с контекстным меню* страницы

* Если не указан номер версии, в которой конкретная функция добавлена (или удалена), она есть во всех версиях.

В качестве основного способа управления всеми функциями в расширении YouTube Embedde RU применяется динамическое контекстное меню: содержит пункты, соответствующие текущему контексту под курсором и домену текущей страницы. О способах настройки меню читаем в подразделе "Описание опций меню настроек".

Контекстное меню на любых страницах, кроме страниц YouTube-роликов, появляется только на ссылках и фреймах.

Аддон "понимает" только URL домена *.youtube.com (.ru и иные вариации не предусмотрены – конечная ссылка всегда ведёт на .com). Корректно распознаются ссылки на YouTube-ролики с основного и некоторых других доменов, также распознаются "урезанные" ссылки на ролики (только домен, без указания 'www.'). При получении ссылок из текста протокол (http(s)://) может отсутствовать (будет установлен автоматически).

Контекстное меню для ссылок доступно также и внутри фреймов (напр., ссылки на "рекомендованные" видео).

Контекстное меню для прочих элементов (на странице ролика на YouTube) позволяет переключить режим страницы в "embedded". Меню недоступно на картинках – сделано для упрощения, чаще всего изображение совпадает со ссылкой.

В любом случае, для запуска каких-либо функций через меню, главное – это корректный идентификатор видео.

Максимальный набор доступных функций отображается в контекстном меню ссылки в embedded-фрейме:

С версии 2018.5.30 доступны дополнительные функции в контекстном меню страницы:

• автозапуск просмотра по ссылке или из фрейма в embedded-плейере ("лишние" элементы интерфейса отключены);
• скачивание по ссылке, из фрейма и со страницы – сервис savefrom.net (прямые ссылки – Скачать без установки);
• проверка ограничений региональной доступности по ссылкам и со страницы/фрейма – сервис unblockvideos.com;
• просмотр заблокированных* роликов по прямым ссылкам на их видео-файлы – сервис youtube.unblockvideos.com.

  * Совет: в режиме прямого просмотра видеофайлов их также можно сохранять – ПКМ + "Сохранить видео как…".

С версии 2018.5.31 кроме вышеуказанных в контекстном меню страницы доступны следующие функции:

• конвертирование/скачивание ролика по ссылке или из фрейма – сервис convert2mp3.net* (выходные форматы mp4/avi/wmv/3gp/mp3/aac/…);
  

  * Во избежание лишних запросов при работе сервиса можно заблокировать для него куки в настройках браузера.

  Функция отключена с версии 2019.10.3 – внешний сервис загрузки и конвертирования более недоступен.
  Функция восстановлена в версии 2019.10.8 – сервис для конвертирования роликов заменён на y2mate.com.
• просмотр страниц заблокированных* роликов через прокси-сервисы UnblockVideos или ProxyFree.

  * Совет: в режиме прямого просмотра видеофайлов их также можно сохранять – ПКМ + "Сохранить видео как…".

С версии 2018.5.31 можно использовать сокращённое меню, содержащее только наиболее часто используемые функции просмотра. Переключение вида меню с полного (по умолчанию) на сокращённое производится в Настройках – пункт "Расширенное контекстное меню".

В большинстве случаев сокращённое контекстное меню не является вложенным и состоит из единственного пункта:

• смотреть видео (для ссылок или фреймов) => новая вкладка с embedded-плейером + автозапуск ролика;
• скачать видео (только для текущего просматриваемого видео) => новая вкладка для выбора/загрузки файла.

Переключение режима страниц на YouTube при этом доступно только по хоткею или через кнопку в омнибоксе.

С версии 2019.10.3 добавлены ещё две функции (и пункты в контекстном меню), работающие на страницах роликов:

• переключение* между мобильной и desktop-версиями сайта (соответствующий пункт в меню страницы);

  * Состояние запоминается в куках браузера в пределах сессии, режим работает до следующего переключения.

• переход на сервис GenYouTube (просмотр без ограничений + загрузка, пункт* "Смотреть/скачать видео");

  * Аналогичный пункт есть и в контекстном меню для ссылок – "Смотреть/скачать по ссылке".

Описание опций* меню настроек

* Если не указан номер версии, в которой конкретная опция добавлена (или удалена), она есть во всех версиях.

При работе с Настройками следует помнить что:

1. Все настройки контекстного меню хранятся только локально, синхронизация отсутствует.
2. Чтение настроек производится однократно при старте браузера (или при запуске расширения).
3. Изменения настроек автоматически сохраняются в локальном хранилище аддона и вступают в силу сразу же.
4. При вызове любых функций аддона настройки не используются и обращения к дисковому хранилищу нет.
5. Запись изменений настроек в хранилище выполняется однократно и только при их переключении в меню.
6. Меню настроек доступно только на страницах видео на YouTube.

Для версий браузера 49+ вызывается по нажатию ПКМ на значке в омнибоксе (или на тулбаре, в версиях 63+).

Браузеры версий 49+: контекстное меню кнопки в омнибоксе (показано состояние опций по умолчанию):

До версии аддона 2018.5.30 включительно:
В старых версиях браузера (до 48 включительно) меню настроек недоступно (ограничения API), все опции – по умолчанию: открытие ссылок всегда в новых активных вкладках, контекстное меню включено, поиска ссылок в выделенном* тексте нет.
^{* Причина ограничения чисто практическая, связана с редким использованием поиска ссылок в текстовом фрагменте.}

Начиная с версии 2018.5.31 меню настроек доступно и на старых браузерах (версий до 48).
Вызывается по щелчку ПКМ на свободном месте страницы любого видео-ролика на YouTube:

Все пункты в этом (вложенном) подменю полностью аналогичны настройкам в меню на кнопке омнибокса.

В зависимости от версии браузера меню Настроек содержит следующие опции-переключатели:

Использовать контекстное меню: включает меню на любых ссылках/фреймах с YouTube-роликами на любых страницах (не только на самом YouTube). Если выключено – остальные настройки недоступны для изменения. Этот пункт отсутствует в настройках для старых браузеров, в них контекстное меню страницы неотключаемое.

Расширенное контекстное меню: доступна с версии 2018.5.31. Если включено (по умолчанию) – в контекстном меню страницы доступны все функции. Если выключено – будут доступны только наиболее часто используемые функции – просмотр ссылок/фреймов в новой вкладке и скачивание текущего просматриваемого видео.

Открывать ссылки в новой вкладке: если выключено – ссылка/фрейм будет открыта в текущей вкладке. Опция влияет только на открытие ссылок, переключение режима страницы YouTube-ролика всегда производится в текущей вкладке. Все сторонние сервисы загрузки файлов и просмотра заблокированного видео всегда открываются в новой активной вкладке.

Открывать ссылки в фоновой вкладке: доступна с версии 2018.5.27. Работает только если включена предыдущая опция. Если выключено – ссылка/фрейм будет открыта в новой активной вкладке. Опция влияет только на открытие ссылок, переключение режима страницы YouTube-ролика всегда производится в текущей вкладке.

Искать ссылки в выделенном тексте: работает на любых страницах для любого выделенного фрагмента текста. Если во фрагменте есть корректная ссылка на YouTube-ролик – она будет распознана и открыта, иначе будет выдано сообщение об ошибке.

Расширенные настройки видео: вложенное меню настроек, влияющих на просмотр.
Эти опции также запоминаются в куках браузера, стираются при очистке/сбросе куков.
Если куки отключены (или запрещены) в настройках браузера, эти настройки НЕ применяются!

При переключении любой из расширенных опций текущая страница перезагружается для немедленного применения настроек. Состояние запоминается в куках браузера сроком на 1 год, работает до следующего переключения (или до очистки куков).

Видео-кодек: только MP4/H264: доступна с версии 2019.10.5. Если включено – плейер будет использовать только форматы потока MP4/H.264. Если выключено (по умолчанию) – для видео выбирается формат WEBM/VP9. Этот пункт отсутствует в настройках браузеров до 48, не поддерживающих воспроизведение форматов MP4/H.264.

Видео-кодек: запретить WEBM/VP9: доступна с версии 2019.10.9. Если включено – плейер будет использовать только формат потока WEBM/VP8. Если выключено (по умолчанию) – для видео выбирается формат WEBM/VP9. Опция отсутствует в настройках браузеров 48+ (с поддержкой MP4) и VP8-only браузерах (до 36, нет поддержки VP9).

Видео-поток: не более 30 кадр/сек: доступна с версии 2019.10.5. Если включено – скорость воспроизведения принудительно ограничивается частотой 30 кадров в секунду. Если выключено (по умолчанию) – кадровая частота устанавливается сервисом автоматически (до 60 кадров в секунду).

Авто-стоп плейера при загрузке: доступна с версии 2019.10.8. Если включено (по умолчанию) – при открытии страницы ролика его воспроизведение автоматически останавливается. Если выключено – используются стандартные настройки YouTube (ролик запускается сразу при загрузке).

Плейер во всю ширину страницы: доступна с версии 2019.10.8. Если включено – размер окна фрейма плейера на странице ролика будет во всю ширину экрана (режим "кинотеатр"). Если выключено (по умолчанию) – используется стандартный размер фрейма. Опция перекрывается кнопкой "Режим кинотеатра" на панели управления плейером. Фактически, используется одна из стандартных функций сервиса, регулируемая значением куки "wide=1".

Отключить загрузку комментариев: доступна с версии 2019.10.8. Если включено – на страницах роликов (в desktop-версии) применяется простейший фильтр скрытия "каментов". Если выключено (по умолчанию) – используются стандартные настройки YouTube (комментарии подгружаются при прокрутке страницы при загрузке).

Восстановить настройки в куки: доступна с версии 2019.10.8. Используется для устранения несоответствий настроек после сброса/очистки куков Youtube. При выборе этого пункта производится перезапись куки в соответствии с текущими настройками. Текущая вкладка при этом всегда перезагружается для применения настроек.