| org.bluez.ProfileManager(5) | Linux System Administration | org.bluez.ProfileManager(5) |
نام (NAME)
org.bluez.ProfileManager - سلسلهمراتب مدیریت پروفایل بلوتوث
واسط (INTERFACE)
- سرویس (Service)
- org.bluez
- واسط (Interface)
- org.bluez.ProfileManager1
- مسیر شیء (Object path)
- /org/bluez
روشها (METHODS)
void RegisterProfile(object profile, string uuid, dict options)
عامل پروفایل (profile agent) را ثبت میکند.
مسیر شیء (object path) مسیری از پروفایل را مشخص میکند که هنگام برقراری اتصال فراخوانی خواهد شد و باید واسط org.bluez.Profile(5) را پیادهسازی کند.
اگر برنامهای اتصال خود را از گذرگاه (bus) قطع کند، تمام پروفایلهای ثبتشده توسط آن حذف خواهند شد.
مقادیر ممکن برای uuid:
- "0000111f-0000-1000-8000-00805f9b34fb"
- پروفایل HFP AG؛ نسخه پیشفرض پروفایل ۱.۷، ویژگیهای (Features) پروفایل 0b001001 و کانال RFCOMM برابر با ۱۳ است. احراز هویت الزامی است.
- "0000111e-0000-1000-8000-00805f9b34fb"
- پروفایل HFP HS؛ نسخه پیشفرض پروفایل ۱.۷، ویژگیهای (Features) پروفایل 0b000000 و کانال RFCOMM برابر با ۷ است. احراز هویت الزامی است.
- "00001112-0000-1000-8000-00805f9b34fb"
- پروفایل HSP AG؛ نسخه پیشفرض پروفایل ۱.۲، کانال RFCOMM برابر با ۱۲ است و احراز هویت الزامی است. از هیچ ویژگیای پشتیبانی نمیکند، گزینه نادیده گرفته میشود.
- "00001108-0000-1000-8000-00805f9b34fb"
- پروفایل HSP HS؛
نسخه
پیشفرض
پروفایل
۱.۲،
ویژگیهای
(Features) پروفایل 0b0
و کانال RFCOMM
برابر با ۶
است. احراز
هویت
الزامی است.
مقدار Features یک مقدار تکبیتی است و قابلیت کنترل ولوم صدای راه دور (Remote Audio Volume Control) را مشخص میکند (به صورت پیشفرض خاموش است).
- "<vendor UUID>"
- UUID تعریفشده توسط سازنده (Vendor)، فاقد مقادیر پیشفرض است و گزینهها باید تنظیم شوند.
مقادیر ممکن برای options:
- string Name
- نام خوانا برای انسان برای پروفایل.
- string Service
- UUID کلاس سرویس اصلی (در صورتی که با UUID واقعی پروفایل متفاوت باشد).
- string Role
- برای
پروفایلهای
نامتقارن
که فاقد
UUIDهای
اختصاصی
جهت
شناسایی
یکتای هر
طرف هستند،
این
پارامتر
امکان
تعیین نقش
محلی دقیق
را فراهم
میکند.
مقادیر ممکن:
- "client"
- "server"
- uint16 Channel
- شماره
کانال RFCOMM که
برای UUIDهای
کلاینت و
سرور
استفاده
میشود.
در صورت کاربرد، در رکورد SDP نیز استفاده خواهد شد.
- uint16 PSM
- شماره PSM که
برای UUIDهای
کلاینت و
سرور
استفاده
میشود.
در صورت کاربرد، در رکورد SDP نیز استفاده خواهد شد.
- boolean RequireAuthentication
- پیش از
برقراری
اتصالات،
جفتسازی
الزامی است.
هیچ دستگاهی در صورت جفت نشدن متصل نخواهد شد.
- boolean RequireAuthorization
- پیش از برقراری هر اتصالی، درخواست مجوز الزامی است.
- boolean AutoConnect
- در مورد UUID کلاینت، این گزینه باعث اتصال اجباری کانالهای RFCOMM یا L2CAP هنگام متصل شدن یک دستگاه دوردست میشود.
- string ServiceRecord
- ارائه دستی رکورد SDP.
- uint16 Version
- نسخه پروفایل (برای رکورد SDP).
- uint16 Features
- ویژگیهای پروفایل (برای رکورد SDP).
خطاهای احتمالی:
void UnregisterProfile(object profile)
شیء پروفایلی را که پیشتر با استفاده از RegisterProfile ثبت شده است لغو ثبت میکند.
پارامتر مسیر شیء باید با همان مقداری که هنگام ثبت استفاده شده است مطابقت داشته باشد.
خطاهای احتمالی:
| October 2023 | BlueZ |