نام (NAME)

sndioctl — دستکاری کنترل‌های دستگاه صوتی

خلاصه دستور (SYNOPSIS)

sndioctl [-dimnqv] [-f device] [command ...]

توضیحات (DESCRIPTION)

ابزار sndioctl می‌تواند کنترل‌های دستگاه‌های صوتی sndio(7) مانند سطح صدای خروجی را نمایش داده یا دستکاری کند. گزینه‌ها به شرح زیر هستند:

-d

فهرست خام کنترل‌های موجود را تخلیه (dump) کرده و خارج می‌شود. به عنوان ابزار اشکال‌زدایی مفید است.

-f device

استفاده از این دستگاه صوتی sndio(7).

-i

نمایش ویژگی‌های کنترل‌های درخواستی به‌جای مقادیر آن‌ها.

-m

نظارت و نمایش تغییرات کنترل‌های صوتی.

-n

جلوگیری از چاپ نام متغیر.

-q

جلوگیری از هرگونه چاپ خروجی هنگام مقداردهی یک متغیر.

-v

فعال‌سازی حالت پرگو (verbose)، یا همان حالت چندکاناله. به‌طور پیش‌فرض، کنترل‌هایی که بر کانال‌های مختلف یک استریم یکسان اثر می‌گذارند، در قالب یک کنترل مونو پنهان می‌شوند تا جزئیات غیرضروری نمایش داده نشوند.

اگر هیچ فرمانی مشخص نشود، تمام کنترل‌های معتبر روی stdout نمایش داده می‌شوند. مگر در صورتی که از -d, -m, -n یا -i استفاده شود، خطوط نمایش داده‌شده دستوراتی معتبر هستند. مجموعه کنترل‌های در دسترس به دستگاه صوتی بستگی دارد.

دستورات به ترتیب از دو قالب زیر برای نمایش و تغییر کنترل‌ها استفاده می‌کنند:

در سمت چپ، گروه کنترل (در صورت وجود)، نام استریم مربوطه و شماره کانال اختیاری مشخص می‌شوند. نمونه‌هایی از عبارت‌های سمت چپ:

اگر شماره کانال (شامل براکت‌ها) حذف شود، فرمان به تمامی کانال‌ها اعمال می‌شود.

مقادیر، اعدادی بین 0 و 1 هستند. کنترل‌های دووضعیتی (کلیدها) مقادیر 0 یا 1 می‌گیرند که معمولاً به ترتیب متناظر با وضعیت‌های off و on هستند.

اگر در ابتدای یک عدد اعشاری علامت مثبت (منفی) قرار گیرد، مقدار داده‌شده به مقدار فعلی کنترل اضافه (از آن کم) می‌شود. اگر به‌جای عدد از "!" استفاده شود، وضعیت کلید معکوس می‌شود (تغییر وضعیت می‌دهد).

مثال‌ها (EXAMPLES)

افزایش کنترل level برای تمام کانال‌های output به میزان ۱۰٪ مقدار بیشینه:

بی‌صدا کردن تمام کانال‌های output:

تغییر وضعیت کنترل mute فوق:

مجاز کردن ضبط صدا و تنظیم تمام کانال‌های input روی ۵۰٪:

# sysctl kern.audio.record=1
$ sndioctl input.mute=0 input.level=0.5

همچنین ببینید (SEE ALSO)

sioctl_open(3)