Skip to content

Latest commit

 

History

History
114 lines (97 loc) · 14.7 KB

SETTINGS.md

File metadata and controls

114 lines (97 loc) · 14.7 KB

Настройки

Где что хранится

Хранилище Что Код
SharedPreferences global_prefs Глобальные настройки приложения data/SettingsRepository
Room ddd_player_db, таблица video_settings Настройки конкретного видео по URI: стерео-режим, вывод, анаглиф, swap, глубина, позиция, длительность, ID аудио- и субтитровой дорожек data/VideoSettings, data/AppDatabase

Записи Room старше 30 дней удаляются при загрузке плейлиста (cleanupOldSettings).

SettingsRepository — синглтон (getInstance(context)). На каждую настройку в нем есть пара get/is... + set..., и ключи строками объявлены прямо в этих методах.

Глобальные настройки (основное)

Ключ По умолчанию Значения / смысл
resume_mode RESUME_ASK (0) 0 спрашивать, 1 всегда, 2 никогда
external_position_mode EXTERNAL_POSITION_APPLY (0) Позиция из Intent: 0 применять сразу, 1 спрашивать
up_button_action UP_ACTION_INFO (3) 0 ничего, 1 OSD-настройки, 2 боковое меню, 3 инфопанель, повторное нажатие — боковое меню (до 1.6 по умолчанию было 2)
ok_button_action OK_ACTION_PAUSE_PANEL (1) 0 пауза, 1 пауза + панель, 2 панель
horizontal_swipe_action 2 Горизонтальный свайп (телефон): 0 — нет, 1 — перемотка, 2 — выход или Пред/След, 3 — вправо выход, влево След. Свайп от края экрана (32dp) не начинается: там системный «Назад»
show_back_button false Стрелка выхода в инфопанели (сенсорные экраны, без фокуса с пульта)
hidden_control_buttons пусто Скрытые кнопки нижней панели (speed, resize, pip, quality, audio, subtitles). Хранятся скрытые, чтобы новые кнопки были видны
sub_font, sub_size, sub_text_color, sub_bg_color, sub_edge_type, sub_edge_color, sub_bottom, sub_embedded как у стандартного SubtitleView Стиль субтитров (SubtitleStyle, экран SubtitleStyleActivity, применение SubtitleStyleOptions.apply)
gesture_volume_brightness true Вертикальные свайпы: громкость справа, яркость слева
confirm_exit true Выход по второму нажатию «Назад» в течение 2 с
auto_pip false Авто-PiP при уходе с экрана
live_mode_control false Эфирный режим (см. PLAYLISTS.md)
show_info_on_change false Инфопанель при смене элемента плейлиста
show_playlist_index true Номера в плейлисте
saved_playlists — Плейлисты по ссылке на стартовом экране (JSON: id, name, url). Прежний startup_playlist_uri переносится сюда один раз и удаляется
smb_servers — Сетевые папки SMB стартового экрана (JSON: id, name, address, user, password, domain)
watch_history — История «Продолжить просмотр» (JSON, до 30 записей, одна на источник: папку или плейлист)
last_channel_uri null Последний канал M3U (служебное)
clock_transparency CLOCK_OFF (-1) -1 выкл, 0..80 % прозрачности. Мигрирует из старого show_clock
buffer_display_mode BUFFER_DISPLAY_OFF (0) 0 выкл, 1 в панели, 2 рядом с часами (и в инфопанели)
target_buffer_mb BUFFER_SIZE_AUTO (-1) Буфер сетевого видео в МБ, варианты ограничены кучей
render_api_mode RENDER_API_AUTO (0) 0 авто (ES 3.0 если есть), 1 принудительно GLES 2.0
pause_dim_level 60 Затемнение на паузе, %
global_resize_mode, video_zoom_scale, remember_zoom 0 (FIT), 115, false Масштаб
video_decoder_priority как decoder_priority, если его меняли, иначе EXTENSION_RENDERER_MODE_ON (HW+) Приоритет встроенного AV1 (dav1d) перед декодерами устройства, раздел «Видео»
audio_decoder_priority как decoder_priority, если его меняли, иначе EXTENSION_RENDERER_MODE_PREFER (SW) Приоритет встроенного FFmpeg перед декодерами устройства, раздел «Аудио»
decoder_priority — Прежняя общая настройка; только значение по умолчанию для двух новых
tunneling_enabled false Туннелирование
default_playback_speed 1.0 Скорость в начале воспроизведения; прямой эфир — всегда 1.00x. Задается и долгим нажатием на пункт меню скорости
custom_playback_speed 1.10 «Своя скорость» в меню скорости: ползунок 0.25–4.00x с шагом 0.05
hdr10plus_enabled true Динамические метаданные HDR10+; выкл — вырезаются, видео играет как HDR10 (перезапуск плеера)
dv_mode DV_MODE_AUTO (1) «Режим Dolby Vision»: 0 «Dolby Vision» (DV декодер), 1 «Авто» (HEVC, если экран или декодер не поддерживают DV), 2 «HDR10/HLG» (всегда HEVC), 3 «Dolby Vision (P7 → P8.1)» — конвертация Profile 7 → 8.1 (libdovi; без DV экрана или декодера ведет себя как «авто»). Мигрирует из старого map_dv_to_hevc (выкл → 0); прежнее значение по умолчанию 2 один раз переводится в 1 (флаг dv_mode_auto_default)
stereo_downmix, mix_* true, пресет 0 Даунмикс многоканального звука в стерео и коэффициенты микшера
hd_audio_iec false DTS-HD MA и TrueHD/Atmos битстримом через несущую IEC 61937 192 кГц/7.1, как у Kodi. Перезапускает плеер (getHardSettingsSignature)
skip_silence, loudness_boost false, 0 Пропуск тишины, усиление громкости
audio_track_memory, audio_track_stats AUDIO_MEMORY_OFF (0), — Запоминание аудиодорожки: 0 выкл, 1 в пределах плейлиста (дорожка, выбранная в этом плейлисте), 2 + между видео (экспериментально): до 20 наиболее используемых дорожек (подпись: название, язык, кодек, каналы), порядок пользователь меняет в настройках
pref_audio_lang, pref_sub_lang "" "" — как в файле, device — язык системы, иначе код языка
subtitle_auto_mode SUB_AUTO_DEFAULT (0) Автовключение субтитров при загрузке видео: 0 как решит плеер, 1 выкл, 2 только форсированные (сначала на языке звука), 3 полные (на pref_sub_lang, иначе с флагом default, иначе первые). Субтитры, сохраненные для видео, и ручной выбор важнее (TrackLogic.autoSubtitleIndex)
frame_rate_matching, afr_* false, ... AFR
app_language system Язык интерфейса
def_output_mode, def_anaglyph_type ANAGLYPH, RC_DUBOIS Вывод по умолчанию для нового стерео-видео (настройка «3D режим по умолчанию»; обновляется и при сохранении настроек видео в OSD)
stereo_auto_detect true Автоопределение стереопары. false — режим «Не обрабатывать»: кадр выводится как есть, стерео включают вручную в OSD
pref_filter_<GROUP> — Последний фильтр в группе очков
calib_<group>_set/leak_a/leak_b, anaglyph_lens_swap, calibration_version — Калибровка анаглиф-очков из визарда (фильтр «Калибровка» группы), порядок линз, версия для перечитывания в плеере
vr_k1, vr_k2, vr_scale, global_screen_separation_pct 0.34, 0.10, 1.2, 0 Параметры VR

Полный список смотрите в SettingsRepository.kt.

«Приложение → Сбросить все настройки» (resetAllSettings) очищает global_prefs, кроме данных пользователя (USER_DATA_KEYS: история, плейлисты, SMB-серверы, последний канал, кэш проверки обновлений). Настройки отдельных видео в Room не трогаются, счетчик калибровки увеличивается. Подтверждение — ChoiceDialog с фокусом на «Отмена»; после сброса экран настроек открывается заново (и сбрасывается язык, если он был выбран вручную). Новый ключ с пользовательскими данными (не настройкой) добавляйте в USER_DATA_KEYS.

Экран глобальных настроек

GlobalSettingsActivity: слева список категорий (categories, пункты item_settings_category), справа прокручиваемые настройки выбранной категории (контейнеры section_*, видим только один). Категории по порядку: Воспроизведение (section_playback), Интерфейс (section_ui), Видео, Звук, Субтитры, 3D, Управление (section_control), Приложение (section_app). У каждой своя иконка ic_settings_*.

Управление с пульта: фокус на категории сразу показывает ее настройки; Вправо — в настройки (на последний выбранный в категории пункт); Влево или Назад — обратно к категориям; CH+/CH- и PgUp/PgDn — соседняя категория из любой колонки; Назад в списке категорий закрывает экран. Выбор из списка значений — ChoiceDialog.show, несколько флажков (например, кнопки панели управления) — ChoiceDialog.showMulti.

Перезапуск плеера

getHardSettingsSignature() включает приоритет декодеров, туннелирование, DV→HEVC, даунмикс с микшером и буфер. Когда пользователь возвращается из настроек, PlayerViewModel.checkSettingsAndRestart() сравнивает сигнатуру с прежней. Если она изменилась, плеер пересоздается с сохранением позиции, иначе вызывается applyLiveSettings() (языки дорожек, skip silence, громкость).

OSD-настройки плеера

Панель сверху (кнопка «Вверх» в режиме OSD или пункт меню) показывает настройки текущего видео (SettingType): тип стереопары, вывод, очки, API рендера, фильтр, параметры Custom, swap, глубина, разнос экранов, VR-дисторсия и зум, дорожки. Список доступных пунктов зависит от режима (updateAvailableSettings). Влево/Вправо меняют значение (changeSettingValue), OK сохраняет в Room (saveCurrentSettings), «Назад» откатывает изменения (restoreSettings).

Как добавить глобальную настройку

  1. SettingsRepository: добавьте геттер и сеттер (и константы значений, если они нужны). Значение по умолчанию должно сохранять текущее поведение.
  2. Если старый ключ поменял смысл, напишите миграцию (пример — getClockTransparency).
  3. GlobalSettingsViewModel: добавьте MutableLiveData с начальным значением из репозитория и метод изменения.
  4. activity_global_settings.xml: добавьте пункт в контейнер нужной категории (section_playback, section_ui, section_video, section_audio, section_subtitles, section_3d, section_control, section_app) по образцу соседних. Пункты фокусируемые: навигация идет с пульта. Новая категория — это новый контейнер section_* плюс запись в GlobalSettingsActivity.categories.
  5. GlobalSettingsActivity: lateinit поля, bindViews, обработчик в setupListeners и подписка в observeViewModel. Для выбора из списка используйте showSingleChoiceDialog.
  6. Строки (title и summary/значения) добавьте во все 5 локалей.
  7. Если для настройки нужно пересоздать ExoPlayer, добавьте ее в getHardSettingsSignature().
  8. Используйте настройку там, где она нужна (обычно PlayerViewModel, PlayerManager или PlayerInputHandler).