Computer >> Hướng Dẫn Máy Tính >  >> Hệ Thống >> Android

Trình quét Bluetooth AOSP 16: Hướng dẫn kỹ thuật toàn diện

Trình quét Bluetooth AOSP 16: Hướng dẫn kỹ thuật toàn diện

Bluetooth - công nghệ mà chúng ta vừa yêu vừa ghét. Nó giống như người bạn luôn hứa sẽ kết nối nhưng rồi... không bao giờ làm được.

Suốt nhiều năm, các nhà phát triển Android đã trải qua một mối tình đầy kịch tính, thường bi thương với Bluetooth. Chúng ta vật lộn với những đặc điểm kỳ quặc, van xin nó hoạt động, và thầm rơi nước mắt trước những ngắt kết nối bí ẩn.

Nhưng nếu tôi nói mọi thứ sắp tốt hơn? Nếu tôi nói rằng với Android 16, các vị thần Bluetooth cuối cùng đã mỉm cười với chúng ta? Đó không phải giấc mơ. Đó là Trình quét Bluetooth AOSP 16, và nó mang lại hy vọng mới cho những tâm hồn nhà phát triển mệt mỏi.

Trong cuốn sổ tay này, chúng ta sẽ cùng đi một hành trình. Hành trình vào tâm điểm của các tính năng Bluetooth mới trong AOSP 16. Chúng ta sẽ cười, sẽ khóc (hy vọng là vì vui), và học cách vận dụng những sức mạnh mới này cho mục đích tốt. Chúng ta sẽ khám phá phép màu của quét thụ động, bi kịch của lý do mất liên kết, và sự tiện lợi tuyệt vời của việc lấy UUID dịch vụ mà không cần những rắc rối thông thường.

Cuối cuốn sách này, bạn sẽ có thể:

  • Xây dựng một trình quét Bluetooth hiệu quả đến mức gần như có khả năng dự đoán.

  • Gỡ lỗi các vấn đề kết nối như một thám tử dày dạn kinh nghiệm.

  • Làm cho bạn bè và đồng nghiệp ngạc nhiên với trình độ Bluetooth mới của bạn.

Điều kiện tiên quyết:

Trước khi đi sâu, bạn nên có hiểu biết cơ bản về phát triển Android và Kotlin. Nếu bạn từng cố gắng làm cho hai thiết bị nói chuyện với nhau và cuối cùng muốn ném máy tính ra cửa sổ, bạn hoàn toàn đủ điều kiện.

Vậy hãy chuẩn bị đồ uống yêu thích, mặc cho mình chiếc áo choàng lập trình, và sẵn sàng cho sự thức tỉnh của Bluetooth!

Mục lục

  1. Lịch sử ngắn gọn về Bluetooth trong Android

  2. Điều gì mới trong AOSP 16: Ba Kiếm sĩ

  3. Đi sâu #1: Quét thụ động

  4. Hiểu về BluetoothLeScanner

  5. Thực hành: Xây dựng trình quét thụ động đầu tiên

  6. Đi sâu #2: Lý do mất liên kết Bluetooth

  7. Đi sâu #3: UUID dịch vụ từ quảng cáo

  8. Chủ đề nâng cao: Nâng cao trò chơi quét của bạn

  9. Các trường hợp sử dụng thực tế: Nơi Bluetooth chạm đường

  10. Kiểm tra phiên bản API: Cách không làm sập ứng dụng

  11. Kiểm thử và gỡ lỗi: Phần vui (không ai từng nói)

  12. Hiệu suất và thực hành tốt nhất: Cách trở thành công dân Bluetooth tốt

  13. Kết luận: Tương lai là thụ động (và đó là ổn)

Lịch sử ngắn gọn về Bluetooth (Hoặc: Làm sao chúng ta học cách ngừng lo lắng và yêu sóng radio)

Thời kỳ đen tối: Bluetooth Classic

Ban đầu có Bluetooth Classic. Nó là đối ứng số của một khách dự tiệc ồn ào, phóng khoáng. Nó có thể truyền nhiều dữ liệu (như bài hát yêu thích đến loa), nhưng lại cực kỳ tốn pin. Nó tuyệt vời cho phát âm thanh, nhưng đối với truyền dữ liệu nhỏ, gián đoạn? Nó giống như dùng vòi chữa cháy để tưới cây bonsai. Quá mức, và thẳng thắn nói là hơi rối rắm.

Các nhà phát triển thời đó dành ngày tháng vật lộn với BluetoothAdapter, BluetoothDevice, và BluetoothSocket đáng sợ. Đó là thời kỳ bất định lớn, nơi một kết nối đơn giản có thể mất vài giây, hoặc... nói thẳng ra là bạn có thể đi pha một ly cà phê. Và hao pin? Người dùng sẽ thấy mức pin thiết bị giảm nhanh như quả bóng chì.

Thời kỳ Phục hưng: Xuất hiện Bluetooth Low Energy (BLE)

Rồi, với Android 4.3, một anh hùng mới xuất hiện: Bluetooth Low Energy, hay BLE. Đây không phải Bluetooth của bố bạn. BLE tinh tế, hiệu quả, và bí ẩn. Nó được thiết kế cho các đợt truyền dữ liệu ngắn, nhấp nháp năng lượng như rượu vang thay vì cạn chén.

BLE là đứa trẻ cool trên khối. Nó giới thiệu cho chúng ta một thế giới mới đầy khả năng: màn hình nhịp tim, đồng hồ thông minh, và hàng triệu thiết bị IoT có thể chạy hàng tháng trên một pin c. Đó là bước ngoặt.

Nhưng sức mạnh lớn đi kèm với... sự phức tạp lớn. Chúng ta phải học một ngôn ngữ hoàn toàn mới về GATT, GAP, dịch vụ, và đặc tính. Nó giống như chuyển từ viết script đơn giản sang soạn một vở opera đầy đủ. Tiềm năng khổng lồ, nhưng đường cong học tập dốc.

Đứa trẻ gây rắc rối: Quét

Và rồi có quét. Hành động tìm kiếm những thiết bị mới tiết kiệm năng lượng này. Trong những ngày đầu của BLE, quét vẫn còn hơi hoang dã. Nó là một quá trình chủ động, ồn ào. Điện thoại bạn sẽ hét vào hư không, "CÓ AI Ở ĐÂY KHÔNG?", rồi lắng nghe phản hồi. Điều này hoạt động, nhưng vẫn tiêu tốn đáng kể pin, đặc biệt nếu ứng dụng cần quét trong thời gian dài.

Đó là bài toán kinh điển của nhà phát triển: bạn cần tìm thiết bị, nhưng không muốn là lý do điện thoại người dùng hết pin trước giờ trưa. Suốt nhiều năm, chúng ta đi dây dây này, cân bằng nhu cầu khám phá với lời cầu nguyện cho pin. Đây là thế giới mà AOSP 16 sinh ra. Một thế giới kêu gọi cách quét tốt hơn. Một thế giới sẵn sàng cho một anh hùng. Và anh hùng đó, các bạn ơi, là quét thụ động. Nhưng sẽ nói sau...

Điều gì mới trong AOSP 16? (Spoiler: Thực sự cool)

Được, hãy đến phần hay. Những món đồ mới bóng bẩy nào mà đội Android tặng chúng ta trong AOSP 16? Thực ra là khá nhiều! Nhưng trước khi bóc quà, hãy nói về lịch phát hành mới, vì ngay cả nó cũng hơi khác.

Câu chuyện của hai bản phát hành

Trong một cú twist sốc, Android quyết định ban cho chúng ta hai bản phát hành API lớn trong 2025. Trước tiên là sự kiện chính, Android 16 (tên mã "Baklava", vì ai không thích một cái bánh ngon?), ra mắt quý 2. Đây là bản phát hành truyền thống, lớn, với tất cả thay đổi hành vi mà bạn đã biết và yêu (hoặc sợ).

Nhưng rồi, quý 4, chúng ta nhận được một màn thứ hai bất ngờ: một bản phát hành nhỏ, và đó là nơi các tính năng Bluetooth mới của chúng ta xuất hiện. Bản phát hành này tập trung vào tính năng và API mới, không có những thay đổi đáng sợ, phá vỡ ứng dụng. Nó giống như được tặng miễn phí món tráng miệng sau khi đã thanh toán.

Ba Kiếm sĩ của Bluetooth

Vậy bản phát hành quý 4 mang gì đến bữa tiệc Bluetooth? Tôi vui vì bạn hỏi. Nó mang ba anh hùng mới, sẵn sàng cứu chúng ta khỏi nỗi khổ Bluetooth. Tôi gọi họ... Ba Kiếm sĩ.

Tính năngTóm tắtTại sao bạn nên quan tâm
Quét thụ độngKhả năng lắng nghe thiết bị Bluetooth mà không cần "hét" vào mặt chúng.Ứng dụng của bạn giờ là một ninja tiết kiệm pin, lặng lẽ.
Lý do mất liên kếtCuối cùng có lý do tại sao kết nối Bluetooth của bạn tan vỡ.Bạn có thể ngừng đoán mò và thực sự gỡ lỗi vấn đề kết nối.
UUID dịch vụ từ Quảng cáoLấy thông tin sống còn của thiết bị trực tiếp từ quảng cáo.Giống như hẹn hò nhanh cho thiết bị Bluetooth. Kết nối nhanh hơn, hiệu quả hơn.

Đây không chỉ là điều chỉnh nhỏ. Đây là cải tiến chất lượng cuộc sống sẽ thay đổi cơ bản cách chúng ta xây dựng và gỡ lỗi ứng dụng hỗ trợ Bluetooth. Giống như đội Android thực sự lắng nghe những tiếng kêu cứu tập thể của chúng ta. (Tôi biết, tôi cũng sốc.)

Trong các phần tiếp theo, chúng ta sẽ tiếp xúc gần gũi với từng tính năng mới. Chúng ta sẽ đi sâu vào code, khám phá trường hợp sử dụng, và học cách khai thác sức mạnh của chúng. Vậy hãy sẵn sàng gặp kiếm sĩ đầu tiên: người mạnh mẽ, lặng lẽ được gọi là Quét thụ động.

Đi sâu #1: Quét thụ động

Hãy tưởng tượng bạn đang ở thư viện. Bạn tìm một người bạn nhưng không biết họ ở đâu. Bạn có hai lựa chọn:

  • Quét chủ động: Bạn đứng giữa thư viện và hét, "Ê, STEVE! BẠN CÓ Ở ĐÂY KHÔNG?" Hiệu quả, nhưng ồn ào, làm phiền, và sẽ bị thủ thư đuổi ra (người trong ví dụ này là pin người dùng).

  • Quét thụ động: Bạn đi nhẹ nhàng quanh thư viện, lắng nghe tiếng cười đặc trưng, khò khè của người bạn. Bạn không nói một lời. Chỉ lắng nghe. Bí mật, hiệu quả, và không làm cạn kiệt pin xã hội (hoặc thực tế).

Suất nhiều năm, quét Bluetooth của Android là người đàn ông hét trong thư viện. Nhưng với AOSP 16, chúng ta cuối cùng có thể là người lặng lẽ lắng nghe. Đó là phép màu của quét thụ động.

Chủ động vs Thụ động: Cuộc đối đầu kỹ thuật

Trong thế giới BLE, thiết bị gửi đi các gói tin nhỏ gọi là "quảng cáo". Đó là cách chúng nói, "Hey, tôi ở đây, và tôi làm việc này!"

  • Quét chủ động: Khi điện thoại thực hiện quét chủ động, nó nghe quảng cáo rồi gửi lại SCAN_REQ (Yêu cầu quét). Nó nói, "Cho tôi biết thêm!" Thiết bị ngoại vi phản hồi bằng SCAN_RSP (Phản hồi quét), chứa thông tin bổ sung.

  • Quét thụ động: Với quét thụ động, điện thoại nghe quảng cáo... và đó là tất cả. Nó không gửi gì trở lại. Chỉ ghi nhận quảng cáo ban đầu và chuyển đi. Đó là cuộc hội thoại một chiều.

Tại sao chọn thụ động? Sức mạnh của sự im lặng

Vậy tại sao đây lại quan trọng? Hai từ: tiêu thụ năng lượng. Mỗi khi radio điện thoại phải truyền 무언가 (như SCAN_REQ), nó dùng năng lượng. Nếu ứng dụng quét thiết bị liên tục, những lần truyền nhỏ này cộng dồn, và pin người dùng trả giá.

Bằng cách chuyển sang quét thụ động, bạn bảo radio chỉ lắng nghe. Không nói, chỉ nghe. Giảm đáng kể năng lượng cần cho quét, làm cho nó trở thành giải pháp hoàn hảo cho ứng dụng cần theo dõi thiết bị gần đó trong thời gian dài.

Code: Cách trở thành Ninja Bluetooth

Vậy làm sao triển khai chế độ ninja mới này? Nó đơn giản bất ngờ. Tất cả归结为 ScanSettings bạn dùng khi bắt đầu quét.

Trước đây, bạn có thể làm như sau:

val settings = ScanSettings.Builder() .setScanMode(ScanSettings.SCAN_MODE_LOW_LATENCY) .build() 

Giờ, với AOSP 16, chúng ta có tùy chọn mới. Để bật quét thụ động, bạn chỉ cần đặt loại quét:

// Dòng phép màu này! .setScanMode(ScanSettings.SCAN_TYPE_PASSIVE) 

Đợi, đó không đúng. Tài liệu nói SCAN_TYPE_PASSIVE là loại quét, không phải chế độ quét. Bạn đúng! Xin lỗi, tôi hơi quá hứng. Cách đúng là đặt chế độ quét thành thụ động. Thử lại.

val settings = ScanSettings.Builder() // Dòng phép màu thực sự! .setScanMode(ScanSettings.SCAN_MODE_OPPORTUNISTIC) // Gần nhất với thụ động .build() 

Đợi, cũng không đúng. Tôi bị nhầm lẫn. Hãy tra cứu văn kiện chính thức... À, đây rồi! ScanSettings.Builder có phương thức mới trong Android 16 QPR2. Không phải setScanMode, mà là một cài đặt hoàn toàn mới.

Hãy làm đúng một lần cho tất cả. Đây là cách chính xác để bật quét thụ động:

// Có sẵn trong Android 16 QPR2 trở lên val settings = ScanSettings.Builder() // Dòng phép màu THỰC SỰ, tôi hứa! .setScanType(ScanSettings.SCAN_TYPE_PASSIVE) .build() 

Và xong. Với một dòng đó, bạn biến ứng dụng từ du khách ồn ào, tốn pin thành ninja Bluetooth lặng lẽ, hiệu quả. Pin người dùng sẽ cảm ơn bạn.

Tất nhiên, có đánh đổi. Vì bạn không gửi SCAN_REQ, bạn không nhận dữ liệu thêm từ SCAN_RSP. Nhưng với nhiều trường hợp, quảng cáo ban đầu là đủ. Và tiết kiệm pin đáng giá.

Bây giờ chúng ta đã thành thạo nghệ thuật quét im lặng, hãy chuyển sang mảnh ghép tiếp theo: hiểu về BluetoothLeScanner.

Hiểu về BluetoothLeScanner (Ngôi sao của buổi trình diễn)

Trước khi thành thạo quét Bluetooth, chúng ta phải hiểu vũ khí chính: BluetoothLeScanner. Hãy coi nó như máy PKE Meter trong Ghostbusters. Đó là công cụ chúng ta dùng để phát hiện năng lượng vô hình (trong trường hợp này là quảng cáo BLE) trôi lửng xung quanh. Nhưng thiết bị săn ma này thực sự hoạt động như thế nào?

Kiến trúc: Nhìn sau màn che

Ở mức cao, quy trình khá đơn giản. Ứng dụng của bạn, sống thoải mái trong thế giới nhỏ, quyết định tìm thiết bị BLE. Nó lấy instance của BluetoothLeScanner và nói, "Hey, đi tìm đồ."

Dưới mui, nhiều thứ xảy ra. BluetoothLeScanner nói với Bluetooth stack của Android (tên mã "Fluoride", nghe như thứ nha sĩ sẽ tự hào). Stack sau đó giao tiếp với Bluetooth controller của thiết bị, phần cứng thực sự gửi và nhận sóng radio. Đó là trường hợp kinh điển "phức tạp hơn vẻ ngoài".

Bổn chữ cái: GATT, GAP, và bạn bè

Khi bạn bước vào thế giới BLE, bạn nhanh chóng gặp một đống viết tắt. Đừng hoảng loạn! Chúng không đáng sàng như vẻ ngoài. Hai quan trọng nhất là GAP và GATT.

  • GAP (Generic Access Profile): Là về cách thiết bị khám phá và kết nối nhau. Hãy coi GAP như bảo vệ quán bar. Nó quyết định ai được nói chuyện với ai. Nó quản lý quảng cáo (thiết bị hét "Tôi ở đây!") và quét (ứng dụng lắng nghe những tiếng hét). BluetoothLeScanner của chúng ta là người chơi chủ chốt trong thế giới GAP.

  • GATT (Generic Attribute Profile): Khi hai thiết bị đã kết nối, GATT übernehmen. Nó định nghĩa cách trao đổi dữ liệu. Hãy coi GATT như cuộc hội thoại thực sự bên trong quán bar. Nó về Dịch vụ, Đặc tính, và Mô tả. Thiết bị có thể có "Dịch vụ nhịp tim", chứa "Đặc tính đo nhịp tim". Ứng dụng đọc/ghi vào các đặc tính này để lấy dữ liệu.

Đối với quét, chúng ta chủ yếu sống trong thế giới GAP. Chúng ta là người đứng ngoài quán, lắng nghe những quảng cáo thú vị.

Vòng đời quét: Một vở kịch ba màn

Cuộc đời của một lần quét Bluetooth là một vở kịch đơn giản, nhẹ nhàng.

  • Màn I: Chuẩn bị. Ứng dụng quyết định đến lúc quét. Nó lấy BluetoothLeScanner, tạo ScanFilters (chỉ tìm thiết bị cụ thể) và ScanSettings (định nghĩa cách quét, như chế độ thụ động mới), và định nghĩa ScanCallback.

  • Màn II: Quét. Ứng dụng gọi startScan(). Radio Bluetooth bật lên, lắng nghe quảng cáo khớp bộ lọc. Khi tìm thấy, báo cáo về ứng dụng qua onScanResult() trong ScanCallback.

  • Màn III: Kết thúc. Khi ứng dụng đã đủ (hoặc quan trọng hơn, đã tìm thấy thứ cần), nó gọi stopScan(). Radio tắt, mọi thứ yên tĩnh. Luôn luôn dừng quét khi xong. Quét mồ côi là nguyên nhân số một của khiếu nại "pin chết trong một giờ".

Đó là BluetoothLeScanner trong vỏ hạt dẻ. Cửa ngõ đến thế giới khám phá BLE. Nó mạnh mẽ, phức tạp, nhưng như chúng ta đang học, nó ngày càng thông minh, hiệu quả với mỗi bản phát hành Android. Bây giờ chúng ta biết công cụ, hãy bám tay vào code và xây dựng trình quét thụ động đầu tiên!

Thực hành: Xây dựng trình quét thụ động đầu tiên

Lý thuyết hay, nhưng thật lòng, chúng ta là nhà phát triển. Chúng ta học bằng cách làm (hoặc copy paste từ Stack Overflow). Đã đến lúc vác tay áo, bật Android Studio, và xây dựng cái gì đó. Chúng ta sẽ tạo app đơn giản dùng sức mạnh quét thụ động mới để tìm thiết bị BLE gần đó.

Bước 1: Lễ truy vấn quyền hạn

Trước khi viết một dòng Kotlin, chúng ta phải thỏa mãn các vị thần quyền hạn Android. Đây là nghi thức thiêng liêng và thường gây bực bội. Đối với quét Bluetooth, quy tắc đã thay đổi một chút qua các năm.

Mở AndroidManifest.xml và thêm:

<uses-permission android:name="android.permission.BLUETOOTH" /> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" /> <!-- Cho Android 12 (API 31) trở lên --> <uses-permission android:name="android.permission.BLUETOOTH_SCAN" /> <!-- Cho phiên bản cũ, cần quyền vị trí --> <!-- Vẫn có thể cần nếu hỗ trợ thiết bị cũ --> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> 

Nhìn các quyền khai báo, bạn thấy sự tiến hóa của mô hình quyền Bluetooth Android diễn ra thực tế.

Hai quyền đầu, BLUETOOTH và BLUETOOTH_ADMIN, là lão vệ. Có từ đầu Android, cung cấp chức năng Bluetooth cơ bản và khám phá thiết bị. Sau đó là BLUETOOTH_SCAN, ra mắt Android 12 (API 31), đại diện cho sự chuyển dịch lớn trong cách Google nghĩ về quyền riêng tư.

Đúng, bạn thấy đấy. Xưa kia (trước Android 12), Google quyết định tìm thiết bị Bluetooth về cơ bản giống biết vị trí chính xác người dùng. Nó có lý: nếu bạn thấy beacon Bluetooth nào gần đó, bạn có thể tam giác vị trí. Nhưng cũng hơi rùng rợn khi app quét Bluetooth đơn giản xin quyền vị trí. Điều này dẫn đến tình huống khó xử: người dùng thấy app tìm tai nghe đơn giản xin vị trí chính xác và 당當 nhiên hoài nghi.

May mắn thay, Android 12 giới thiệu quyền BLUETOOTH_SCAN, hợp lý hơn. Quyền này cho phép app quét thiết bị Bluetooth mà không cần xin truy cập vị trí, hợp lý hơn từ góc độ người dùng. Bạn vẫn phải xin quyền này lúc runtime, nhưng ít nhất không phải giải thích tại sao app tìm gadget muốn biết bạn sống đâu.

Tuy nhiên, chú ý hai quyền vị trí cuối. Đó là di tích hệ thống cũ. Nếu app cần hỗ trợ thiết bị cũ chạy Android 11 trở xuống, bạn cần giữ quyền vị trí trong manifest để tương thích ngược. Trên thiết bị hiện đại, quyền BLUETOOTH_SCAN đơn lẻ đủ.

Bước 2: Code thức tỉnh

Được, đến phần vui. Dưới đây là cách triển khai trình quét thụ động trong Activity hoặc Fragment.

Lấy Scanner

Trước tiên, cần instance của BluetoothLeScanner.

private val bluetoothAdapter: BluetoothAdapter? by lazy { val bluetoothManager = getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager bluetoothManager.adapter } private val bleScanner: BluetoothLeScanner? by lazy { bluetoothAdapter?.bluetoothLeScanner } 

Hãy phân tích code trên. Chúng ta dùng lazy delegation của Kotlin, cách sang để nói "đừng tạo object này cho đến khi tôi thực sự cần". Thực hành tốt vì lấy Bluetooth adapter liên quan đến system call, và không cần làm việc đó nếu không dùng.

Trước tiên, lấy BluetoothManager từ system services. Coi BluetoothManager như người gác cổng mọi thứ Bluetooth trên thiết bị. Từ manager này, lấy BluetoothAdapter, đại diện cho phần cứng Bluetooth vật lý. Lưu ý khai báo nullable (BluetoothAdapter?) vì, tin hay không, không phải thiết bị Android nào cũng có Bluetooth. Một số tablet hoặc thiết bị lạ có thể không có phần cứng, nên cần chuẩn bị cho khả năng đó.

Khi có adapter, xin nó cho BluetoothLeScanner. Đây là object thực sự dùng để quét. Lại dùng safe call operator (?.) vì nếu adapter null (không có phần cứng Bluetooth), chắc chắn không lấy được scanner. Lập trình phòng thủ này có vẻ đa nghi, nhưng đó là ranh giới giữa app crash bí ẩn và app xử lý graceful các trường hợp biên.

Định nghĩa Callback

Đây là nơi phép màu xảy ra. ScanCallback là object lắng nghe kết quả quét. Cần override hai phương thức: onScanResult và onScanFailed.

private val scanCallback = object : ScanCallback() { override fun onScanResult(callbackType: Int, result: ScanResult) { // Tìm thấy thiết bị! // Object 'result' chứa device, RSSI, và dữ liệu quảng cáo. Log.d("BleScanner", "Found device: ${result.device.address}, RSSI: ${result.rssi}") } override fun onScanFailed(errorCode: Int) { // Cách của vũ trụ nói bạn nghỉ ngơi. // Hoặc có thứ gì đó sai tồi tệ. Log.e("BleScanner", "Scan failed with error code: $errorCode") } } 

ScanCallback chúng ta định nghĩa là "tai" của app trong thế giới Bluetooth. Khi scanner tìm thấy thiết bị, nó không chỉ lưu thông tin đâu, nó chủ động callback đến app qua object này. Đó là event-driven programming kinh điển, cách Android giữ app responsive mà không block main thread.

onScanResult được gọi mỗi khi scanner khám phá thiết bị khớp bộ lọc (hoặc mọi thiết bị nếu không dùng filter). Tham số result là kho báu thông tin. Chứa BluetoothDevice (có MAC address và tên), giá trị RSSI (Received Signal Strength Indicator - cơ bản là thiết bị gần bao nhiêu, số càng cao càng gần), và dữ liệu quảng cáo thô thiết bị phát sóng.

Trong ví dụ đơn giản, chúng ta chỉ log MAC address và RSSI, nhưng app thực tế sẽ muốn cập nhật UI, thêm thiết bị vào danh sách, hoặc kích hoạt kết nối.

Tham số callbackType cho bạn biết TẠI SAO callback được kích hoạt. Có thể là CALLBACK_TYPE_ALL_MATCHES (mặc định, nghĩa là "đây là mọi thiết bị tìm thấy"), CALLBACK_TYPE_FIRST_MATCH (lần đầu thấy thiết bị này), hoặc CALLBACK_TYPE_MATCH_LOST (không thấy thiết bị lâu rồi, nó có thể đã đi). Chúng ta sẽ đi sâu hơn ở phần nâng cao.

Rồi onScanFailed, phương thức chúng ta hy vọng không bao giờ được gọi nhưng bắt buộc phải xử lý. Được triệu hồi khi có chuyện tồi tệ với quét. Có thể Bluetooth adapter bị tắt giữa chừng, app thiếu quyền, hoặc Bluetooth controller đơn giản đang có ngày xui. errorCode sẽ gợi ý chuyện gì xảy ra, và bạn nên luôn log và xử lý graceful - có thể hiện thông báo cho người dùng hoặc thử khởi động lại quét sau delay.

Cấu hình quét

Bây giờ, tạo ScanSettings. Đây là nơi nói với Android chúng ta muốn là ninja thụ động, tiết kiệm pin.

val scanSettings = ScanSettings.Builder() .setScanMode(ScanSettings.SCAN_MODE_LOW_POWER) // Hãy tử tế với pin .setCallbackType(ScanSettings.CALLBACK_TYPE_ALL_MATCHES) .setMatchMode(ScanSettings.MATCH_MODE_AGGRESSIVE) .setNumOfMatches(ScanSettings.MATCH_NUM_ONE_ADVERTISEMENT) // Báo cáo mỗi quảng cáo một lần .setReportDelay(0L) // Báo cáo ngay lập tức // Và đây là ngôi sao của buổi trình diễn! .setScanType(ScanSettings.SCAN_TYPE_PASSIVE) .build() 

Object ScanSettings chúng ta xây dựng giống như sách hướng dẫn chi tiết cho scanner Bluetooth. Mỗi lời gọi phương thức tinh chỉnh chính xác cách quét nên hành xử, và việc cài đúng settings là khác biệt giữa app thân thiện pin và app bị gỡ cài trong vài giờ.

Hãy đi qua từng setting. Trước tiên, setScanMode(SCAN_MODE_LOW_POWER) bảo scanner dùng chế độ quét tiết kiệm năng lượng, nghĩa là quét theo khoảng thời gian thay vì liên tục. Hoàn hảo cho hầu hết trường hợp không cần kết quả tức thì và muốn bảo toàn pin. Scanner sẽ thức, quét một chút, ngủ, lặp lại. Đó là tương đương Bluetooth của giấc ngủ ngắn.

Tiếp, setCallbackType(CALLBACK_TYPE_ALL_MATCHES) nghĩa là muốn được thông báo mỗi khi scanner tìm thấy thiết bị khớp. Đây là hành vi mặc định và bạn sẽ dùng hầu hết thời gian. Như đã nói, bạn cũng có thể dùng CALLBACK_TYPE_FIRST_MATCH hoặc CALLBACK_TYPE_MATCH_LOST cho phát hiện hiện diện tinh vi hơn.

setMatchMode(MATCH_MODE_AGGRESSIVE) kiểm soát mức độ phần cứng cố gắng khớp thiết bị với filter của bạn. MATCH_MODE_AGGRESSIVE nghĩa là "báo khớp nhanh, ngay cả khi không 100% chắc", trong khi MATCH_MODE_STICKY nghĩa là "đợi đến khi thực sự chắc mới báo". Aggressive mode cho kết quả nhanh hơn nhưng có thể false positive đôi khi.

setNumOfMatches(MATCH_NUM_ONE_ADVERTISEMENT) bảo scanner báo cáo thiết bị sau khi thấy chỉ một quảng cáo từ nó. Lựa chọn thay thế là MATCH_NUM_FEW_ADVERTISEMENT, chờ nhiều quảng cáo trước khi báo. Dùng một quảng cáo cho khám phá nhanh hơn, chờ vài cái giảm false positive từ thiết bị chỉ đi qua.

setReportDelay(0L) rất quan trọng. Delay 0 nghĩa là "báo cáo kết quả ngay lập tức". Nếu đặt 5000 milliseconds, scanner sẽ gom kết quả và gửi mỗi 5 giây. Batching tốt cho quét background (như thảo luận phần nâng cao), nhưng quét foreground nơi người dùng chờ đợi chủ động, báo cáo ngay là điều bạn muốn.

Và cuối cùng, ngôi sao: setScanType(SCAN_TYPE_PASSIVE). Đây là API mới từ Android 16 QPR2 biến scanner thành người lặng lẽ lắng nghe. Thay vì chủ động gửi scan request cho mọi thiết bị nghe được, nó chỉ lắng nghe quảng cáo bay trong không khí. Cài đặt đơn lẻ này có thể giảm đáng kể tiêu thụ pin khi quét. Đó là tính năng chúng ta chờ đợi, và nó vinh quang.

Bắt đầu và dừng quét

Cuối cùng, cần hàm start và stop quét. Nhớ: LUÔN dừng quét! Quét bị quên là quái vật giết pin.

private fun startBleScan() { // Đừng quên xin quyền trước! if (bleScanner != null) { // Có thể thêm ScanFilters ở đây để tìm thiết bị cụ thể val scanFilters: List<ScanFilter> = listOf() bleScanner.startScan(scanFilters, scanSettings, scanCallback) Log.d("BleScanner", "Scan started.") } else { Log.e("BleScanner", "Bluetooth is not available.") } } private fun stopBleScan() { if (bleScanner != null) { bleScanner.stopScan(scanCallback) Log.d("BleScanner", "Scan stopped.") } } 

Hai hàm trên là công tắc bật/tắt scanner Bluetooth, và chúng đơn giản đến lừa dối cho tầm quan trọng của chúng. Hãy phân tích.

Trong startBleScan(), đầu tiên check bleScanner không null. Đây là lưới an toàn: nếu thiết bị không có phần cứng Bluetooth hoặc Bluetooth bị tắt, scanner sẽ null, và chúng ta không muốn crash bằng cách gọi method trên null object. Nếu scanner tồn tại, gọi startScan() với ba tham số: list ScanFilter, ScanSettings tỉ mỉ, và ScanCallback định nghĩa trước.

List scanFilters rỗng trong ví dụ nghĩa là "tìm TẤT CẢ thiết bị BLE". App thực tế, bạn thường thêm filter để thu hẹp tìm kiếm. Ví dụ, app chỉ làm việc với màn hình nhịp tim, bạn tạo filter chỉ khớp thiết bị quảng cáo Heart Rate Service UUID. Điều này quan trọng cho cả hiệu suất và pin: tại sao phải đánh thức app cho bàn chải điện Bluetooth ngẫu nhiên khi bạn chỉ quan tâm tracker thể thao?

startScan() khởi động quá trình quét. Từ thời điểm này, radio Bluetooth chủ động (hoặc trong trường hợp chúng ta, thụ động) lắng nghe quảng cáo, và scanCallback bắt đầu nhận kết quả. Đây là hoạt động bất đồng bộ, nghĩa là code không block chờ kết quả - nó tiếp tục thực thi, và kết quả đến qua callback khi có sẵn.

Bây giờ nói về stopBleScan(), có lẽ hàm quan trọng nhất bạn viết. Khi gọi stopScan() với callback, bạn nói với radio Bluetooth, "Ổn rồi, chúng ta xong, bạn có thể ngủ tiếp." Điều này dừng ngay quá trình quét và giải phóng tài nguyên.

Điều then chốt: nếu bạn không gọi nó, quét sẽ chạy vô thời hạn, hút pin người dùng như ma cà rồng tại quán ăn buffet máu không giới hạn. Đó là lý do chúng ta nhấn mạnh: lời gọi stopScan() bị quên là một trong những nguyên nhân phổ biến nhất của khiếu nại hao pin trong app Bluetooth.

Lưu ý chúng ta truyền cùng object scanCallback cho stopScan() như startScan(). Đó là cách Android biết dừng quét nào - bạn lý thuyết có thể chạy nhiều quét với callback khác nhau (dù hiếm khi hay). Luôn đảm bảo dừng đúng quét đã bắt đầu bằng cách dùng cùng tham chiếu callback.

Ghép tất cả lại

Đây là ví dụ hoàn chỉnh drop vào Activity. Chỉ nhớ xử lý runtime permission!

// Trong class Activity class MainActivity : AppCompatActivity() { // ... (lazy properties cho adapter và scanner như trên) override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) // ... setup UI ... // Ví dụ: Bắt đầu quét khi click nút val startButton = findViewById<Button>(R.id.startButton) startButton.setOnClickListener { // BẮT BUỘC xin quyền trước khi gọi! startBleScan() } // Ví dụ: Dừng quét khi click nút khác val stopButton = findViewById<Button>(R.id.stopButton) stopButton.setOnClickListener { stopBleScan() } } // ... (scanCallback, startBleScan, stopBleScan như trên) override fun onPause() { super.onPause() // LUÔN dừng quét khi activity không hiển thị. stopBleScan() } } 

Ví dụ hoàn chỉnh trên cho thấy cách các mảnh ghép vừa vặn trong Activity thực. Đây là trình quét Bluetooth tối thiểu nhưng chức năng mà bạn có thể chạy ngay. Hãy highlight vài pattern quan trọng.

Thứ nhất, chú ý cách gắn vòng đời quét với hành động người dùng qua click nút. Pattern phổ biến: người dùng rõ ràng bắt đầu/dừng quét, cho họ kiểm soát khi app dùng Bluetooth. Tốt cho UX và pin, vì quét chỉ chạy khi người dùng muốn.

Nhưng đây là phần QUAN TRỌNG: override onPause(). Đây là lưới an toàn quan trọng. Khi Activity vào background (người dùng bấm home, hoặc chuyển app khác), onPause() được gọi, và chúng ta dừng quét ngay. Điều này thiết yếu vì nếu người dùng không thấy app, họ không cần kết quả quét, và không lý do gì hao pin. Pattern này đảm bảo ngay cả khi người dùng quên bấm "Dừng", quét cũng không chạy mãi background.

Bạn có thể thắc mắc, "onResume() thì sao? Có nên restart quét khi người dùng quay lại không?" Đó là quyết định thiết kế. Một số app muốn tự động restart quét trong onResume(). App khác muốn người dùng bấm "Bắt đầu" lại rõ ràng. Tùy use case. App tìm thiết bị nơi người dùng chủ động tìm, auto-resume hợp lý. App giám sát chạy background, có thể muốn kiểm soát rõ ràng hơn.

Một điều quan trọng ví dụ không chỉ: xử lý runtime permission. Nhớ quyền khai báo trong manifest? Trên Android 6.0 trở lên, bạn không chỉ khai báo, phải thực sự xin từ người dùng lúc runtime. Trước khi gọi startBleScan(), check quyền cần thiết và nếu chưa có, xin qua ActivityCompat.requestPermissions(). Nếu thử start quét mà thiếu quyền, nó sẽ fail thầm (hoặc to tùy version Android), và bạn sẽ gãi đầu băn khoăn tại sao không hoạt động.

Và xong! Bạn vừa xây dựng trình quét Bluetooth thụ động AOSP 16 đầu tiên. Nó gọn gàng, mạnh mẽ, và cực kỳ tiết kiệm năng lượng. Scanner lặng lẽ lắng nghe quảng cáo BLE, báo cáo qua callback, và dừng graceful khi không cần.

Bây giờ, chuyển sang chủ đề tiếp theo: làm gì khi chuyện xui xảy ra. Đã đến lúc nói về chia tay... chia tay liên kết Bluetooth, đó là.

Đi sâu #2: Lý do mất liên kết Bluetooth

À, liên kết Bluetooth. Nó đẹp, thiêng liêng. Đó là tương đương số của việc trao đổi vòng tay tình bạn. Khi bạn liên kết điện thoại với tai nghe, bạn tạo mối quan hệ dài hạn, tin cậy. Chia sẻ khóa bí mật, nhớ nhau, và hứa kết nối tự động, cứu bạn khỏi rắc rối pair mỗi lần. Đó là mối tình đẹp.

Cho đến khi nó không còn nữa.

Đột ngột, một ngày, chúng... quên nhau. Kết nối mất. Niềm tin vỡ. Và app của bạn bị kẹt giữa chừng, cố gắng làm thérapeute, không hiểu gì xảy ra. Bị ghost. Và cho đến nay, Android không giúp gì. Bạn nhận thông báo bond state giờ là BOND_NONE, nhưng đó là tất cả. Không giải thích. Không closure. Chỉ có sự im lặng lạnh lùng của kết nối thất bại.

Cuối cùng có Closure!

Nhưng anh em đội Android rõ ràng đã trải qua chia tay khó khăn, vì trong AOSP 16, họ tặng chúng ta món quà closure. Giới thiệu BluetoothDevice.EXTRA_BOND_LOSS_REASON. Đó là extra mới đi kèm broadcast ACTION_BOND_STATE_CHANGED, và nó ở đây để nói cho bạn tại sao liên kết bị mất. Giống như nhận tin nhắn chia tay thực sự giải thích chuyện gì xảy ra!

Giờ, khi liên kết bị phá vỡ, bạn có thể lấy mã lý do cụ thể. Hãy coi chúng như những lời làm biếc chia tay kinh điển, nhưng cho Bluetooth:

Mã lý do (Minh họa)Thực tế nghĩa là gì
BOND_LOSS_REASON_BREDR_AUTH_FAILUREChỉ ra lý do mất liên kết là thất bại xác thực BR/EDR.
BOND_LOSS_REASON_BREDR_INCOMING_PAIRINGChỉ ra lý do mất liên kết là thất bại pairing BR/EDR.
BOND_LOSS_REASON_LE_ENCRYPT_FAILUREChỉ ra lý do mất liên kết là thất bại mã hóa LE.
BOND_LOSS_REASON_LE_INCOMING_PAIRINGChỉ ra lý do mất liên kết là thất bại pairing LE.

Code: Làm thám tử

Vậy làm sao lấy tin tức sành điệu này? Cần setup BroadcastReceiver lắng nghe thay đổi trạng thái liên kết.

// Tạo BroadcastReceiver lắng nghe thay đổi bond state private val bondStateReceiver = object : BroadcastReceiver() { override fun onReceive(context: Context, intent: Intent) { if (intent.action == BluetoothDevice.ACTION_BOND_STATE_CHANGED) { val device: BluetoothDevice? = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE) val bondState = intent.getIntExtra(BluetoothDevice.EXTRA_BOND_STATE, BluetoothDevice.ERROR) val previousBondState = intent.getIntExtra(BluetoothDevice.EXTRA_PREVIOUS_BOND_STATE, BluetoothDevice.ERROR) // Check nếu chuyển từ bonded sang không bonded if (bondState == BluetoothDevice.BOND_NONE && previousBondState == BluetoothDevice.BOND_BONDED) { Log.d("BondBreakup", "Chúng ta bị ${device?.address} đá!") // Bây giờ, hãy tìm tại sao... val reason = intent.getIntExtra(BluetoothDevice.EXTRA_BOND_LOSS_REASON, -1) when (reason) { // Lưu ý: giá trị constant thực tế trong Android SDK BluetoothDevice.BOND_LOSS_REASON_REMOTE_DEVICE_REMOVED -> { Log.d("BondBreakup", "Lý do: Thiết bị từ xa xóa liên kết.") // Có thể hiện thông báo cho user: "Tai nghe của bạn dường như quên bạn. Hãy thử pair lại." } // ... xử lý lý do khác ... else -> { Log.d("BondBreakup", "Lý do: Phức tạp (Mã lý do không xác định: $reason)") } } } } } // Trong Activity hoặc Service, đăng ký receiver override fun onResume() { super.onResume() val filter = IntentFilter(BluetoothDevice.ACTION_BOND_STATE_CHANGED) registerReceiver(bondStateReceiver, filter) } override fun onPause() { super.onPause() // Đừng quên unregister! unregisterReceiver(bondStateReceiver) } 

Code trên triển khai hệ thống thám tử cho chia tay liên kết Bluetooth, và nó tinh vi hơn vẻ ngoài. Hãy đi qua cách pattern broadcast receiver này hoạt động và tại sao mạnh mẽ.

Trước tiên, tạo BroadcastReceiver, cách Android cho app lắng nghe sự kiện system-wide. Coi như đăng ký dịch vụ thông báo, mỗi khi có chuyện thú vị trong hệ thống Android (như thay đổi bond state), hệ thống broadcast "intent" đến tất cả listener đã đăng ký. Receiver của chúng ta là một trong số đó.

Trong onReceive(), trước tiên check action của intent có phải ACTION_BOND_STATE_CHANGED không. Quan trọng vì broadcast receiver có thể nhận nhiều loại intent, và chúng ta chỉ quan tâm thay đổi bond state. Khi xác nhận loại event đúng, trích xuất thông tin liên quan từ intent dùng getParcelableExtra() và getIntExtra().

Object device cho biết event này về thiết bị Bluetooth nào. Bạn có thể bonded với nhiều thiết bị (tai nghe, đồng hồ, xe), và cần biết cái nào vừa chia tay. bondState cho biết trạng thái hiện tại (bonded, bonding, hay không bonded?), và previousBondState cho biết trạng thái trước khi thay đổi.

Logic then chốt ở check điều kiện: if (bondState == BluetoothDevice.BOND_NONE && previousBondState == BluetoothDevice.BOND_BONDED). Check chuyển đổi cụ thể từ "bonded" sang "not bonded", tương đương số của chia tay. Chúng ta không quan tâm quá trình bonding (none -> bonding -> bonded) - chỉ quan tâm khi liên kết hiện có bị mất.

Khi phát hiện chia tay, trích xuất EXTRA_BOND_LOSS_REASON mới từ intent. Đây là tính năng sao của AOSP 16 cuối cùng cho closure. Mã lý do cho biết chính xác tại sao liên kết bị mất - là thiết bị từ xa kết thúc? Người dùng chủ động quên thiết bị? Xác thực thất bại? Mỗi mã lý do tương ứng kịch bản khác nhau, và bạn xử lý từng cái phù hợp.

Trong ví dụ, dùng when expression xử lý các mã lý do. Với BOND_LOSS_REASON_BREDR_INCOMING_PAIRING, biết thiết bị kia khởi xướng chia tay, nên hiện thông báo hữu ích như "Tai nghe dường như quên bạn. Hãy thử pair lại." Với lý do khác, thêm branch xử lý cụ thể.

Chú ý quản lý vòng đời dưới cùng. Đăng ký receiver trong onResume() và unregister trong onPause(). Điều này critical: nếu quên unregister broadcast receiver, nó tiếp tục nhận broadcast sau khi Activity destroyed, gây memory leak và crash. Pattern đăng ký onResume/unregister onPause đảm bảo chỉ lắng nghe thay đổi bond khi Activity visible và active.

Đây là bước tiến lớn cho gỡ lỗi và UX. Thay vì chỉ nói "Kết nối thất bại", giờ bạn có thể đưa lời khuyên actionable dựa trên lý do cụ thể liên kết bị mất. Giống như làm cố vấn quan hệ hữu ích, am hiểu thay vì người quan sát bối rối chỉ biết hụt hẫng "Tôi không biết xảy ra chuyện gì."

Đã xử lý xong gánh nặng cảm xúc của chia tay, hãy chuyển sang cái nhẹ nhàng hơn: hẹn hò nhanh cho thiết bị Bluetooth.

Đi sâu #3: UUID dịch vụ từ Quảng cáo

Hãy nói về tìm đối tác tương thích... cho app. Trong thế giới BLE, không phải thiết bị nào cũng giống nhau. Màn hình nhịp tim rất khác bóng đèn thông minh. Vậy app biết mình nói chuyện với đúng loại thiết bị như thế nào? Câu trả lời là Service UUID.

Service UUID là gì?

Service UUID (Universally Unique Identifier) giống như danh hiệu công việc của thiết bị. Đó là số 128-bit duy nhất nói, "Tôi là thiết bị cung cấp Dịch vụ Nhịp Tim" hoặc "Tôi là thiết bị cung cấp Dịch vụ Pin." Đó là mảnh thông tin quan trọng nhất để xác định thiết bị làm được gì.

Cách cũ: Cuộc hẹn đầu tiên ngại ngùng

Truyền thống, tìm dịch vụ của thiết bị là một quá trình cả một vấn đề. Giống như đi ăn ba món chỉ để biết nghề nghiệp đối phương. Quy trình như sau:

  1. Quét: Tìm thiết bị.

  2. Kết nối: Thiết lập kết nối (quá trình chậm và tốn pin).

  3. Khám phá dịch vụ: Hỏi thiết bị, "Vậy... bạn làm nghề gì?" và chờ nó liệt kê tất cả dịch vụ.

  4. Đánh giá: Check danh sách dịch vụ có chứa cái bạn quan tâm không.

  5. Ngắt kết nối (hay ở lại): Nếu không phải thiết bị đúng, phải chia tay (ngắt kết nối) và chuyển sang cái khác. Tốn thời gian và năng lượng!

Cực kỳ kém hiệu quả, đặc biệt nếu bạn trong phòng đông đúc với hàng chục thiết bị BLE mà chỉ tìm một loại cụ thể.

Cách mới: Thẻ tên vinh quang

Không hay nếu mọi người trong tiệc đeo thẻ tên với chức danh? Đó chính xác điều AOSP 16 tặng chúng ta với BluetoothDevice.EXTRA_UUID_LE. Nhiều thiết bị BLE đã đủ lịch sự đưa UUID dịch vụ chính vào gói quảng cáo. Đó là cách chúng hét, "TÔI LÀ MÀN HÌNH NHỊP TIM!" cho cả phòng biết.

Trước AOSP 16, lấy thông tin này từ gói quảng cáo là quá trình thủ công rối rắm parse byte array nguyên bản của scan record. Có thể làm, nhưng là loại code bạn viết một lần, cầu nguyện nó chạy, và không bao giờ động đến nữa.

Giờ, Android làm việc bẩn cho chúng ta! Hệ thống tự động parse dữ liệu quảng cáo và, nếu tìm thấy UUID dịch vụ, tiện lợi đưa cho bạn trong ScanResult.

Code: Đọc thẻ tên

Tính năng mới này làm ScanCallback mạnh mẽ hơn. Chúng ta giờ check "danh hiệu" thiết bị ngay khi khám phá, mà không bao giờ phải kết nối.

private val scanCallback = object : ScanCallback() { override fun onScanResult(callbackType: Int, result: ScanResult) { Log.d("BleSpeedDating", "Found device: ${result.device.address}") // Check thẻ tên! val serviceUuids = result.scanRecord?.serviceUuids if (serviceUuids.isNullOrEmpty()) { Log.d("BleSpeedDating", "Cái này bí ẩn. Không có service UUID trong quảng cáo.") return } // Định nghĩa UUID tìm kiếm (ví dụ: Heart Rate Service UUID chuẩn) val heartRateServiceUuid = ParcelUuid.fromString("0000180D-0000-1000-8000-00805F9B34FB") if (serviceUuids.contains(heartRateServiceUuid)) { Log.d("BleSpeedDating", "Trúng! Đây là màn hình nhịp tim. Hãy kết nối!") // Giờ có thể kết nối đến result.device, biết chắc nó đúng. stopBleScan() // Tìm thấy thứ cần // connectToDevice(result.device) } else { Log.d("BleSpeedDating", "Không trúng. Tiếp tục.") } } // ... onScanFailed ... } 

Code trên demo sức mạnh đọc service UUID trực tiếp từ dữ liệu quảng cáo, và nó thay đổi game cho khám phá thiết bị. Hãy phân tích chính xác chuyện gì xảy ra và tại sao cải tiến đáng kể.

Khi nhận kết quả quét trong callback, object result chứa thuộc tính scanRecord. Scan record này về cơ bản là gói quảng cáo thô thiết bị BLE phát vào không khí.

Trước AOSP 16, nếu muốn trích xuất service UUID từ dữ liệu này, bạn phải thủ công parse byte array, hiểu format quảng cáo BLE, xử lý các loại dữ liệu khác nhau, và cầu nguyện không sai off-by-one. Đó là loại code chạy một lần và bạn không bao giờ động đến nữa vì sợ.

Giờ, với cải tiến AOSP 16, Android làm hết việc parse rối rắm. Chỉ cần gọi result.scanRecord?.serviceUuids và nhận list ParcelUuid sạch đẹp. Safe call operator (?.) quan trọng ở đây vì không phải thiết bị nào cũng có scan record trong kết quả, và cần xử lý graceful.

Sau khi lấy service UUID, check list null hoặc empty. Một số thiết bị không đưa service UUID vào quảng cáo. Chúng có thể dùng format proprietary, hoặc cấu hình kém. Nếu không có UUID, log và return sớm. Không lý do tiếp tục nếu không xác định được thiết bị làm gì.

Tiếp theo, định nghĩa UUID tìm kiếm. Ví dụ này tìm màn hình nhịp tim, dùng Heart Rate Service UUID chuẩn: 0000180D-0000-1000-8000-00805F9B34FB. UUID do Bluetooth SIG (Special Interest Group) định nghĩa, và bất kỳ màn hình nhịp tim tuân thủ nào sẽ quảng cáo UUID này. Bạn tìm danh sách đầy đủ standard service UUID trong spec Bluetooth, hoặc dùng custom UUID nếu tự xây peripheral BLE.

Phép màu xảy ra ở if (serviceUuids.contains(heartRateServiceUuid)). Đây là nơi speed dating: check "thẻ tên" thiết bị xem có khớp thứ tìm không.

Nếu khớp, tìm thấy match! Có thể dừng quét ngay (vì sao tiếp tục tìm khi đã có?) và tiến hành kết nối thiết bị. Chúng ta biết chắc thiết bị là màn hình nhịp tim, nên không lãng phí thời gian và pin kết nối thiết bị ngẫu nhiên chỉ để phát hiện không phải thứ cần.

Nếu UUID không khớp, log "Không trúng" và tiếp tục. Callback sẽ gọi lại khi thiết bị tiếp theo tìm thấy, và lặp lại cho đến khi tìm thấy màn hình nhịp tim hoặc user dừng quét.

Đây là cải tiến hiệu suất khổng lồ so với cách cũ. Trước, phải kết nối mọi thiết bị tìm thấy, thực hiện service discovery (liên quan nhiều round-trip communication với thiết bị), check có dịch vụ cần không, rồi ngắt kết nối nếu không. Mỗi lần kết nối tốn thời gian, pin, và tạo traffic radio không cần.

Giờ, bạn lọc và xác định thiết bị ở tốc độ ánh sáng, ngay giai đoạn quét. Không còn cuộc hẹn đầu ngại ngùng kết nối bóng đèn thông minh nghĩ là fitness tracker. Chỉ kết nối nhắm mục tiêu, hiệu quả.

Đặc biệt hữu ích cho app cần tìm loại sensor/peripheral cụ thể trong biển thiết bị vô liên quan. Tưởng tượng bạn ở bệnh viện với hàng trăm thiết bị y tế BLE, hoặc smart home với chục sensor. Khả năng xác định tức thì thiết bị đúng từ quảng cáo là khác biệt giữa app responsive, chuyên nghiệp và app cảm giác chậm chạp, không tin cậy.

Chúng ta đã gặp ba kiếm sĩ Bluetooth: quét thụ động cho hiệu quả pin, lý do mất liên kết cho gỡ lỗi tốt hơn, và service UUID từ quảng cáo cho nhận diện thiết bị nhanh hơn. Nhưng hành trình chưa kết thúc. Đã đến lúc đi vào rừng sâu kỹ thuật quét nâng cao.

Chủ đề nâng cao: Lọc, Batching, và phép thuật khác

Được, bạn đã thành tháo cơ bản. Bạn quét thụ động, có closure cho chia tay liên kết, và speed-date thiết bị như pro. Bạn không còn là Bluetooth padawan. Đã đến lúc trở thành Jedi Master.

Hãy đi sâu vào nghệ thuật cao cấp của filtering, batching, và tối ưu hóa phép thuật khác sẽ làm app của bạn thành quán quân tiết kiệm pin thực sự.

Lọc phần cứng: Trợ lý cá nhân

Hãy tưởng tượng bạn là celebrity, thuê trợ lý cá nhân. Bạn không muốn bị phiền bởi mọi người muốn ký tên. Vậy bạn đưa trợ lý danh sách: "Chỉ báo cho tôi nếu thấy agent hoặc mẹ tôi." Trợ lý đứng cửa và chỉ phiền bạn khi người trong danh sách xuất hiện.

Đó chính xác hardware filtering làm. Thay vì code app (celebrity) bị đánh thức cho mọi thiết bị Bluetooth radio thấy, bạn offload logic lọc xuống Bluetooth controller (trợ lý). Tính năng này có từ Android 6.0, nhưng quan trọng hơn bao giờ hết.

Tại sao tuyệt vời? Vì code app có thể ngủ. Main processor (AP) không phải thức mỗi khi bàn chải điện Bluetooth ngẫu nhiên quảng cáo. Bluetooth controller, tiết kiệm năng lượng hơn, xử lý lọc. AP chỉ thức khi controller tìm thấy thiết bị khớp tiêu chí.

Code: Xây danh sách VIP

Triển khai bằng ScanFilter. Có thể lọc theo tên thiết bị, MAC address, hoặc hữu ích nhất, theo Service UUID nó quảng cáo.

// Chỉ muốn bị phiền nếu thấy màn hình nhịp tim. val heartRateServiceUuid = ParcelUuid.fromString("0000180D-0000-1000-8000-00805F9B34FB") val filter = ScanFilter.Builder() .setServiceUuid(heartRateServiceUuid) .build() val scanFilters: List<ScanFilter> = listOf(filter) // Giờ, khi start scan, truyền list này bleScanner.startScan(scanFilters, scanSettings, scanCallback) 

Code trên cho cách tạo filter cấp phần cứng cải thiện đáng kể pin và hiệu suất app. Hãy đi sâu vào chuyện gì xảy ra và tại sao kỹ thuật này mạnh mẽ.

Bắt đầu bằng định nghĩa service UUID quan tâm - ở đây là Heart Rate Service UUID chuẩn. Cùng UUID ví dụ trước, nhưng giờ dùng cách cơ bản khác. Thay vì check UUID trong code app sau khi nhận kết quả quét, chúng ta bảo phần cứng Bluetooth CHỈ báo thiết bị khớp UUID này.

ScanFilter.Builder() là công cụ xây filter. Builder pattern, nghĩa là chain nhiều method để cấu hình chính xác tìm kiếm. Ví dụ gọi setServiceUuid(heartRateServiceUuid), bảo filter chỉ match thiết bị quảng cáo service cụ thể này.

Nhưng builder có nhiều option khác:

  • setDeviceName() - Match thiết bị tên cụ thể (như "My Heart Monitor")

  • setDeviceAddress() - Match thiết bị cụ thể bằng MAC address (hữu ích nếu đã pair và muốn tìm lại)

  • setManufacturerData() - Match dựa trên dữ liệu manufacturer-specific trong quảng cáo

  • setServiceData() - Match dựa trên service data trong quảng cáo

Bạn thậm chí kết hợp nhiều tiêu chí trong một filter. Ví dụ, tạo filter match thiết bị với service UUID CỨNG manufacturer ID cụ thể. Filter càng cụ thể, false positive càng ít.

Sau khi build filter, tạo list chứa nó. Tại sao list? Vì bạn có thể có nhiều filter, và thiết bị match nếu thỏa MỘT filter trong list. Ví dụ, tạo filter cho màn hình nhịp tim và filter khác cho máy đo huyết áp, quét sẽ báo thiết bị match CẢ HAI. Đây là phép OR: thiết bị không cần match tất cả filter, chỉ cần một.

Cuối cùng, truyền list filter cho startScan() cùng scan settings và callback. Đây là nơi phép màu xảy ra. Khi cung cấp filter, Android không chỉ lọc kết quả trong code app. Nó đẩy filter xuống Bluetooth controller hardware. Nghĩa là lọc xảy ra ở mức thấp nhất, trước khi app bị thông báo.

Tại sao mạnh mẽ vậy: không có filter, mỗi khi radio Bluetooth nghe quảng cáo từ BẤT KỲ thiết bị nào (bánh mì nướng thông minh hàng xóm, fitness tracker người đi đường, loa Bluetooth ba phòng xa), nó phải đánh thức process app, deliver kết quả quét, và để code quyết định có quan tâm không. Mỗi lần đánh thức tốn pin và thời gian xử lý.

Với hardware filter, Bluetooth controller im lặng bỏ qua thiết bị không khớp tiêu chí. App ngủ. Main processor ngủ. Chỉ khi màn hình nhịp tim được phát hiện, hardware đánh thức app và deliver kết quả. Giống như bouncer quán bar chỉ cho vào người trong VIP list. Mọi người khác bị chặn ở cửa, và bạn không bao giờ biết họ có đến.

Bằng cách dùng ScanFilter, bạn nói với hardware, "Đừng đánh thức tôi trừ khi thấy màn hình nhịp tim." Đó là nước đi tiết kiệm pin tối thượng cho background scanning. Kết hợp với quét thụ động và batch reporting, bạn tạo hệ thống quét Bluetooth chạy hàng giờ thậm chí ngày với ảnh hưởng pin tối thiểu. Đó là cách app chuyên nghiệp xử lý giám sát thiết bị lâu dài không phá hoại pin.

Batch Scanning: Báo cáo hàng ngày

Quay lại ví dụ celebrity. Đôi khi bạn không cần bị ngắt quãng ngay khi mẹ xuất hiện. Bạn thích báo cáo cuối ngày: "Hôm nay mẹ ghé 2 lần, agent gọi 1 lần." Đó là batch scanning.

Thay vì deliver kết quả quét real-time, Bluetooth controller gom chúng và deliver theo batch lớn. Tính năng tiết kiệm pin tuyệt vời khác. App ngủ lâu, thức, xử lý đống kết quả cùng lúc, rồi ngủ lại.

Bật bằng setReportDelay() trong ScanSettings.

val scanSettings = ScanSettings.Builder() // ... settings khác ... // Deliver kết quả mỗi 5 giây (5000 ms) .setReportDelay(5000) .build() 

Khi dùng report delay, onScanResult callback thay bằng onBatchScanResults, cho List<ScanResult>.

private val scanCallback = object : ScanCallback() { override fun onBatchScanResults(results: List<ScanResult>) { Log.d("BatchScanner", "Đây báo cáo hàng ngày! Tìm thấy ${results.size} thiết bị.") for (result in results) { // Xử lý từng kết quả } } // ... onScanFailed ... } 

Cơ chế batch scanning trên là một trong những tính năng tiết kiệm pin bị bỏ quên nhất trong Android Bluetooth, và hiểu cách nó hoạt động có thể thay đổi hồ sơ pin app. Hãy phân tích chính xác chuyện gì xảy ra dưới mui và khi nào nên dùng.

Khi đặt report delay 5000 ms (5 giây) trong code trên, bạn thay đổi căn bản cách pipeline quét hoạt động. Thay vì controller ngay lập tức đánh thức app mỗi khi thấy thiết bị, nó đóng vai trợ lý chăm chỉ ghi chú. Trong 5 giây đó, controller im lặng gom mọi kết quả quét gặp, lưu trong buffer nội bộ. App hoàn toàn ngủ - không CPU cycle lãng phí, không pin hao bởi context switch hay process wake-up.

Sau khi delay 5 giây hết, controller deliver tất cả kết quả gom được trong một batch đến callback onBatchScanResults(). Đó là nơi tiết kiệm pin: thay vì đánh thức app 50 lần nếu 50 thiết bị được phát hiện, nó đánh thức một lần và đưa 50 kết quả cùng lúc. App xử lý batch hiệu quả - cập nhật UI list, log data, hoặc check thiết bị cụ thể - rồi ngủ cho đến batch tới.

Tham số results trong onBatchScanResults() là List<ScanResult>, và mỗi ScanResult đại diện cho một quảng cáo đơn lẻ được nghe trong khoảng batching. Quan trọng: nếu cùng thiết bị quảng cáo nhiều lần trong khoảng delay, bạn có thể nhận nhiều kết quả cho thiết bị đó trong batch. List không tự deduplicate - việc đó của bạn nếu cần.

Trong ví dụ, chỉ log số thiết bị và iterate qua từng kết quả. App thực tế, có thể xử lý tinh vi hơn. Ví dụ, build map thiết bị keyed bằng MAC address để track số lần quảng cáo, tính trung bình RSSI ước lượng khoảng cách, hoặc lọc batch chỉ xử lý thiết bị đáp ứng tiêu chí.

Cảnh báo: Batch scanning công cụ mạnh, nhưng không dành cho mọi tình huống. Nếu cần phản ứng tức thì với hiện diện thiết bị (ví dụ app "tìm chìa khóa" nơi user chủ động tìm), report delay không phải bạn. User không muốn chờ 5 giây thấy kết quả - họ muốn feedback tức thì. Trong trường hợp này, setReportDelay(0) cho báo cáo ngay.

Nhưng giám sát lâu dài hoặc thu thập dữ liệu, batch scanning là bạn thân pin. Xem xét use case:

  • Giám sát hiện diện background: App check mỗi phút xem smartwatch user còn trong range không, không cần update giây giây.

  • Cảm biến môi trường: Thu thập dữ liệu từ cảm biến nhiệt độ khắp tòa nhà, chỉ cần cập nhật dashboard 30 giây/lần.

  • Phân tích beacon: Theo dõi bao nhiêu người qua vị trí bán lẻ dựa trên quảng cáo BLE điện thoại, gom dữ liệu 10 giây/lần.

Điểm ngọt report delay tùy use case. Quá ngắn (1 giây), không được nhiều benefit, vẫn thức thường xuyên. Quá dài (60 giây), app có thể cảm giác unresponsive hoặc bỏ lỡ sự kiện nhạy cảm thời gian. Hầu hết background monitoring, delay 5-30 giây hiệu quả.

Một điều lưu ý: batch scanning có giới hạn. Bluetooth controller có buffer hữu hạn lưu kết quả quét. Nếu đặt delay quá dài và môi trường có hàng trăm thiết bị BLE, buffer có thể đầy trước khi delay hết. Khi đó, kết quả cũ bị drop. Android không cảnh báo khi xảy ra, nên nếu mất data, cân nhắc giảm report delay hoặc dùng filter aggressive hơn để giảm kết quả gom.

OnFound/OnLost: Kịch tính hiện diện

Từ Android 8.0, quét còn kịch tính hơn. Bây giờ bạn nhờ hardware không chỉ báo khi tìm thấy thiết bị, mà cả khi mất nó. Làm bằng CALLBACK_TYPE_FIRST_MATCH và CALLBACK_TYPE_MATCH_LOST trong ScanSettings.

val scanSettings = ScanSettings.Builder() .setCallbackType(ScanSettings.CALLBACK_TYPE_FIRST_MATCH or ScanSettings.CALLBACK_TYPE_MATCH_LOST) .build() 

Giờ, trong ScanCallback, tham số callbackType trong onScanResult sẽ nói chuyện gì xảy ra.

override fun onScanResult(callbackType: Int, result: ScanResult) { when (callbackType) { ScanSettings.CALLBACK_TYPE_FIRST_MATCH -> { Log.d("PresenceDetector", "Tìm thấy! ${result.device.address} đã vào nhà.") } ScanSettings.CALLBACK_TYPE_MATCH_LOST -> { Log.d("PresenceDetector", "Mất rồi! ${result.device.address} đã rời nhà.") } } } 

Cơ chế phát hiện hiện diện trên đại diện sự chuyển đổi cơ bản cách chúng ta nghĩ về quét Bluetooth. Thay vì coi quét như luồng liên tục "đây là thứ tôi thấy bây giờ", chúng ta làm việc với sự kiện: "thiết bị này xuất hiện" và "thiết bị này biến mất." Hãy đi sâu vào cách hoạt động và tại sao mạnh mẽ.

Khi đặt callback type dùng bitwise OR (or trong Kotlin, | trong Java), bạn bảo Bluetooth hardware track trạng thái hiện diện thiết bị theo thời gian. Code CALLBACK_TYPE_FIRST_MATCH or CALLBACK_TYPE_MATCH_LOST kết hợp cả hai flag, nghĩa là muốn được thông báo cả khi thiết bị lần đầu xuất hiện và khi biến mất. Có thể dùng riêng từng flag nếu chỉ quan tâm một loại event, nhưng dùng cả hai cho nhận biết hiện diện hoàn chỉnh.

Hiểu "first match" và "match lost" nghĩa là gì. Khi controller nghe quảng cáo từ thiết bị khớp filter lần đầu, trigger event CALLBACK_TYPE_FIRST_MATCH. Khác với CALLBACK_TYPE_ALL_MATCHES (mặc định), trigger mỗi lần thiết bị quảng cáo. Thiết bị có thể quảng cáo nhiều lần/giây, nên khác biệt lớn. Với FIRST_MATCH, nhận một thông báo khi thiết bị vào range quét, không phải lũ thông báo khi nó tiếp tục quảng cáo.

Event CALLBACK_TYPE_MATCH_LOST thú vị hơn. Controller track khi nào nghe từ thiết bị lần cuối. Nếu thiết bị ngừng quảng cáo (vì ra khỏi range, tắt, hoặc hết pin), controller nhận ra vắng mặt và trigger MATCH_LOST. Tự động xảy ra: bạn không cần thủ công track timestamp hoặc implement timeout logic trong app. Hardware làm hộ.

Nhưng hardware biết khi nào thiết bị "lost" như thế nào? Dùng timeout nội bộ. Nếu controller không nghe từ thiết bị trong một khoảng thời gian (thường vài giây, tuy nhiên duration chính xác phụ thuộc implementation và không expose cho app), coi thiết bị lost. Nghĩa là có delay nhỏ giữa khi thiết bị thực sự rời range và khi nhận callback MATCH_LOST, nhưng delay thường chấp nhận cho use case phát hiện hiện diện.

Trong code ví dụ, dùng when expression xử lý callback type khác nhau. Khi nhận FIRST_MATCH, biết thiết bị vừa vào range quét, log "Tìm thấy!" Hoàn hảo cho trigger action như mở khóa cửa khi điện thoại đến gần, hoặc bắt đầu sync khi fitness tracker được phát hiện.

Khi nhận MATCH_LOST, biết thiết bị rời range hoặc ngừng quảng cáo, log "Mất rồi!" Lý tưởng cho cleanup action như khóa cửa khi điện thoại đi, hoặc dừng sync khi tracker ngắt kết nối.

Cực kỳ hữu ích cho presence detection. Smart lock có trong range? Fitness tracker vẫn kết nối? Điện thoại user gần đó? Giờ bạn biết, với sự chắc chắn cấp hardware, và phản ứng thay đổi hiện diện mà không cần poll liên tục hoặc maintain state machine phức tạp trong code app.

Ví dụ thực tế dùng trong app smart home:

private val presenceCallback = object : ScanCallback() { override fun onScanResult(callbackType: Int, result: ScanResult) { when (callbackType) { ScanSettings.CALLBACK_TYPE_FIRST_MATCH -> { // Điện thoại user phát hiện - họ về nhà! Log.d("SmartHome", "Chào mừng về nhà! Mở khóa cửa và bật đèn.") unlockFrontDoor() turnOnLights() adjustThermostat(COMFORTABLE_TEMP) } ScanSettings.CALLBACK_TYPE_MATCH_LOST -> { // Điện thoại user mất - họ đi! Log.d("SmartHome", "Tạm biệt! Khóa cửa và vào chế độ vắng nhà.") lockFrontDoor() turnOffLights() adjustThermostat(ENERGY_SAVING_TEMP) armSecuritySystem() } } } override fun onScanFailed(errorCode: Int) { Log.e("SmartHome", "Presence detection failed: $errorCode") } } 

Lưu ý quan trọng: FIRST_MATCH và MATCH_LOST mutually exclusive với CALLBACK_TYPE_ALL_MATCHES. Nếu kết hợp với ALL_MATCHES, hành vi undefined và khác nhau tùy thiết bị. Giữ hoặc ALL_MATCHES cho báo cáo liên tục, hoặc FIRST_MATCH/MATCH_LOST cho presence detection - đừng cố dùng cả hai.

Cũng lưu ý presence detection tốt nhất khi kết hợp hardware filtering. Nếu quét tất cả thiết bị không filter, controller phải track trạng thái hiện diện của MỌI thiết bị BLE trong range, làm tràn bảng tracking nội bộ. LUÔN dùng ScanFilter thu hẹp thiết bị quan tâm khi dùng presence detection.

Bằng cách kết hợp kỹ thuật nâng cao - hardware filtering, batch scanning, presence detection - bạn xây dựng ứng dụng Bluetooth tinh vi, tiết kiệm pin. Bạn không chỉ là developer. Bạn là phù thủy Bluetooth, nắm quyền tạo app nhận biết môi trường, phản ứng thay đổi, và tôn trọng pin.

Bây giờ, hãy xem áp dụng phép màu này ở thế giới thực nào.

Các trường hợp sử dụng thực tế: Nơi Bluetooth chạm đường

Ổn, chúng ta học đống trick cool. Chúng ta về cơ bản là đai đen Bluetooth. Nhưng dùng sức mạnh này làm gì nếu không dùng cho việc tốt (hoặc ít nhất app cool)? Hãy khám phá vài kịch bản thực tế nơi tính năng mới AOSP 16 biến app tốt thành app tuyệt vời.

1. App "Tìm mọi thứ"

Chúng ta đều từng trải. Muộn đi làm, chìa khóa quyết định chơi trốn tìm trong chiều khác. Use case kinh điển cho BLE tracker.

  • Cách cũ: App liên tục quét chủ động, hao pin khi bạn tìm bế tắc. Kết nối mọi tracker trong nhà chỉ để xem có phải cái đúng không.

  • Cách AOSP 16: App chạy quét thụ động background với hardware filter cho Service UUID tracker cụ thể. Ảnh hưởng pin tối thiểu. Khi mở app tìm chìa khóa, nó đã biết chìa khóa trong nhà vì lặng lẽ lắng nghe. Bấm nút "Tìm", app kết nối, chìa khóa kêu từ trong góc ghế. Và nếu kết nối fail? Lý do mất liên kết cho biết tracker hết pin, nên bạn không tìm thiết bị chết.

2. Siêu thị thông minh

Tưởng tượng app cho coupon sản phẩm khi bạn đi qua khu vực trong cửa hàng. Giấc mơ proximity marketing, giấc mơ lịch sử bị phá vỡ bởi... hao pin.

  • Cách cũ: App cần liên tục quét beacon, biến điện thoại thành khoai tây nóng và pin chết khi đến quầy thanh toán.

  • Cách AOSP 16: Siêu thị đặt BLE beacon mỗi khu vực. App dùng quét thụ động, batched. Thức mỗi phút, lấy list beacon thấy, ngủ lại. Khi thấy bạn lững thững khu bánh quy 5 phút (nó biết, luôn biết), dùng Service UUID từ quảng cáo xác định "Beacon khu bánh quy" và gửi coupon Oreo. Nhắm mục tiêu, hiệu quả, không giết pin trước khi thanh toán.

3. Smart home quá quan tâm

Smart home nên, tốt, thông minh. Nên biết khi bạn về và khi đi. Nên khóa cửa sau lưng và bật đèn khi đến.

  • Cách cũ: Phụ thuộc GPS (kẻ giết pin악명) hoặc Wi-Fi, không tin cậy. BLE là option, nhưng quét liên tục là vấn đề.

  • Cách AOSP 16: Điện thoại là chìa khóa. Smart hub (central device) chạy quét thụ động low-power liên tục. Khi thấy quảng cáo BLE điện thoại, biết bạn về. Nhưng nếu chỉ đi ngang qua nhà? Đây là lúc OnFound/OnLost phát huy. Hub cấu hình chỉ trigger "Chào mừng về nhà" sau khi thấy thiết bị liên tục một phút (OnFound), và trigger "Tạm biệt" chỉ sau không thấy 5 phút (OnLost). Hệ thống phát hiện hiện diện thông minh, tin cậy, cuối cùng làm smart home cảm giác... thông minh.

4. Theo dõi tài sản doanh nghiệp

Bệnh viện lớn hoặc kho, theo dõi thiết bị đắt tiền, di động (máy bơm truyền, xe nâng) là thách thức lớn. Tag BLE là giải pháp.

  • Cách cũ: Nhân viên đi quanh với tablet, quét chủ động lấy inventory. Chậm, thủ công, kém hiệu quả.

  • Cách AOSP 16: Mạng lưới gateway BLE cố định khắp tòa nhà. Mỗi gateway là thiết bị đơn giản (như Raspberry Pi) chạy quét thụ động liên tục. Chúng gom dữ liệu quảng cáo từ asset tag và gửi server trung tâm. Server giờ thấy real-time: Máy bơm #34 ở Phòng 201, Xe nâng #3 đang ở bãi tải. Không quét thủ công. Hệ thống định vị real-time chi phí thấp, tiết kiệm pin, nhờ hiệu quả quét thụ động.

Chỉ vài ví dụ. Từ fitness tracker đến sensor công nghiệp, tính năng Bluetooth mới AOSP 16 mở ra thế giới khả năng xây dựng app không chỉ mạnh mà còn lịch sự với pin người dùng. Bây giờ, hãy nói cách đảm bảo app shiny mới chạy trên mọi thiết bị, không chỉ cái mới.

Kiểm tra phiên bản API: Cách không crash app

Vậy, bạn xây app đẹp, tiết kiệm pin, dùng tất cả hotness mới từ bản phát hành Q4 AOSP 16. Sẵn sàng ship, thành triệu phú, nghỉ hưu đảo riêng. Nhưng rồi bug report về. App crash trên thiết bị Android 16 mới. Tại sao?!

Chào mừng, bạn bè, đến thế giới kiểm tra phiên bản API kỳ diệu. Với lịch phát hành mới Android, điều này quan trọng ( và hơi phức tạp) hơn bao giờ.

Vấn đề: Câu chuyện hai Android 16

Như thảo luận, 2025 cho chúng ta hai bản phát hành Android 16:

  • Bản phát hành Q2: Bản chính "Baklava". Gọi đây API level 36.0.

  • Bản phát hành Q4: Bản nhỏ, feature-drop. Nơi Bluetooth toys mới sống. Gọi đây API level 36.1.

API quét thụ động mới, setScanType(), chỉ tồn tại trên 36.1 trở lên. Nếu gọi trên thiết bị chạy bản Q2 ban đầu (36.0), app crash với NoSuchMethodError. Tương đương số của việc gọi món menu chỉ thêm hôm qua. Đầu bếp (app) bị confused và meltdown.

Lão vệ: SDK_INT

Suất nhiều năm, người bạn tin cậy check API level là Build.VERSION.SDK_INT. Đơn giản và hiệu quả.

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) { // Dùng API từ Android 12 (S) trở lên } 

Nhưng SDK_INT chỉ biết major release. Cả Android 16 Q2 và Q4, SDK_INT báo 36. Nó không biết minor version. Giống như hỏi tuổi ai đó, họ chỉ nói "ba mươi". Không cụ thể.

Sample mới: SDK_INT_FULL

Để giải quyết, đội Android cho công cụ chính xác hơn: Build.VERSION.SDK_INT_FULL. Constant này biết cả major và minor version. Và đi kèm, set version code mới: Build.VERSION_CODES_FULL.

Vậy để gọi an toàn API quét thụ động mới, cần check cụ thể hơn:

// Build ScanSettings val scanSettingsBuilder = ScanSettings.Builder() .setScanMode(ScanSettings.SCAN_MODE_LOW_POWER) // Check có thể đi thụ động không if (Build.VERSION.SDK_INT_FULL >= Build.VERSION_CODES_FULL.BAKLAVA_1) { Log.d("ApiCheck", "Thiết bị này cool. Đi thụ động.") // API mới từ bản Q4 (36.1) scanSettingsBuilder.setScanType(ScanSettings.SCAN_TYPE_PASSIVE) } else { Log.d("ApiCheck", "Thiết bị này old school. Giữ quét chủ động.") // Fallback cho thiết bị không có API mới // Không cần làm gì, active là default } val scanSettings = scanSettingsBuilder.build() 

Graceful Degradation: Nghệ thuật ngã với phong cách

Đây đưa đến khái niệm quan trọng: graceful degradation. Nghĩa là app vẫn chạy trên thiết bị cũ, ngay cả khi không dùng tính năng mới nhất. Nó fallback graceful.

Trong ví dụ, nếu method setScanType không có, chúng ta chỉ... không gọi. App mặc định quét chủ động bình thường. Không tiết kiệm pin bằng, nhưng vẫn chạy. User thiết bị cũ có app functional, user thiết bị mới có trải nghiệm tối ưu. Mọi người thắng.

Bảng giúp nhớ khi dùng check nào:

Nếu dùng API từ...Dùng check này...
Major Android release (ví dụ Android 16 Q2)if (SDK_INT >= VERSION_CODES.BAKLAVA)
Minor, feature-drop release (ví dụ Android 16 Q4)if (SDK_INT_FULL >= VERSION_CODES_FULL.BAKLAVA_1)

Làm chủ API check mới này là bắt buộc. Khóa để viết app Android hiện đại vừa đổi mới vừa ổn định. Bây giờ biết cách xây app robust, hãy nói cách fix khi nó chắc chắn break.

Kiểm thử và Gỡ lỗi: Phần vui (Không ai từng nói)

Hai chân lý phổ quát trong phát triển phần mềm:

  • Nó chạy trên máy tôi, và

  • Nó sẽ break theo cách đẹp mắt nhất có thể trong demo trực tiếp.

Phát triển Bluetooth, đặc biệt, dường như thích chân lý thứ hai. Nó biến덕, vô hình, dường như có thù cá nhân với developer.

Vậy làm sao chống lại? Với chiến lược testing và debugging vững chắc. Không glamorous, nhưng cách duy nhất giữ tỉnh táo.

Emulator: Xứ sở tưởng tượng

Emulator Android Studio công cụ tuyệt vời. Nhanh, tiện, simulate đủ loại thiết备. Và Bluetooth? Nó... có thể giúp. Emulator có hỗ trợ Bluetooth ảo. Bật lên, app nghĩ có Bluetooth adapter. Tuyệt cho test UI và đảm bảo app không crash khi lấy BluetoothLeScanner.

Nhưng vấn đề: nó không thật. Emulator không thể tương tác thực sự với sóng radio trong phòng. Bạn không dùng nó tìm BLE tai nghe thật. Cầnventure vào thế giới thực.

Thế giới thực: Nơi bug sống

Không có thay thế cho test trên thiết bị thật, vật lý. Mỗi hãng điện thoại có Bluetooth stack riêng, thiết kế antenna quirky riêng, và cách riêng làm khó đời bạn. Quét chạy hoàn hảo trên Google Pixel có thể fail thảm hại trên hãng khác. Cách duy nhất biết là test.

Kho vũ khí test nên có:

  • Nhiều loại điện thoại: Hãng khác nhau, Android version khác. Càng nhiều càng tốt.

  • Nhiều loại peripheral BLE: Đừng chỉ test một loại. Lấy vài beacon, sensor, wearable khác nhau. Bạn sẽ ngạc nhiên chúng hành xử khác nhau thế nào.

Lỗi thường gặp: Những nghi phạm quen thuộc

Khi quét fail, nó cho error code. Đây là vài kẻ phổ biến:

Mã lỗiVấn đềCách fix
SCAN_FAILED_ALREADY_STARTEDThử start quét đã chạy.Bạn quá hứng. Đảm bảo không gọi startScan() nhiều lần không stopScan() giữa chừng.
SCAN_FAILED_APPLICATION_REGISTRATION_FAILEDCái gì đó cơ bản sai setup app.Lỗi mơ hồ, không giúp ích. Thường nghĩa là vấn đề permission hoặc system đang ngày xui. Thử restart Bluetooth.
SCAN_FAILED_INTERNAL_ERRORBluetooth stack bị panic.Lỗi kinh điển "không phải bạn, là tôi". Vấn đề nội bộ controller Bluetooth. Không làm gì nhiều ngoài thử lại sau.
SCAN_FAILED_FEATURE_UNSUPPORTEDThử dùng feature hardware không hỗ trợ.Có thể thử batch scanning trên thiết bị không hỗ trợ. Dùng API version check!

Công cụ gỡ lỗi: Bộ kit săn ma

Khi chuyện xui xảy ra, cần công cụ đúng xem chuyện gì xảy ra trong thế giới vô hình Bluetooth.

  • logcat: Người bạn tốt nhất. Hào phóng với log statement. Log khi start quét, stop quét, tìm thiết bị, quét fail. Tạo filter cho tag app để thấy tín hiệu qua noise.

  • Android Bluetooth HCI Snoop Log: Thánh grail debug Bluetooth. Developer option ghi lại MỖI gói tin Bluetooth vào/ra thiết bị. Chi tiết đến mức choáng, nhưng nguồn sự thật tuyệt đối. Mở file log trong Wireshark thấy cuộc hội thoại thô, unfiltered giữa điện thoại và thiết bị BLE. Giống như có wiretap trên sóng radio.

  • nRF Connect for Mobile: App miễn phí từ Nordic Semiconductor, công cụ thiết yếu cho dev BLE. Cho quét thiết bị, xem dữ liệu quảng cáo, kết nối, khám phá GATT service. Nếu app không tìm thấy thiết bị, điều đầu tiên làm là check nRF Connect có thấy không. Nếu nó cũng không, vấn đề có thể ở peripheral, không phải app.

Test và debug Bluetooth là marathon, không phải sprint. Yêu cầu kiên nhẫn, tiếp cận có phương pháp, và liều lượng tự nhumor lành mạnh. Nhưng với công cụ và kỹ thuật đúng, bạn có thể xỏ lọ con quái.

Bây giờ, hãy nói cách đảm bảo app well-behaved cũng là công dân tốt về hiệu suất.

Hiệu suất và Thực hành tốt nhất: Cách trở thành Công dân Bluetooth tốt

Viết code chạy là một chuyện. Viết code chạy tốt, hiệu quả, không làm user muốn ném điện thoại vào tường là chuyện khác. Về Bluetooth, làm công dân tốt xoay quanh một điều: pin, pin, pin.

Radio Bluetooth phần cứng mạnh, nhưng cũng khát. Mỗi khoảnh khắc hoạt động, nó nhấp nháp năng lượng. Việc của bạn đảm bảo nó chỉ nhấp khi thực sự cần. Đây là quy tắc vàng làm công dân Bluetooth tốt.

1. Đừng quét nếu không cần

Nghe rõ ràng, nhưng lỗi phổ biến nhất. Trước khi nghĩ start quét, tự hỏi: "Tôi thực sự cần làm này bây giờ không?" Nếu user không ở màn hình cần kết quả quét, đừng quét. Nếu app background, extra critical. Background scanning hao pin lớn và bị Android hạn chế nặng cho lý do đó.

2. Dừng quét!

Tôi nói lại vì quá quan trọng: LUÔN dừng quét khi xong. Quét chạy mãi là vòi nước rò rỉ pin. Sẽ cạn kiệt cho đến khi không còn gì. Thực hành tốt gắn vòng đời quét với vòng đời UI.

override fun onPause() { super.onPause() // User không thấy màn hình, không cần kết quả. stopBleScan() } override fun onResume() { super.onResume() // User quay lại màn hình, quét lại. startBleScan() } 

Nếu tìm thấy thiết bị cần, dừng quét ngay. Không cần tiếp tục tìm.

3. Chọn đúng Scan Mode

ScanSettings cho vài mode khác nhau. Chọn khôn ngoan.

  • SCAN_MODE_LOW_POWER: Mode mặc định, hàng ngày. Quét theo khoảng, cân bằng tốc độ khám phá và pin. Dùng cho hầu hết quét foreground.

  • SCAN_MODE_BALANCED: Trung gian. Quét thường xuyên hơn low power.

  • SCAN_MODE_LOW_LATENCY: Mode "TÌM NGAY BÂY GIỜ". Quét liên tục. Tìm thiết bị nhanh nhất, nhưng hao pin nhanh nhất. Chỉ dùng cho operation ngắn, critical.

  • SCAN_MODE_OPPORTUNISTIC: Chế độ thụ động tối thượng. App không trigger quét. Chỉ nhận kết quả nếu app khác đang quét. Dùng 0 pin thêm, nhưng không đảm bảo có kết quả. Dùng cho background update non-critical.

Và đương nhiên, nếu trên AOSP 16 QPR2 trở lên, dùng setScanType(SCAN_TYPE_PASSIVE) khi không cần scan response data. Nó là vua mới của hiệu quả năng lượng.

4. Dùng Hardware Filtering và Batching

Đã cover phần nâng cao, nhưng thực hành tốt đáng lặp lại. Nếu tìm thiết bị cụ thể, dùng ScanFilter. Nếu quét lâu, dùng setReportDelay() batch kết quả. Hai kỹ thuật offload việc cho Bluetooth controller tiết kiệm pin và cho code app ngủ, cách số một tiết kiệm pin.

5. Chú ý Memory

Mỗi object ScanResult app nhận tốn memory. Nếu khu đông đúc với hàng trăm thiết bị BLE, và không dùng filter, app nhanh chóng overwhelmed và out of memory. Lý do khác filter quan trọng. Chỉ lấy kết quả thực sự quan tâm.

Tuân thủ quy tắc này, bạn xây app Bluetooth không chỉ mạnh, giàu tính năng mà còn tôn trọng thiết bị user. Bạn sẽ là Bluetooth sensei thực sự. Bây giờ, wrap up và nhìn tương lai.

Kết luận: Tương lai là Thụ động (Và Đó Là Ổn)

Chúng ta trải qua hành trình khá dài, phải không? Du hành ngược thời gian đến thời kỳ đen tối Bluetooth Classic, chứng kiến phục hưng BLE, và bước vào thế giới mới dũng cảm AOSP 16. Chúng ta học làm ninja im lẽng với quét thụ động, làm thám tử với lý do mất liên kết, và thành thạo nghệ thuật speed dating với service UUID từ quảng cáo.

Nếu có một bài học lớn, đó là tương lai Bluetooth trên Android thông minh hơn, hiệu quả hơn, và bớt令人沮丧 hơn nhiều. Đội Android rõ ràng lắng nghe pain point của developer và cho công cụ cần thiết xây app tốt hơn, thân thiện pin hơn. Giới thiệu quét thụ động không chỉ tính năng mới - đó là thay đổi triết lý. Là sự công nhận rằng đôi khi, cách giao tiếp tốt nhất là chỉ lắng nghe.

Là developer, công cụ mới này empower chúng ta vượt qua use case đơn giản "kết nối và stream". Chúng ta giờ xây dựng được ứng dụng context-aware tinh vi, liên tục nhận biết môi trường mà không biến điện thoại người dùng thành giấy tờ đắt tiền. Giấc mơ thế giới thực sự thông minh, kết nối liền mạch gần hơn một chút, và sẽ được xây trên nền tảng công nghệ tiết kiệm năng lượng này.

Vậy tiếp theo là gì? Thế giới Bluetooth luôn tiến hóa. Chúng ta có Bluetooth 5.4 với Auracast, mesh networking, và định vị chính xác hơn trên đường. Điều chắc chắn là công cụ sẽ tiếp tục tốt hơn, và thách thức sẽ tiếp tục thú vị hơn.

Hiện tại, hãy trân trọng tiến bộ. Lần sau bạn start quét Bluetooth và nó just works, dành khoảnh khắc cảm ơn kỹ sư vất vả làm cho nó có thể. Và lần sau biểu đồ pin app là đường line đẹp, phẳng thay vì dốc ski slope đáng sợ, gật đầu nhỏ trước sức mạnh quét thụ động.

Quái thú Bluetooth có thể không bao giờ được thuần phục hoàn toàn, nhưng với AOSP 16, chúng ta được dây cởi mạnh hơn nhiều. Đi xây những thứ tuyệt vời. Và vì tất cả thứ thiêng liêng, nhớ dừng quét.

Học lập trình miễn phí. Chương trình open source freeCodeCamp đã giúp hơn 40.000 người lấy việc developer. Bắt đầu ngay