Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release thay vì aosp-main để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.

Trang này được dịch bởi Cloud Translation API.

Bluetooth

Android cung cấp một ngăn xếp Bluetooth mặc định hỗ trợ cả Bluetooth cổ điển và Bluetooth năng lượng thấp. Bằng Bluetooth, các thiết bị Android có thể tạo mạng khu vực cá nhân để gửi và nhận dữ liệu với các thiết bị Bluetooth ở gần.

Trong Android 4.3 trở lên, ngăn xếp Bluetooth của Android cung cấp khả năng triển khai Bluetooth năng lượng thấp (BLE). Để sử dụng đầy đủ các API BLE, hãy làm theo Yêu cầu về HCI Bluetooth của Android. Các thiết bị Android có chipset đủ tiêu chuẩn có thể triển khai Bluetooth truyền thống hoặc cả Bluetooth truyền thống và BLE. BLE không tương thích ngược với các chipset Bluetooth cũ.

Trong Android 8.0, ngăn xếp Bluetooth hoàn toàn đủ điều kiện cho Bluetooth 5. Để sử dụng các tính năng Bluetooth 5 hiện có, thiết bị cần có một chipset đạt tiêu chuẩn Bluetooth 5.

Cấu trúc Android

Ứng dụng Bluetooth giao tiếp với quy trình Bluetooth thông qua Binder. Quy trình Bluetooth sử dụng JNI để giao tiếp với ngăn xếp Bluetooth và cho phép nhà phát triển truy cập vào nhiều cấu hình Bluetooth. Sơ đồ này cho thấy cấu trúc chung của ngăn xếp Bluetooth:

Sơ đồ minh hoạ các lớp của ngăn xếp Bluetooth trên Android.

Hình 1. Cấu trúc Bluetooth của Android.

khung ứng dụng: Ở cấp độ khung ứng dụng là mã ứng dụng, sử dụng các API android.bluetooth để tương tác với phần cứng Bluetooth. Trong nội bộ, mã này gọi quy trình Bluetooth thông qua cơ chế Binder IPC.
Ứng dụng Bluetooth: Ứng dụng Bluetooth, nằm trong packages/modules/Bluetooth/android/app, được đóng gói dưới dạng một ứng dụng Android và triển khai các hồ sơ Bluetooth ở lớp khung Android. Ứng dụng này gọi vào ngăn xếp Bluetooth thông qua JNI.
JNI: Mã JNI liên kết với android.bluetooth nằm trong packages/modules/Bluetooth/android/app/jni. Mã JNI gọi vào ngăn xếp Bluetooth khi một số thao tác Bluetooth xảy ra, chẳng hạn như khi các thiết bị được phát hiện.
Ngăn xếp Bluetooth: Ngăn xếp Bluetooth mặc định được cung cấp trong AOSP và nằm trong packages/modules/Bluetooth/system. Ngăn xếp này triển khai HAL Bluetooth chung và tuỳ chỉnh HAL đó bằng các tiện ích và thay đổi về cấu hình.
triển khai của nhà cung cấp: Các thiết bị của nhà cung cấp tương tác với ngăn xếp Bluetooth bằng Ngôn ngữ thiết kế giao diện phần cứng (HIDL).

HIDL

HIDL xác định giao diện giữa ngăn xếp Bluetooth và quá trình triển khai của nhà cung cấp. Để tạo các tệp HIDL Bluetooth, hãy truyền các tệp giao diện Bluetooth vào công cụ tạo HIDL. Các tệp giao diện nằm trong hardware/interfaces/bluetooth.

Phát triển ngăn xếp Bluetooth

Ngăn xếp Bluetooth Android là một ngăn xếp Bluetooth đủ điều kiện. Danh sách các tiêu chuẩn có trên trang web của Bluetooth SIG trong phần QDID 169365.

Ngăn xếp Bluetooth cốt lõi nằm trong packages/modules/Bluetooth. Quá trình phát triển diễn ra trong AOSP và chúng tôi hoan nghênh mọi đóng góp.

Cấu trúc Android 7.x trở xuống

Một dịch vụ hệ thống Bluetooth giao tiếp với ngăn xếp Bluetooth thông qua JNI và với các ứng dụng thông qua Binder IPC. Dịch vụ hệ thống cung cấp cho nhà phát triển quyền truy cập vào nhiều hồ sơ Bluetooth. Sơ đồ này cho thấy cấu trúc chung của ngăn xếp Bluetooth:

Sơ đồ các lớp kiến trúc Bluetooth của Android 7.x trở xuống.

Hình 2. Cấu trúc Bluetooth của Android 7.x trở xuống.

khung ứng dụng: Ở cấp độ khung ứng dụng là mã ứng dụng, sử dụng các API android.bluetooth để tương tác với phần cứng Bluetooth. Trong nội bộ, mã này gọi quy trình Bluetooth thông qua cơ chế Binder IPC.
Dịch vụ hệ thống Bluetooth: Dịch vụ hệ thống Bluetooth, nằm trong packages/apps/Bluetooth, được đóng gói dưới dạng một ứng dụng Android và triển khai dịch vụ cũng như hồ sơ Bluetooth ở lớp khung Android. Ứng dụng này gọi vào lớp HAL thông qua JNI.
JNI: Mã JNI liên kết với android.bluetooth nằm trong packages/apps/Bluetooth/jni. Mã JNI gọi vào lớp HAL và nhận các lệnh gọi lại từ HAL khi một số thao tác Bluetooth nhất định xảy ra, chẳng hạn như khi các thiết bị được phát hiện.
HAL: Lớp trừu tượng phần cứng xác định giao diện tiêu chuẩn mà các API android.bluetooth và quy trình Bluetooth gọi vào, đồng thời bạn phải triển khai để phần cứng Bluetooth của mình hoạt động đúng cách. Tệp tiêu đề cho HAL Bluetooth là hardware/libhardware/include/hardware/bluetooth.h. Ngoài ra, hãy xem xét tất cả các tệp hardware/libhardware/include/hardware/bt_*.h.
Ngăn xếp Bluetooth: Ngăn xếp Bluetooth mặc định được cung cấp cho bạn và nằm trong system/bt. Ngăn xếp này triển khai HAL Bluetooth chung và tuỳ chỉnh HAL đó bằng các tiện ích cũng như thay đổi về cấu hình.
tiện ích của nhà cung cấp: Để thêm các tiện ích tuỳ chỉnh và một lớp HCI để theo dõi, bạn có thể tạo một mô-đun libbt-vendor và chỉ định các thành phần này.

Triển khai HAL

HAL Bluetooth nằm trong /hardware/libhardware/include/hardware/bluetooth.h. Tệp bluetooth.h chứa giao diện cơ bản cho ngăn xếp Bluetooth và bạn phải triển khai các hàm của tệp này.

Các tệp dành riêng cho hồ sơ nằm trong cùng một thư mục. Để biết thông tin chi tiết, hãy xem Tài liệu tham khảo về tệp HAL.