Untitled conversation
- User
--[[ blackout / by sibwaf / https://github.com/sibwaf/mpv-scripts Turns the screen completely black and pauses on a button press ([b] by default) so you can hide whatever you are watching from other people fast enough. Unpause or press the same button to go back. May not work if your VO driver doesn't support changing contrast. MIT license - do whatever you want, but I'm not responsible for any possible problems. Please keep the URL to the original repository. Thanks! ]] --[[ Configuration: # property In theory, can be any of: "brightness", "contrast", "saturation", "gamma", "hue". In practice, "contrast" seems to work best. Setting it to "saturation" or "hue" is pretty much pointless as you will get gray-scale or a colored negative video. ]] local property = "contrast" ---------- local watch_later_options_default = mp.get_property_native("watch-later-options") local watch_later_options_blackout = {} for _, option in pairs(watch_later_options_default) do if option == property then -- remove elseif option == "sid" then -- remove elseif option == "secondary-sid" then -- remove else table.insert(watch_later_options_blackout, option) end end local saved_value = nil local saved_sid = nil local saved_secondary_sid = nil function toggle_blackout() if saved_value then mp.set_property(property, saved_value) saved_value = nil mp.set_property("sid", saved_sid) saved_sid = nil mp.set_property("secondary-sid", saved_secondary_sid) saved_secondary_sid = nil mp.set_property_native("watch-later-options", watch_later_options_default) else mp.set_property("pause", "yes") saved_value = mp.get_property(property) mp.set_property(property, -100) saved_sid = mp.get_property("sid") mp.set_property("sid", "no") saved_secondary_sid = mp.get_property("secondary-sid") mp.set_property("secondary-sid", "no") mp.set_property_native("watch-later-options", watch_later_options_blackout) end end function on_pause_change(name, value) if not value and saved_value then toggle_blackout() end end mp.add_key_binding("b", "blackout", toggle_blackout) mp.observe_property("pause", "bool", on_pause_change)Проанализируй и улучши
- Assistant
Данный скрипт для проигрывателя mpv под названием "blackout" был создан пользователем sibwaf. Его основная функция заключается в быстром скрытии текущего видео путем затемнения экрана и приостановки воспроизведения при нажатии определенной клавиши (по умолчанию это клавиша
[b]). Это позволяет пользователю мгновенно скрыть содержимое экрана от посторонних глаз. Повторное нажатие клавиши или продолжение воспроизведения возвращает все в исходное состояние.Анализ скрипта:
-
Конфигурация:
В начале скрипта описывается конфигурируемый параметр
property, который отвечает за то, какой видеопараметр будет изменен для затемнения экрана. По умолчанию это"contrast".local property = "contrast" -
Настройка
watch-later-options:Скрипт получает текущий список опций
watch-later-options, чтобы исключить изменяемые параметры из сохранения при использовании функции "смотреть позже".local watch_later_options_default = mp.get_property_native("watch-later-options") local watch_later_options_blackout = {} for _, option in pairs(watch_later_options_default) do if option == property then -- remove elseif option == "sid" then -- remove elseif option == "secondary-sid" then -- remove else table.insert(watch_later_options_blackout, option) end end -
Сохранение и восстановление значений:
Переменные
saved_value,saved_sidиsaved_secondary_sidиспользуются для сохранения исходных значений изменяемых свойств, чтобы их можно было восстановить позже.local saved_value = nil local saved_sid = nil local saved_secondary_sid = nil -
Функция
toggle_blackout:Эта функция отвечает за переключение режима затемнения.
- Если
saved_valueуже сохранено (то есть затемнение активно), функция восстанавливает исходные значения свойств. - Если
saved_valueне сохранено (затемнение не активно), функция сохраняет текущие значения свойств, изменяет их для затемнения экрана и обновляетwatch-later-options.
function toggle_blackout() if saved_value then -- Восстанавливаем исходные значения else -- Сохраняем текущие значения и затемняем экран end end - Если
-
Обработка изменения состояния паузы:
Функция
on_pause_changeследит за изменением свойстваpause. Если видео выходит из состояния паузы, и затемнение активно, функция автоматически отключает затемнение.function on_pause_change(name, value) if not value and saved_value then toggle_blackout() end end -
Привязка к клавише и наблюдение за свойством:
В конце скрипта привязывается функция
toggle_blackoutк клавише[b], и устанавливается наблюдатель за свойствомpause.mp.add_key_binding("b", "blackout", toggle_blackout) mp.observe_property("pause", "bool", on_pause_change)
Предложения по улучшению:
-
Обработка ошибок и проверка поддерживаемых свойств:
В качестве улучшения можно добавить проверку того, поддерживается ли изменяемое свойство текущим видеооутом. Если свойство не поддерживается, вывести уведомление пользователю.
if not mp.get_property_osd("contrast") then mp.osd_message("Свойство 'contrast' не поддерживается текущим видеооутом.") return end -
Удаление лишних глобальных переменных:
Можно пересмотреть использование глобальных переменных и сделать их локальными в области видимости функции, чтобы избежать потенциальных конфликтов.
-
Улучшение читаемости кода:
Добавление комментариев и улучшение форматирования кода поможет сделать скрипт более понятным для других разработчиков.
-
Гибкость конфигурации:
Можно добавить возможность настройки используемой клавиши через конфигурационный файл или добавить опции для изменения других свойств (например, яркость или насыщенность) без изменения кода.
-
Добавление звукового уведомления:
Для улучшения UX можно добавить звуковой сигнал при активации или деактивации затемнения.
-
Оптимизация работы с
watch-later-options:Вместо ручного удаления свойств можно использовать более элегантный способ, если такой предоставляется API
mpv.
Улучшенный код с учетом предложений:
--[[ blackout / by sibwaf / https://github.com/sibwaf/mpv-scripts Улучшенная версия скрипта для затемнения и приостановки видео по нажатию клавиши. MIT license - do whatever you want, but I'm not responsible for any possible problems. Please keep the URL to the original repository. Thanks! ]] --[[ Конфигурация ]] -- Свойство, используемое для затемнения (можно изменить на "brightness", "saturation" и т.д.) local property = "contrast" -- Клавиша для активации/деактивации затемнения (по умолчанию "b") local blackout_key = "b" ---------- -- Проверяем, поддерживается ли выбранное свойство if mp.get_property(property) == nil then mp.osd_message("Свойство '" .. property .. "' не поддерживается текущим видеооутом.") return end -- Сохраняем исходный список опций "watch-later-options" local watch_later_options_default = mp.get_property_native("watch-later-options") local watch_later_options_blackout = {} for _, option in pairs(watch_later_options_default) do if option ~= property and option ~= "sid" and option ~= "secondary-sid" then table.insert(watch_later_options_blackout, option) end end -- Переменные для сохранения исходных значений свойств local saved_value = nil local saved_sid = nil local saved_secondary_sid = nil -- Функция для переключения режима затемнения local function toggle_blackout() if saved_value then -- Восстанавливаем исходные значения mp.set_property(property, saved_value) saved_value = nil mp.set_property("sid", saved_sid) saved_sid = nil mp.set_property("secondary-sid", saved_secondary_sid) saved_secondary_sid = nil mp.set_property_native("watch-later-options", watch_later_options_default) mp.osd_message("Затемнение отключено") else -- Проверяем, поддерживается ли свойство перед затемнением if mp.get_property(property) == nil then mp.osd_message("Свойство '" .. property .. "' не поддерживается текущим видеооутом.") return end -- Сохраняем текущие значения и затемняем экран mp.set_property("pause", "yes") saved_value = mp.get_property(property) mp.set_property(property, -100) saved_sid = mp.get_property("sid") mp.set_property("sid", "no") saved_secondary_sid = mp.get_property("secondary-sid") mp.set_property("secondary-sid", "no") mp.set_property_native("watch-later-options", watch_later_options_blackout) mp.osd_message("Затемнение включено") end end -- Функция для наблюдения за изменением состояния паузы local function on_pause_change(name, value) if not value and saved_value then toggle_blackout() end end -- Привязываем функцию к клавише и устанавливаем наблюдателя mp.add_key_binding(blackout_key, "blackout", toggle_blackout) mp.observe_property("pause", "bool", on_pause_change)Объяснение улучшений:
- Проверка поддержки свойства: Перед активацией затемнения скрипт проверяет, доступно ли выбранное свойство, и уведомляет пользователя, если нет.
- Добавлены локальные функции и переменные: Это улучшает структурированность кода и предотвращает возможные конфликты.
- Добавлены уведомления OSD: При активации и деактивации затемнения пользователь получает сообщение на экран.
- Возможность настройки клавиши активации: Теперь можно легко изменить клавишу для включения/выключения затемнения без изменения кода.
- Улучшена читаемость кода: Дополнительные комментарии и форматирование делают скрипт более понятным.
Заключение:
Предложенные улучшения направлены на повышение надежности и удобства использования скрипта. Они обеспечивают лучшую совместимость с различными конфигурациями
mpvи делают скрипт более гибким и информативным для пользователя. -