| org.bluez.AgentManager(5) | Linux System Administration | org.bluez.AgentManager(5) |
نام (NAME)
org.bluez.AgentManager - مستندات واسط D-Bus مدیر عاملهای بلوتوث در BlueZ
واسط (INTERFACE)
- سرویس (Service)
- org.bluez
- واسط (Interface)
- org.bluez.AgentManager1
- مسیر شیء (Object path)
- /org/bluez
- مورد استفاده توسط (Used by)
- bluetoothctl(1)
متدها (Methods)
void RegisterAgent(object agent, string capability)
عامل جفتسازی (pairing agent) را ثبت میکند.
مسیر شیء (object path) مسیری از عامل را تعیین میکند که هنگام نیاز به ورودی کاربر فراخوانی خواهد شد و باید واسط org.bluez.Agent(5) را پیادهسازی کند.
هر برنامه میتواند عامل اختصاصی خود را ثبت کند و برای تمام کارهای راهاندازیشده توسط آن برنامه، عامل خودش استفاده میشود.
ثبت یک عامل توسط برنامه الزامی نیست. اگر برنامهای تصمیم بگیرد که عاملی ثبت نکند، عامل پیشفرض استفاده میشود. این کار در بیشتر موارد رویکرد مناسبی است. فقط برنامههایی مانند برنامه هدایت جفتسازی (pairing wizard) باید عامل اختصاصی خود را ثبت کنند.
یک برنامه تنها میتواند یک عامل ثبت کند. ثبت چند عامل برای یک برنامه پشتیبانی نمیشود.
مقادیر ممکن برای capability:
- ""
- بازگشت به "KeyboardDisplay".
- "DisplayOnly"
- "DisplayYesNo"
- "KeyboardOnly"
- "NoInputNoOutput"
- "KeyboardDisplay"
خطاهای احتمالی:
مثالها:
- bluetoothctl
- > agent <on/off/auto/capability>
void UnregisterAgent(object agent)
عاملی را که پیشتر با استفاده از RegisterAgent ثبت شده است لغو ثبت میکند. پارامتر مسیر شیء باید با همان مقداری که هنگام ثبت استفاده شده است مطابقت داشته باشد.
خطاهای احتمالی:
void RequestDefaultAgent(object agent)
درخواست میکند که عامل برنامه به عامل پیشفرض تبدیل شود. برنامه موظف است عاملی را ثبت کند.
ممکن است برای تبدیل شدن به عامل پیشفرض، دسترسی ویژهای نیاز باشد.
خطاهای احتمالی:
مثالها:
- bluetoothctl
- > default-agent
| October 2023 | BlueZ |