.TH "pipewire-pulse.conf" 5 "1.6.8" "PipeWire" \" -*- nroff -*-
.ad l
.nh
.SH "نام (NAME)"
pipewire-pulse.conf \- فایل پیکربندی سرور PulseAudio در پایپ‌ویر
.SH "توضیحات (DESCRIPTION)"
.PP
فایل پیکربندی سرور PulseAudio پایپ‌ویر (PipeWire)

.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP

.PP
\fI$XDG_CONFIG_HOME/pipewire/pipewire-pulse\&.conf\fP

.PP
\fI/etc/pipewire/pipewire-pulse\&.conf\fP

.PP
\fI/usr/share/pipewire/pipewire-pulse\&.conf\fP

.PP
\fI/usr/share/pipewire/pipewire-pulse\&.conf\&.d/\fP

.PP
\fI/etc/pipewire/pipewire-pulse\&.conf\&.d/\fP

.PP
\fI$XDG_CONFIG_HOME/pipewire/pipewire-pulse\&.conf\&.d/\fP

.PP
.SH "توضیحات (DESCRIPTION)"
.PP

.PP
پیکربندی دیمن سازگار با PulseAudio در پایپ‌ویر\&.

.PP
قالب فایل پیکربندی و منطق جستجوی آن دقیقاً مشابه \fBpipewire\&.conf(5)\fP است\&.

.PP
فایل‌های پیکربندی تکمیلی (Drop-in) به صورت \fRpipewire-pulse\&.conf\&.d/*\&.conf\fP می‌توانند استفاده شوند و استفاده از آن‌ها توصیه می‌شود\&. به \fBpipewire\&.conf(5)\fP مراجعه کنید\&.
.SH "بخش‌های فایل پیکربندی (CONFIGURATION FILE SECTIONS)"
.PP
\fBstream\&.properties\fP
.RS 4
دیکشنری (Dictionary)\&. این ویژگی‌ها، مشخصات جریان سرور PulseAudio در پایپ‌ویر را پیکربندی می‌کنند\&.
.RE
.PP
\fBstream\&.rules\fP
.RS 4
دیکشنری (Dictionary)\&. این ویژگی‌ها، قواعد مربوط به جریان‌ها در سرور PulseAudio پایپ‌ویر را پیکربندی می‌کنند\&.
.RE
.PP
\fBpulse\&.properties\fP
.RS 4
دیکشنری (Dictionary)\&. این ویژگی‌ها، مشخصات عمومی سرور PulseAudio در پایپ‌ویر را پیکربندی می‌کنند\&.
.RE
.PP
\fBpulse\&.cmd\fP
.RS 4
آرایه‌ای از دیکشنری‌ها\&. مجموعه‌ای از دستورات که باید در زمان راه‌اندازی اجرا شوند\&.
.RE
.PP
\fBpulse\&.rules\fP
.RS 4
آرایه‌ای از دیکشنری‌ها\&. مجموعه‌ای از قواعد تطبیق و اقداماتی که باید بر روی کلاینت‌ها اعمال شوند\&.
.RE
.PP
برای توضیحات تفصیلی به \fBlibpipewire-module-protocol-pulse(7)\fP مراجعه فرمایید\&.

.PP
علاوه بر این، بخش‌های پیکربندی بافتار پایپ‌ویر نیز می‌توانند مشخص شوند؛ به \fBpipewire\&.conf(5)\fP مراجعه کنید\&.
.SH "ویژگی‌های جریان (STREAM PROPERTIES)"
.PP
بخش \fRstream\&.properties\fP شامل ویژگی‌هایی برای جریان‌های ایجادشده توسط سرور pipewire-pulse است\&.

.PP
گزینه‌های در دسترس در \fBpipewire-client\&.conf(5) stream\&.properties\fP شرح داده شده‌اند\&.

.PP
برخی از این ویژگی‌ها به مدخل‌های پیکربندی PulseAudio در \fR/etc/pulse/default\&.pa\fP به شکل زیر نگاشت می‌شوند:

.PP
.nf
PulseAudio                      PipeWire                یادداشت‌ها
remixing-use-all-sink-channels  channelmix\&.upmix
remixing-produce-lfe            channelmix\&.lfe-cutoff  تنظیم روی مقدار > 0 جهت فعال‌سازی
remixing-consume-lfe            channelmix\&.mix-lfe
lfe-crossover-freq              channelmix\&.lfe-cutoff
.fi

.PP
.SS "مثال (Example)"

.PP
.PP
.nf
# ~\&./config/pipewire/pipewire\-pulse\&.conf\&.d/custom\&.conf

stream\&.properties = {
    #node\&.latency = 1024/48000
    #node\&.autoconnect = true
    #resample\&.disable = false
    #resample\&.quality = 4
    #monitor\&.channel\-volumes = false
    #channelmix\&.disable = false
    #channelmix\&.min\-volume = 0\&.0
    #channelmix\&.max\-volume = 10\&.0
    #channelmix\&.normalize = false
    #channelmix\&.mix\-lfe = true
    #channelmix\&.upmix = true
    #channelmix\&.upmix\-method = psd  # none, simple
    #channelmix\&.lfe\-cutoff = 150\&.0
    #channelmix\&.fc\-cutoff = 12000\&.0
    #channelmix\&.rear\-delay = 12\&.0
    #channelmix\&.stereo\-widen = 0\&.0
    #channelmix\&.hilbert\-taps = 0
    #dither\&.noise = 0
    #dither\&.method = none # rectangular, triangular, triangular\-hf, wannamaker3, shaped5
    #debug\&.wav\-path = ""
}
.fi
.PP
.SH "قواعد جریان (STREAM RULES)"
.PP
بخش \fRstream\&.rules\fP دقیقاً همانند \fBpipewire-client\&.conf(5) stream\&.rules\fP عمل می‌کند\&.
.SH "ویژگی‌های پولس‌آدیو (PULSEAUDIO PROPERTIES)"
.PP
برای گزینه‌های موجود در بخش \fRpulse\&.properties\fP، به \fBlibpipewire-module-protocol-pulse(7)\fP مراجعه فرمایید\&.
.SH "قواعد پولس‌آدیو (PULSEAUDIO RULES)"
.PP
برای هر کلاینت، می‌توان مجموعه‌ای از قواعد را در بخش \fRpulse\&.rules\fP نوشت تا رفتارهای خاص کلاینت را پیکربندی کرده یا پیکربندی جریان ویژه PulseAudio را تحمیل کند\&.

.PP
نمای کلی این بخش به شکل زیر است و از ساختار \fBقواعد تطبیق، به pipewire(1)\fP پیروی می‌کند\&.

.PP
برای گزینه‌های موجود به \fBlibpipewire-module-protocol-pulse(7)\fP مراجعه فرمایید\&.

.PP
.SS "مثال (Example)"

.PP
.PP
.nf
# ~\&./config/pipewire/pipewire\-pulse\&.conf\&.d/custom\&.conf

pulse\&.rules = [
    {
        # skype does not want to use devices that don't have an S16 sample format\&.
        matches = [
             { application\&.process\&.binary = "teams" }
             { application\&.process\&.binary = "teams\-insiders" }
             { application\&.process\&.binary = "skypeforlinux" }
        ]
        actions = { quirks = [ force\-s16\-info ] }
    }
    {
        # speech dispatcher asks for too small latency and then underruns\&.
        matches = [ { application\&.name = "~speech\-dispatcher*" } ]
        actions = {
            update\-props = {
                pulse\&.min\&.req          = 1024/48000     # 21ms
                pulse\&.min\&.quantum      = 1024/48000     # 21ms
            }
        }
    }
]
.fi
.PP
.SH "دستورات پولس‌آدیو (PULSEAUDIO COMMANDS)"
.PP
به عنوان بخشی از فرآیند راه‌اندازی سرور می‌توانید با استفاده از بخش \fRpulse\&.cmd\fP در \fRpipewire-pulse\&.conf\fP دستورات تکمیلی را اجرا کنید\&.

.PP
.PP
.nf
# ~\&./config/pipewire/pipewire\-pulse\&.conf\&.d/custom\&.conf

pulse\&.cmd = [
    { cmd = "load\-module" args = "module\-always\-sink" flags = [ ] }
    { cmd = "load\-module" args = "module\-switch\-on\-connect" }
    { cmd = "load\-module" args = "module\-gsettings" flags = [ "nofail" ] }
]
\&.\&.\&.
.fi
.PP

.PP
دستورات بیشتر را همچنین می‌توان از طریق \fBبخش context\&.exec، به pipewire\&.conf(5)\fP اجرا کرد\&.

.PP
دستورات پشتیبانی‌شده:

.PP
\fBload-module \fP
.RS 4
بارگذاری ماژول مشخص‌شده PulseAudio هنگام راه‌اندازی، درست مانند استفاده از \fBpactl(1)\fP برای بارگذاری ماژول\&.
.RE
.PP
.SH "ماژول‌های پولس‌آدیو (PULSEAUDIO MODULES)"
.PP
برای مشاهده محتوای بخش \fRpulse\&.modules\fP، به \fBpipewire-pulse-modules(7)\fP مراجعه کنید\&.

.PP
.SH "نویسندگان (AUTHORS)"
.PP

.PP
توسعه‌دهندگان پایپ‌ویر <https://gitlab.freedesktop.org/pipewire/pipewire/issues>؛ پایپ‌ویر از <https://pipewire.org> در دسترس است

.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP

.PP
\fBlibpipewire-module-protocol-pulse(7)\fP, \fBpipewire\&.conf(5)\fP, \fBpipewire-pulse(1)\fP, \fBpipewire-pulse-modules(7)\fP