| 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)
| User | Manuals |