generic-system-acceleration: Rework PipeWire section a bit

Signed-off-by: Vasiliy Stelmachenok <[email protected]>

Author: ventureoo

docs/source/sound.rst

@@ -8,49 +8,66 @@
 
 .. _sound:
 
-**********************
-Низкие задержки звука
-**********************
+*******************
+Настройка PipeWire
+*******************
 
-.. index:: installation, lowlatency, audio, pipewire
+.. index:: installation, audio, pipewire, about
 .. _pipewire:
 
-========
-PipeWire
-========
+====================
+Что такое PipeWire?
+====================
 
 `PipeWire <https://wiki.archlinux.org/title/PipeWire_(Русский)>`__ -
-это новая альтернатива PulseAudio, которая призвана избавить от
-проблем своего предшественника, уменьшить задержки звука, снизить
-потребление памяти и улучшить безопасность. PipeWire поставляется по
-умолчанию в Arch Linux в качестве звукового сервера, требуемого для
-клиентов libpulse [#]_, так что никаких команд для его установки
-прописывать не нужно. Однако несмотря на это рекомендуется установить
-дополнительные компоненты и явно включить пользовательские службы для
-уменьшения задержки их запуска через активацию путем сокетов, которая
-используется по умолчанию для запуска PipeWire::
+это новая альтернатива PulseAudio, которая призвана избавить
+пользователей от проблем своего предшественника, уменьшить задержки
+звука и снизить потребление памяти, а также улучшить безопасность.
 
-  sudo pacman -S pipewire-jack gst-plugin-pipewire
-  systemctl --user enable --now pipewire pipewire-pulse wireplumber
+С недавних пор PipeWire поставляется в Arch Linux и ряде других
+дистрибутивов Linux в качестве звукового сервера по умолчанию,
+требуемого для клиентов libpulse [#]_, так что никаких команд для его
+установки прописывать не нужно.
 
-Для непосредственно уменьшения самих задержек установим дополнительный
-пакет ``realtime-privileges`` и добавим пользователя в группу
-``realtime``::
+.. [#] https://gitlab.archlinux.org/archlinux/packaging/packages/pipewire/-/commit/14614b08f6f8cf8e50b4cbb78a141e82066e7f80
 
-  sudo pacman -S realtime-privileges rtkit
-  sudo usermod -aG realtime "$USER"
+.. index:: installation, lowlatency, audio, pipewire
+.. _pipewire_lowlatency_setup:
 
-Дополнительно советуем установить реализацию Jack API. См. раздел
-ниже.
+==========================
+Уменьшение задержки звука
+==========================
 
-.. [#] https://gitlab.archlinux.org/archlinux/packaging/packages/pipewire/-/commit/14614b08f6f8cf8e50b4cbb78a141e82066e7f80
+Для понижения задержек звука нужно изменить алгоритм планирования
+процессов PipeWire, сделав обработку звука первоочередной задачей для
+системы. Сделать это можно при помощи уже упомянутой ранее службы
+``ananicy-cpp`` путём создания дополнительного набора правил, который
+позволит автоматически изменять используемую политику планирования и
+повышать приоритет в отношении данных процессов:
+
+.. code-block:: shell
+  :caption: ``/etc/ananicy.d/pipewire.rules``
+
+   { "name": "pipewire", "sched": "rr", "rtprio": 20 }
+   { "name": "pipewire-pulse", "sched": "rr", "rtprio": 20 }
+   { "name": "wireplumber", "sched": "rr", "rtprio": 10 }
+
+После сохранения файла следует перезапустить службу::
+
+  sudo systemctl restart ananicy-cpp
+
+Использование данных правил также может помочь избавиться от
+неприятного потрескивания при воспроизведении звука в ситуациях
+повышенной нагрузки на систему. Однако это не единственная мера,
+которая может помочь справится со звуковыми искажениями. Подробнее
+смотрите следующие разделы.
 
 .. index:: pipewire, lowlatency, audio, sound
 .. _pipewire_setup:
 
---------------------
-Настройка PipeWire
---------------------
+=================================
+Настройка частоты дискретизации
+=================================
 
 Несмотря на то, что настройки по умолчанию могут работать достаточно
 хорошо для большинства оборудования, имеет смысл выполнить
@@ -120,9 +137,9 @@ PipeWire так же считает оптимальные задержки дл
 .. index:: pipewire, upmix, 5.1, sound
 .. _upmixing-5.1:
 
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
+--------------------------
 Микширование стерео в 5.1
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
+--------------------------
 
 PipeWire так же как и PulseAuido позволяет микшировать звук в 5.1.
 Эта возможность отключена по умолчанию, но для неё существует заранее
@@ -136,19 +153,20 @@ PipeWire так же как и PulseAuido позволяет микширова
 .. index:: pipewire, choppy, high-load, cpu, sound
 .. _choppy-audio:
 
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Исправление хрипов под нагрузкой
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+================================================
+Исправление "потрескивания" звука под нагрузкой
+================================================
 
 Некоторые пользователи после перехода на PipeWire могут столкнуться с
-появлением "хрипов" во время произведения звука, если система находится
-под высокой нагрузкой (например, фоновой компиляцией или во время игры).
-Это происходит потому, что PipeWire старается осуществлять вывод с
-звука с наименьшими задержками, что сложно гарантировать когда
-система нагружена даже с установленными ``realtime-privileges``.
+появлением "хрипов" или так называемого "потрескивания" во время
+произведения звука, если система находится под высокой нагрузкой
+(например, фоновой компиляцией или во время игры). Это происходит
+потому, что PipeWire старается осуществлять вывод с звука с
+наименьшими задержками, что сложно гарантировать даже тогда, когда
+система настроена на приоритизацию процессов по выводу звука.
 
-Для их исправления создадим новый конфигурационный файл и изменим
-следующие значения для размера буфера по умолчанию:
+Для решения данной проблемы следует создать новый конфигурационный
+файл с указанием измененных значений для минимального размера буфера:
 
 .. code-block:: shell
   :caption: ``~/.config/pipewire/pipewire.conf.d/10-sound.conf``
@@ -163,11 +181,12 @@ PipeWire так же как и PulseAuido позволяет микширова
 ``min-quantum`` на два и проверить снова до тех пор пока проблема не
 перестанет воспроизводится.
 
-.. jack:
+.. index:: pipewire, lowlatency, audio, jack
+.. _pipewire_jack:
 
-----
-JACK
-----
+===============
+Поддержка JACK
+===============
 
 JACK - это ещё один альтернативный звуковой сервер с одноименной
 библиотекой API, цель которого состоит выведение звука с минимальной
@@ -181,6 +200,8 @@ PipeWire, так как актуальная реализация JACK - `jack2
 библиотеки API лучше всего установить пакет ``pipewire-jack``, который
 предоставляет совместимость между такими приложениями со звуковым
 сервером PipeWire, что позволяет всем изменениям проделенным выше для
-его настройки распространяться и на приложения, использующие JACK.
+его настройки распространяться и на приложения, использующие JACK:
+
+  sudo pacman -S pipewire-jack
 
 .. vim:set textwidth=70: