| Хранилище | Что | Код |
|---|---|---|
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 или пункт меню) показывает настройки текущего видео
(SettingType): тип стереопары, вывод, очки, API рендера, фильтр, параметры Custom, swap, глубина,
разнос экранов, VR-дисторсия и зум, дорожки. Список доступных пунктов зависит от режима
(updateAvailableSettings). Влево/Вправо меняют значение (changeSettingValue), OK сохраняет
в Room (saveCurrentSettings), «Назад» откатывает изменения (restoreSettings).
SettingsRepository: добавьте геттер и сеттер (и константы значений, если они нужны). Значение по умолчанию должно сохранять текущее поведение.- Если старый ключ поменял смысл, напишите миграцию (пример —
getClockTransparency). GlobalSettingsViewModel: добавьтеMutableLiveDataс начальным значением из репозитория и метод изменения.activity_global_settings.xml: добавьте пункт в контейнер нужной категории (section_playback,section_ui,section_video,section_audio,section_subtitles,section_3d,section_control,section_app) по образцу соседних. Пункты фокусируемые: навигация идет с пульта. Новая категория — это новый контейнерsection_*плюс запись вGlobalSettingsActivity.categories.GlobalSettingsActivity:lateinitполя,bindViews, обработчик вsetupListenersи подписка вobserveViewModel. Для выбора из списка используйтеshowSingleChoiceDialog.- Строки (
titleиsummary/значения) добавьте во все 5 локалей. - Если для настройки нужно пересоздать ExoPlayer, добавьте ее в
getHardSettingsSignature(). - Используйте настройку там, где она нужна (обычно
PlayerViewModel,PlayerManagerилиPlayerInputHandler).