| JACKTRIP(1) | دستورهای کاربری | JACKTRIP(1) |
نام (NAME)
JackTrip - سامانهای با کیفیت بالا برای اجرای صوتی تحت شبکه
خلاصه دستور (SYNOPSIS)
jacktrip [-s|-c|-S|-C hostIPAddressOrURL] [گزینهها]
توضیحات (DESCRIPTION)
JackTrip: سامانهای برای اجرای صوتی باکیفیت در بستر شبکه روی اینترنت حق نشر © 2008-2022 Juan-Pablo Caceres, Chris Chafe. گروه SoundWIRE در CCRMA، دانشگاه Stanford این ساخت از JackTrip مشمول مجوز LGPL است. کد منبع JackTrip تحت مجوزهای MIT و GPL منتشر شده است. برای اطلاعات بیشتر، فایل LICENSE.md را ببینید. نسخه: 3.0.1
گزینهها (OPTIONS)
آرگومانهای الزامی: یکی از موارد زیر:
- -s, --server
- اجرا در حالت سرور P2P
- -c, --client <peer_hostname_or_IP_num>
- اجرا در حالت کلاینت P2P
- -S, --jacktripserver
- اجرا در حالت سرور Hub
- -C, --pingtoserver <peer_name_or_IP>
- اجرا در حالت کلاینت Hub
آرگومانهای اختیاری:
- -n, --numchannels #
- تعداد کانالهای ورودی و خروجی (# بزرگتر از 0، پیشفرض: 2)
- --receivechannels #
- تعداد کانالهای دریافتی از شبکه (# بزرگتر از 0)
- --sendchannels #
- تعداد کانالهای ارسالی به شبکه (# بزرگتر از 0)
- -q, --queue # (2 یا بیشتر)
- طول بافر صف، بر حسب اندازه بسته (پیشفرض: 4)
- -r, --redundancy # (1 یا بیشتر)
- افزونگی بسته برای جلوگیری از افت کیفیت صوتی ناشی از گم شدن بستهها (پیشفرض: 1)
- -o, --portoffset #
- آفست پورت اتصال (bind) دریافتی و پورت همتا از مقدار پیشفرض 4464
- -B, --bindport #
- تنها تنظیم شماره پورت اتصال (bind) (پیشفرض: 4464)
- -P, --peerport #
- تنها تنظیم شماره پورت همتا (پیشفرض: 4464)
- -U, --udpbaseport
- تنها تنظیم شماره پورت پایه udp سرور (پیشفرض: 61002)
- -b, --bitres # (8, 16, 24, 32)
- تفکیکپذیری عمق بیتی صدا (پیشفرض: 16، مقدار 32 از ممیز شناور استفاده میکند)
- -z, --zerounderrun
- تنظیم بافر روی صفر هنگام وقوع underrun (پیشفرض: wavetable)
- -t, --timeout
- خروج پس از 10 ثانیه عدم فعالیت شبکه
- -l, --loopback
- اجرا در حالت Loop-Back
- -j, --jamlink
- اجرا در حالت JamLink (اتصال به JamLink Box)
- -J, --clientname
- تغییر نام پیشفرض کلاینت (پیشفرض: JackTrip)
- -K, --remotename
- تغییر نام پیشفرض کلاینت دوردست هنگام اتصال به یک سرور hub (پیشفرض از نشانی IP خارجی این رایانه مشتق میشود)
- --appendthreadid
- الصاق شناسه ریسه (thread ID) به نامهای کلاینت
- -L, --localaddress
- تغییر نشانی IP میزبان محلی پیشفرض (پیشفرض: 127.0.0.1)
- -D, --nojackportsconnect
- عدم اتصال خودکار پورتهای صوتی پیشفرض در jack
- --bufstrategy # (0, 1, 2, 3, 4)
- استفاده از بافر جیتر (jitter buffer) جایگزین
- --broadcast <broadcast_queue>
- تکثیر پورتهای دریافتی با طول مشخصشده برای broadcast_queue. خروجیهای پخشی (Broadcast) تأخیر بالاتر اما اتلاف بسته کمتری دارند.
- --udprt
- استفاده از اولویت ریسه بلادرنگ (RT) برای ورودی/خروجی شبکه
گزینههای اتصالات صوتی در حالت سرور HUB:
- -p, --hubpatch # (0, 1, 2, 3, 4, 5)
- اتصال صوتی خودکار Hub، تنها در صورت اجرای حالت سرور HUB اثر دارد، 0=سرور به کلاینتها، 1=لوپبک کلاینت، 2=پخش ورودی/خروجی کلاینت بدون لوپبک، 3=رزرو شده برای TUB، 4=میکس کامل، 5=بدون اتصال خودکار (پیشفرض: 0)
- -i, --includeserver
- گنجاندن صدای ورودی و خروجی سرور در میکس هنگام اتصال. تنها بر حالتهای اتصال -p 2 (پخش ورودی/خروجی کلاینت بدون لوپبک) و -p 4 (میکس کامل) اثر میگذارد.
- -u, --upmix
- تبدیل صوتی کلاینتهای مونو به استریو (upmix) هنگام اتصال
پردازش سیگنال اختیاری:
- -f, --effects # | paramString | help
- فعال کردن کمپرسور و/یا ریورب ورودی و/یا خروجی در کلاینت - برای جزئیات `-f help` را ببینید
- -O, --overflowlimiting i|o[w]|io[w]|n|help
- استفاده از محدودکننده(های) صوتی در کلاینت، i=ورودی از شبکه، o=خروجی به شبکه، io=هر دو، n=بدون محدودکننده، w=هشدار هنگام محدودسازی (پیشفرض=n). برای اطلاعات بیشتر دستور -O help را وارد کنید.
- -a, --assumednumclients help|# (1,2,..)
- تعداد کلاینتهای (منابع) فرضی که در سرور Hub میکس میشوند (در غیر این صورت مقدار 2 توسط -O فرض میشود)
- -T, --srate #
- تنظیم نرخ نمونهبرداری، تنها روی برخی از بکاندهای صوتی کار میکند (پیشفرض: 48000)
- -F, --bufsize #
- تنظیم اندازه بافر، تنها روی برخی از بکاندهای صوتی کار میکند (پیشفرض: 128)
آرگومانهای استفاده از JACKTRIP بدون JACK:
- -R, --rtaudio
- استفاده از سامانه صوتی پیشفرض سیستم به جای Jack
--audiodevice "input-output device name"
--audiodevice "input device name","output device name"
--audioinputdevice "input device name"
- --audiooutputdevice "output device name"
- تنظیم دستگاه صوتی مورد استفاده؛ در صورت عدم تنظیم، از دستگاه پیشفرض استفاده خواهد شد
- --listdevices
- فهرست کردن دستگاههای صوتی موجود
- -d, --deviceid #
- تنظیم شناسه دستگاه rtaudio (منسوخ شده، به جای آن از --audiodevice استفاده کنید)
آرگومانهای نمایش آمار ورودی/خروجی:
- -I, --iostat <time_in_secs>
- فعالسازی گزارش آمار ورودی/خروجی با فاصله زمانی مشخصشده (به ثانیه)
- -G, --iostatlog <log_file>
- ذخیره گزارش آمار در یک فایل (پیشفرض: چاپ در خروجی استاندارد stdout)
- -x, --examine-audio-delay <print_interval_in_secs> | help
- چاپ آمار تأخیر صوتی رفت و برگشت (round-trip). برای جزئیات `-x help` را ببینید.
آرگومانهای شبیهسازی مشکلات شبکه:
- --simloss <rate>
- شبیهسازی اتلاف بسته (packet loss)
- --simjitter <rate>,<d>
- شبیهسازی جیتر (jitter)، مقدار d بیشینه تأخیر بر حسب بسته است
آرگومانهای احراز هویت سرور/کلاینت HUB:
- -A, --auth
- استفاده از احراز هویت در سمت کلاینت، یا اجباری کردن آن در سمت سرور
- --certfile
- فایل گواهی برای استفاده در سرور hub
- --keyfile
- فایل کلید خصوصی برای استفاده در سرور hub
- --credsfile
- فایل حاوی نامهای کاربری و گذرواژههای ذخیرهشده
- --username
- نام کاربری برای استفاده هنگام اتصال به عنوان کلاینت hub (اگر اینجا مشخص نشود، از ورودی استاندارد خوانده میشود)
- --password
- گذرواژه برای استفاده هنگام اتصال به عنوان کلاینت hub (اگر اینجا مشخص نشود، از ورودی استاندارد خوانده میشود)
- --iceservers
- فهرست جداشده با کاما از سرورهای ICE برای عبور از NAT در WebRTC (مانند "stun:stun.l.google.com:19302")
آرگومانهای رابط کاربری گرافیکی (GUI):
- --gui
- اجبار JackTrip به اجرا با رابط کاربری گرافیکی (GUI). در صورت عدم استفاده از حالت VirtualStudio، سوئیچهای خط فرمان در بخشهای آرگومانهای الزامی، آرگومانهای اختیاری (به جز -l، -j، -L و --appendthreadid)، اتصالات صوتی و احراز هویت اعمال خواهند شد و در مواردی که آرگومانها مشخص نشده باشند از تنظیمات پیشفرض استفاده میشود. گزینههای بخشهای دیگر نادیده گرفته خواهند شد (و آخرین تنظیمات استفادهشده بارگیری میشوند)، به جز -V و سوئیچهای --version و --help که این موارد را لغو و بازنویسی میکنند.
- --classic-gui
- اجبار JackTrip به اجرا با رابط گرافیکی حالت کلاسیک (Classic Mode GUI).
- --deeplink
- مدیریت یک نشانی اینترنتی پیوند عمیق (deeplink URL) با قالب jacktrip://join/<studio_id> از طریق اتصال به عنوان کلاینت hub
- --logtofile
- نوشتن پیامهای گزارش در فایل log.txt در دایرکتوری دادههای برنامه نیز انجام شود. به طور پیشفرض غیرفعال است؛ پیامهای گزارش همواره در کنسول نوشته میشوند.
آرگومانهای راهنما:
- -v, --version
- چاپ شماره نسخه
- -V, --verbose
- حالت پرگو، چاپ پیامهای اشکالزدایی
- -h, --help
- چاپ این راهنما
کپیرایت و تکثیر (COPYRIGHT)
حق نشر © 2008-2022 Juan-Pablo Caceres, Chris Chafe. گروه SoundWIRE در CCRMA، دانشگاه Stanford این ساخت از JackTrip مشمول مجوز LGPL است. کد منبع JackTrip تحت مجوزهای MIT و GPL منتشر شده است. برای اطلاعات بیشتر، فایل LICENSE.md را ببینید.
| September 2026 | JackTrip VERSION: 3.0.1 |