.\" 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.LEAdvertisement" "5" "اکتبر 2023" "BlueZ" "مدیریت سیستم لینوکس"
.SH "نام (NAME)"
org.bluez.LEAdvertisement \- مستندات واسط D-Bus برای LEAdvertisement در BlueZ
.SH "توضیحات (DESCRIPTION)"
.sp
بسته‌های تبلیغاتی (Advertising packets)، داده‌های ساختاریافته‌ای هستند که روی کانال‌های تبلیغاتی بلوتوث کم‌مصرف (LE) همه‌پخشی (broadcast) شده و برای تمام دستگاه‌های درون محدوده در دسترس هستند. به دلیل فضای محدود موجود در بسته‌های تبلیغاتی LE، محتوای هر بسته باید با دقت کنترل شود.
.sp
\fBbluetoothd(8)\fP به عنوان ذخیره‌گاهی برای داده‌های تبلیغاتی (Advertisement Data) که قرار است ارسال شوند عمل می‌کند. این برنامه داده‌های تبلیغاتی صحیح را از روی داده‌های ساختاریافته تولید کرده و هسته را برای ارسال تبلیغات مناسب پیکربندی می‌کند.
.SH "واسط (INTERFACE)"
.sp
داده‌های تبلیغاتی برای انتشار و برخی از پارامترهای تبلیغاتی را مشخص می‌کند. ویژگی‌هایی که وجود ندارند در داده‌ها گنجانده نخواهند شد. انواع داده‌های تبلیغاتی الزامی همیشه لحاظ می‌شوند. تمام UUIDها در واسط برنامه‌نویسی نسخه‌های ۱۲۸ بیتی هستند و نسخه‌های ۱۶ یا ۳۲ بیتی همان UUID در صورت لزوم در داده‌های تبلیغاتی استفاده خواهند شد.
.INDENT 0.0
.TP
.B سرویس (Service)
org.bluez
.TP
.B واسط (Interface)
org.bluez.LEAdvertisement1
.TP
.B مسیر شیء (Object path)
به‌صورت آزاد قابل تعریف است (freely definable)
.TP
.B مورد استفاده توسط (Used by)
\fBbluetoothctl\-advertise(1)\fP
.UNINDENT
.SS "متدها (Methods)"
.SS void Release() [noreply]
.sp
این متد هنگامی که \fBbluetoothd(8)\fP تبلیغ را حذف می‌کند فراخوانی می‌شود.
.sp
یک کلاینت می‌تواند از آن برای انجام وظایف پاک‌سازی استفاده کند. نیازی به فراخوانی \fBUnregisterAdvertisement()\fP نیست، زیرا هنگام فراخوانی این متد، تبلیغ از پیش لغو ثبت شده است.
.SS "ویژگی‌ها (Properties)"
.SS string Type [readonly]
.sp
نوع بسته تبلیغاتی درخواستی را تعیین می‌کند.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B \(dqbroadcast\(dq
.TP
.B \(dqperipheral\(dq
.UNINDENT
.SS array{string} ServiceUUIDs [readonly, optional]
.sp
فهرستی از UUIDها برای گنجاندن در فیلد \(dqService UUID\(dq داده‌های تبلیغاتی.
.SS dict ManufacturerData [readonly, optional]
.sp
فیلدهای داده‌های تولیدکننده برای گنجاندن در داده‌های تبلیغاتی.
.sp
کلیدها شناسه تولیدکننده (Manufacturer ID) هستند که با داده‌ها مرتبط می‌شوند.
.SS array{string} SolicitUUIDs [readonly, optional]
.sp
فهرستی از UUIDها برای گنجاندن در فیلد \(dqService Solicitation\(dq داده‌های تبلیغاتی.
.SS dict ServiceData [readonly, optional]
.sp
عناصر داده‌های سرویس برای گنجاندن در داده‌های تبلیغاتی.
.sp
کلیدها UUIDهایی هستند که با داده‌ها مرتبط می‌شوند.
.SS dict Data [readonly, optional]
.sp
داده‌های تبلیغاتی جهت گنجاندن.
.sp
کلید، نوع تبلیغات و مقدار، داده‌ها به‌صورت آرایه‌ای از بایت‌ها است.
.sp
نکته: انواع داده‌ای که پیش‌تر توسط ویژگی‌های دیگر مدیریت شده‌اند نباید استفاده شوند.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B <type>
<byte array>
.UNINDENT
.INDENT 0.0
.TP
.B مثال:
.nf
<Transport Discovery> <Organization Flags...>
0x26                   0x01         0x01...
.fi
.UNINDENT
.SS array{string} ScanResponseServiceUUIDs [readonly, optional, experimental]
.sp
فهرستی از UUIDها برای گنجاندن در فیلد \(dqService UUID\(dq داده‌های پاسخ پویش (Scan Response Data).
.SS dict ScanResponseManufacturerData [readonly, optional, experimental]
.sp
فیلدهای داده‌های تولیدکننده برای گنجاندن در داده‌های پاسخ پویش.
.sp
کلیدها شناسه تولیدکننده هستند که با داده‌ها مرتبط می‌شوند.
.SS array{string} ScanResponseSolicitUUIDs [readonly, optional, experimental]
.sp
فهرستی از UUIDها برای گنجاندن در فیلد \(dqService Solicitation\(dq داده‌های پاسخ پویش.
.SS dict ScanResponseServiceData [readonly, optional, experimental]
.sp
عناصر داده‌های سرویس برای گنجاندن در داده‌های پاسخ پویش.
.sp
کلیدها UUIDهایی هستند که با داده‌ها مرتبط می‌شوند.
.SS dict ScanResponseData [readonly, optional, experimental]
.sp
داده‌های پاسخ پویش جهت گنجاندن.
.sp
کلید، نوع تبلیغات و مقدار، داده‌ها به‌صورت آرایه‌ای از بایت‌ها است.
.SS bool Discoverable [readonly, optional]
.sp
تبلیغ به‌صورت عمومی قابل کشف (general discoverable). در صورت وجود، این ویژگی تنظیم Discoverable آداپتور را بازنویسی خواهد کرد.
.sp
نکته: هنگامی که \fBType\fP روی \(dqbroadcast\(dq تنظیم شده باشد، این ویژگی نباید مقداردهی شود.
.SS uint16 DiscoverableTimeout [readonly, optional]
.sp
مهلت زمانی قابلیت کشف برحسب ثانیه. مقدار صفر به این معنی است که مهلت زمانی غیرفعال بوده و برای همیشه در حالت قابل کشف/محدود (discoverable/limited) باقی خواهد ماند.
.sp
نکته: هنگامی که \fBType\fP روی \(dqbroadcast\(dq تنظیم شده باشد، این ویژگی نباید مقداردهی شود.
.SS array{string} Includes [readonly, optional]
.sp
فهرستی از ویژگی‌هایی که باید در بسته تبلیغاتی گنجانده شوند.
.sp
مقادیر ممکن:
.sp
ویژگی \fBSupportedIncludes\fP در \fBorg.bluez.LEAdvertisingManager(5)\fP را ببینید.
.SS string LocalName [readonly, optional]
.sp
نام محلی مورد استفاده در گزارش تبلیغاتی. اگر رشته برای قرار گرفتن در بسته بیش از حد بزرگ باشد، کوتاه خواهد شد.
.sp
اگر این ویژگی موجود باشد، \(aqlocal\-name\(aq نمی‌تواند در \fBIncludes\fP وجود داشته باشد.
.SS uint16 Appearance [readonly, optional]
.sp
ظاهر (Appearance) مورد استفاده در گزارش تبلیغاتی.
.sp
مقادیر ممکن: همان‌طور که در سرویس GAP تعریف شده است.
.SS uint16 Duration [readonly, optional]
.sp
مدت‌زمان چرخش تبلیغ برحسب ثانیه.
.sp
اگر برنامه‌های دیگری در حال تبلیغ باشند و هیچ مدت‌زمانی تعیین نشده باشد، مقدار پیش‌فرض ۲ ثانیه است.
.SS uint16 Timeout [readonly, optional]
.sp
مهلت زمانی تبلیغ برحسب ثانیه. این مقدار طول عمر تبلیغ را مشخص می‌کند.
.SS string SecondaryChannel [readonly, optional]
.sp
کانال ثانویه مورد استفاده.
.sp
کانال اولیه همیشه روی \(dq1M\(dq تنظیم شده است مگر اینکه \(dqCoded\(dq تنظیم شده باشد.
.sp
مقدار ممکن:
.INDENT 0.0
.TP
.B \(dq1M\(dq (پیش‌فرض)
.TP
.B \(dq2M\(dq
.TP
.B \(dqCoded\(dq
.UNINDENT
.SS uint32 MinInterval [readonly, optional]
.sp
حداقل بازه زمانی تبلیغات برای استفاده توسط مجموعه تبلیغاتی، برحسب میلی‌ثانیه.
.sp
مقادیر قابل قبول در محدوده [20ms, 10,485s] هستند.
.sp
اگر MinInterval ارائه‌شده بزرگ‌تر از MaxInterval ارائه‌شده باشد، فرآیند ثبت با شکست مواجه خواهد شد.
.SS uint32 MaxInterval [readonly, optional]
.sp
حداکثر بازه زمانی تبلیغات برای استفاده توسط مجموعه تبلیغاتی، برحسب میلی‌ثانیه.
.sp
مقادیر قابل قبول در محدوده [20ms, 10,485s] هستند.
.sp
اگر MinInterval ارائه‌شده بزرگ‌تر از MaxInterval ارائه‌شده باشد، فرآیند ثبت با شکست مواجه خواهد شد.
.SS int16 TxPower [readonly, optional]
.sp
توان ارسال درخواستی برای این مجموعه تبلیغاتی.
.sp
مقدار ارائه‌شده تنها در صورتی استفاده می‌شود که ویژگی \(dqCanSetTxPower\(dq در \fBorg.bluez.LEAdvertisingManager(5)\fP فعال باشد.
.sp
مقادیر باید در محدوده [\-127 تا +20] باشند، که واحد آن برحسب dBm است.
.SS byte Instance [read\-write, optional]
.sp
نمونه (Instance) تبلیغ. پس از ثبت تبلیغ در \fBorg.bluez.LEAdvertisingManager(5)\fP توسط دیمن bluetoothd تنظیم می‌شود.
.\" End of generated man page.