pactl(1)                    General Commands Manual                   pactl(1)

نام (NAME)
       pactl - کنترل یک سرور صوتی در حال اجرای PulseAudio

خلاصه دستور (SYNOPSIS)
       pactl [options] COMMAND [ARGS ...]

       pactl --help

       pactl --version

توضیحات (DESCRIPTION)
       از pactl می‌توان برای صدور دستورهای کنترلی به سرور صوتی PulseAudio
       استفاده کرد.

       ابزار pactl تنها زیرمجموعه‌ای از عملیات‌های دردسترس را ارائه می‌دهد. برای
       دسترسی به مجموعه کامل، از pacmd(1) استفاده کنید.

گزینه‌ها (OPTIONS)
       -h | --help
              نمایش راهنما.

       --version
              نمایش اطلاعات نسخه.

       -s | --server=SERVER
              انتخاب سرور برای اتصال به آن.

       -f | --format=FORMAT
              انتخاب قالب خروجی؛ گزینه‌های دردسترس "text" یا "json" هستند.

       -n | --client-name=NAME
              مشخص کردن نام کلاینتی که pactl هنگام اتصال به سرور ارسال می‌کند.

دستورها (COMMANDS)
       هنگامی که به عنوان آرگومان به دستورهای زیر داده شوند، می‌توان از نام‌های
       ویژه @DEFAULT_SINK@، @DEFAULT_SOURCE@ و @DEFAULT_MONITOR@ به ترتیب برای
       مشخص کردن sink، source و monitor پیش‌فرض استفاده کرد.

       stat   نمایش آماری کوتاه درباره میزان مصرف حافظه توسط دیمن PulseAudio.

       info   نمایش اطلاعاتی درباره دیمن PulseAudio.

       list [short] [TYPE]
              نمایش تمام ماژول‌های بارگذاری‌شده، sinkها، sourceها، جریان‌ها و
              موارد دردسترس دیگر. مقدار TYPE باید یکی از این موارد باشد:
              modules، sinks، sources، sink-inputs، source-outputs، clients،
              samples، cards، message-handlers. در صورت عدم تعیین، تمامی
              اطلاعات به استثنای message-handlers فهرست می‌شوند. اگر short مشخص
              شود، خروجی در قالبی جدولی برای پردازش آسان توسط اسکریپت‌ها ارائه
              خواهد شد.

       exit   درخواست از سرور PulseAudio برای خاتمه کار.

       upload-sample FILENAME [NAME]
              بارگذاری یک صدا از فایل صوتی مشخص‌شده در حافظه نهان نمونه (sample
              cache). انواع فایل‌های پشتیبانی‌شده مواردی هستند که توسط
              libsndfile پشتیبانی می‌شوند. نمونه موجود در حافظه نهان بر اساس
              فایل صوتی نام‌گذاری می‌شود، مگر اینکه نام صراحتاً مشخص شده باشد.

       play-sample NAME [SINK]
              پخش نمونه مشخص‌شده از حافظه نهان نمونه. این نمونه روی sink پیش‌فرض
              پخش می‌شود، مگر اینکه نام نمادین یا نمایه عددی sink مورد نظر برای
              پخش مشخص شده باشد.

       remove-sample NAME
              حذف نمونه مشخص‌شده از حافظه نهان نمونه.

       load-module NAME [ARGUMENTS ...]
              بارگذاری ماژول مشخص‌شده با آرگومان‌های داده‌شده در سرور صوتی در حال
              اجرا. نمایه عددی ماژول تازه بارگذاری‌شده را در STDOUT چاپ می‌کند.
              می‌توانید بعداً از آن برای تخلیه ماژول استفاده کنید.

       unload-module ID|NAME
              تخلیه نمونه ماژول شناسایی‌شده با نمایه عددی مشخص، یا تخلیه تمام
              ماژول‌ها با نام مشخص‌شده.

       move-sink-input ID SINK
              انتقال جریان پخش مشخص‌شده (شناسایی‌شده با نمایه عددی آن) به sink
              مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن).

       move-source-output ID SOURCE
              انتقال جریان ضبط مشخص‌شده (شناسایی‌شده با نمایه عددی آن) به source
              مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن).

       suspend-sink SINK true|false
              تعلیق یا ازسرگیری sink مشخص‌شده (که می‌تواند با نام نمادین یا
              نمایه عددی آن مشخص شود)، بسته به اینکه مقدار true (تعلیق) یا
              false (ازسرگیری) به عنوان آخرین آرگومان ارسال شده باشد. تعلیق یک
              sink تمام پخش را متوقف خواهد کرد. بسته به ماژولی که sink را
              پیاده‌سازی می‌کند، این عمل ممکن است باعث بسته شدن دستگاه زیربنایی
              شود و آن را برای استفاده سایر برنامه‌ها آزاد کند. رفتار دقیق
              بستگی به ماژول دارد.

       suspend-source SOURCE true|false
              تعلیق یا ازسرگیری source مشخص‌شده (که می‌تواند با نام نمادین یا
              نمایه عددی آن مشخص شود)، بسته به اینکه مقدار true (تعلیق) یا
              false (ازسرگیری) به عنوان آخرین آرگومان ارسال شده باشد. تعلیق یک
              source تمام ضبط را متوقف خواهد کرد. بسته به ماژولی که source را
              پیاده‌سازی می‌کند، این عمل ممکن است باعث بسته شدن دستگاه زیربنایی
              شود و آن را برای استفاده سایر برنامه‌ها آزاد کند. رفتار دقیق
              بستگی به ماژول دارد.

       set-card-profile CARD PROFILE
              تنظیم کارت مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن)
              به نمایه مشخص‌شده (شناسایی‌شده با نام نمادین آن).

       get-default-sink
              نام نمادین sink پیش‌فرض را برمی‌گرداند.

       set-default-sink SINK
              تنظیم sink مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن)
              به عنوان sink پیش‌فرض. از نام ویژه @NONE@ برای لغو sink پیش‌فرضِ
              تعیین‌شده توسط کاربر استفاده کنید. این کار باعث می‌شود pulseaudio
              به انتخاب پیش‌فرض sink بر اساس اولویت sink بازگردد.

       set-sink-port SINK PORT
              تنظیم sink مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن)
              بر روی درگاه مشخص‌شده (شناسایی‌شده با نام نمادین آن).

       get-default-source
              نام نمادین source پیش‌فرض را برمی‌گرداند.

       set-default-source SOURCE
              تنظیم source مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن)
              به عنوان source پیش‌فرض. از نام ویژه @NONE@ برای لغو source
              پیش‌فرضِ تعیین‌شده توسط کاربر استفاده کنید. این کار باعث می‌شود
              pulseaudio به انتخاب پیش‌فرض source بر اساس اولویت source
              بازگردد.

       set-source-port SOURCE PORT
              تنظیم source مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه عددی آن)
              بر روی درگاه مشخص‌شده (شناسایی‌شده با نام نمادین آن).

       set-port-latency-offset CARD PORT OFFSET
              تنظیم افست تأخیر برای درگاه مشخص‌شده (شناسایی‌شده با نام نمادین
              آن) متعلق به یک کارت (شناسایی‌شده با نام نمادین یا نمایه عددی
              آن). مقدار OFFSET عددی است که افست تأخیر را بر حسب میکروثانیه
              مشخص می‌کند.

       get-sink-volume SINK
              دریافت بلندی صدای sink مشخص‌شده (شناسایی‌شده با نام نمادین یا
              نمایه عددی آن) در همان قالبی که توسط دستور `info` نمایش داده
              می‌شود.

       set-sink-volume SINK VOLUME [VOLUME ...]
              تنظیم بلندی صدای sink مشخص‌شده (شناسایی‌شده با نام نمادین یا نمایه
              عددی آن). مقدار VOLUME را می‌توان به صورت یک عدد صحیح (مانند
              2000، 16384)، یک ضریب خطی (مانند 0.4، 1.100)، یک درصد (مانند
              10%، 100%) یا یک مقدار دسی‌بل (مانند 0dB، 20dB) تعیین کرد. اگر
              مقدار بلندی صدا با + یا - شروع شود، تنظیم میزان صدا به صورت نسبی
              با بلندی صدای فعلی sink اعمال خواهد شد. یک مقدار واحد روی تمام
              کانال‌ها تأثیر می‌گذارد؛ در صورت ارائه چندین مقدار، تعداد آن‌ها
              باید با تعداد کانال‌های sink مطابقت داشته باشد.

       get-source-volume SOURCE
              دریافت بلندی صدای source مشخص‌شده (شناسایی‌شده با نام نمادین یا
              نمایه عددی آن) در همان قالبی که توسط دستور `info` نمایش داده
              می‌شود.

       set-source-volume SOURCE VOLUME [VOLUME ...]
              تنظیم بلندی صدای source مشخص‌شده (شناسایی‌شده با نام نمادین یا
              نمایه عددی آن). مقدار VOLUME را می‌توان به صورت یک عدد صحیح
              (مانند 2000، 16384)، یک ضریب خطی (مانند 0.4، 1.100)، یک درصد
              (مانند 10%، 100%) یا یک مقدار دسی‌بل (مانند 0dB، 20dB) تعیین کرد.
              اگر مقدار بلندی صدا با + یا - شروع شود، تنظیم میزان صدا به صورت
              نسبی با بلندی صدای فعلی source اعمال خواهد شد. یک مقدار واحد روی
              تمام کانال‌ها تأثیر می‌گذارد؛ در صورت ارائه چندین مقدار، تعداد
              آن‌ها باید با تعداد کانال‌های source مطابقت داشته باشد.

       set-sink-input-volume INPUT VOLUME [VOLUME ...]
              تنظیم بلندی صدای ورودی sink مشخص‌شده (شناسایی‌شده با نمایه عددی
              آن). مقدار VOLUME را می‌توان به صورت یک عدد صحیح (مانند 2000،
              16384)، یک ضریب خطی (مانند 0.4، 1.100)، یک درصد (مانند 10%،
              100%) یا یک مقدار دسی‌بل (مانند 0dB، 20dB) تعیین کرد. اگر مقدار
              بلندی صدا با + یا - شروع شود، تنظیم میزان صدا به صورت نسبی با
              بلندی صدای فعلی ورودی sink اعمال خواهد شد. یک مقدار واحد روی
              تمام کانال‌ها تأثیر می‌گذارد؛ در صورت ارائه چندین مقدار، تعداد
              آن‌ها باید با تعداد کانال‌های ورودی sink مطابقت داشته باشد.

       set-source-output-volume OUTPUT VOLUME [VOLUME ...]
              تنظیم بلندی صدای خروجی source مشخص‌شده (شناسایی‌شده با نمایه عددی
              آن). مقدار VOLUME را می‌توان به صورت یک عدد صحیح (مانند 2000،
              16384)، یک ضریب خطی (مانند 0.4، 1.100)، یک درصد (مانند 10%،
              100%) یا یک مقدار دسی‌بل (مانند 0dB، 20dB) تعیین کرد. اگر مقدار
              بلندی صدا با + یا - شروع شود، تنظیم میزان صدا به صورت نسبی با
              بلندی صدای فعلی خروجی source اعمال خواهد شد. یک مقدار واحد روی
              تمام کانال‌ها تأثیر می‌گذارد؛ در صورت ارائه چندین مقدار، تعداد
              آن‌ها باید با تعداد کانال‌های خروجی source مطابقت داشته باشد.

       get-sink-mute SINK
              دریافت وضعیت بی‌صدا بودن sink مشخص‌شده (شناسایی‌شده با نام نمادین
              یا نمایه عددی آن).

       set-sink-mute SINK 1|0|toggle
              تنظیم وضعیت بی‌صدا بودن sink مشخص‌شده (شناسایی‌شده با نام نمادین یا
              نمایه عددی آن).

       get-source-mute SOURCE
              دریافت وضعیت بی‌صدا بودن source مشخص‌شده (شناسایی‌شده با نام نمادین
              یا نمایه عددی آن).

       set-source-mute SOURCE 1|0|toggle
              تنظیم وضعیت بی‌صدا بودن source مشخص‌شده (شناسایی‌شده با نام نمادین
              یا نمایه عددی آن).

       set-sink-input-mute INPUT 1|0|toggle
              تنظیم وضعیت بی‌صدا بودن ورودی sink مشخص‌شده (شناسایی‌شده با نمایه
              عددی آن).

       set-source-output-mute OUTPUT 1|0|toggle
              تنظیم وضعیت بی‌صدا بودن خروجی source مشخص‌شده (شناسایی‌شده با نمایه
              عددی آن).

       set-sink-formats SINK FORMATS
              تنظیم قالب‌های پشتیبانی‌شده توسط sink مشخص‌شده (شناسایی‌شده با نمایه
              عددی آن) در صورت پشتیبانی توسط sink. مقدار FORMATS به صورت
              فهرستی از قالب‌ها که با نقطه-ویرگول (;) از هم جدا شده‌اند به فرم
              '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
              را ببینید.

       send-message RECIPIENT MESSAGE MESSAGE_PARAMETERS
              ارسال یک پیام به شیء گیرنده مشخص‌شده. در صورت کاربرد، می‌توان یک
              رشته اضافی حاوی پارامترهای پیام را مشخص کرد. یک رشته به عنوان
              پاسخ به پیام بازگردانده می‌شود. برای مشاهده پیام‌های دردسترس،
              https://cgit.freedesktop.org/pulseaudio/pulseaudio/tree/doc/messaging_api.txt
              را ببینید.

       subscribe
              اشتراک در رویدادها؛ pactl خودبه‌خود خارج نمی‌شود، بلکه منتظر
              دریافت رویدادهای جدید باقی می‌ماند.

نویسندگان (AUTHORS)
       توسعه‌دهندگان PulseAudio <pulseaudio-discuss (at) lists (dot)
       freedesktop (dot) org>؛ PulseAudio از طریق http://pulseaudio.org در
       دسترس است.

همچنین ببینید (SEE ALSO)
       pulseaudio(1)، pacmd(1)

Manuals                              User                             pactl(1)