| bluetoothctl-assistant(1) | Linux System Administration | bluetoothctl-assistant(1) |
نام (NAME)
bluetoothctl-assistant - زیرمنوی مدیریت دستیار صوتی و خدمات صوتی بلوتوث
خلاصه دستور (SYNOPSIS)
bluetoothctl [--options] [assistant.commands]
این زیرمنو دستیارهای پخش BAP (BAP Broadcast Assistants) را با استفاده از واسط org.bluez.MediaAssistant(5) مدیریت میکند.
دستورات دستیار (Assistant Commands)
list
فهرست کردن دستیارهای موجود.
- کاربرد (Usage)
- > list
- مثال نمایش تمام دستیارهای پخش BAP موجود
-
> list
show
نمایش اطلاعات دستیار.
- کاربرد (Usage)
- > show [assistant]
- استفادهها (Uses)
- ویژگیهای org.bluez.MediaAssistant(5)
- [assistant]
- مسیر دستیار پخش BAP (اختیاری، در صورت حذف، مورد فعلی نمایش داده میشود)
- مثال نمایش اطلاعات دستیار انتخابشده فعلی
-
> show
- مثال نمایش اطلاعات یک دستیار پخش BAP مشخص
-
> show /org/bluez/hci0/src_05_1F_EE_F3_F8_7D/dev_00_60_37_31_7E_3F/bis1
push
ارسال اطلاعات جریان به دستگاه مقابل (peer).
این دستور توسط یک دستیار پخش BAP (BAP Broadcast Assistant) برای ارسال اطلاعات مربوط به یک جریان پخش به یک نماینده پویش BAP (BAP Scan Delegator) در دستگاه مقابل استفاده میشود.
این اطلاعات از طریق یک فرمان نوشتن GATT (GATT Write Command) برای مشخصه نقطه کنترل پویش صوتی پخش BASS (BASS Broadcast Audio Scan Control Point) ارسال میشود.
پس از اجرای دستور، از کاربر خواسته میشود تا متادیتای LTV جریان را برای ارسال به دستگاه مقابل وارد کند. اگر گزینه auto انتخاب شود، دستیار پخش متادیتای پیشفرضی را که درباره جریان کشف شده ارسال میکند. در غیر این صورت، متادیتای پیشفرض با مقادیر LTV واردشده توسط کاربر بازنویسی خواهد شد.
اگر جریان رمزگذاری شده باشد، از کاربر خواسته میشود که کد پخش (Broadcast Code) را نیز وارد کند. این کد همان کلید رمزگشایی جریان است. در سطح رابط کاربری، کد پخش باید به صورت یک رشته با حداقل ۴ بایت (octet) و حداکثر ۱۶ بایت در قالب نمایشی UTF-8 مشخص شود. این رشته از طریق GATT به عنوان یک آرایه ۱۶ بایتی به دستگاه مقابل ارسال خواهد شد.
اگر هنگام درخواست کد پخش مقدار auto انتخاب شود، یک آرایه پرشده از صفر به دستگاه مقابل ارسال میشود. در غیر این صورت، رشته واردشده توسط کاربر به عنوان آرایهای از بایتها ارسال خواهد شد.
- کاربرد (Usage)
- > push <assistant>
- استفادهها (Uses)
- متد Push در org.bluez.MediaAssistant(5)
- <assistant>
- مسیر دستیار پخش BAP برای ارسال اطلاعات جریان به آن
- مثال ارسال اطلاعات جریان با متادیتا و کد پخش خودکار
-
> push /org/bluez/hci0/src_05_1F_EE_F3_F8_7D/dev_00_60_37_31_7E_3F/bis1 [Assistant] Enter Metadata (auto/value): auto [Assistant] Enter Broadcast Code (auto/value): auto
- مثال ارسال اطلاعات جریان با متادیتا و کد پخش سفارشی
-
> push /org/bluez/hci0/src_05_1F_EE_F3_F8_7D/dev_00_60_37_31_7E_3F/bis1 [Assistant] Enter Metadata (auto/value): 0x03 0x02 0x04 0x00 [Assistant] Enter Broadcast Code (auto/value): Borne House
منابع (RESOURCES)
گزارش باگها (REPORTING BUGS)
<linux-bluetooth@vger.kernel.org>
کپیرایت (COPYRIGHT)
استفاده آزاد از این نرمافزار تحت شرایط مجوز عمومی همگانی کمتر گنو (LGPL) اعطا شده است.
| August 2024 | BlueZ |