| pw-cli(1) | General Commands Manual | pw-cli(1) |
نام (NAME)
pw-cli - رابط خط فرمان PipeWire
خلاصه دستور (SYNOPSIS)
pw-cli [command]
توضیحات (DESCRIPTION)
تعامل با یک نمونهٔ PipeWire.
هنگامی که یک دستور داده شود، pw-cli دستور را اجرا کرده و خارج می‌شود.
اگر دستوری مشخص نشود، pw-cli یک نشست تعاملی با نمونهٔ پیش‌فرض PipeWire یعنی pipewire-0 آغاز می‌کند.
امکان برقراری اتصال با سایر نمونه‌های دوردست (remote) نیز وجود دارد. نام نمونهٔ فعلی در اعلان خط فرمان نمایش داده می‌شود.
توجه داشته باشید که pw-cli همچنین یک نمونهٔ محلی از PipeWire ایجاد می‌کند. برخی دستورها بر روی نمونهٔ فعلی (دوردست) و برخی دیگر روی نمونهٔ محلی عمل می‌کنند، مانند بارگذاری ماژول‌ها.
از دستور 'help' برای مشاهدهٔ فهرست دستورهای موجود استفاده کنید.
دستورهای عمومی (GENERAL COMMANDS)
help | h
quit | q
list-vars
مدیریت ماژول‌ها (MODULE MANAGEMENT)
ماژول‌ها در نمونهٔ محلی (یعنی خود باینری pw-cli) بارگذاری و تخلیه می‌شوند و می‌توانند قابلیت‌ها یا اشیایی را به نمونهٔ محلی بیفزایند. در PipeWire امکان بارگذاری ماژول‌ها در نمونه‌ای دیگر وجود ندارد.
load-module name [arguments...]
این دستور متغیر ماژولی برمی‌گرداند که می‌تواند برای تخلیهٔ ماژول استفاده شود.
ماژول محلی در نمونهٔ دوردست قابل مشاهده نیست. در PipeWire امکان بارگذاری ماژول در یک نمونهٔ دوردست وجود ندارد.
unload-module module-var
درون‌نگری اشیاء (OBJECT INTROSPECTION)
list-objects
اشیاء به همراه id، type و version خود فهرست می‌شوند.
info id | all
درخواست اطلاعات دربارهٔ یک شیء همچنین شما را از تغییرات آن مطلع خواهد کرد.
کار با نمونه‌های دوردست (WORKING WITH REMOTES)
connect [remote-name]
اگر نام دوردستی مشخص نشود، اتصال به نمونهٔ دوردست پیش‌فرض (معمولاً pipewire-0) برقرار می‌شود.
نام دوردستِ ویژهٔ internal می‌تواند برای اتصال به نمونهٔ محلی PipeWire در pw-cli به کار رود.
این دستور یک متغیر دوردست (remote var) برمی‌گرداند که می‌تواند برای قطع اتصال یا تغییر نمونهٔ دوردست استفاده شود.
disconnect [remote-var]
اگر نام دوردستی مشخص نشود، اتصال نمونهٔ فعلی قطع می‌شود.
list-remotes
switch-remote [remote-var]
اگر نام دوردستی مشخص نشود، نخستین نمونه به عنوان نمونهٔ فعلی در نظر گرفته می‌شود.
مدیریت گره‌ها (NODE MANAGEMENT)
create-node factory-name [properties...]
ویژگی‌ها (properties) جفت‌های key=value هستند که با نویسهٔ فاصله جدا می‌شوند.
این دستور یک متغیر گره برمی‌گرداند.
export-node node-id [remote-var]
مدیریت دستگاه‌ها (DEVICE MANAGEMENT)
create-device factory-name [properties...]
ویژگی‌ها جفت‌های key=value هستند که با نویسهٔ فاصله جدا می‌شوند.
این دستور یک متغیر دستگاه برمی‌گرداند.
مدیریت پیوندها (LINK MANAGEMENT)
create-link node-id port-id node-id port-id [properties...]
شناسه‌های درگاه (port-id) و شناسه‌های گره (node-id) را می‌توان روی - تنظیم کرد تا یک گره یا درگاه به طور خودکار انتخاب شود.
شناسه‌های درگاه می‌توانند * باشند تا درگاه‌های منطبق در گره‌ها به طور خودکار به هم پیوند داده شوند.
ویژگی‌ها جفت‌های key=value هستند که با نویسهٔ فاصله جدا می‌شوند.
این دستور یک یا چند متغیر پیوند برمی‌گرداند.
مدیریت سراسری‌ها (GLOBALS MANAGEMENT)
destroy object-id
مدیریت پارامترها (PARAMETER MANAGEMENT)
enum-params object-id param-id
param-id را می‌توان به عنوان نام کوتاه پارامتر نیز مشخص کرد.
set-param object-id param-id param-json
param-id را می‌توان به عنوان نام کوتاه پارامتر نیز مشخص کرد.
مدیریت مجوزها (PERMISSION MANAGEMENT)
permissions client-id object-id permission
object-id می‌تواند برای تنظیم مجوزهای پیش‌فرض برابر -1 باشد.
get-permissions client-id
مدیریت دستورها (COMMAND MANAGEMENT)
send-command object-id
نویسندگان (AUTHORS)
توسعه‌دهندگان PipeWire https://gitlab.freedesktop.org/pipewire/pipewire/issues؛ PipeWire در https://pipewire.org در دسترس است
همچنین ببینید (SEE ALSO)
| 1.6.8 | PipeWire |