.\" 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.MediaTransport" "5" "July 2024" "BlueZ" "Linux System Administration" .SH "نام (NAME)" org.bluez.MediaTransport \- مستندات API واسط MediaTransport در BlueZ D-Bus .SH "واسط (INTERFACE)" .INDENT 0.0 .TP .B سرویس (Service) org.bluez .TP .B واسط (Interface) org.bluez.MediaTransport1 .TP .B مسیر شیء (Object path) [variable prefix]/{hci0,hci1,...}/dev_{BDADDR}/fd# .TP .B مورد استفاده توسط (Used by) \fBbluetoothctl\-transport(1)\fP .UNINDENT .SS "متدها (Methods)" .SS fd, uint16, uint16 Acquire() .sp توصیف‌کننده فایل (file descriptor) انتقال و مقدار MTU را به ترتیب برای خواندن و نوشتن دریافت (Acquire) می‌کند. .sp خطاهای ممکن: .INDENT 0.0 .TP .B org.bluez.Error.NotAuthorized .TP .B org.bluez.Error.Failed .UNINDENT .sp مثال‌ها: .INDENT 0.0 .TP .B bluetoothctl > transport.acquire [transport1...] .UNINDENT .SS fd, uint16, uint16 TryAcquire() .sp توصیف‌کننده فایل انتقال را تنها در صورتی دریافت می‌کند که در زمان دریافت پیام توسط BlueZ، انتقال در وضعیت \(dqpending\(dq (در انتظار) باشد. در غیر این صورت هیچ درخواستی به دستگاه راه دور ارسال نخواهد شد و متد تنها با خطای \fBorg.bluez.Error.NotAvailable\fP\& شکست می‌خورد. .sp خطاهای ممکن: .INDENT 0.0 .TP .B org.bluez.Error.NotAuthorized .TP .B org.bluez.Error.Failed .TP .B org.bluez.Error.NotAvailable .UNINDENT .SS void Release() .sp توصیف‌کننده فایل را آزاد (Release) می‌کند. .sp مثال‌ها: .INDENT 0.0 .TP .B bluetoothctl > transport.release [transport1...] .UNINDENT .SS void Select() .sp تنها برای انتقال‌های ایجادشده توسط یک مقصد پخش فراگیر (broadcast sink) کاربرد دارد. این متد انتقال را از وضعیت \(dqidle\(dq به \(dqbroadcasting\(dq منتقل می‌کند. .sp این متد به فراخوان‌کننده‌ها امکان می‌دهد از طریق یک فرایند ۲ مرحله‌ای انتخاب کنند که مایل به همگام‌سازی با کدام BISها هستند: .INDENT 0.0 .IP 1. 3 کاربر متد را فراخوانی می‌کند و وضعیت انتقال را به broadcasting تغییر می‌دهد .IP 2. 3 سرور صوتی تشخیص می‌دهد که انتقال در وضعیت \(aqbroadcasting\(aq قرار دارد و به طور خودکار آن را دریافت (acquire) می‌کند .UNINDENT .sp خطاهای ممکن: .INDENT 0.0 .TP .B org.bluez.Error.NotAuthorized .UNINDENT .sp مثال‌ها: .INDENT 0.0 .TP .B bluetoothctl > transport.select [transport1...] .UNINDENT .SS void Unselect() .sp تنها برای انتقال‌های ایجادشده توسط یک مقصد پخش فراگیر (broadcast sink) کاربرد دارد. این متد انتقال را از وضعیت \(dqbroadcasting\(dq یا \(dqactive\(dq به \(dqidle\(dq منتقل می‌کند. .sp این متد به فراخوان‌کننده‌ها امکان می‌دهد همگام‌سازی با یک BIS را از طریق یک فرایند ۲ مرحله‌ای خاتمه دهند: .INDENT 0.0 .IP 1. 3 کاربر این متد را فراخوانی می‌کند و وضعیت انتقال را به idle تغییر می‌دهد .IP 2. 3 سرور صوتی این رویداد را تشخیص داده و انتقال را آزاد (release) می‌کند .UNINDENT .sp خطاهای ممکن: .INDENT 0.0 .TP .B org.bluez.Error.NotAuthorized .UNINDENT .sp مثال‌ها: .INDENT 0.0 .TP .B bluetoothctl > transport.unselect [transport1...] .UNINDENT .SS "ویژگی‌ها (Properties)" .SS object Device [فقط‌خواندنی] .sp شیء دستگاهی که انتقال به آن متصل است. .SS string UUID [فقط‌خواندنی] .sp شناسه UUID پروفایلی که انتقال برای آن است. .SS byte Codec [فقط‌خواندنی] .sp شماره اختصاص‌یافته کدک که انتقال از آن پشتیبانی می‌کند. .sp مقادیر باید با مشخصات پروفایل که توسط UUID تعیین شده است مطابقت داشته باشند. .SS array{byte} Configuration [فقط‌خواندنی] .sp داده باینری (blob) پیکربندی؛ این داده همان‌طور که هست استفاده می‌شود، بنابراین اندازه و ترتیب بایت‌ها باید مطابقت داشته باشد. .SS string State [فقط‌خواندنی] .sp وضعیت انتقال را نشان می‌دهد. مقادیر ممکن عبارتند از: .INDENT 0.0 .TP .B \(dqidle\(dq بدون استریم داده صوتی .TP .B \(dqpending\(dq در حال استریم اما دریافت (acquire) نشده است .TP .B \(dqbroadcasting\(dq در حال استریم اما دریافت نشده است؛ تنها برای انتقال‌های ایجادشده توسط یک مقصد پخش فراگیر (broadcast sink) کاربرد دارد .TP .B \(dqactive\(dq در حال استریم و دریافت‌شده .UNINDENT .SS uint16 Delay [خواندنی/نوشتنی، اختیاری] .sp تأخیر انتقال بر حسب یک‌دهم میلی‌ثانیه؛ این ویژگی تنها زمانی قابل نوشتن است که انتقال مربوط به یک نقطه انتهایی مقصد (sink endpoint) باشد و توسط فرستنده دریافت شده باشد. .SS uint16 Volume [خواندنی/نوشتنی، اختیاری] .sp سطح صدای انتقال را نشان می‌دهد؛ این ویژگی تنها زمانی قابل نوشتن است که انتقال توسط فرستنده دریافت شده باشد. .sp مقادیر ممکن: .INDENT 0.0 .TP .B 0\-127 (A2DP) .TP .B 0\-255 (BAP) .UNINDENT .sp مثال‌ها: .INDENT 0.0 .TP .B bluetoothctl > transport.volume [value] .UNINDENT .SS object Endpoint [فقط‌خواندنی، اختیاری، آزمایشی] .sp شیء نقطه انتهایی (Endpoint) که انتقال با آن مرتبط است. .SS uint32 Location [فقط‌خواندنی، فقط ISO، آزمایشی] .sp موقعیت مکانی صوتی (Audio Location) انتقال را نشان می‌دهد. .SS array{byte} Metadata [خواندنی/نوشتنی، فقط ISO، آزمایشی] .sp متادیتای انتقال را نشان می‌دهد. .SS array{object} Links [فقط‌خواندنی، اختیاری، فقط CIS، آزمایشی] .sp اشیاء انتقال پیوندیافته (Linked transport) که این انتقال با آن‌ها مرتبط است. .SS array{object} Links [خواندنی/نوشتنی، فقط BIS، آزمایشی] .sp برای یک مقصد پخش فراگیر (Broadcast Sink)، فرایند همگام‌سازی BIG مستلزم آن است که تمامی استریم‌های مورد نظر از ابتدا شمارش شوند و نمی‌توان بعداً آن را با افزودن یا حذف BISها مجدداً پیکربندی کرد. .sp برای جلوگیری از پایان دادن و ایجاد مجدد همگام‌سازی BIG در هر بار که یک انتقال جدید برای دریافت (acquire) انتخاب می‌شود، تمامی انتقال‌های انتخاب‌شده از طریق \fBSelect\fP باید به یکدیگر پیوند داده شوند. .sp هنگامی که اولین انتقال از طریق Transport.Acquire دریافت می‌شود، تمامی پیوندها در دستور همگام‌سازی BIG گنجانده می‌شوند. .sp یک انتقال دریافت‌شده، توصیف‌کننده‌های فایل (fdها) را برای تمامی پیوندهای خود ایجاد و تنظیم می‌کند. سپس، هر پیوند باید به طور جداگانه دریافت شود تا fd را به دست آورد و شروع به دریافت صدا کند. .SS dict QoS [خواندنی/نوشتنی، اختیاری، فقط ISO، آزمایشی] .sp تنها زمانی وجود دارد که QoS پیکربندی شده باشد. .sp مقادیر ممکن برای Unicast (تک‌پخشی): .INDENT 0.0 .TP .B byte CIG شناسه CIG پیکربندی‌شده را نشان می‌دهد. .sp مقادیر ممکن: .INDENT 7.0 .TP .B 0x00 \- 0xef محدوده شناسه معتبر. .TP .B 0xff تخصیص خودکار. .UNINDENT .TP .B byte CIS شناسه CIS پیکربندی‌شده را نشان می‌دهد. .sp مقادیر ممکن: .INDENT 7.0 .TP .B 0x00 \- 0xef .UNINDENT .sp محدوده شناسه معتبر. .INDENT 7.0 .TP .B 0xff تخصیص خودکار. .UNINDENT .TP .B byte Framing قاب‌بندی (framing) پیکربندی‌شده را نشان می‌دهد. .sp مقادیر ممکن: .INDENT 7.0 .TP .B 0x00 بدون قاب‌بندی (Unframed). .TP .B 0x01 قاب‌بندی‌شده (Framed). .UNINDENT .TP .B uint32 PresentationDelay تأخیر نمایش (presentation delay) پیکربندی‌شده برای انتقال را بر حسب میکروثانیه (us) نشان می‌دهد. .TP .B byte TargetLatency تأخیر هدف درخواستی را نشان می‌دهد. .sp مقادیر ممکن: .INDENT 7.0 .TP .B 0x01 تأخیر کم (Low Latency). .TP .B 0x02 تأخیر/قابلیت اطمینان متعادل (Balanced Latency/Reliability). .TP .B 0x03 قابلیت اطمینان بالا (High Reliability). .UNINDENT .UNINDENT .sp مقادیر ممکن برای Broadcast (پخش فراگیر): .INDENT 0.0 .TP .B byte BIG شناسه BIG پیکربندی‌شده برای QoS را نشان می‌دهد. .TP .B byte BIS شناسه BIS پیکربندی‌شده را نشان می‌دهد. .TP .B byte SyncFactor ضریب همگام‌سازی پخش فراگیر پیکربندی‌شده را نشان می‌دهد. .TP .B byte Packing بسته‌بندی (packing) پیکربندی‌شده را نشان می‌دهد. .TP .B byte Framing قاب‌بندی (framing) پیکربندی‌شده را نشان می‌دهد. .TP .B array{byte} BCode رشته مورد استفاده برای رمزگذاری/رمزگشایی را نشان می‌دهد. .TP .B byte encryption مشخص می‌کند که آیا استریم رمزگذاری شده است یا خیر. .TP .B byte Options گزینه‌های پخش فراگیر پیکربندی‌شده را نشان می‌دهد. .TP .B uint16 Skip مقدار پرش (skip) پخش فراگیر پیکربندی‌شده را نشان می‌دهد. .TP .B byte SyncTimeout مهلت زمانی همگام‌سازی (sync timeout) پخش فراگیر پیکربندی‌شده را نشان می‌دهد. .TP .B byte SyncType نوع CTE همگام‌سازی پخش فراگیر پیکربندی‌شده را نشان می‌دهد. .TP .B byte MSE مقدار MSE پخش فراگیر پیکربندی‌شده را نشان می‌دهد. .TP .B uint16 Timeout مهلت زمانی (timeout) پخش فراگیر پیکربندی‌شده را نشان می‌دهد. .UNINDENT .sp مقادیر ممکن برای هر دو حالت Unicast و Broadcast: .INDENT 0.0 .TP .B uint32 Interval فاصله زمانی ISO (ISO interval) پیکربندی‌شده بر حسب میکروثانیه (us) را نشان می‌دهد. .TP .B uint16 Latency تأخیر انتقال پیکربندی‌شده بر حسب میلی‌ثانیه (ms) را نشان می‌دهد. .TP .B uint16 SDU حداکثر SDU پیکربندی‌شده را نشان می‌دهد. .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 تعداد ارسال‌های مجدد (retransmissions) پیکربندی‌شده را نشان می‌دهد. .UNINDENT .SS boolean Desynchronized [خواندنی/نوشتنی، اختیاری، فقط CIS، آزمایشی، برای تست] .sp تنها زمانی در دسترس است که واسط‌های آزمایشی D\-Bus فعال باشند و انتقال دارای ویژگی \fBLinks\fP باشد. .sp کنترل می‌کند که آیا انتقال‌های پیوندیافته به طور هم‌زمان دریافت (acquire) شوند یا خیر. .sp هنگامی که روی False (پیش‌فرض) تنظیم شود، دریافت یکی از انتقال‌های پیوندیافته به طور خودکار تمامی پیوندها را دریافت می‌کند. .sp هنگامی که روی True تنظیم شود، پیوندها به طور خودکار دریافت نمی‌شوند و هر پیوند باید به طور جداگانه دریافت شود. .\" End of generated man page.