.\" 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.LEAdvertisingManager" "5" "اکتبر 2023" "BlueZ" "مدیریت سیستم لینوکس"
.SH "نام (NAME)"
org.bluez.LEAdvertisingManager \- رابط کاربری D-Bus برای مدیریت تبلیغات بلوتوث کم‌مصرف در BlueZ
.SH "واسط (INTERFACE)"
.sp
مدیر تبلیغات (Advertising Manager) به برنامه‌های خارجی امکان می‌دهد تا داده‌های تبلیغاتی (Advertisement Data) را که باید به دستگاه‌ها اعلان عمومی شوند، ثبت نمایند. عناصر داده‌های تبلیغاتی باید از API برای داده‌های تبلیغاتی LE که شرح داده شده پیروی کنند.
.INDENT 0.0
.TP
.B سرویس (Service)
org.bluez
.TP
.B واسط (Interface)
org.bluez.LEAdvertisingManager1
.TP
.B مسیر شیء (Object path)
/org/bluez/{hci0,hci1,...}
.TP
.B مورد استفاده توسط (Used by)
\fBbluetoothctl(1)\fP
.UNINDENT
.SS "متدها (Methods)"
.SS void RegisterAdvertisement(object advertisement, dict options)
.sp
یک شیء تبلیغاتی را برای ارسال بر روی کانال تبلیغات LE ثبت می‌کند.
.sp
این سرویس باید واسط \fBorg.bluez.LEAdvertisement(5)\fP را پیاده‌سازی کند.
.sp
خطاهای ممکن:
.INDENT 0.0
.TP
.B org.bluez.Error.InvalidArguments
نشان می‌دهد شیء دارای ویژگی‌های نامعتبر یا دارای تداخل است.
.TP
.B org.bluez.Error.AlreadyExists
نشان می‌دهد شیء از قبل ثبت شده است.
.TP
.B org.bluez.Error.InvalidLength
نشان می‌دهد داده‌های ارائه‌شده یک بسته داده بیش از حد طولانی ایجاد می‌کنند.
.TP
.B org.bluez.Error.NotPermitted
نشان می‌دهد حداکثر تعداد نمونه‌های تبلیغاتی تکمیل شده است.
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> advertise <on/off/type>
.UNINDENT
.SS void UnregisterAdvertisement(object advertisement)
.sp
تبلیغی را که پیش‌تر با استفاده از \fBRegisterAdvertisement()\fP\& ثبت شده است لغو ثبت می‌کند.
.sp
پارامتر مسیر شیء باید با همان مقداری که هنگام ثبت استفاده شده است مطابقت داشته باشد.
.sp
خطاهای ممکن:
.INDENT 0.0
.TP
.B org.bluez.Error.InvalidArguments
.TP
.B org.bluez.Error.DoesNotExist
.UNINDENT
.SS "ویژگی‌ها (Properties)"
.SS byte ActiveInstances [readonly]
.sp
تعداد نمونه‌های تبلیغاتی فعال.
.SS byte SupportedInstances [readonly]
.sp
تعداد نمونه‌های تبلیغاتی در دسترس.
.SS array{string} SupportedIncludes [readonly]
.sp
فهرست موارد سیستمی پشتیبانی‌شده.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B \(dqtx\-power\(dq
.TP
.B \(dqappearance\(dq
.TP
.B \(dqlocal\-name\(dq
.TP
.B \(dqrsi\(dq
.UNINDENT
.SS array{string} SupportedSecondaryChannels [readonly]
.sp
فهرست کانال‌های ثانویه پشتیبانی‌شده. کانال‌های ثانویه می‌توانند برای تبلیغ با لایه فیزیکی (PHY) مربوطه استفاده شوند.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B \(dq1M\(dq
.TP
.B \(dq2M\(dq
.TP
.B \(dqCoded\(dq
.UNINDENT
.SS dict SupportedCapabilities [readonly]
.sp
قابلیت‌های کنترل‌کننده مربوط به تبلیغات را که برای کلاینت مفید هستند برمی‌شمارد.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B byte MaxAdvLen
حداکثر طول داده‌های تبلیغات
.TP
.B byte MaxScnRspLen
حداکثر طول پاسخ پویش (scan response) تبلیغات
.TP
.B int16 MinTxPower
حداقل توان ارسال تبلیغات (dBm)
.TP
.B int16 MaxTxPower
حداکثر توان ارسال تبلیغات (dBm)
.UNINDENT
.SS array{string} SupportedFeatures [readonly,optional]
.sp
فهرست ویژگی‌های پلتفرم پشتیبانی‌شده. اگر هیچ ویژگی در پلتفرم موجود نباشد، آرایه SupportedFeatures خالی خواهد بود.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B \(dqCanSetTxPower\(dq
نشان می‌دهد آیا پلتفرم می‌تواند توان ارسال را برای هر نمونه تبلیغاتی تعیین کند یا خیر.
.TP
.B \(dqHardwareOffload\(dq
نشان می‌دهد آیا تبلیغات چندگانه به کنترل‌کننده واگذار (offload) خواهد شد یا خیر.
.UNINDENT
.\" End of generated man page.