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

bluetoothctl-player - زیرمنوی کنترل پخش‌کننده رسانه و صوت بلوتوث (Media Player)

bluetoothctl [--options] [player.commands]

این زیرمنو پخش رسانه را با استفاده از رابط org.bluez.MediaPlayer(5) کنترل می‌کند.

فهرست کردن پخش‌کننده‌های موجود.

کاربرد (Usage)
> list
مثال نمایش تمام پخش‌کننده‌های رسانه موجود (محلی و راه دور)
> list

نمایش اطلاعات پخش‌کننده.

کاربرد (Usage)
> show [player]
استفاده‌ها (Uses)
ویژگی‌های org.bluez.MediaPlayer(5)
[player]
مسیر یا شناسه پخش‌کننده رسانه (اختیاری؛ در صورت حذف، پخش‌کننده انتخاب‌شده فعلی را نمایش می‌دهد)
مثال نمایش اطلاعات پخش‌کننده انتخاب‌شده فعلی
> show
مثال نمایش اطلاعات پخش‌کننده راه دور
> show /org/bluez/hci0/dev_00_11_22_33_44_55/player0

انتخاب پخش‌کننده پیش‌فرض.

کاربرد (Usage)
> select <player>
<player>
مسیر یا شناسه پخش‌کننده رسانه برای انتخاب به عنوان پیش‌فرض
مثال انتخاب پخش‌کننده رسانه بلوتوث راه دور
> select /org/bluez/hci0/dev_00_11_22_33_44_55/player0

شروع پخش.

کاربرد (Usage)
> play [item]
استفاده‌ها (Uses)
متد Play در org.bluez.MediaPlayer(5)
[item]
مسیر آیتم رسانه‌ای برای پخش (اختیاری؛ در صورت حذف، پخش آیتم فعلی را آغاز می‌کند)
مثال شروع پخش در پخش‌کننده فعلی
> play
مثال پخش یک آیتم خاص از مرورگر رسانه
> play /org/bluez/item/1
مثال پخش آیتم قطعه نام‌گذاری‌شده
> play /org/bluez/item/track_001
مثال پخش قطعه از پوشه آلبوم خاص
> play /org/bluez/item/album_rock/track_05

مکث پخش.

کاربرد (Usage)
> pause
استفاده‌ها (Uses)
متد Pause در org.bluez.MediaPlayer(5)
مثال مکث پخش فعلی
> pause

توقف پخش.

کاربرد (Usage)
> stop
استفاده‌ها (Uses)
متد Stop در org.bluez.MediaPlayer(5)
مثال توقف پخش فعلی
> stop

رفتن به آیتم بعدی.

کاربرد (Usage)
> next
استفاده‌ها (Uses)
متد Next در org.bluez.MediaPlayer(5)
مثال رفتن به قطعه بعدی
> next

رفتن به آیتم قبلی.

کاربرد (Usage)
> previous
استفاده‌ها (Uses)
متد Previous در org.bluez.MediaPlayer(5)
مثال بازگشت به قطعه قبلی
> previous

جلو بردن سریع پخش (Fast Forward).

کاربرد (Usage)
> fast-forward
استفاده‌ها (Uses)
متد FastForward در org.bluez.MediaPlayer(5)
مثال فعال کردن حالت جلو بردن سریع
> fast-forward

عقب بردن پخش (Rewind).

کاربرد (Usage)
> rewind
استفاده‌ها (Uses)
متد Rewind در org.bluez.MediaPlayer(5)
مثال فعال کردن حالت عقب بردن
> rewind

فعال/غیرفعال کردن اکولایزر.

کاربرد (Usage)
> equalizer <on/off>
استفاده‌ها (Uses)
ویژگی Equalizer در org.bluez.MediaPlayer(5)
<on/off>
فعال‌سازی (on) یا غیرفعال‌سازی (off) اکولایزر
مثال فعال کردن اکولایزر
> equalizer on
مثال غیرفعال کردن اکولایزر
> equalizer off

تنظیم حالت تکرار.

کاربرد (Usage)
> repeat <singletrack/alltrack/group/off>
استفاده‌ها (Uses)
ویژگی Repeat در org.bluez.MediaPlayer(5)
<singletrack/alltrack/group/off>
تنظیم حالت تکرار - singletrack (قطعه فعلی)، alltrack (تمام قطعات)، group (گروه/آلبوم فعلی)، یا off (بدون تکرار)
مثال غیرفعال کردن حالت تکرار
> repeat off
مثال تکرار قطعه فعلی
> repeat singletrack
مثال تکرار کل فهرست پخش/صف
> repeat alltrack
مثال تکرار گروه/آلبوم فعلی
> repeat group

تنظیم حالت پخش تصادفی (Shuffle).

کاربرد (Usage)
> shuffle <alltracks/group/off>
استفاده‌ها (Uses)
ویژگی Shuffle در org.bluez.MediaPlayer(5)
<alltracks/group/off>
تنظیم حالت تصادفی - alltracks (پخش تصادفی تمام قطعات)، group (پخش تصادفی در گروه فعلی)، یا off (بدون پخش تصادفی)
مثال غیرفعال کردن حالت پخش تصادفی
> shuffle off
مثال پخش تصادفی تمام قطعات در فهرست پخش
> shuffle alltracks
مثال پخش تصادفی قطعات در گروه فعلی
> shuffle group

تنظیم حالت پویش (Scan).

کاربرد (Usage)
> scan <alltracks/group/off>
استفاده‌ها (Uses)
ویژگی Scan در org.bluez.MediaPlayer(5)
<alltracks/group/off>
تنظیم حالت پویش - alltracks (پویش در میان تمام قطعات)، group (پویش در گروه فعلی)، یا off (بدون پویش)
مثال غیرفعال کردن حالت پویش
> scan off
مثال پویش در میان تمام قطعات
> scan alltracks
مثال پویش فقط در میان گروه فعلی
> scan group

تغییر پوشه فعلی.

کاربرد (Usage)
> change-folder <item>
<item>
مسیر پوشه برای رفتن به آن، یا ".." برای رفتن یک سطح بالاتر در ساختار دایرکتوری
مثال رفتن به پوشه آلبوم‌ها (Albums)
> change-folder /org/bluez/item/Albums
مثال رفتن به پوشه هنرمندان (Artists)
> change-folder /org/bluez/item/Artists
مثال رفتن به پوشه فهرست‌های پخش (Playlists)
> change-folder /org/bluez/item/Playlists
مثال رفتن یک سطح به دایرکتوری بالاتر
> change-folder ..

فهرست کردن آیتم‌های پوشه فعلی.

کاربرد (Usage)
> list-items [start] [end]
[start]
شاخص شروع برای فهرست آیتم‌ها (اختیاری؛ پیش‌فرض: 0)
[end]
شاخص پایان برای فهرست آیتم‌ها (اختیاری؛ در صورت حذف، تمام آیتم‌ها را از ابتدا فهرست می‌کند)
مثال فهرست کردن تمام آیتم‌ها در پوشه فعلی
> list-items
مثال فهرست کردن ۱۰ آیتم نخست (0-10)
> list-items 0 10
مثال فهرست کردن آیتم‌های ۵ تا ۱۵
> list-items 5 15
مثال فهرست کردن آیتم‌های ۱۰ تا ۲۰
> list-items 10 20
مثال فهرست کردن ۵۰ آیتم نخست
> list-items 0 50

جستجوی آیتم‌های شامل یک رشته متنی.

کاربرد (Usage)
> search <string>
<string>
عبارت جستجو برای یافتن آیتم‌های منطبق (آهنگ‌ها، آلبوم‌ها، هنرمندان و غیره)
مثال جستجو برای آهنگ‌ها/آلبوم‌های بیتلز (The Beatles)
> search "The Beatles"
مثال جستجو برای آیتم‌های شامل "rock"
> search "rock"
مثال جستجو برای آیتم‌های سال 2023
> search "2023"
مثال جستجو برای فهرست‌های پخش
> search "playlist"

افزودن آیتم به صف فهرست پخش.

کاربرد (Usage)
> queue <item>
<item>
مسیر آیتم رسانه‌ای برای افزودن به صف پخش
مثال افزودن یک قطعه خاص به صف
> queue /org/bluez/item/track_001
مثال افزودن یک آلبوم کامل به صف
> queue /org/bluez/item/album_rock
مثال افزودن یک فهرست پخش به صف
> queue /org/bluez/item/playlist_favorites

نمایش اطلاعات آیتم.

کاربرد (Usage)
> show-item <item>
<item>
مسیر آیتم رسانه‌ای برای نمایش اطلاعات با جزئیات
مثال نمایش جزئیات یک قطعه خاص
> show-item /org/bluez/item/track_001
مثال نمایش جزئیات یک آلبوم
> show-item /org/bluez/item/album_rock
مثال نمایش جزئیات یک هنرمند
> show-item /org/bluez/item/artist_beatles

http://www.bluez.org

<linux-bluetooth@vger.kernel.org>

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

November 2022 BlueZ