.TH pactl 1 User Manuals
.SH "نام (NAME)"
pactl \- کنترل یک سرور صوتی در حال اجرای PulseAudio
.SH "خلاصه دستور (SYNOPSIS)"
\fBpactl [\fIoptions\fB] \fICOMMAND\fB [\fIARGS ...\fB]

pactl --help\fB

pactl --version\fB
\f1
.SH "توضیحات (DESCRIPTION)"
از \fIpactl\f1 می‌توان برای صدور دستورهای کنترلی به سرور صوتی PulseAudio استفاده کرد.

ابزار \fIpactl\f1 تنها زیرمجموعه‌ای از عملیات‌های دردسترس را ارائه می‌دهد. برای دسترسی به مجموعه کامل، از \fBpacmd(1)\f1 استفاده کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-h | --help\f1
نمایش راهنما.
.TP
\fB--version\f1
نمایش اطلاعات نسخه.
.TP
\fB-s | --server\f1\fI=SERVER\f1
انتخاب سرور برای اتصال به آن.
.TP
\fB-f | --format\f1\fI=FORMAT\f1
انتخاب قالب خروجی؛ گزینه‌های دردسترس "text" یا "json" هستند.
.TP
\fB-n | --client-name\f1\fI=NAME\f1
مشخص کردن نام کلاینتی که \fIpactl\f1 هنگام اتصال به سرور ارسال می‌کند.
.SH "دستورها (COMMANDS)"
هنگامی که به عنوان آرگومان به دستورهای زیر داده شوند، می‌توان از نام‌های ویژه \@DEFAULT_SINK@، \@DEFAULT_SOURCE@ و \@DEFAULT_MONITOR@ به ترتیب برای مشخص کردن sink، source و monitor پیش‌فرض استفاده کرد.
.TP
\fBstat\f1
نمایش آماری کوتاه درباره میزان مصرف حافظه توسط دیمن PulseAudio.
.TP
\fBinfo\f1
نمایش اطلاعاتی درباره دیمن PulseAudio.
.TP
\fBlist\f1 [\fIshort\f1] [\fITYPE\f1]
نمایش تمام ماژول‌های بارگذاری‌شده، sinkها، sourceها، جریان‌ها و موارد دردسترس دیگر. مقدار \fITYPE\f1 باید یکی از این موارد باشد: modules، sinks، sources، sink-inputs، source-outputs، clients، samples، cards، message-handlers. در صورت عدم تعیین، تمامی اطلاعات به استثنای message-handlers فهرست می‌شوند. اگر short مشخص شود، خروجی در قالبی جدولی برای پردازش آسان توسط اسکریپت‌ها ارائه خواهد شد.
.TP
\fBexit\f1
درخواست از سرور PulseAudio برای خاتمه کار.
.TP
\fBupload-sample\f1 \fIFILENAME\f1 [\fINAME\f1]
بارگذاری یک صدا از فایل صوتی مشخص‌شده در حافظه نهان نمونه (sample cache). انواع فایل‌های پشتیبانی‌شده مواردی هستند که توسط \fIlibsndfile\f1 پشتیبانی می‌شوند. نمونه موجود در حافظه نهان بر اساس فایل صوتی نام‌گذاری می‌شود، مگر اینکه نام صراحتاً مشخص شده باشد.
.TP
\fBplay-sample\f1 \fINAME\f1 [\fISINK\f1]
پخش نمونه مشخص‌شده از حافظه نهان نمونه. این نمونه روی sink پیش‌فرض پخش می‌شود، مگر اینکه نام نمادین یا نمایه عددی sink مورد نظر برای پخش مشخص شده باشد.
.TP
\fBremove-sample\f1 \fINAME\f1
حذف نمونه مشخص‌شده از حافظه نهان نمونه.
.TP
\fBload-module\f1 \fINAME\f1 [\fIARGUMENTS ...\f1]
بارگذاری ماژول مشخص‌شده با آرگومان‌های داده‌شده در سرور صوتی در حال اجرا. نمایه عددی ماژول تازه بارگذاری‌شده را در STDOUT چاپ می‌کند. می‌توانید بعداً از آن برای تخلیه ماژول استفاده کنید.
.TP
\fBunload-module\f1 \fIID|NAME\f1
تخلیه نمونه ماژول شناسایی‌شده با نمایه عددی مشخص، یا تخلیه تمام ماژول‌ها با نام مشخص‌شده.
.TP
\fBmove-sink-input\f1 \fIID\f1 \fISINK\f1
انتقال جریان پخش مشخص‌شده (شناسایی‌شده با نمایه عددی آن) به sink مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن).
.TP
\fBmove-source-output\f1 \fIID\f1 \fISOURCE\f1
انتقال جریان ضبط مشخص‌شده (شناسایی‌شده با نمایه عددی آن) به source مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن).
.TP
\fBsuspend-sink\f1 \fISINK\f1 \fItrue|false\f1
تعلیق یا ازسرگیری sink مشخص‌شده (که می‌تواند با نام نمادین یا نمایه عددی آن مشخص شود)، بسته به اینکه مقدار true (تعلیق) یا false (ازسرگیری) به عنوان آخرین آرگومان ارسال شده باشد. تعلیق یک sink تمام پخش را متوقف خواهد کرد. بسته به ماژولی که sink را پیاده‌سازی می‌کند، این عمل ممکن است باعث بسته شدن دستگاه زیربنایی شود و آن را برای استفاده سایر برنامه‌ها آزاد کند. رفتار دقیق بستگی به ماژول دارد.
.TP
\fBsuspend-source\f1 \fISOURCE\f1 \fItrue|false\f1
تعلیق یا ازسرگیری source مشخص‌شده (که می‌تواند با نام نمادین یا نمایه عددی آن مشخص شود)، بسته به اینکه مقدار true (تعلیق) یا false (ازسرگیری) به عنوان آخرین آرگومان ارسال شده باشد. تعلیق یک source تمام ضبط را متوقف خواهد کرد. بسته به ماژولی که source را پیاده‌سازی می‌کند، این عمل ممکن است باعث بسته شدن دستگاه زیربنایی شود و آن را برای استفاده سایر برنامه‌ها آزاد کند. رفتار دقیق بستگی به ماژول دارد.
.TP
\fBset-card-profile\f1 \fICARD\f1 \fIPROFILE\f1
تنظیم کارت مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن) به نمایه مشخص‌شده (شناسایی‌شده با نام نمادین آن).
.TP
\fBget-default-sink\f1
نام نمادین sink پیش‌فرض را برمی‌گرداند.
.TP
\fBset-default-sink\f1 \fISINK\f1
تنظیم sink مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن) به عنوان sink پیش‌فرض. از نام ویژه \@NONE@ برای لغو sink پیش‌فرضِ تعیین‌شده توسط کاربر استفاده کنید. این کار باعث می‌شود pulseaudio به انتخاب پیش‌فرض sink بر اساس اولویت sink بازگردد.
.TP
\fBset-sink-port\f1 \fISINK\f1 \fIPORT\f1
تنظیم sink مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن) بر روی درگاه مشخص‌شده (شناسایی‌شده با نام نمادین آن).
.TP
\fBget-default-source\f1
نام نمادین source پیش‌فرض را برمی‌گرداند.
.TP
\fBset-default-source\f1 \fISOURCE\f1
تنظیم source مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن) به عنوان source پیش‌فرض. از نام ویژه \@NONE@ برای لغو source پیش‌فرضِ تعیین‌شده توسط کاربر استفاده کنید. این کار باعث می‌شود pulseaudio به انتخاب پیش‌فرض source بر اساس اولویت source بازگردد.
.TP
\fBset-source-port\f1 \fISOURCE\f1 \fIPORT\f1
تنظیم source مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن) بر روی درگاه مشخص‌شده (شناسایی‌شده با نام نمادین آن).
.TP
\fBset-port-latency-offset\f1 \fICARD\f1 \fIPORT\f1 \fIOFFSET\f1
تنظیم افست تأخیر برای درگاه مشخص‌شده (شناسایی‌شده با نام نمادین آن) متعلق به یک کارت (شناسایی‌شده با نام نمادین یا نمایه عددی آن). مقدار \fIOFFSET\f1 عددی است که افست تأخیر را بر حسب میکروثانیه مشخص می‌کند.
.TP
\fBget-sink-volume\f1 \fISINK\f1
دریافت بلندی صدای sink مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن) در همان قالبی که توسط دستور `info` نمایش داده می‌شود.
.TP
\fBset-sink-volume\f1 \fISINK\f1 \fIVOLUME [VOLUME ...]\f1
تنظیم بلندی صدای sink مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن). مقدار \fIVOLUME\f1 را می‌توان به صورت یک عدد صحیح (مانند 2000، 16384)، یک ضریب خطی (مانند 0.4، 1.100)، یک درصد (مانند 10%، 100%) یا یک مقدار دسی‌بل (مانند 0dB، 20dB) تعیین کرد. اگر مقدار بلندی صدا با + یا - شروع شود، تنظیم میزان صدا به صورت نسبی با بلندی صدای فعلی sink اعمال خواهد شد. یک مقدار واحد روی تمام کانال‌ها تأثیر می‌گذارد؛ در صورت ارائه چندین مقدار، تعداد آن‌ها باید با تعداد کانال‌های sink مطابقت داشته باشد.
.TP
\fBget-source-volume\f1 \fISOURCE\f1
دریافت بلندی صدای source مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن) در همان قالبی که توسط دستور `info` نمایش داده می‌شود.
.TP
\fBset-source-volume\f1 \fISOURCE\f1 \fIVOLUME [VOLUME ...]\f1
تنظیم بلندی صدای source مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن). مقدار \fIVOLUME\f1 را می‌توان به صورت یک عدد صحیح (مانند 2000، 16384)، یک ضریب خطی (مانند 0.4، 1.100)، یک درصد (مانند 10%، 100%) یا یک مقدار دسی‌بل (مانند 0dB، 20dB) تعیین کرد. اگر مقدار بلندی صدا با + یا - شروع شود، تنظیم میزان صدا به صورت نسبی با بلندی صدای فعلی source اعمال خواهد شد. یک مقدار واحد روی تمام کانال‌ها تأثیر می‌گذارد؛ در صورت ارائه چندین مقدار، تعداد آن‌ها باید با تعداد کانال‌های source مطابقت داشته باشد.
.TP
\fBset-sink-input-volume\f1 \fIINPUT\f1 \fIVOLUME [VOLUME ...]\f1
تنظیم بلندی صدای ورودی sink مشخص‌شده (شناسایی‌شده با نمایه عددی آن). مقدار \fIVOLUME\f1 را می‌توان به صورت یک عدد صحیح (مانند 2000، 16384)، یک ضریب خطی (مانند 0.4، 1.100)، یک درصد (مانند 10%، 100%) یا یک مقدار دسی‌بل (مانند 0dB، 20dB) تعیین کرد. اگر مقدار بلندی صدا با + یا - شروع شود، تنظیم میزان صدا به صورت نسبی با بلندی صدای فعلی ورودی sink اعمال خواهد شد. یک مقدار واحد روی تمام کانال‌ها تأثیر می‌گذارد؛ در صورت ارائه چندین مقدار، تعداد آن‌ها باید با تعداد کانال‌های ورودی sink مطابقت داشته باشد.
.TP
\fBset-source-output-volume\f1 \fIOUTPUT\f1 \fIVOLUME [VOLUME ...]\f1
تنظیم بلندی صدای خروجی source مشخص‌شده (شناسایی‌شده با نمایه عددی آن). مقدار \fIVOLUME\f1 را می‌توان به صورت یک عدد صحیح (مانند 2000، 16384)، یک ضریب خطی (مانند 0.4، 1.100)، یک درصد (مانند 10%، 100%) یا یک مقدار دسی‌بل (مانند 0dB، 20dB) تعیین کرد. اگر مقدار بلندی صدا با + یا - شروع شود، تنظیم میزان صدا به صورت نسبی با بلندی صدای فعلی خروجی source اعمال خواهد شد. یک مقدار واحد روی تمام کانال‌ها تأثیر می‌گذارد؛ در صورت ارائه چندین مقدار، تعداد آن‌ها باید با تعداد کانال‌های خروجی source مطابقت داشته باشد.
.TP
\fBget-sink-mute\f1 \fISINK\f1
دریافت وضعیت بی‌صدا بودن sink مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن).
.TP
\fBset-sink-mute\f1 \fISINK\f1 \fI1|0|toggle\f1
تنظیم وضعیت بی‌صدا بودن sink مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن).
.TP
\fBget-source-mute\f1 \fISOURCE\f1
دریافت وضعیت بی‌صدا بودن source مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن).
.TP
\fBset-source-mute\f1 \fISOURCE\f1 \fI1|0|toggle\f1
تنظیم وضعیت بی‌صدا بودن source مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن).
.TP
\fBset-sink-input-mute\f1 \fIINPUT\f1 \fI1|0|toggle\f1
تنظیم وضعیت بی‌صدا بودن ورودی sink مشخص‌شده (شناسایی‌شده با نمایه عددی آن).
.TP
\fBset-source-output-mute\f1 \fIOUTPUT\f1 \fI1|0|toggle\f1
تنظیم وضعیت بی‌صدا بودن خروجی source مشخص‌شده (شناسایی‌شده با نمایه عددی آن).
.TP
\fBset-sink-formats\f1 \fISINK\f1 \fIFORMATS\f1
تنظیم قالب‌های پشتیبانی‌شده توسط sink مشخص‌شده (شناسایی‌شده با نمایه عددی آن) در صورت پشتیبانی توسط sink. مقدار \fIFORMATS\f1 به صورت فهرستی از قالب‌ها که با نقطه-ویرگول (;) از هم جدا شده‌اند به فرم 'encoding[, key1=value1, key2=value2, ...]' مشخص می‌شود (برای مثال، AC3 در فرکانس‌های 32000، 44100 و 48000 هرتز به صورت 'ac3-iec61937, format.rate = "[ 32000, 44100, 48000 ]"' مشخص خواهد شد). برای مشاهده کدگذاری‌های ممکن، https://www.freedesktop.org/wiki/Software/PulseAudio/Documentation/User/SupportedAudioFormats را ببینید.
.TP
\fBsend-message\f1 \fIRECIPIENT\f1 \fIMESSAGE\f1 \fIMESSAGE_PARAMETERS\f1
ارسال یک پیام به شیء گیرنده مشخص‌شده. در صورت کاربرد، می‌توان یک رشته اضافی حاوی پارامترهای پیام را مشخص کرد. یک رشته به عنوان پاسخ به پیام بازگردانده می‌شود. برای مشاهده پیام‌های دردسترس، https://cgit.freedesktop.org/pulseaudio/pulseaudio/tree/doc/messaging_api.txt را ببینید.
.TP
\fBsubscribe\f1
اشتراک در رویدادها؛ pactl خودبه‌خود خارج نمی‌شود، بلکه منتظر دریافت رویدادهای جدید باقی می‌ماند.
.SH "نویسندگان (AUTHORS)"
توسعه‌دهندگان PulseAudio <pulseaudio-discuss (at) lists (dot) freedesktop (dot) org>؛ PulseAudio از طریق \fBhttp://pulseaudio.org\f1 در دسترس است.
.SH "همچنین ببینید (SEE ALSO)"
\fBpulseaudio(1)\f1، \fBpacmd(1)\f1