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