.\" 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.MediaEndpoint" "5" "سپتامبر 2023" "BlueZ" "مدیریت سیستم لینوکس"
.SH "نام (NAME)"
org.bluez.MediaEndpoint \- رابط کاربری D-Bus برای نقطه انتهایی رسانه در BlueZ
.SH "رابط (INTERFACE)"
.INDENT 0.0
.TP
.B Service
unique name (نقش Server)
org.bluez (نقش Client)
.TP
.B Interface
org.bluez.MediaEndpoint1
.TP
.B Object path
freely definable (نقش Server)
[variable prefix]/{hci0,hci1,...}/dev_{BDADDR}/sep# (نقش Client)
.TP
.B Used by
\fBbluetoothctl\-endpoint(1)\fP
.UNINDENT
.SS "متدها (Methods)"
.SS void SetConfiguration(object transport, dict properties)
.sp
پیکربندی را برای انتقال (transport) تنظیم می‌کند.
.INDENT 0.0
.TP
.B object transport
شیء انتقال پیکربندی‌شده.
.TP
.B dict properties
ویژگی‌های پیکربندی‌شده \fBorg.bluez.MediaTransport(5)\fP\&.
.UNINDENT
.sp
برای نقش کلاینت (client role)، پارامتر transport باید با یک شیء نقطه انتهایی سرور که پیکربندی خواهد شد مقداردهی شود و properties باید شامل ویژگی‌های زیر باشد:
.INDENT 0.0
.TP
.B array{byte} Capabilities [اجباری]
ویژگی Capabilities را ببینید.
.TP
.B array{byte} Metadata [فقط ISO]
ویژگی Metadata را ببینید.
.TP
.B dict QoS [فقط ISO]
ویژگی QoS در \fBorg.bluez.MediaTransport(5)\fP را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B خطاهای ممکن برای نقاط انتهایی A2DP:
.INDENT 7.0
.TP
.B org.bluez.Error.A2DP.InvalidCodecType
.TP
.B org.bluez.Error.A2DP.NotSupportedCodecType
.TP
.B org.bluez.Error.A2DP.InvalidSamplingFrequency
.TP
.B org.bluez.Error.A2DP.NotSupportedSamplingFrequency
.TP
.B org.bluez.Error.A2DP.InvalidChannelMode
.TP
.B org.bluez.Error.A2DP.NotSupportedChannelMode
.TP
.B org.bluez.Error.A2DP.InvalidSubbands
.TP
.B org.bluez.Error.A2DP.NotSupportedSubbands
.TP
.B org.bluez.Error.A2DP.InvalidAllocationMethod
.TP
.B org.bluez.Error.A2DP.NotSupportedAllocationMethod
.TP
.B org.bluez.Error.A2DP.InvalidMinimumBitpoolValue
.TP
.B org.bluez.Error.A2DP.NotSupportedMinimumBitpoolValue
.TP
.B org.bluez.Error.A2DP.InvalidMaximumBitpoolValue
.TP
.B org.bluez.Error.A2DP.NotSupportedMaximumBitpoolValue
.TP
.B org.bluez.Error.A2DP.InvalidLayer
.TP
.B org.bluez.Error.A2DP.NotSupportedLayer
.TP
.B org.bluez.Error.A2DP.NotSupportedCRC
.TP
.B org.bluez.Error.A2DP.NotSupportedMPF
.TP
.B org.bluez.Error.A2DP.NotSupportedVBR
.TP
.B org.bluez.Error.A2DP.InvalidBitRate
.TP
.B org.bluez.Error.A2DP.NotSupportedBitRate
.TP
.B org.bluez.Error.A2DP.InvalidObjectType
.TP
.B org.bluez.Error.A2DP.NotSupportedObjectType
.TP
.B org.bluez.Error.A2DP.InvalidChannels
.TP
.B org.bluez.Error.A2DP.NotSupportedChannels
.TP
.B org.bluez.Error.A2DP.InvalidVersion
.TP
.B org.bluez.Error.A2DP.NotSupportedVersion
.TP
.B org.bluez.Error.A2DP.NotSupportedMaximumSUL
.TP
.B org.bluez.Error.A2DP.InvalidBlockLength
.TP
.B org.bluez.Error.A2DP.InvalidCPType
.TP
.B org.bluez.Error.A2DP.InvalidCPFormat
.TP
.B org.bluez.Error.A2DP.InvalidCodecParameter
.TP
.B org.bluez.Error.A2DP.NotSupportedCodecParameter
.TP
.B org.bluez.Error.A2DP.InvalidDRC
.TP
.B org.bluez.Error.A2DP.NotSupportedDRC
.UNINDENT
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> endpoint.config <endpoint> <local endpoint> [preset]
.UNINDENT
.SS array{byte} SelectConfiguration(array{byte} capabilities)
.sp
پیکربندی ترجیحی را از بین قابلیت‌های پشتیبانی‌شده انتخاب می‌کند.
.sp
پیکربندی‌ای را برمی‌گرداند که می‌تواند برای راه‌اندازی یک transport استفاده شود؛ برای مقادیر ممکن به \fBorg.bluez.MediaTransport(5)\fP مراجعه کنید.
.sp
توجه: نیازی به ذخیره موقت (کَش کردن) پیکربندی انتخاب‌شده نیست، چرا که در صورت موفقیت، پیکربندی به عنوان پارامتر متد SetConfiguration بازگردانده می‌شود.
.SS dict SelectProperties(dict capabilities)
.sp
پیکربندی BAP unicast را از بین قابلیت‌های پشتیبانی‌شده انتخاب می‌کند:
.INDENT 0.0
.TP
.B object Endpoint
.TP
.B array{byte} Capabilities
.TP
.B array{byte} Metadata
.TP
.B uint32 Locations
.TP
.B uint32_t ChannelAllocation
.TP
.B dict QoS
.INDENT 7.0
.TP
.B byte Framing
.TP
.B byte PHY
.TP
.B uint16 MaximumLatency
.TP
.B uint32 MinimumDelay
.TP
.B uint32 MaximumDelay
.TP
.B uint32 PreferredMinimumDelay
.TP
.B uint32 PreferredMaximumDelay
.UNINDENT
.UNINDENT
.sp
برای مقادیر ممکن، به MediaEndpoint Properties مراجعه کنید.
.sp
پیکربندی‌ای را برمی‌گرداند که می‌تواند برای راه‌اندازی یک transport استفاده شود:
.INDENT 0.0
.TP
.B array{byte} Capabilities
.TP
.B array{byte} Metadata [اختیاری]
.TP
.B dict QoS
.UNINDENT
.sp
برای مقادیر ممکن، به SetConfiguration مراجعه کنید.
.sp
توجه: نیازی به ذخیره موقت (کَش کردن) ویژگی‌های انتخاب‌شده نیست، چرا که در صورت موفقیت، پیکربندی به عنوان پارامتر متد SetConfiguration بازگردانده می‌شود.
.SS void ClearConfiguration(object transport)
.sp
پیکربندی transport را پاک می‌کند.
.sp
\fBنقش سرور (Server role):\fP [فقط ISO]
.sp
جریانی را که با transport داده‌شده مرتبط است می‌بندد. اگر مسیر داده‌شده همان مسیر این نقطه انتهایی باشد، تمامی جریان‌های آن بسته می‌شوند.
.SS void Reconfigure(dict properties)
.sp
[فقط ISO]
.sp
یک نقطه انتهایی BAP unicast را دوباره پیکربندی می‌کند. این متد تمام جریان‌های موجود در نقطه انتهایی را می‌بندد و جریان انتخاب پیکربندی را بازنشانی می‌کند، که برای نمونه موجب فراخوانی \fISelectProperties\fP شده و به سرور صوتی اجازه می‌دهد پیکربندی را اصلاح کند.
.sp
آرگومان‌های زیر در \fIproperties\fP دریافت می‌شوند:
.INDENT 0.0
.TP
.B boolean Defer [اختیاری]
اگر مقدار True باشد، نقطه انتهایی را برای پیکربندی مجدد نشانه‌گذاری می‌کند اما آن را تا زمانی که یک عملیات غیرمعوق \fIReconfigure()\fP بر روی نقطه‌ای انتهایی از همان دستگاه انجام شود به تعویق می‌اندازد.
.sp
استفاده از این گزینه هنگام پیکربندی مجدد جریان‌های source و sink که هدف، ترکیب آن‌ها در همان CIG و احتمالاً تشکیل یک CIS دوطرفه (bidirectional) است، ضروری خواهد بود.
.UNINDENT
.SS void Release()
.sp
این متد زمانی فراخوانی می‌شود که \fBbluetoothd(8)\fP ثبت نقطه انتهایی را لغو کند.
.sp
نقطه انتهایی می‌تواند از آن برای انجام وظایف پاکسازی استفاده کند. نیازی به لغو ثبت نقطه انتهایی نیست، چرا که هنگام فراخوانی این متد، ثبت آن از پیش لغو شده است.
.SS MediaEndpoint Properties
.SS string UUID [readonly, optional]
.sp
شناسه UUID پروفایلی که این نقطه انتهایی برای آن است.
.SS byte Codec [readonly, optional]
.sp
شماره تخصیص‌یافته کدک که نقطه انتهایی پیاده‌سازی می‌کند.
.sp
مقادیر باید با مشخصات پروفایلی که توسط UUID تعیین شده مطابقت داشته باشند.
.SS uint32_t Vendor [readonly, Optional]
.sp
چندتایی شناسه شرکت (Company ID) و شناسه کدک (Codec ID) مختص فروشنده که نقطه انتهایی پیاده‌سازی می‌کند.
.sp
زمانی که کدک ویژه فروشنده (0xff) استفاده می‌شود، باید مقدار مناسبی برای آن تنظیم شود.
.SS array{byte} Capabilities [readonly, optional]
.sp
داده باینری (blob) مربوط به Capabilities؛ این مقدار همان‌گونه که هست استفاده می‌شود، بنابراین اندازه و ترتیب بایت‌ها باید مطابقت داشته باشد.
.SS array{byte} Metadata [readonly, Optional]
.sp
داده باینری (blob) مربوط به Metadata؛ این مقدار همان‌گونه که هست استفاده می‌شود، بنابراین اندازه و ترتیب بایت‌ها باید مطابقت داشته باشد.
.SS object Device [readonly, optional]
.sp
شیء دستگاهی که این نقطه انتهایی به آن تعلق دارد.
.SS bool DelayReporting [readonly, optional]
.sp
مشخص می‌کند آیا نقطه انتهایی از گزارش تأخیر (Delay Reporting) پشتیبانی می‌کند یا خیر.
.SS uint32 Locations [readonly, optional, ISO only, experimental]
.sp
موقعیت‌های پشتیبانی‌شده توسط نقطه انتهایی را مشخص می‌کند.
.SS uint16 SupportedContext [readonly, optional, ISO only, experimental]
.sp
بافت صوتی پشتیبانی‌شده توسط نقطه انتهایی را مشخص می‌کند.
.SS uint16 Context [readonly, optional, ISO only, experimental]
.sp
بافت صوتی موجود نقطه انتهایی را مشخص می‌کند.
.SS dict QoS [readonly, optional, ISO only, experimental]
.sp
قابلیت‌های QoS را مشخص می‌کند.
.INDENT 0.0
.TP
.B byte Framing
پشتیبانی نقطه انتهایی از framing را مشخص می‌کند.
.sp
مقادیر ممکن:
.INDENT 7.0
.TP
.B 0x00
از PDUهای فاقد چارچوب (Unframed PDUs) پشتیبانی می‌شود.
.TP
.B 0x01
از PDUهای فاقد چارچوب (Unframed PDUs) پشتیبانی نمی‌شود.
.UNINDENT
.TP
.B byte PHY
لایه فیزیکی (PHY) ترجیحی نقطه انتهایی را مشخص می‌کند.
.sp
مقادیر ممکن:
.INDENT 7.0
.TP
.B bit 0
ترجیح با LE 1M است.
.TP
.B bit 1
ترجیح با LE 2M است.
.TP
.B bit 2
ترجیح با LE Coded است.
.UNINDENT
.TP
.B byte Retransmissions
تعداد بازترسلی‌های ترجیحی نقطه انتهایی را مشخص می‌کند.
.TP
.B uint16 MaximumLatency
حداکثر تأخیر نقطه انتهایی را مشخص می‌کند.
.TP
.B uint32 MinimumDelay
حداقل تأخیر ارائه (presentation delay) نقطه انتهایی را مشخص می‌کند.
.TP
.B uint32 MaximumDelay
حداکثر تأخیر ارائه نقطه انتهایی را مشخص می‌کند.
.TP
.B uint32 PreferredMinimumDelay
حداقل تأخیر ارائه ترجیحی نقطه انتهایی را مشخص می‌کند.
.TP
.B uint32 PreferredMaximumDelay
حداکثر تأخیر ارائه ترجیحی نقطه انتهایی را مشخص می‌کند.
.UNINDENT
.SS dict SupportedFeatures [readonly, ISO only, experimental]
.sp
دیکشنری نشان‌دهنده ویژگی‌های پشتیبانی‌شده برای سرویس‌های گوناگون. کلیدها، UUIDهای سرویس و مقادیر، آرایه‌هایی از رشته‌ها هستند.
.sp
سرویس‌ها:
.INDENT 0.0
.TP
.B array{string} 00001855\-0000\-1000\-8000\-00805f9b34fb
ویژگی‌های TMAP. موارد ممکن:
.INDENT 7.0
.TP
.B \(dqcg\(dq
دروازه تماس (Call Gateway)
.TP
.B \(dqct\(dq
پایانه تماس (Call Terminal)
.TP
.B \(dqums\(dq
فرستنده رسانه تک‌پخشی (Unicast Media Sender)
.TP
.B \(dqumr\(dq
گیرنده رسانه تک‌پخشی (Unicast Media Receiver)
.TP
.B \(dqbms\(dq
فرستنده رسانه همگانی (Broadcast Media Sender)
.TP
.B \(dqbmr\(dq
گیرنده رسانه همگانی (Broadcast Media Receiver)
.UNINDENT
.TP
.B array{string} 00001858\-0000\-1000\-8000\-00805f9b34fb
ویژگی‌های GMAP. موارد ممکن:
.INDENT 7.0
.TP
.B \(dqugg\(dq
دروازه بازی تک‌پخشی (Unicast Game Gateway)
.TP
.B \(dqugt\(dq
پایانه بازی تک‌پخشی (Unicast Game Terminal)
.TP
.B \(dqbgs\(dq
فرستنده بازی همگانی (Broadcast Game Sender)
.TP
.B \(dqbgr\(dq
گیرنده بازی همگانی (Broadcast Game Receiver)
.TP
.B \(dqugg\-multiplex\(dq
پشتیبانی از ویژگی UGG Multiplex
.TP
.B \(dqugg\-96kbps\-source\(dq
پشتیبانی از ویژگی UGG 96 kbps Source
.TP
.B \(dqugg\-multisink\(dq
پشتیبانی از ویژگی UGG Multisink
.TP
.B \(dqugt\-source\(dq
پشتیبانی از ویژگی UGT Source
.TP
.B \(dqugt\-80kbps\-source\(dq
پشتیبانی از ویژگی UGT 80 kbps Source
.TP
.B \(dqugt\-sink\(dq
پشتیبانی از ویژگی UGT Sink
.TP
.B \(dqugt\-64kbps\-sink\(dq
پشتیبانی از ویژگی UGT 64 kbps Sink
.TP
.B \(dqugt\-multiplex\(dq
پشتیبانی از ویژگی UGT Multiplex
.TP
.B \(dqugt\-multisink\(dq
پشتیبانی از ویژگی UGT Multisink
.TP
.B \(dqugt\-multisource\(dq
پشتیبانی از ویژگی UGT Multisource
.TP
.B \(dqbgs\-96kbps\(dq
پشتیبانی از ویژگی BGS 96 kbps
.TP
.B \(dqbgr\-multisink\(dq
پشتیبانی از ویژگی BGR Multisink
.TP
.B \(dqbgr\-multiplex\(dq
پشتیبانی از ویژگی BGR Multiplex
.UNINDENT
.UNINDENT
.\" End of generated man page.