Skip to content

guide binding accessibility RU

alvit edited this page Oct 22, 2026 · 7 revisions

Ручная привязка XMLTV и доступность с клавиатуры

English · العربية · বাংলা · Čeština · Deutsch · Español · فارسی · Français
עברית · हिन्दी · Bahasa Indonesia · Italiano · 日本語 · 한국어 · Nederlands · Polski
Português · Русский · ไทย · Türkçe · Українська · Tiếng Việt · 简体中文 · 繁體中文

Архитектура телепрограммы

Исправление телепрограммы канала без редактирования плейлиста

Включите нужный канал M3U, откройте Information → EPG, затем измените URL источника EPG и XMLTV ID. Введите точный ID из <channel id="…"> файла XMLTV, а не отображаемое имя. Выберите Set, чтобы сохранить привязку и перезагрузить плейлист. Automatic удаляет переопределение этого канала и загружает исходное сопоставление плейлиста. Само перемещение стрелками никогда не сохраняет и не сбрасывает привязку. Назад оставляет сохранённую привязку без изменений.

Редактор доступен в размещённой браузерной версии и нативных XMLTV-оболочках (Tauri и Capacitor). Он не переопределяет телепрограммы провайдера, явные JSON-эндпоинты =source и внешние вспомогательные серверы. Обычный старый браузер с удалённым вспомогательным сервером сохраняет существующий протокол сопоставления. Первая версия принимает точный ID; она не загружает и не показывает список всех XMLTV-каналов с поиском.

Ручная привязка связывает источник плейлиста и стабильный канал с одним источником XMLTV и точным ID; иначе действует обычное сопоставление.

Привязка хранит отпечаток источника плейлиста, стабильный ключ канала, явный URL телепрограммы и XMLTV ID. Изменение отображаемого имени или порядка строк не меняет привязку, пока идентичность канала прежняя. Замена URL/аккаунта плейлиста меняет пространство имён источника. Для старых M3U-записей без itemId используется существующий ID канала, полученный из URL; изменение этого URL меняет идентичность.

Выбранный канал сохраняет отображаемое имя и URL воспроизведения. Поиск телепрограммы использует один явный источник без запасного сопоставления по имени, поэтому отсутствующий ID не подставляет молча программу другого канала. Автоматические региональные сдвиги, выведенные из имени канала, не применяются к этой точной привязке; явный tvg-shift плейлиста продолжает действовать. Укажите правильный региональный XMLTV ID. Если собственный HTTPS-источник нельзя прочитать из-за CORS или правил смешанного содержимого, обычная диагностика EPG сообщит об ошибке.

Локальная запись ограничена 500 привязками и 512 KiB на источник; она разбирается один раз при загрузке плейлиста, а не для каждого канала. Запись сравнивает прежнее значение и перечитывает сохранённый результат перед перезагрузкой. Запоздалый callback редактора не может сохранить данные в заменивший прежний источник. Это локальная настройка, а не синхронизация между устройствами. URL источников могут содержать учётные данные; не публикуйте экспорты хранилища.

Доступные классические элементы управления

  • Виртуализированный основной список предоставляет именованный listbox, выбранный вариант, полное количество элементов и абсолютную позицию. Только выбранная видимая строка является остановкой Tab. Стрелки обновляют визуальный выбор и семантическое состояние; фокус следует за уже сфокусированным списком при замене страницы.
  • Стандартные диалоги информации/подтверждения, редактор и панели About предоставляют модальные роли и локализованные имена. Tab и Shift+Tab циклически перемещаются внутри переднего модального окна. Закрытие вложенного окна восстанавливает всё ещё видимый родительский элемент; устаревшие запланированные открытия не могут похитить фокус после закрытия.
  • Информационные сообщения и подтверждения описывают свои диалоги. Временные уведомления используют область состояния с ненавязчивым озвучиванием.
  • Существующие каталоги переводов предоставляют все добавленные подписи. XMLTV и ID — идентификаторы протокола; имена каналов и хостов источников остаются метаданными источника.

Приложение сохраняет маршруты пульта и синтаксис ES5. Семантические проверки DOM не означают полной сертификации WCAG: специфичный для устройства фокус, речь VoiceOver/TalkBack и поведение TV-браузеров всё ещё требуют физических тестов.

Проверка

Выполните:

node tests/test_classic_accessibility.cjs
node tests/test_guide_bindings.cjs
node tests/test_screen_ownership.cjs
node tests/test_guide_integration.cjs
node tests/test_m3u_provider_driver.cjs
node tests/test_localization_catalog.cjs
npm run typecheck

На интегрированной ветке также выполните обычные проверки сборки/ES5/размера пакета. Браузерные проверки должны охватить длинный список через границы страниц, вложенное подтверждение, замену источника при редактировании, правильную, отсутствующую и удалённую привязку и ошибку загрузки EPG. Семантические настройки дорожек нативного Android-приложения реализованы в его отдельном репозитории и независимы от этих классических элементов управления.


Source revision: f51bac7a. This documentation may describe changes awaiting release; use the matching build.

Clone this wiki locally