از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
بلوتوث
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Android یک پشته بلوتوث پیش‌فرض ارائه می‌کند که از بلوتوث کلاسیک و بلوتوث کم انرژی (BLE) پشتیبانی می‌کند. با استفاده از بلوتوث، دستگاه‌های Android می‌توانند شبکه‌های منطقه‌ای شخصی برای ارسال و دریافت داده‌ها با دستگاه‌های بلوتوث نزدیک ایجاد کنند.
در اندروید 4.3 و بالاتر، پشته بلوتوث اندروید قابلیت پیاده سازی BLE را فراهم می کند. برای استفاده کامل از APIهای BLE، الزامات Android Bluetooth HCI را دنبال کنید. دستگاه‌های اندرویدی با چیپست واجد شرایط می‌توانند بلوتوث کلاسیک یا بلوتوث کلاسیک و BLE را پیاده‌سازی کنند. BLE با چیپست های بلوتوث قدیمی سازگار نیست.
در Android 8.0، پشته بلوتوث کاملاً برای بلوتوث 5 واجد شرایط است. برای استفاده از ویژگی‌های موجود بلوتوث 5، دستگاه باید چیپست دارای بلوتوث 5 باشد.
معماری اندروید
یک برنامه بلوتوث از طریق Binder با فرآیند بلوتوث ارتباط برقرار می کند. فرآیند بلوتوث از رابط بومی جاوا (JNI) برای برقراری ارتباط با پشته بلوتوث استفاده می کند و به توسعه دهندگان امکان دسترسی به پروفایل های مختلف بلوتوث را می دهد. این نمودار ساختار کلی پشته بلوتوث را نشان می دهد:
شکل 1. معماری بلوتوث اندروید.
- چارچوب برنامه
- در سطح چارچوب برنامه، کد برنامه وجود دارد که از API های
android.bluetooth برای تعامل با سخت افزار بلوتوث استفاده می کند. در داخل، این کد فرآیند بلوتوث را از طریق مکانیزم Binder IPC فراخوانی می کند. - برنامه بلوتوث
- برنامه بلوتوث، واقع در
packages/modules/Bluetooth/android/app ، به‌عنوان یک برنامه اندروید بسته‌بندی شده است و نمایه‌های بلوتوث را در لایه چارچوب Android پیاده‌سازی می‌کند. این برنامه از طریق JNI به پشته بلوتوث تماس می گیرد. - JNI
- کد JNI مرتبط با
android.bluetooth در packages/modules/Bluetooth/android/app/jni قرار دارد. کد JNI هنگامی که عملیات بلوتوث خاصی رخ می دهد، مانند زمانی که دستگاه ها کشف می شوند، به پشته بلوتوث فراخوانی می شود. - پشته بلوتوث
- پشته بلوتوث پیش‌فرض در AOSP ارائه شده است و در
packages/modules/Bluetooth/system قرار دارد. پشته HAL بلوتوث عمومی را پیاده سازی می کند و آن را با برنامه های افزودنی و تغییرات پیکربندی سفارشی می کند. - پیاده سازی فروشنده
- دستگاه های فروشنده با استفاده از زبان تعریف رابط HAL (HIDL) با پشته بلوتوث تعامل دارند.
HIDL
HIDL رابط بین پشته بلوتوث و پیاده سازی فروشنده را تعریف می کند. برای تولید فایل های بلوتوث HIDL، فایل های رابط بلوتوث را به ابزار تولید HIDL منتقل کنید. فایل های رابط در hardware/interfaces/bluetooth قرار دارند.
توسعه پشته بلوتوث
پشته بلوتوث Android یک پشته بلوتوث کاملاً واجد شرایط است. فهرست صلاحیت در وب سایت Bluetooth SIG (نیاز به ورود به سیستم) تحت QDID 169365 است.
پشته بلوتوث هسته در packages/modules/Bluetooth قرار دارد. توسعه در AOSP اتفاق می‌افتد و از مشارکت‌ها استقبال می‌شود.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-08-22 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-22 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Bluetooth\n\nAndroid provides a default Bluetooth stack that supports both Classic Bluetooth and Bluetooth\nLow Energy (BLE). Using Bluetooth, Android devices can create personal area networks to send\nand receive data with nearby Bluetooth devices.\n\n\nIn Android 4.3 and higher, the Android Bluetooth stack provides the ability to implement\nBLE. To fully use the BLE APIs, follow the\n[Android Bluetooth HCI Requirements](/docs/core/connect/bluetooth/hci_requirements). Android devices with a qualified chipset can implement either Classic Bluetooth or both\nClassic Bluetooth and BLE. BLE isn't backward compatible with older Bluetooth chipsets.\n\n\nIn Android 8.0, the Bluetooth stack is fully qualified for Bluetooth 5. To use\navailable Bluetooth 5 features, the device needs to have a Bluetooth 5 qualified chipset.\n\nAndroid architecture\n--------------------\n\n\nA Bluetooth app communicates with the Bluetooth process through Binder. The Bluetooth\nprocess uses Java Native Interface (JNI) to communicate with the Bluetooth stack and provides\ndevelopers with access to various Bluetooth profiles. This diagram shows the general\nstructure of the Bluetooth stack:\n\n**Figure 1.** Android Bluetooth architecture.\n\napp framework\n:\n At the app framework level is app code, which uses the\n [`android.bluetooth`](http://developer.android.com/reference/android/bluetooth/package-summary.html)\n APIs to interact with the Bluetooth hardware. Internally, this code calls the Bluetooth\n process through the Binder IPC mechanism.\n\nBluetooth app\n:\n The Bluetooth app, located in `packages/modules/Bluetooth/android/app`,\n is packaged as an Android app and implements the Bluetooth profiles at the Android framework\n layer. This app calls into the Bluetooth stack through JNI.\n\nJNI\n:\n The JNI code associated with `android.bluetooth` is located in\n `packages/modules/Bluetooth/android/app/jni`. The JNI code calls into the\n Bluetooth stack when certain Bluetooth operations occur, such as when devices are\n discovered.\n\nBluetooth stack\n:\n The default Bluetooth stack is provided in AOSP and is located in\n `packages/modules/Bluetooth/system`. The stack implements the generic Bluetooth\n HAL and customizes it with extensions and configuration changes.\n\nvendor implementation\n:\n Vendor devices interact with the Bluetooth stack using the HAL interface definition\n language (HIDL).\n\n### HIDL\n\n\n[HIDL](/docs/core/architecture/hidl) defines the interface between the\nBluetooth stack and the vendor implementation. To generate the Bluetooth HIDL files, pass the\nBluetooth interface files into the HIDL generation tool. The interface files are located in\n[`hardware/interfaces/bluetooth`](https://android.googlesource.com/platform/hardware/interfaces/+/android16-release/bluetooth/).\n\n### Bluetooth stack development\n\n\nThe Android Bluetooth stack is a fully qualified Bluetooth stack. The qualification listing is\non the Bluetooth SIG website (requires sign-in) under\n[QDID 169365](https://launchstudio.bluetooth.com/ListingDetails/130825).\n\n\nThe core Bluetooth stack resides in\n[packages/modules/Bluetooth](https://cs.android.com/android/platform/superproject/+/android-latest-release:packages/modules/Bluetooth/). Development happens in AOSP, and contributions are welcome."]]
