.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "bluetoothctl-transport" "1" "November 2022" "BlueZ" "Linux System Administration" .SH "نام (NAME)" bluetoothctl-transport \- زیردستور مدیریت لایه انتقال مدیا در bluetoothctl .SH "خلاصه دستور (SYNOPSIS)" .sp \fBbluetoothctl\fP [\-\-options] [transport.commands] .sp این زیرمنو لایه‌های انتقال رسانه (media transports) را برای جاری‌سازی صوتی با استفاده از واسط \fBorg.bluez.MediaTransport(5)\fP مدیریت می‌کند. .SH "دستورات انتقال رسانه (Media Transport Commands)" .SS list .sp فهرست کردن لایه‌های انتقال موجود. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> list\fP .TP .B مثال نمایش تمام لایه‌های انتقال رسانه موجود (A2DP، LE Audio و غیره) .nf \fB> list\fP .fi .sp .UNINDENT .SS show .sp نمایش اطلاعات لایه انتقال. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> show [transport]\fP .TP .B استفاده‌ها (Uses) ویژگی‌های \fBorg.bluez.MediaTransport(5)\fP .TP .B [transport] مسیر شیء لایه انتقال مشخص (اختیاری؛ در صورت حذف، مورد فعلی نمایش داده می‌شود) .TP .B مثال نمایش اطلاعات لایه انتقال انتخاب‌شده فعلی .nf \fB> show\fP .fi .sp .TP .B مثال نمایش اطلاعات لایه انتقال .nf \fB> show /org/bluez/hci0/dev_00_11_22_33_44_55/fd0\fP .fi .sp .TP .B مثال نمایش لایه انتقال جریان همگام پخشی (Broadcast Isochronous Stream) .nf \fB> show /org/bluez/hci0/dev_11_22_33_44_55_66/bis1\fP .fi .sp .UNINDENT .SS acquire .sp در اختیار گرفتن لایه انتقال (Acquire). .INDENT 0.0 .TP .B کاربرد (Usage) \fB> acquire [transport1...]\fP .TP .B استفاده‌ها (Uses) متد \fBAcquire\fP در \fBorg.bluez.MediaTransport(5)\fP .TP .B مسیر شیء انتقال رسانه برای در اختیار گرفتن جهت جاری‌سازی صوتی .TP .B [transport1...] مسیرهای انتقال اضافی برای در اختیار گرفتن چند جریانی (اختیاری) .TP .B مثال در اختیار گرفتن لایه انتقال .nf \fB> acquire /org/bluez/hci0/dev_00_11_22_33_44_55/fd0\fP .fi .sp .TP .B مثال در اختیار گرفتن چندین لایه انتقال .nf \fB> acquire /org/bluez/hci0/dev_00_11_22_33_44_55/fd0 /org/bluez/hci0/dev_00_11_22_33_44_55/fd1\fP .fi .sp .UNINDENT .sp نکته: .sp در صورت اجرای این پیکربندی به همراه یک سرور صوتی دارای پشتیبانی از LE Audio (مانند PipeWire)، سرور صوتی به‌طور خودکار لایه‌های انتقال را متناسب با نقش‌های پیکربندی‌شده در اختیار می‌گیرد. .SS select .sp انتخاب لایه انتقال. فقط برای لایه‌های انتقال ایجادشده روی یک دستگاه گیرنده پخش (Broadcast Sink). این دستور لایه انتقال را در وضعیت \(dqbroadcasting\(dq قرار می‌دهد تا در انتظار در اختیار گرفته شدن (acquire) بماند. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> select [transport1...]\fP .TP .B استفاده‌ها (Uses) متد \fBSelect\fP در \fBorg.bluez.MediaTransport(5)\fP .TP .B مسیر انتقال گیرنده پخش برای انتقال به وضعیت broadcasting .TP .B [transport1...] مسیرهای انتقال اضافی برای انتخاب چند جریانی (اختیاری) .TP .B مثال انتخاب یک جریان همگام پخشی منفرد (Broadcast Isochronous Stream) .nf \fB> select /org/bluez/hci0/dev_00_11_22_33_44_55/bis1\fP .fi .sp .TP .B مثال انتخاب جریان‌های پخشی استریو .nf \fB> select /org/bluez/hci0/dev_00_11_22_33_44_55/bis1 /org/bluez/hci0/dev_00_11_22_33_44_55/bis2\fP .fi .sp .UNINDENT .sp نکته: .sp اگر دستور select فهرستی از لایه‌های انتقال را دریافت کند، آن‌ها ابتدا با استفاده از ویژگی \(dqLinks\(dq در MediaTransport پیوند داده می‌شوند. سپس با فراخوانی متد \(dqSelect\(dq در MediaTransport یک‌به‌یک انتخاب خواهند شد. پس از در اختیار گرفته شدن اولین لایه انتقال، گیرنده پخش (Broadcast Sink) توصیف‌کننده‌های فایل (fdها) را برای جریان مربوطه و تمام پیوندهای آن ایجاد می‌کند. سپس هر پیوند را می‌توان یک‌به‌یک در اختیار گرفت، fd را برای لایه انتقال تنظیم کرد و شروع به دریافت صدا نمود. .sp دستور select نیازی به ثبت قبلی نقطه انتهایی محلی (local endpoint) ندارد. دلیل این امر آن است که اگر پیکربندی با یک سرور صوتی دارای پشتیبانی از LE Audio (مانند PipeWire) اجرا شود، این سرور صوتی است که نقاط انتهایی را ثبت می‌کند و لایه‌های انتقال در نتیجه آن ایجاد می‌شوند. به محض انتخاب یک لایه انتقال، سرور صوتی به‌طور خودکار آن را در اختیار خواهد گرفت. .SS unselect .sp لغو انتخاب لایه انتقال. فقط برای لایه‌های انتقال ایجادشده روی یک دستگاه گیرنده پخش (Broadcast Sink). این دستور لایه انتقال را به وضعیت \(dqidle\(dq منتقل می‌کند تا در انتظار آزادسازی توسط سرور صوتی بماند. اگر لایه انتقال توسط bluetoothctl در اختیار گرفته شده باشد، می‌توان آن را مستقیماً و بدون نیاز به لغو انتخاب آزاد کرد. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> unselect [transport1...]\fP .TP .B مسیر انتقال گیرنده پخش برای انتقال به وضعیت idle .TP .B [transport1...] مسیرهای انتقال اضافی برای لغو انتخاب چند جریانی (اختیاری) .TP .B مثال لغو انتخاب لایه انتقال جریان پخشی .nf \fB> unselect /org/bluez/hci0/dev_00_11_22_33_44_55/bis1\fP .fi .sp .TP .B مثال لغو انتخاب چندین جریان پخشی .nf \fB> unselect /org/bluez/hci0/dev_00_11_22_33_44_55/bis1 /org/bluez/hci0/dev_00_11_22_33_44_55/bis2\fP .fi .sp .UNINDENT .sp نکته: .sp در صورت اجرای این پیکربندی با یک سرور صوتی دارای پشتیبانی از LE Audio (مانند PipeWire)، این کار باعث می‌شود سرور صوتی به‌طور خودکار لایه انتقال را آزاد کند. .SS release .sp آزادسازی لایه انتقال (Release). .INDENT 0.0 .TP .B کاربرد (Usage) \fB> release [transport1...]\fP .TP .B استفاده‌ها (Uses) متد \fBRelease\fP در \fBorg.bluez.MediaTransport(5)\fP .TP .B مسیر شیء انتقال رسانه برای آزادسازی از جاری‌سازی صوتی .TP .B [transport1...] مسیرهای انتقال اضافی برای آزادسازی چند جریانی (اختیاری) .TP .B مثال آزادسازی لایه انتقال .nf \fB> release /org/bluez/hci0/dev_00_11_22_33_44_55/fd0\fP .fi .sp .TP .B مثال آزادسازی چندین لایه انتقال .nf \fB> release /org/bluez/hci0/dev_00_11_22_33_44_55/fd0 /org/bluez/hci0/dev_00_11_22_33_44_55/fd1\fP .fi .sp .UNINDENT .sp نکته: .sp لایه‌های انتقالی که توسط یک سرور صوتی در اختیار گرفته شده‌اند، فقط توسط همان سرور صوتی قابل آزادسازی هستند. .SS send .sp ارسال محتوای یک فایل. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> send [transport1...]\fP .TP .B مسیر شیء انتقال رسانه برای ارسال داده‌های صوتی از طریق آن .TP .B مسیر فایل صوتی جهت ارسال (پشتیبانی از قالب‌های WAV، MP3 و PCM) .TP .B [transport1...] مسیرهای انتقال اضافی برای ارسال چند جریانی (اختیاری) .TP .B مثال ارسال فایل صوتی کدگذاری‌شده از طریق لایه انتقال .nf \fB> send /org/bluez/hci0/dev_00_11_22_33_44_55/fd0 /home/user/music.\fP .fi .sp .TP .B مثال ارسال همزمان به چندین لایه انتقال .nf \fB> send /org/bluez/hci0/dev_00_11_22_33_44_55/fd0 /home/user/stereo\-left. /org/bluez/hci0/dev_00_11_22_33_44_55/fd1 /home/user/stereo\-rigth.\fP .fi .sp .UNINDENT .SS receive .sp دریافت یا تعیین فایل برای ضبط/دریافت. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> receive [filename]\fP .TP .B مسیر شیء انتقال رسانه برای دریافت داده‌های صوتی از آن .TP .B [filename] مسیر ذخیره داده‌های صوتی دریافتی (اختیاری؛ در صورت حذف، مورد فعلی نمایش داده می‌شود) .TP .B مثال نمایش فایل دریافت فعلی برای لایه انتقال .nf \fB> receive /org/bluez/hci0/dev_00_11_22_33_44_55/fd0\fP .fi .sp .TP .B مثال تعیین فایل برای دریافت داده‌های صوتی .nf \fB> receive /org/bluez/hci0/dev_00_11_22_33_44_55/fd0 /tmp/recorded_audio.wav\fP .fi .sp .TP .B مثال تعیین فایل برای ضبط صدای پخشی (به علامت نقل‌قول توجه کنید) .nf \fB> receive /org/bluez/hci0/dev_11_22_33_44_55_66/bis1 \(dq/home/user/My Recordings/broadcast.wav\(dq\fP .fi .sp .UNINDENT .SS volume .sp دریافت یا تنظیم میزان بلندی صدای لایه انتقال. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> volume [value]\fP .TP .B استفاده‌ها (Uses) ویژگی \fBVolume\fP در \fBorg.bluez.MediaTransport(5)\fP .TP .B مسیر شیء انتقال رسانه جهت کنترل صدا .TP .B [value] سطح بلندی صدا (0\-127، اختیاری؛ در صورت حذف، مقدار فعلی نمایش داده می‌شود) .TP .B مثال نمایش سطح بلندی صدای فعلی .nf \fB> volume /org/bluez/hci0/dev_00_11_22_33_44_55/fd0\fP .fi .sp .TP .B مثال تنظیم بلندی صدا روی 100 .nf \fB> volume /org/bluez/hci0/dev_00_11_22_33_44_55/fd0 100\fP .fi .sp .UNINDENT .SS metadata .sp دریافت یا تنظیم متادیتای لایه انتقال. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> metadata [value...]\fP .TP .B مسیر شیء انتقال رسانه .TP .B [value...] مقدار متادیتا به عنوان یک رشته هگزادسیمال (اختیاری؛ در صورت حذف، مقدار فعلی نمایش داده می‌شود) .TP .B مثال نمایش متادیتای فعلی لایه انتقال .nf \fB> metadata /org/bluez/hci0/dev_00_11_22_33_44_55/fd0\fP .fi .sp .TP .B مثال تنظیم مقدار متادیتا .nf \fB> metadata /org/bluez/hci0/dev_00_11_22_33_44_55/fd0 0x03020100\fP .fi .sp .UNINDENT .SH "منابع (RESOURCES)" .sp \% .SH "گزارش اشکالات (REPORTING BUGS)" .sp \% .SH "حق نشر (COPYRIGHT)" استفاده آزاد از این نرم‌افزار تحت شرایط مجوز عمومی کمتر گنو (LGPL) اعطا شده است. .\" End of generated man page.