روش‌ها (METHODS)

void Release()

این متد زمانی فراخوانی می‌شود که bluetoothd(8) ثبت عامل (agent) را لغو کند.

یک عامل می‌تواند از آن برای انجام وظایف پاک‌سازی استفاده کند. نیازی به لغو ثبت عامل نیست، زیرا هنگام فراخوانی این متد، ثبت آن از پیش لغو شده است.

string RequestPinCode(object device)

این متد زمانی فراخوانی می‌شود که bluetoothd(8) برای یک احراز هویت نیاز به دریافت کلید عبور (passkey) داشته باشد.

مقدار بازگشتی باید رشته‌ای به طول ۱-۱۶ نویسه باشد. این رشته می‌تواند حرفی-عددی (alphanumeric) باشد.

خطاهای احتمالی:

void DisplayPinCode(object device, string pincode)

این متد زمانی فراخوانی می‌شود که bluetoothd(8) نیاز به نمایش یک پین‌کد (pincode) برای احراز هویت داشته باشد.

باید یک پاسخ خالی بازگردانده شود. هنگامی که دیگر نیازی به نمایش پین‌کد نباشد، متد Cancel عامل فراخوانی خواهد شد.

این متد در طول فرایند جفت‌سازی صفحه‌کلیدهایی استفاده می‌شود که از «جفت‌سازی ساده و امن» (Secure Simple Pairing) بلوتوث ۲.۱ پشتیبانی نمی‌کنند، در مقابل DisplayPasskey که برای صفحه‌کلیدهای دارای این قابلیت به کار می‌رود.

این متد همواره تنها یک بار فراخوانی خواهد شد، زیرا صفحه‌کلیدهای قدیمی‌تر از اعلان تایپ (typing notification) پشتیبانی نمی‌کنند.

توجه داشته باشید که PIN همواره یک عدد ۶-رقمی خواهد بود که با افزودن صفر به سمت چپ به ۶ رقم تکمیل می‌شود (zero-padded). این کار برای هماهنگی با مشخصات نسخه‌های بعدی است.

خطاهای احتمالی:

uint32 RequestPasskey(object device)

این متد زمانی فراخوانی می‌شود که bluetoothd(8) برای یک احراز هویت نیاز به دریافت کلید عبور (passkey) داشته باشد.

مقدار بازگشتی باید یک مقدار عددی بین ۰-۹۹۹۹۹۹ باشد.

خطاهای احتمالی:

void DisplayPasskey(object device, uint32 passkey, uint16 entered)

این متد زمانی فراخوانی می‌شود که bluetoothd(8) نیاز به نمایش یک کلید عبور (passkey) برای احراز هویت داشته باشد.

پارامتر entered نشان‌دهنده تعداد کلیدهای تایپ‌شده تاکنون در طرف راه دور است.

باید یک پاسخ خالی بازگردانده شود. هنگامی که دیگر نیازی به نمایش کلید عبور نباشد، متد Cancel عامل فراخوانی خواهد شد.

در طول فرایند جفت‌سازی ممکن است این متد چندین بار فراخوانی شود تا مقدار entered به‌روزرسانی گردد.

توجه داشته باشید که کلید عبور همواره یک عدد ۶-رقمی خواهد بود، بنابراین اگر مقدار کمتر از ۶ رقم داشته باشد، نمایش آن در ابتدا باید با صفر تکمیل شود (zero-padded).

void RequestConfirmation(object device, uint32 passkey)

این متد زمانی فراخوانی می‌شود که bluetoothd(8) نیاز به تأیید یک کلید عبور برای احراز هویت داشته باشد.

برای تأیید مقدار، باید یک پاسخ خالی بازگردانده شود، یا در صورتی که کلید عبور نامعتبر باشد، یک خطا بازگردانده شود.

توجه داشته باشید که کلید عبور همواره یک عدد ۶-رقمی خواهد بود، بنابراین اگر مقدار کمتر از ۶ رقم داشته باشد، نمایش آن در ابتدا باید با صفر تکمیل شود (zero-padded).

خطاهای احتمالی:

void RequestAuthorization(object device)

این متد برای درخواست از کاربر جهت مجاز کردن تلاش جفت‌سازی ورودی فراخوانی می‌شود که در شرایط دیگر مدل just-works را فعال می‌کرد، یا زمانی که کاربر دستگاهی را متصل کرده است که جفت‌سازی کابلی (cable pairing) را پیاده‌سازی می‌کند. در حالت دوم، دستگاه هنوز از طریق بلوتوث به آداپتور متصل نشده است.

خطاهای احتمالی:

void AuthorizeService(object device, string uuid)

این متد زمانی فراخوانی می‌شود که bluetoothd(8) نیاز به مجاز کردن یک درخواست اتصال/سرویس داشته باشد.

خطاهای احتمالی:

void Cancel()

این متد برای نشان دادن اینکه درخواست عامل پیش از بازگرداندن پاسخ با شکست مواجه شده است، فراخوانی می‌شود.