.\" 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.Media" "5" "آوریل 2025" "BlueZ" "راهنمای مدیر سیستم لینوکس"
.SH "نام (NAME)"
org.bluez.Media \- سلسلهمراتب چندرسانهای بلوتوث
.SH "واسط (INTERFACE)"
.INDENT 0.0
.TP
.B Service
org.bluez
.TP
.B Interface
org.bluez.Media1
.TP
.B Object path
[variable prefix]/{hci0,hci1,...}
.TP
.B Used by
\fBbluetoothctl\-endpoint(1)\fP
.UNINDENT
.SH "روشها (METHODS)"
.SS void RegisterEndpoint(object endpoint, dict properties)
.sp
یک نقطه انتهایی (endpoint) محلی را در فرستنده ثبت می‌کند؛ فرستنده می‌تواند به هر تعداد که مایل باشد نقطه انتهایی ثبت کند.
.sp
نکته: در صورتی که ارتباط فرستنده قطع شود، نقاط انتهایی به طور خودکار لغو ثبت می‌شوند.
.sp
ویژگی‌های ممکن:
.INDENT 0.0
.TP
.B string UUID
شناسه UUID پروفایلی که نقطه انتهایی برای آن است.
.sp
شناسه UUID باید در فهرست SupportedUUIDS باشد.
.TP
.B byte Codec
شماره اختصاص‌یافته کدک که نقطه انتهایی پیاده‌سازی می‌کند. مقادیر باید با مشخصات پروفایل که توسط UUID تعیین شده است مطابقت داشته باشند.
.TP
.B uint32_t Vendor [Optional]
چندتایی شناسه شرکت (Company ID) و شناسه کدک (Codec ID) اختصاصی سازنده که نقطه انتهایی پیاده‌سازی می‌کند.
.sp
هنگامی که از کدک اختصاصی سازنده (0xff) استفاده می‌شود، باید بر روی مقدار مناسب تنظیم گردد.
.TP
.B array{byte} Capabilities
داده باینری (blob) مربوط به قابلیت‌ها (Capabilities)؛ این داده همان‌طور که هست استفاده می‌شود، بنابراین اندازه و ترتیب بایت‌ها باید مطابقت داشته باشد.
.TP
.B array{byte} Metadata [Optional]
داده باینری (blob) مربوط به متادیتا (Metadata)؛ این داده همان‌طور که هست استفاده می‌شود، بنابراین اندازه و ترتیب بایت‌ها باید مطابقت داشته باشد.
.UNINDENT
.sp
خطاهای ممکن:
.INDENT 0.0
.TP
.B org.bluez.Error.InvalidArguments
.TP
.B org.bluez.Error.NotSupported
هنگامی صادر می‌شود که واسط برای نقطه انتهایی غیرفعال باشد.
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> endpoint.register <UUID> <codec[:company]> [capabilities...]
.UNINDENT
.SS void UnregisterEndpoint(object endpoint)
.sp
نقطه انتهایی فرستنده را لغو ثبت می‌کند.
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> endpoint.unregister <UUID/object>
.UNINDENT
.SS void RegisterPlayer(object player, dict properties)
.sp
یک شیء پخش‌کننده چندرسانه‌ای (media player) را در فرستنده ثبت می‌کند؛ فرستنده می‌تواند به هر تعداد که مایل باشد شیء ثبت کند.
.sp
شیء باید دست‌کم \fBorg.mpris.MediaPlayer2.Player\fP را همان‌گونه که در مشخصات MPRIS 2.2 تعریف شده است پیاده‌سازی کند:
.sp
\%<http://\:specifications\:.freedesktop\:.org/\:mpris-spec/\:latest>
.sp
نکته: در صورتی که ارتباط فرستنده قطع شود، اشیاء آن به طور خودکار لغو ثبت می‌شوند.
.sp
خطاهای ممکن:
.INDENT 0.0
.TP
.B org.bluez.Error.InvalidArguments
.TP
.B org.bluez.Error.NotSupported
.UNINDENT
.SS void UnregisterPlayer(object player)
.sp
پخش‌کننده چندرسانه‌ای فرستنده را لغو ثبت می‌کند.
.SS void RegisterApplication(object root, dict options)
.sp
نقاط انتهایی و اشیاء پخش‌کننده را درون شیء ریشه (root) که باید \fBorg.freedesktop.DBus.ObjectManager\fP\& را پیاده‌سازی کند، ثبت می‌کند.
.sp
مسیر شیء برنامه به همراه شناسه اتصال گذرگاه سیستم D\-Bus، شناسه برنامه را تعیین می‌کنند.
.sp
خطاهای ممکن:
.INDENT 0.0
.TP
.B org.bluez.Error.InvalidArguments
.TP
.B org.bluez.Error.AlreadyExists
.UNINDENT
.SS void UnregisterApplication(object application)
.sp
این متد سرویس‌هایی را که پیش‌تر ثبت شده‌اند لغو ثبت می‌کند.
.sp
پارامتر مسیر شیء باید با همان مقداری که هنگام ثبت استفاده شده است مطابقت داشته باشد.
.sp
خطاهای ممکن:
.INDENT 0.0
.TP
.B org.bluez.Error.InvalidArguments
.TP
.B org.bluez.Error.DoesNotExist
.UNINDENT
.SH "ویژگیها (PROPERTIES)"
.SS array{string} SupportedUUIDs [readonly]
.sp
فهرستی از شناسه‌های ۱۲۸\-بیتی UUID که ثبت نقطه انتهایی (Endpoint) پشتیبانی‌شده را نشان می‌دهند.
.SS array{string} SupportedFeatures [readonly]
.sp
فهرستی از رشته‌ها که ویژگی‌های ویژه پشتیبانی‌شده را نشان می‌دهند.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B \(dqtx\-timestamping\(dq
برچسب‌گذاری زمانی ارسال بلوتوث (Bluetooth TX timestamping) در سوکت‌های جریان رسانه توسط BlueZ و هسته لینوکس پشتیبانی می‌شود. برنامه‌ها می‌توانند پشتیبانی هسته از انواع خاص برچسب زمانی را از طریق SIOCETHTOOL بررسی کنند.
.UNINDENT
.\" End of generated man page.