Hướng dẫn sử dụng ứng dụng Trình xác thực âm thanh LE

Trang này dành riêng cho phiên bản LE Audio của Ứng dụng trình xác thực. Hãy xem trang Ứng dụng trình xác thực nút chuyển âm thanh để được trợ giúp về phiên bản nút chuyển âm thanh của Ứng dụng trình xác thực.

Thiết lập

Cách bật tính năng kiểm thử trong ứng dụng Trình xác thực:

  • Đảm bảo thiết bị có GmsCore phiên bản 23.37.xx trở lên.
  • Đảm bảo email kiểm thử của bạn thuộc Nhóm kiểm thử đối tác Fast Pair.
    • Có thể mất từ 6 đến 24 giờ để email và điện thoại mới đăng ký đồng bộ hoá quyền.
    • Thao tác đăng nhập và đăng xuất khỏi Tài khoản Google được liên kết cũng có thể kích hoạt quá trình đồng bộ hoá ngay lập tức.

Bạn có thể tìm thấy phiên bản GMS trong trang Thông tin ứng dụng cho Dịch vụ Google Play.

Thiết bị bắt buộc

Bạn cần có ít nhất 2 (2) điện thoại để kiểm thử:

  • Một thiết bị chạy Android 15 (U) có hỗ trợ công nghệ Âm thanh LE (ví dụ: Pixel 7)
  • Một thiết bị chạy Android 6-13 (M-T) không hỗ trợ LE Audio.
    • Các thiết bị chỉ dùng dữ liệu chỉ cần sử dụng một trong những điện thoại này.

Kết nối với Hồ sơ âm thanh LE trên Android 15 (V)

Tính năng Âm thanh LE không được bật theo cách gốc trên Android 15 (V). Cách bật tính năng này:

  • Chuyển đến trang "Tuỳ chọn cho nhà phát triển" trên điện thoại.
    • Cách bật Tuỳ chọn cho nhà phát triển:
    • Chuyển đến phần Cài đặt > Hệ thống > Giới thiệu về điện thoại > Số bản dựng.
    • Nhấn vào "Số bản dựng" 7 lần.
  • Tắt chế độ "Tắt âm thanh Bluetooth LE".
  • Bật "Bỏ qua danh sách cho phép đối với tính năng Bluetooth Âm thanh năng lượng thấp".
  • Khởi động lại điện thoại.

Thao tác này sẽ hiển thị các nút chuyển LEA trong trang Tuỳ chọn cho nhà phát triển.

Bật tính năng Kiểm thử BLE cho thiết bị chỉ có dữ liệu

Ứng dụng trình xác thực sẽ hiển thị trình đơn kiểm thử chỉ dữ liệu nếu Mã kiểu của thiết bị có "Kết nối chỉ dữ liệu" được chọn trong Device Console (lưu ý: không phải loại thiết bị nào cũng có tuỳ chọn này). Trình đơn kiểm thử cho chế độ này như sau:

Ứng dụng sẽ tự động cập nhật danh sách kiểm thử cho thiết bị chỉ có dữ liệu sau khi bạn bật nút chuyển.

Bật Quy cách BLE và kiểm thử BT cổ điển cho các thiết bị không hỗ trợ Âm thanh LE

Người kiểm thử sẽ cần bật nút chuyển "Bật kiểm thử theo thông số kỹ thuật LE" để xem các kiểm thử BLE. Người kiểm thử sẽ cần xác nhận rằng thiết bị đang được kiểm thử không hỗ trợ Âm thanh năng lượng thấp để xem các bài kiểm thử BT Classic, như minh hoạ:

Danh sách kiểm thử chỉ được cập nhật sau khi người kiểm thử xác nhận rằng thiết bị không hỗ trợ Âm thanh LE.

Bật Quy cách BLE và kiểm thử Âm thanh LE trên điện thoại Pixel chạy Android 14 (U) trở lên

Người kiểm thử sẽ cần bật nút chuyển "Bật kiểm thử theo thông số LE" để xem các kiểm thử BLE. Sau đó, người kiểm thử phải xác nhận các lời nhắc còn lại để xem màn hình kiểm thử. Ứng dụng sẽ tự động điền các bài kiểm thử có sẵn cho cấu hình này, bao gồm cả các bài kiểm thử LE Audio, như minh hoạ:

Ứng dụng có thể điền chính xác danh sách kiểm thử vì điện thoại Pixel là một cấu hình đã biết.

Bật Quy cách BLE và kiểm thử Âm thanh LE trên điện thoại Pixel chạy Android 13 (T) trở xuống

Người kiểm thử sẽ cần bật nút chuyển "Bật kiểm thử theo thông số LE" để xem các kiểm thử BLE. Sau đó, người kiểm thử phải xác nhận các lời nhắc còn lại để xem màn hình kiểm thử. Ứng dụng sẽ tự động điền các bài kiểm thử có sẵn cho cấu hình này, bao gồm cả các bài kiểm thử BT cổ điển, như minh hoạ:

Ứng dụng có thể điền chính xác danh sách kiểm thử vì điện thoại Pixel là một cấu hình đã biết.

Bật Thông số kỹ thuật BLE và kiểm thử Âm thanh LE trên điện thoại không phải Pixel có hỗ trợ Âm thanh LE

Người kiểm thử sẽ cần bật nút chuyển "Bật kiểm thử theo thông số LE" để xem các kiểm thử BLE. Người kiểm thử phải cho Ứng dụng xác thực biết liệu Điện thoại và thiết bị kiểm thử (trình tìm kiếm) có hỗ trợ kết nối với Âm thanh năng lượng thấp hay không. Ứng dụng không thể biết thông tin này đối với điện thoại không phải Pixel, vì nhà sản xuất thiết bị gốc (OEM) kiểm soát việc hỗ trợ tính năng. Việc chọn hỗ trợ Âm thanh năng lượng thấp trong cửa sổ bật lên sẽ bật các bài kiểm thử Âm thanh năng lượng thấp, như minh hoạ:

Các bài kiểm thử Âm thanh năng lượng thấp sẽ xuất hiện nếu người dùng xác nhận rằng điện thoại không phải Pixel hỗ trợ Âm thanh năng lượng thấp.

Bật quy cách BLE và kiểm thử âm thanh LE trên điện thoại không phải Pixel có hỗ trợ A2DP và HFP

Người kiểm thử sẽ cần bật nút chuyển "Bật kiểm thử theo thông số LE" để xem các kiểm thử BLE. Người kiểm thử phải cho Ứng dụng xác thực biết liệu Điện thoại và thiết bị kiểm thử (trình tìm kiếm) có hỗ trợ kết nối với Âm thanh năng lượng thấp hay không. Ứng dụng không thể biết thông tin này đối với điện thoại không phải Pixel, vì nhà sản xuất thiết bị gốc (OEM) kiểm soát việc hỗ trợ tính năng. Việc chọn hỗ trợ A2DP + HFP trong cửa sổ bật lên sẽ bật các thử nghiệm BT Classic, như minh hoạ:

Các bài kiểm thử BT Classic sẽ xuất hiện nếu người dùng chọn hỗ trợ A2DP + HFP cho điện thoại không phải Pixel.

Bài kiểm thử bắt buộc

Hãy xem Mục kiểm thử bắt buộc để biết những kiểm thử cần thiết cho một phiên bản Ghép nối nhanh và loại thiết bị nhất định. Xin lưu ý rằng bảng này có các thẻ riêng biệt cho Thiết bị chỉ dùng dữ liệu, Điện thoại chạy Android 13 trở xuống và Điện thoại chạy Android 14 trở lên.

Xác minh UUID của Dịch vụ âm thanh phổ biến

Quy trình kiểm thử này xác minh rằng quảng cáo có thể kết nối LE bao gồm CAS UUID, theo yêu cầu của Hồ sơ bộ chuyển đổi Bluetooth (BAP 1.0.1)Hồ sơ âm thanh chung.

Kết quả kiểm thử thành công sẽ có dạng như sau:

Một lần kiểm thử thành công sẽ hiển thị kết quả Đạt trong nhật ký.

Quy trình kiểm thử này xác minh rằng Nhà cung cấp sử dụng đúng loại địa chỉ (dữ liệu dịch vụ ghép nối nhanh (0xFE2C)) khi quảng cáo trong quá trình ghép nối ban đầu (địa chỉ nhận dạng) và các lần ghép nối tiếp theo (RPA).

  • Những thiết bị hỗ trợ CTKD từ phiên bản Cũ đến LE phải quảng cáo RPA trong quá trình ghép nối ban đầu.
  • Tất cả các thiết bị khác hỗ trợ CTKD từ LE đến Classic phải quảng cáo địa chỉ nhận dạng của chúng trong quá trình ghép nối ban đầu.
  • Tất cả thiết bị, bất kể có hỗ trợ CTKD hay không, đều phải quảng cáo RPA của chúng trong quá trình ghép nối tiếp theo.

Kết quả kiểm thử thành công sẽ có dạng như sau:

Một lần kiểm thử thành công sẽ hiển thị kết quả Đạt trong nhật ký.

Kiểm thử các thay đổi trong Chế độ đặc tả BLE

Một số bài kiểm thử sẽ thay đổi sau khi bạn kích hoạt nút chuyển "Bật kiểm thử thông số kỹ thuật LE". Ví dụ: các bài kiểm thử "Cập nhật mức pin" sẽ thay đổi thành "Cập nhật mức pin bằng kết nối âm thanh LE" và "Cập nhật mức pin bằng kết nối hồ sơ cổ điển". Các chương trình kiểm thử đã sửa đổi sẽ chỉ xuất hiện trên các phiên bản Android tương ứng.

Mọi kiểm thử thay đổi như vậy đều phải được kiểm thử trên 2 điện thoại để đảm bảo chức năng hoạt động đúng cách, một điện thoại không có LE Audio và một điện thoại có LE Audio. Đối với điện thoại Pixel, điều này có nghĩa là kiểm thử trên điện thoại chạy Android 14 (U) trở lên và điện thoại chạy Android 13 (T) trở xuống. Đối với điện thoại không phải Pixel, điều này có nghĩa là kiểm thử trên một điện thoại đã triển khai LE Audio và một điện thoại chỉ có A2D + HFP.

Ví dụ về thay đổi này:

Quy trình kiểm thử sẽ thay đổi thành LE Audio trên Android 14 trở lên, trong khi sử dụng BLE CLassic trên Android 13 trở xuống.

Cách tải kết quả lên Bảng điều khiển thiết bị

Cách gửi kết quả

Nút "GỬI KẾT QUẢ" sẽ hiển thị bản tóm tắt kết quả kiểm tra nhưng không thực sự gửi kết quả cho Google.

Quy trình gửi bắt đầu bằng cách nhấn vào nút "GỬI KẾT QUẢ".

Sau khi xem xét tất cả kết quả, hãy nhấn nút "GỬI" ở cuối trang kết quả để gửi kết quả cho Google.

Kết quả sẽ được gửi sau khi bạn cuộn xuống cuối trang kết quả và nhấn

Xem kết quả đã tải lên trong Device Console

Bạn có thể xem kết quả kiểm thử đã gửi trên Bảng điều khiển Nearby. (Chỉ số khoảng cách và Chỉ số thời lượng sẽ bị xoá đối với các trường hợp kiểm thử nút chuyển Âm thanh). Ví dụ:

Kết quả kiểm thử sẽ xuất hiện trong một bảng trong Nearby Console.

Khắc phục sự cố

Hãy thử tắt rồi bật lại Bluetooth nếu tất cả các bài kiểm thử đều không thành công.

Bạn có thể bật và tắt Bluetooth bằng nút trên trình đơn thả xuống.

Không nhận được KeyBasedPairingResponse

Nếu ghép nối thành công nhưng thông báo lỗi vẫn xuất hiện như minh hoạ, thì có thể nguyên nhân là do phiên bản lõi GMS cũ. Xác minh rằng điện thoại đã được định cấu hình như mô tả trong phần thiết lập.

Các ảnh chụp màn hình sau đây cho thấy cách lỗi này có thể xuất hiện trong các bài kiểm thử khác nhau.

Ứng dụng hiển thị lỗi KeyBasedPairingResponse trong kiểm thử tích hợp E2E. Ứng dụng hiển thị lỗi KeyBasedPairingResponse trong các kiểm thử Tự động ghép nối và Tự động ghép nối tiếp theo.

Loại KeyBasedPairingResponse không chính xác

Điều này có thể là do Nhà cung cấp gửi sai loại thông báo. Trình tìm kiếm hỗ trợ LE Audio sẽ nhận được loại thông báo 2, còn tất cả các trường hợp khác sẽ nhận được loại thông báo 1.

Các ảnh chụp màn hình sau đây cho thấy cách lỗi này có thể xuất hiện trong các bài kiểm thử khác nhau.

Ứng dụng hiển thị lỗi KeyBasedPairingResponseType trong kiểm thử tích hợp E2E. Ứng dụng hiển thị lỗi KeyBasedPairingResponseType trong các kiểm thử Tự động ghép nối và Tự động ghép nối tiếp theo.

KeyBasedPairingExtensionResponse Chiều dài địa chỉ không chính xác

Điều này có thể là do bạn chọn sai loại hỗ trợ CSIP cho thiết bị Âm thanh LE. Các thiết bị hỗ trợ CSIP và LE Audio sẽ nhận được địa chỉ có độ dài là 2, còn tất cả các trường hợp khác sẽ nhận được địa chỉ có độ dài là 1.

Các ảnh chụp màn hình sau đây cho thấy cách lỗi này có thể xuất hiện trong các bài kiểm thử khác nhau.

Ứng dụng hiển thị lỗi về độ dài địa chỉ KeyBasedPairingExtensionResponse trong kiểm thử tích hợp E2E. Ứng dụng hiển thị lỗi về độ dài địa chỉ KeyBasedPairingExtensionResponse trong các bài kiểm thử Tự động ghép nối và Tự động ghép nối tiếp theo.

Lỗi trạng thái

Điều này thường là do nhà cung cấp (thiết bị) không kết nối được. Đối với thiết bị CSIP, phải có hai (2) sự kiện kết nối.

Các ảnh chụp màn hình sau đây cho thấy cách lỗi này có thể xuất hiện trong các bài kiểm thử khác nhau.

Ứng dụng hiển thị lỗi Trạng thái trong kiểm thử Tích hợp E2E. Ứng dụng hiển thị lỗi Trạng thái trong kiểm thử Tự động ghép nối và Tự động ghép nối tiếp theo.

Chỉ nhận sự kiện kết nối từ 1 địa chỉ

Điều này xảy ra khi Trình tìm kiếm chỉ nhận được 1 địa chỉ từ thiết bị CSIP. Thiết bị có khả năng CSIP phải luôn cung cấp 2 địa chỉ.

Các ảnh chụp màn hình sau đây cho thấy cách lỗi này có thể xuất hiện trong các bài kiểm thử khác nhau.

Ứng dụng chỉ hiển thị sự kiện kết nối nhận được từ 1 lỗi địa chỉ trong các bài kiểm thử Tự động ghép nối và Tự động ghép nối tiếp theo.

Không nhận được UUID

Trình tìm kiếm không nhận được bất kỳ UUID nào.

Các ảnh chụp màn hình sau đây cho thấy cách lỗi này có thể xuất hiện trong các bài kiểm thử khác nhau.

Ứng dụng hiển thị lỗi UUID trong kiểm thử tích hợp E2E. Ứng dụng hiển thị lỗi UUID trong các bài kiểm thử Tự động ghép nối và Tự động ghép nối tiếp theo.

Không nhận được UUID dự kiến

Trình tìm kiếm dự kiến sẽ nhận được một loại UUID cụ thể cho nhiều tình huống. Bảng sau đây xác định UUID trong các trường hợp khác nhau.

Nhà cung cấp hỗ trợ âm thanh LE Nhà cung cấp không hỗ trợ Âm thanh năng lượng thấp Nhà cung cấp là một thiết bị chỉ có dữ liệu
Trình tìm kiếm không hỗ trợ BLE 110B hoặc 1108 hoặc 111E 110B hoặc 1108 hoặc 111E Không áp dụng
Trình tìm kiếm hỗ trợ BLE 110B hoặc 1108 hoặc 111E 110B hoặc 1108 hoặc 111E 1812
Trình tìm kiếm hỗ trợ BLE và LEA 184E 110B hoặc 1108 hoặc 111E 1812

Các ảnh chụp màn hình sau đây cho thấy cách lỗi này có thể xuất hiện trong các bài kiểm thử khác nhau.

Ứng dụng hiển thị lỗi UUID không mong muốn trong kiểm thử tích hợp E2E. Ứng dụng hiển thị lỗi UUID không mong muốn trong các bài kiểm thử Tự động ghép nối và Tự động ghép nối tiếp theo.

Chỉ nhận được UUID chính xác từ 1 địa chỉ

Điều này xảy ra khi Trình tìm kiếm chỉ nhận được 1 địa chỉ từ thiết bị CSIP. Thiết bị có khả năng CSIP phải luôn cung cấp 2 địa chỉ.

Các ảnh chụp màn hình sau đây cho thấy cách lỗi này có thể xuất hiện trong các bài kiểm thử khác nhau.

Ứng dụng chỉ cho thấy lỗi nhận 1 UUID trong kiểm thử tích hợp E2E. Ứng dụng chỉ cho thấy lỗi nhận được 1 UUID trong các thử nghiệm Tự động ghép nối và Tự động ghép nối tiếp theo.