bluetoothctl-transport(1) Linux System Administration bluetoothctl-transport(1)

bluetoothctl-transport - زیردستور مدیریت لایه انتقال مدیا در bluetoothctl

bluetoothctl [--options] [transport.commands]

این زیرمنو لایه‌های انتقال رسانه (media transports) را برای جاری‌سازی صوتی با استفاده از واسط org.bluez.MediaTransport(5) مدیریت می‌کند.

فهرست کردن لایه‌های انتقال موجود.

کاربرد (Usage)
> list
مثال نمایش تمام لایه‌های انتقال رسانه موجود (A2DP، LE Audio و غیره)
> list

نمایش اطلاعات لایه انتقال.

کاربرد (Usage)
> show [transport]
استفاده‌ها (Uses)
ویژگی‌های org.bluez.MediaTransport(5)
[transport]
مسیر شیء لایه انتقال مشخص (اختیاری؛ در صورت حذف، مورد فعلی نمایش داده می‌شود)
مثال نمایش اطلاعات لایه انتقال انتخاب‌شده فعلی
> show
مثال نمایش اطلاعات لایه انتقال
> show /org/bluez/hci0/dev_00_11_22_33_44_55/fd0
مثال نمایش لایه انتقال جریان همگام پخشی (Broadcast Isochronous Stream)
> show /org/bluez/hci0/dev_11_22_33_44_55_66/bis1

در اختیار گرفتن لایه انتقال (Acquire).

کاربرد (Usage)
> acquire <transport> [transport1...]
استفاده‌ها (Uses)
متد Acquire در org.bluez.MediaTransport(5)
<transport>
مسیر شیء انتقال رسانه برای در اختیار گرفتن جهت جاری‌سازی صوتی
[transport1...]
مسیرهای انتقال اضافی برای در اختیار گرفتن چند جریانی (اختیاری)
مثال در اختیار گرفتن لایه انتقال
> acquire /org/bluez/hci0/dev_00_11_22_33_44_55/fd0
مثال در اختیار گرفتن چندین لایه انتقال
> acquire /org/bluez/hci0/dev_00_11_22_33_44_55/fd0 /org/bluez/hci0/dev_00_11_22_33_44_55/fd1

نکته:

در صورت اجرای این پیکربندی به همراه یک سرور صوتی دارای پشتیبانی از LE Audio (مانند PipeWire)، سرور صوتی به‌طور خودکار لایه‌های انتقال را متناسب با نقش‌های پیکربندی‌شده در اختیار می‌گیرد.

انتخاب لایه انتقال. فقط برای لایه‌های انتقال ایجادشده روی یک دستگاه گیرنده پخش (Broadcast Sink). این دستور لایه انتقال را در وضعیت "broadcasting" قرار می‌دهد تا در انتظار در اختیار گرفته شدن (acquire) بماند.

کاربرد (Usage)
> select <transport> [transport1...]
استفاده‌ها (Uses)
متد Select در org.bluez.MediaTransport(5)
<transport>
مسیر انتقال گیرنده پخش برای انتقال به وضعیت broadcasting
[transport1...]
مسیرهای انتقال اضافی برای انتخاب چند جریانی (اختیاری)
مثال انتخاب یک جریان همگام پخشی منفرد (Broadcast Isochronous Stream)
> select /org/bluez/hci0/dev_00_11_22_33_44_55/bis1
مثال انتخاب جریان‌های پخشی استریو
> select /org/bluez/hci0/dev_00_11_22_33_44_55/bis1 /org/bluez/hci0/dev_00_11_22_33_44_55/bis2

نکته:

اگر دستور select فهرستی از لایه‌های انتقال را دریافت کند، آن‌ها ابتدا با استفاده از ویژگی "Links" در MediaTransport پیوند داده می‌شوند. سپس با فراخوانی متد "Select" در MediaTransport یک‌به‌یک انتخاب خواهند شد. پس از در اختیار گرفته شدن اولین لایه انتقال، گیرنده پخش (Broadcast Sink) توصیف‌کننده‌های فایل (fdها) را برای جریان مربوطه و تمام پیوندهای آن ایجاد می‌کند. سپس هر پیوند را می‌توان یک‌به‌یک در اختیار گرفت، fd را برای لایه انتقال تنظیم کرد و شروع به دریافت صدا نمود.

دستور select نیازی به ثبت قبلی نقطه انتهایی محلی (local endpoint) ندارد. دلیل این امر آن است که اگر پیکربندی با یک سرور صوتی دارای پشتیبانی از LE Audio (مانند PipeWire) اجرا شود، این سرور صوتی است که نقاط انتهایی را ثبت می‌کند و لایه‌های انتقال در نتیجه آن ایجاد می‌شوند. به محض انتخاب یک لایه انتقال، سرور صوتی به‌طور خودکار آن را در اختیار خواهد گرفت.

لغو انتخاب لایه انتقال. فقط برای لایه‌های انتقال ایجادشده روی یک دستگاه گیرنده پخش (Broadcast Sink). این دستور لایه انتقال را به وضعیت "idle" منتقل می‌کند تا در انتظار آزادسازی توسط سرور صوتی بماند. اگر لایه انتقال توسط bluetoothctl در اختیار گرفته شده باشد، می‌توان آن را مستقیماً و بدون نیاز به لغو انتخاب آزاد کرد.

کاربرد (Usage)
> unselect <transport> [transport1...]
<transport>
مسیر انتقال گیرنده پخش برای انتقال به وضعیت idle
[transport1...]
مسیرهای انتقال اضافی برای لغو انتخاب چند جریانی (اختیاری)
مثال لغو انتخاب لایه انتقال جریان پخشی
> unselect /org/bluez/hci0/dev_00_11_22_33_44_55/bis1
مثال لغو انتخاب چندین جریان پخشی
> unselect /org/bluez/hci0/dev_00_11_22_33_44_55/bis1 /org/bluez/hci0/dev_00_11_22_33_44_55/bis2

نکته:

در صورت اجرای این پیکربندی با یک سرور صوتی دارای پشتیبانی از LE Audio (مانند PipeWire)، این کار باعث می‌شود سرور صوتی به‌طور خودکار لایه انتقال را آزاد کند.

آزادسازی لایه انتقال (Release).

کاربرد (Usage)
> release <transport> [transport1...]
استفاده‌ها (Uses)
متد Release در org.bluez.MediaTransport(5)
<transport>
مسیر شیء انتقال رسانه برای آزادسازی از جاری‌سازی صوتی
[transport1...]
مسیرهای انتقال اضافی برای آزادسازی چند جریانی (اختیاری)
مثال آزادسازی لایه انتقال
> release /org/bluez/hci0/dev_00_11_22_33_44_55/fd0
مثال آزادسازی چندین لایه انتقال
> release /org/bluez/hci0/dev_00_11_22_33_44_55/fd0 /org/bluez/hci0/dev_00_11_22_33_44_55/fd1

نکته:

لایه‌های انتقالی که توسط یک سرور صوتی در اختیار گرفته شده‌اند، فقط توسط همان سرور صوتی قابل آزادسازی هستند.

ارسال محتوای یک فایل.

کاربرد (Usage)
> send <transport> <filename> [transport1...]
<transport>
مسیر شیء انتقال رسانه برای ارسال داده‌های صوتی از طریق آن
<filename>
مسیر فایل صوتی جهت ارسال (پشتیبانی از قالب‌های WAV، MP3 و PCM)
[transport1...]
مسیرهای انتقال اضافی برای ارسال چند جریانی (اختیاری)
مثال ارسال فایل صوتی کدگذاری‌شده از طریق لایه انتقال
> send /org/bluez/hci0/dev_00_11_22_33_44_55/fd0 /home/user/music.<format>
مثال ارسال همزمان به چندین لایه انتقال
> send /org/bluez/hci0/dev_00_11_22_33_44_55/fd0 /home/user/stereo-left.<format> /org/bluez/hci0/dev_00_11_22_33_44_55/fd1 /home/user/stereo-rigth.<format>

دریافت یا تعیین فایل برای ضبط/دریافت.

کاربرد (Usage)
> receive <transport> [filename]
<transport>
مسیر شیء انتقال رسانه برای دریافت داده‌های صوتی از آن
[filename]
مسیر ذخیره داده‌های صوتی دریافتی (اختیاری؛ در صورت حذف، مورد فعلی نمایش داده می‌شود)
مثال نمایش فایل دریافت فعلی برای لایه انتقال
> receive /org/bluez/hci0/dev_00_11_22_33_44_55/fd0
مثال تعیین فایل برای دریافت داده‌های صوتی
> receive /org/bluez/hci0/dev_00_11_22_33_44_55/fd0 /tmp/recorded_audio.wav
مثال تعیین فایل برای ضبط صدای پخشی (به علامت نقل‌قول توجه کنید)
> receive /org/bluez/hci0/dev_11_22_33_44_55_66/bis1 "/home/user/My Recordings/broadcast.wav"

دریافت یا تنظیم میزان بلندی صدای لایه انتقال.

کاربرد (Usage)
> volume <transport> [value]
استفاده‌ها (Uses)
ویژگی Volume در org.bluez.MediaTransport(5)
<transport>
مسیر شیء انتقال رسانه جهت کنترل صدا
[value]
سطح بلندی صدا (0-127، اختیاری؛ در صورت حذف، مقدار فعلی نمایش داده می‌شود)
مثال نمایش سطح بلندی صدای فعلی
> volume /org/bluez/hci0/dev_00_11_22_33_44_55/fd0
مثال تنظیم بلندی صدا روی 100
> volume /org/bluez/hci0/dev_00_11_22_33_44_55/fd0 100

دریافت یا تنظیم متادیتای لایه انتقال.

کاربرد (Usage)
> metadata <transport> [value...]
<transport>
مسیر شیء انتقال رسانه
[value...]
مقدار متادیتا به عنوان یک رشته هگزادسیمال (اختیاری؛ در صورت حذف، مقدار فعلی نمایش داده می‌شود)
مثال نمایش متادیتای فعلی لایه انتقال
> metadata /org/bluez/hci0/dev_00_11_22_33_44_55/fd0
مثال تنظیم مقدار متادیتا
> metadata /org/bluez/hci0/dev_00_11_22_33_44_55/fd0 0x03020100

http://www.bluez.org

<linux-bluetooth@vger.kernel.org>

استفاده آزاد از این نرم‌افزار تحت شرایط مجوز عمومی کمتر گنو (LGPL) اعطا شده است.

November 2022 BlueZ