| org.bluez.AdvertisementMonitorManager(5) | مدیریت سیستم لینوکس | org.bluez.AdvertisementMonitorManager(5) |
نام (NAME)
org.bluez.AdvertisementMonitorManager - مستندات واسط پایشگر آگهیهای بلوتوث در BlueZ
واسط (INTERFACE)
- سرویس (Service)
- org.bluez
- واسط (Interface)
- org.bluez.AdvertisementMonitorManager1 [experimental]
- مسیر شیء (Object path)
- /org/bluez/{hci0,hci1,...}
- مورد استفاده توسط (Used by)
- bluetoothctl-monitor(1)
متدها (Methods)
void RegisterMonitor(object application)
مسیر ریشه یک سلسلهمراتب از پایشگرهای آگهی (advertisement monitors) را که org.bluez.AdvertisementMonitor(5) را پیادهسازی میکنند، ثبت میکند.
مسیر شیء برنامه به همراه شناسه اتصال گذرگاه سیستم در D-Bus، شناسه برنامهای را که پایشگرهای آگهی را ثبت میکند، تعریف میکنند.
پس از ثبت یک مسیر ریشه توسط کلاینت از طریق این متد، کلاینت میتواند آزادانه و بدون نیاز به ثبت دوباره مسیر ریشه، پایشگرهای آگهی را ارائه یا حذف کند (expose/unexpose).
پس از استفاده، کلاینت باید متد UnregisterMonitor() را برای باطلسازی پایشگرهای آگهی فراخوانی کند.
خطاهای ممکن:
مثالها:
- bluetoothctl
- [monitor] > add-or-pattern <start_pos> <ad_type> <content>
void UnregisterMonitor(object application)
سلسلهمراتبی از پایشگرهای آگهی را که پیشتر با RegisterMonitor() ثبت شده است، لغو ثبت میکند. پارامتر مسیر شیء باید با همان مقداری که هنگام ثبت استفاده شده، مطابقت داشته باشد.
هنگام لغو ثبت، پایشگر(های) آگهی باید انتظار دریافت متد Release() را به عنوان نشانهای مبنی بر غیرفعال شدن پایشگر(ها) داشته باشند.
خطاهای ممکن:
مثالها:
- bluetoothctl
- [monitor] > remove-pattern <monitor-id/all>
ویژگیها (Properties)
array{string} SupportedMonitorTypes [read-only]
این بخش، انواع پشتیبانیشده پایشگرهای آگهی را برمیشمارد. یک برنامه باید پیش از نمونهسازی و ارائه شیئی از org.bluez.AdvertisementMonitor(5) این ویژگی را بررسی کند.
مقادیر ممکن:
- "or_patterns"
- الگوهایی که منطق OR روی آنها اعمال شده است. در این نوع، ویژگی Patterns باید وجود داشته باشد و دستکم شامل یک الگو باشد.
array{string} SupportedFeatures [read-only]
این بخش، قابلیتهای پایش آگهی پشتیبانیشده توسط bluetoothd(8) را برمیشمارد.
مقادیر ممکن:
- "controller-patterns"
- اگر کنترلکننده قادر به اجرای پایش آگهی بر اساس الگوها باشد، bluetoothd(8) الگوها را به کنترلکننده واگذار (offload) میکند تا مصرف انرژی کاهش یابد.
| اکتبر 2023 | BlueZ |