Simple Media Player (Простой медиаплеер)

Дополнение предоставляет полнофункциональный медиаплеер с графическим интерфейсом внутри NVDA для воспроизведения музыкальных файлов.

Возможности

• Воспроизведение аудиофайлов форматов MP3, WAV, OGG.
• Управление воспроизведением: воспроизведение/пауза, следующий/предыдущий трек, перемотка.
• Режимы повтора и перемешивания плейлиста.
• Регулировка громкости.
• Отображение метаданных (исполнитель, альбом, название) и обложки альбома (при наличии).
• Гибкая настройка отображения обложки: показ обложки из тегов или стандартной иконки.
• Управление папкой с музыкой: выбор произвольной папки, возврат к папке по умолчанию, копирование файлов в папку дополнения.
• Сохранение настроек (последняя папка, громкость, режим сортировки, подтверждение выхода) между сеансами.
• Управление с клавиатуры через горячие клавиши.
• Поддержка нескольких схем сортировки отображаемой информации.

Использование

Открытие плеера

После установки в NVDA появится категория пунктов «Simple Media Player». Для открытия плеера выполните пункт из этой категории (по умолчанию назначается жестом, который можно настроить в диалоге «Жесты ввода»).

Интерфейс плеера

Окно плеера содержит следующие элементы:

1. Область обложки — вверху окна. Отображает обложку текущего трека или иконку плеера.
2. Информационное поле — показывает название, исполнителя и альбом в выбранном формате.
3. Ползунок прогресса — отображает текущую позицию в треке.
4. Выпадающий список сортировки — позволяет выбрать порядок отображения информации: «Название — Исполнитель — Альбом», «Альбом — Название — Исполнитель» или «Исполнитель — Название — Альбом».
5. Список плейлиста — отображает все аудиофайлы в текущей папке. Двойной щелчок или Enter запускает воспроизведение выбранного трека.
6. Ползунок громкости — для регулировки уровня громкости.
7. Панель управления — кнопки управления воспроизведением и настройками.

Кнопки управления

• Воспроизведение/Пауза (K) — начать воспроизведение или поставить на паузу.
• Предыдущий (P) — перейти к предыдущему треку.
• Следующий (S) — перейти к следующему треку.
• Перемотка назад (G) — перемотать на 10 секунд назад.
• Перемотка вперёд (I) — перемотать на 10 секунд вперёд.
• Повтор: Вкл/Выкл (T) — включить/выключить повтор текущего плейлиста.
• Перемешать: Вкл/Выкл (R) — включить/выключить случайный порядок воспроизведения треков.
• Уменьшить громкость — уменьшить громкость.
• Увеличить громкость — увеличить громкость.
• Запустить заново (B) — начать текущий трек сначала.
• Выбрать папку (Ctrl+O) — выбрать другую папку с музыкой.
• Папка по умолчанию (D) — вернуться к папке по умолчанию (папка sounds в данных дополнения).
• Копировать музыку (C) — скопировать выбранные файлы в папку по умолчанию.
• Дополнительные настройки (A) — открыть настройки отображения обложки альбома.
• Выход — закрыть плеер. Если отмечен чекбокс «Спрашивать перед выходом», будет запрошено подтверждение.

Горячие клавиши

Горячие клавиши работают, когда окно плеера активно (и фокус не находится в списке плейлиста для клавиш навигации).

• Ctrl+O — Выбрать папку с музыкой.
• D — Вернуться к папке по умолчанию.
• C — Копировать музыку.
• A — Дополнительные настройки.
• Стрелка Вверх — Увеличить громкость.
• Стрелка Вниз — Уменьшить громкость.
• K — Воспроизведение/Пауза.
• S — Следующий трек.
• P — Предыдущий трек.
• G — Перемотка назад.
• I — Перемотка вперёд.
• R — Вкл/Выкл перемешивание.
• T — Вкл/Выкл повтор.
• B — Перезапустить текущий трек.

Примечание: В списке плейлиста клавиши Enter и Пробел запускают воспроизведение выбранного трека, а Стрелки Вверх/Вниз перемещают выбор.

Настройки

Дополнительные настройки (кнопка «A»)

Открывает диалог с параметрами отображения обложки альбома:

• Показывать обложку альбома — включить/выключить отображение обложки.
• Режим отображения (доступен при включённой опции выше):
  • Показывать обложку музыкального альбома, если доступна — пытается извлечь обложку из тегов файла. Если обложки нет, область остаётся пустой.
  • Всегда показывать значок медиаплеера по умолчанию — всегда отображает стандартную иконку плеера, даже если в файле есть обложка.

Прочие настройки

• Сортировка информации — изменяется через выпадающий список в основном окне. Настройка сохраняется.
• Подтверждение выхода — чекбокс в нижней части окна. При включении перед закрытием плеера будет запрашиваться подтверждение.
• Громкость — уровень громкости сохраняется автоматически при закрытии.
• Последняя папка — путь к последней выбранной папке с музыкой сохраняется.

Папка данных дополнения

Плеер создаёт и использует папку для хранения настроек и музыки по умолчанию. Путь:
%APPDATA%\nvda\simple_media_player\

• Файл settings.json — все настройки плеера.
• Папка sounds — папка по умолчанию для музыки. Сюда можно копировать файлы через функцию «Копировать музыку (C)».

Технические детали

Дополнение использует библиотеки:
* pygame — для воспроизведения аудио.
* mutagen — для чтения метаданных (тегов) и обложек из аудиофайлов.

Библиотеки включены в состав дополнения в папке lib.