.\" 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 "org.bluez.MediaPlayer" "5" "سپتامبر 2023" "BlueZ" "مدیریت سیستم لینوکس"
.SH "نام (NAME)"
org.bluez.MediaPlayer \- رابط کاربری D-Bus برای پخش‌کننده چندرسانه‌ای در BlueZ
.SH "واسط (INTERFACE)"
.INDENT 0.0
.TP
.B سرویس (Service)
org.bluez (نقش کنترل‌کننده / Controller role)
.TP
.B واسط (Interface)
org.bluez.MediaPlayer1
.TP
.B مسیر شیء (Object path)
[variable prefix]/{hci0,hci1,...}/dev_{BDADDR}/player#
.TP
.B مورد استفاده توسط (Used by)
\fBbluetoothctl\-player(1)\fP
.UNINDENT
.SS "متدها (Methods)"
.SS void Play()
.sp
از سرگیری پخش.
.sp
خطاهای احتمالی:
.INDENT 0.0
.TP
.B org.bluez.Error.NotSupported
.TP
.B org.bluez.Error.Failed
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> player.play [item]
.UNINDENT
.SS void Pause()
.sp
توقف موقت پخش.
.sp
خطاهای احتمالی:
.INDENT 0.0
.TP
.B org.bluez.Error.NotSupported
.TP
.B org.bluez.Error.Failed
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> player.pause
.UNINDENT
.SS void Stop()
.sp
توقف پخش.
.sp
خطاهای احتمالی:
.INDENT 0.0
.TP
.B org.bluez.Error.NotSupported
.TP
.B org.bluez.Error.Failed
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> player.stop
.UNINDENT
.SS void Next()
.sp
مورد بعدی.
.sp
خطاهای احتمالی:
.INDENT 0.0
.TP
.B org.bluez.Error.NotSupported
.TP
.B org.bluez.Error.Failed
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> player.next
.UNINDENT
.SS void Previous()
.sp
مورد قبلی.
.sp
خطاهای احتمالی:
.INDENT 0.0
.TP
.B org.bluez.Error.NotSupported
.TP
.B org.bluez.Error.Failed
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> player.previous
.UNINDENT
.SS void FastForward()
.sp
جلو بردن سریع پخش؛ این عمل تنها زمانی متوقف می‌شود که متد دیگری در این واسط فراخوانی شود.
.sp
خطاهای احتمالی:
.INDENT 0.0
.TP
.B org.bluez.Error.NotSupported
.TP
.B org.bluez.Error.Failed
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> player.fast\-forward
.UNINDENT
.SS void Rewind()
.sp
عقب بردن سریع پخش؛ این عمل تنها زمانی متوقف می‌شود که متد دیگری در این واسط فراخوانی شود.
.sp
خطاهای احتمالی:
.INDENT 0.0
.TP
.B org.bluez.Error.NotSupported
.TP
.B org.bluez.Error.Failed
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> player.rewind
.UNINDENT
.SS void Press(byte avc_key)
.sp
فشردن یک کلید مشخص جهت ارسال به عنوان دستور عبوری (passthrough).
.sp
کلید به صورت خودکار رها خواهد شد. در صورتی که قصد پایین نگه داشتن کلید را دارید، به جای آن از \fBHold()\fP استفاده کنید.
.sp
خطاهای احتمالی:
.INDENT 0.0
.TP
.B org.bluez.Error.InvalidArguments
.TP
.B org.bluez.Error.NotSupported
.TP
.B org.bluez.Error.Failed
.UNINDENT
.SS void Hold(byte avc_key)
.sp
فشردن و نگه داشتن یک کلید مشخص جهت ارسال به عنوان دستور عبوری (passthrough). مسئولیت اطمینان از فراخوانی \fBRelease()\fP پس از فراخوانی این متد بر عهده فراخواننده است.
.sp
کلید نگه‌داشته‌شده همچنین با فراخوانی هر متد دیگری در این واسط رها خواهد شد.
.sp
خطاهای احتمالی:
.INDENT 0.0
.TP
.B org.bluez.Error.InvalidArguments
.TP
.B org.bluez.Error.NotSupported
.TP
.B org.bluez.Error.Failed
.UNINDENT
.SS void Release()
.sp
رها کردن کلید نگه‌داشته‌شده قبلی که با استفاده از \fBHold()\fP فراخوانی شده است.
.sp
خطاهای احتمالی:
.INDENT 0.0
.TP
.B org.bluez.Error.NotSupported
.TP
.B org.bluez.Error.Failed
.UNINDENT
.SS "ویژگی‌ها (Properties)"
.SS string Equalizer [readwrite]
.sp
تنظیمات اکولایزر پخش‌کننده را مشخص می‌کند.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B \(dqoff\(dq
.TP
.B \(dqon\(dq
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
[player] > equalizer <on/off>
.UNINDENT
.SS string Repeat [readwrite]
.sp
تنظیمات تکرار پخش‌کننده را مشخص می‌کند.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B \(dqoff\(dq
.TP
.B \(dqsingletrack\(dq
.TP
.B \(dqalltracks\(dq
.TP
.B \(dqgroup\(dq
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
[player] > repeat <singletrack/alltracks/group/off>
.UNINDENT
.SS string Shuffle [readwrite]
.sp
تنظیمات پخش تصادفی پخش‌کننده را مشخص می‌کند.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B \(dqoff\(dq
.TP
.B \(dqalltracks\(dq
.TP
.B \(dqgroup\(dq
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
[player] > shuffle <alltracks/group/off>
.UNINDENT
.SS string Scan [readwrite]
.sp
تنظیمات پویش (Scan) پخش‌کننده را مشخص می‌کند.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B \(dqoff\(dq
.TP
.B \(dqalltracks\(dq
.TP
.B \(dqgroup\(dq
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
[player] > scan <alltracks/group/off>
.UNINDENT
.SS string Status [readonly]
.sp
وضعیت پخش‌کننده را مشخص می‌کند.
.sp
وضعیت‌های ممکن:
.INDENT 0.0
.TP
.B \(dqplaying\(dq
.TP
.B \(dqstopped\(dq
.TP
.B \(dqpaused\(dq
.TP
.B \(dqforward\-seek\(dq
.TP
.B \(dqreverse\-seek\(dq
.TP
.B \(dqerror\(dq
.UNINDENT
.SS uint32 Position [readonly]
.sp
موقعیت پخش بر حسب میلی‌ثانیه.
.sp
تغییر دادن موقعیت ممکن است رویدادهای بیشتری تولید کند که به دستگاه از راه دور ارسال خواهند شد. هنگامی که موقعیت برابر 0 باشد به این معنی است که قطعه در حال شروع است، و زمانی که بزرگ‌تر یا مساوی با مدت‌زمان قطعه باشد، قطعه پایان یافته است.
.sp
توجه داشته باشید که حتی اگر مدت‌زمان در متادیتا موجود نباشد، با تنظیم موقعیت روی حداکثر مقدار uint32 امکان اعلام پایان آن وجود دارد.
.SS dict Track [readonly]
.sp
متادیتای قطعه.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B string Title
عنوان قطعه
.TP
.B string Artist
نام هنرمند قطعه
.TP
.B string Album
نام آلبوم قطعه
.TP
.B string Genre
نام سبک (ژانر) قطعه
.TP
.B uint32 NumberOfTracks
تعداد کل قطعه‌ها
.TP
.B uint32 TrackNumber
شماره قطعه
.TP
.B uint32 Duration
مدت‌زمان قطعه بر حسب میلی‌ثانیه
.TP
.B string ImgHandle
[آزمایشی]
.sp
دستگیره تصویر قطعه (Track image handle)، فقط در طول مدت اتصال OBEX BIP به ObexPort در دسترس و معتبر است.
.UNINDENT
.SS object Device [readonly]
.sp
مسیر شیء دستگاه.
.SS string Name [readonly]
.sp
نام پخش‌کننده.
.SS string Type [readonly]
.sp
نوع پخش‌کننده.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B \(dqAudio\(dq
.TP
.B \(dqVideo\(dq
.TP
.B \(dqAudio Broadcasting\(dq
.TP
.B \(dqVideo Broadcasting\(dq
.UNINDENT
.SS string Subtype [readonly]
.sp
زیرنوع پخش‌کننده.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B \(dqAudio Book\(dq
.TP
.B \(dqPodcast\(dq
.UNINDENT
.SS boolean Browsable [readonly]
.sp
در صورت وجود، نشان می‌دهد که می‌توان پخش‌کننده را با استفاده از واسط MediaFolder مرور کرد.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B True
پشتیبانی‌شده و فعال
.TP
.B False
پشتیبانی‌شده اما غیرفعال
.UNINDENT
.sp
نکته: در صورت پشتیبانی اما غیرفعال بودن، کلاینت‌ها می‌توانند با استفاده از واسط
\fBorg.bluez.MediaFolder(5)\fP
آن را فعال کنند، اما ممکن است در پخش سایر پخش‌کننده‌ها تداخل ایجاد کند.
.SS boolean Searchable [readonly]
.sp
در صورت وجود، نشان می‌دهد که می‌توان در پخش‌کننده با استفاده از واسط MediaFolder جستجو کرد.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B True
پشتیبانی‌شده و فعال
.TP
.B False
پشتیبانی‌شده اما غیرفعال
.UNINDENT
.sp
نکته: در صورت پشتیبانی اما غیرفعال بودن، کلاینت‌ها می‌توانند با استفاده از واسط
\fBorg.bluez.MediaFolder(5)\fP
آن را فعال کنند، اما ممکن است در پخش سایر پخش‌کننده‌ها تداخل ایجاد کند.
.SS object Playlist
.sp
مسیر شیء فهرست پخش (Playlist).
.SS uint16 ObexPort [readonly, experimental]
.sp
در صورت وجود، نشان می‌دهد که پخش‌کننده می‌تواند با استفاده از BIP روی OBEX از طریق این پورت PSM تصویر جلد (cover art) را دریافت کند.
.\" End of generated man page.