.TH "pipewire-client.conf" 5 "1.6.8" "PipeWire" " -*- nroff -*-
.ad l
.nh
.SH "نام (NAME)"
pipewire-client.conf \- فایل پیکربندی کلاینت PipeWire
.SH "خلاصه دستور (SYNOPSIS)"
.PP

.PP
\fI/pipewire/client\&.conf\fP

.PP
\fI/etc/pipewire/client\&.conf\fP

.PP
\fI/usr/share/pipewire/client\&.conf\fP

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

.PP
\fI/etc/pipewire/client\&.conf\&.d/\fP

.PP
\fI/pipewire/client\&.conf\&.d/\fP

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

.PP
پیکربندی برای کلاینت‌های بومی PipeWire و برای پلاگین ALSA مربوط به PipeWire\&.

.PP
یک برنامه کلاینت بومی PipeWire پیکربندی پیش‌فرض را برای بارگذاری انتخاب می‌کند، و اگر چیزی مشخص نشده باشد، معمولاً \fRclient\&.conf\fP را بارگذاری می‌نماید\&.

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

.PP
فایل‌های پیکربندی قطره‌ای (drop-in) به صورت \fRclient\&.conf\&.d/*\&.conf\fP قابل استفاده بوده و توصیه می‌شوند\&. به \fBpipewire\&.conf(5)\fP مراجعه کنید\&.
.SH "بخش‌های فایل پیکربندی (CONFIGURATION FILE SECTIONS)"
.PP
\fBstream\&.properties\fP
.RS 4
پیکربندی گزینه‌ها برای جریان‌های کلاینت بومی\&.
.RE
.PP
\fBstream\&.rules\fP
.RS 4
پیکربندی قواعد برای جریان‌های کلاینت بومی\&.
.RE
.PP
\fBalsa\&.properties\fP
.RS 4
پیکربندی کلاینت ALSA\&.
.RE
.PP
\fBalsa\&.rules\fP
.RS 4
قواعد تطبیق کلاینت ALSA\&.
.RE
.PP
علاوه بر این، بخش‌های پیکربندی زمینه (context) در PipeWire نیز ممکن است مشخص شوند، به \fBpipewire\&.conf(5)\fP مراجعه کنید\&.
.SH "ویژگی‌های جریان (STREAM PROPERTIES)"
.PP
فایل‌های پیکربندی کلاینت شامل یک بخش stream\&.properties هستند که گزینه‌های جریان‌های کلاینت را پیکربندی می‌کند:
.PP
.nf
# ~/\&.config/pipewire/client\&.conf\&.d/custom\&.conf

stream\&.properties = {
    #node\&.latency = 1024/48000
    #node\&.autoconnect = true
    #resample\&.disable = false
    #resample\&.quality = 4
    #resample\&.window = exp # blackman kaiser
    #resample\&.cutoff = 0\&.0
    #resample\&.n\-taps = 0
    #resample\&.param\&.exp\&.A = 0\&.0
    #resample\&.param\&.blackman\&.alpha = 0\&.0
    #resample\&.param\&.kaiser\&.alpha = 0\&.0
    #resample\&.param\&.kaiser\&.stopband\-attenuation = 0\&.0
    #resample\&.param\&.kaiser\&.transition\-bandwidth = 0\&.0
    #monitor\&.channel\-volumes = false
    #channelmix\&.disable = false
    #channelmix\&.min\-volume = 0\&.0
    #channelmix\&.max\-volume = 10\&.0
    #channelmix\&.normalize = false
    #channelmix\&.lock\-volume = 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

.PP
برخی از ویژگی‌ها به جنبه‌های مختلف جریان اشاره دارند:

.PP
.IP "\(bu" 2
ویژگی‌های عمومی جریان برای شناسایی جریان\&.
.IP "\(bu" 2
ویژگی‌های عمومی جریان برای دسته‌بندی جریان\&.
.IP "\(bu" 2
نحوه زمان‌بندی آن توسط گراف پردازش\&.
.IP "\(bu" 2
نحوه پیوند آن توسط مدیر نشست (session manager)\&.
.IP "\(bu" 2
نحوه انجام پردازش داخلی\&.
.IP "\(bu" 2
ویژگی‌هایی برای پیکربندی قالب رسانه\&.
.PP

.PP
فهرستی از ویژگی‌های شیء که می‌توان بر جریان‌ها اعمال کرد در \fBpipewire-props(7) Common Node Properties\fP و \fBpipewire-props(7) Audio Adapter Properties\fP یافت می‌شود\&.
.SH "قواعد جریان (STREAM RULES)"
.PP
می‌توانید \fBقواعد تطبیق (به pipewire(1) مراجعه کنید)\fP را برای تنظیم ویژگی‌های جریان‌ها و فیلترهای مشخص اضافه کنید\&.

.PP
بخش‌های \fRstream\&.rules\fP و \fRfilter\&.rules\fP یک کنش \fRupdate-props\fP فراهم می‌کنند که یک شیء حاوی ویژگی‌ها دریافت کرده و آن‌ها را روی شیء گره (node) جریان و فیلتر به‌روزرسانی می‌کند\&.

.PP
یک بخش \fRstream\&.rules\fP یا \fRfilter\&.rules\fP را به این صورت در فایل پیکربندی اضافه کنید:

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

stream\&.rules = [
    {
        matches = [
            {
                # all keys must match the value\&. ! negates\&. ~ starts regex\&.
                application\&.process\&.binary = "firefox"
            }
        ]
        actions = {
            update\-props = {
                node\&.name = "My Name"
            }
        }
    }
]
.fi
.PP

.PP
این پیکربندی node\&.name مربوط به Firefox را روی "My Name" تنظیم می‌کند\&.
.SH "ویژگی‌های کلاینت ALSA (ALSA CLIENT PROPERTIES)"
.PP
یک بخش \fRalsa\&.properties\fP می‌تواند برای پیکربندی برنامه‌های کلاینت که از طریق پلاگین ALSA مربوط به PipeWire متصل می‌شوند اضافه شود\&.

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

alsa\&.properties = {
    #alsa\&.deny = false
    #alsa\&.format = 0
    #alsa\&.rate = 0
    #alsa\&.channels = 0
    #alsa\&.period\-bytes = 0
    #alsa\&.buffer\-bytes = 0
    #alsa\&.volume\-method = cubic         # linear, cubic
}
.fi
.PP

.PP
\fBalsa\&.deny \fP
.RS 4
دسترسی ALSA را برای کلاینت مسدود می‌کند\&. در قواعد یا در متغیر محیطی PIPEWIRE_ALSA مفید است\&.
.RE
.PP
\fBalsa\&.format \fP
.RS 4
قالب ALSA مورد استفاده برای کلاینت\&. این یک نام قالب ALSA است\&. پیش‌فرض 0 است، که به معنای مجاز بودن تمام قالب‌هاست\&.
.RE
.PP
\fBalsa\&.rate \fP
.RS 4
نرخ نمونه‌برداری مورد استفاده برای کلاینت\&. پیش‌فرض 0 است، که به معنای مجاز بودن همه نرخ‌هاست\&.
.RE
.PP
\fBalsa\&.channels \fP
.RS 4
تعداد کانال‌ها برای کلاینت\&. پیش‌فرض 0 است، که به معنای مجاز بودن هر تعداد کانال است\&.
.RE
.PP
\fBalsa\&.period-bytes \fP
.RS 4
تعداد بایت‌ها در هر دوره (period)\&. پیش‌فرض 0 است که به معنای مجاز بودن هر تعداد بایت دوره است\&.
.RE
.PP
\fBalsa\&.buffer-bytes \fP
.RS 4
تعداد بایت‌ها در بافر ALSA\&. پیش‌فرض 0 است، که به معنای مجاز بودن هر تعداد بایت است\&.
.RE
.PP
\fBalsa\&.volume-method = cubic | linear\fP
.RS 4
این گزینه منحنی بلندی صدا را روی میکسر ALSA کنترل می‌کند\&. مقادیر ممکن عبارتند از \fRcubic\fP و \fRlinear\fP\&. پیش‌فرض استفاده از \fRcubic\fP است\&.
.RE
.PP
.SH "قواعد کلاینت ALSA (ALSA CLIENT RULES)"
.PP
امکان تنظیم ویژگی‌های خاص کلاینت ALSA با استفاده از \fBقواعد تطبیق (به pipewire(1) مراجعه کنید)\fP وجود دارد\&. می‌توانید هر یک از ویژگی‌های ALSA بالا یا هر یک از \fRstream\&.properties\fP را تنظیم کنید\&.

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

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

alsa\&.rules = [
    {   matches = [ { application\&.process\&.binary = "resolve" } ]
        actions = {
            update\-props = {
                alsa\&.buffer\-bytes = 131072
            }
        }
    }
]
.fi
.PP
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
برای متغیرهای محیطی متداول به \fBpipewire(1)\fP مراجعه کنید\&. بسیاری از آن‌ها برای برنامه‌های کلاینت نیز اعمال می‌شوند\&.

.PP
متغیرهای محیطی همچنین بر برنامه‌های ALSA که از پلاگین ALSA مربوط به PipeWire استفاده می‌کنند تأثیر می‌گذارند\&.

.PP
\fBPIPEWIRE_ALSA \fP
.RS 4
می‌تواند شیئی با ویژگی‌هایی از \fRalsa\&.properties\fP یا \fRstream\&.properties\fP باشد که برای ایجاد کلاینت و جریان‌ها استفاده خواهد شد\&.

.PP
برای نمونه:
.PP
.nf
PIPEWIRE_ALSA='{ alsa\&.buffer\-bytes=16384 node\&.name=foo }' aplay \&.\&.\&.

.fi
.PP
برنامه aplay را با ویژگی‌های سفارشی اجرا می‌کند\&.
.RE
.PP

.PP
\fBPIPEWIRE_NODE \fP
.RS 4
به کلاینت ALSA دستور می‌دهد تا به یک سینک یا سورس خاص با \fRobject\&.serial\fP یا \fRnode\&.name\fP مشخص متصل شود\&.

.PP
برای نمونه:
.PP
.nf
PIPEWIRE_NODE=alsa_output\&.pci\-0000_00_1b\&.0\&.analog\-stereo aplay \&.\&.\&.

.fi
.PP
باعث می‌شود aplay صدا را روی سینک صوتی مشخص‌شده پخش کند\&.
.RE
.PP

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

.PP
توسعه‌دهندگان PipeWire <https://gitlab.freedesktop.org/pipewire/pipewire/issues>؛ پروژه PipeWire از <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