Ghép nối tài liệu và ghi chú kỹ thuật về tính năng ghép nối nhanh

Trang này mô tả thông tin hữu ích mà các Đối tác cần cho cả việc lập kế hoạch dự án Ghép nối nhanh và tích hợp hệ thống.

Tài liệu và quy trình Ghép nối nhanh

Phần này cung cấp đường liên kết đến thông tin chung về hoạt động tiếp thị và quy trình.

Tiếp thị, xây dựng thương hiệu và truyền tải thông điệp

Hãy truy cập vào Partner Marketing Hub để xem hướng dẫn về việc xây dựng thương hiệu và truyền tải thông điệp. Các đối tác mới cần đăng ký để có quyền truy cập, trong khi các đối tác hiện tại đã có thể truy cập vào nội dung thông qua tài khoản Miền đối tác của họ.

Vòng đời dự án Ghép nối nhanh

Hãy xem trang Vai trò và trách nhiệm của Đơn vị tích hợp hệ thống (SI) để biết nội dung mô tả tổng quan về vòng đời dự án và trách nhiệm của Đối tác khi tích hợp Ghép nối nhanh vào một sản phẩm.

Quy trình chứng nhận

Các thiết bị triển khai Ghép nối nhanh phải được Chứng nhận trước khi bạn có thể tiếp thị sản phẩm bằng tính năng này. Nguyên tắc chứng nhận Ghép nối nhanh mô tả cách chuẩn bị cho quy trình chứng nhận và thực hiện các bài kiểm tra tự đánh giá trước khi chứng nhận.

Câu hỏi thường gặp về chứng chỉ bao gồm nhiều câu hỏi thường gặp, trong đó có nội dung mô tả chung về thời điểm cần có chứng chỉ đầy đủ (hoặc chứng chỉ mới).

Các thiết bị triển khai hoặc sử dụng các tiện ích mở rộng của tính năng Ghép nối nhanh (chẳng hạn như Chuyển đổi âm thanh) cũng phải được chứng nhận. Tính năng chuyển đổi âm thanh có một Nguyên tắc chứng nhận riêng mô tả các bước Tự kiểm tra và chuẩn bị cho Chứng nhận của phòng thí nghiệm bên thứ ba.

Các phòng thí nghiệm bên thứ ba có thể chứng nhận tính năng Ghép nối nhanh và Chuyển đổi âm thanh theo trình tự. Hãy xem trang Vận chuyển thiết bị đến phòng thí nghiệm bên thứ ba để biết phòng thí nghiệm nào cung cấp Dịch vụ chứng nhận nào.

Ghi chú kỹ thuật

Phần này mô tả một số lưu ý về việc triển khai kỹ thuật để hỗ trợ Đối tác trong quá trình phát triển và tích hợp.

Cách quảng cáo các giao thức khác cùng với Ghép nối nhanh

Một số thiết bị có thể muốn hỗ trợ các tính năng bổ sung ngoài Ghép nối nhanh, chẳng hạn như Trợ lý Google hoặc Eddystone, yêu cầu có thêm không gian quảng cáo. Xoay vòng dữ liệu quảng cáo là lựa chọn tốt nhất cho những trường hợp này. Tuy nhiên, quảng cáo Ghép nối nhanh vẫn phải được quảng cáo trong Khoảng thời gian quảng cáo theo chế độ có thể phát hiệnchế độ không thể phát hiện.

Tính năng xoay vòng quảng cáo được kiểm thử trong giai đoạn kiểm thử bên thứ ba của quy trình chứng nhận. Hãy nhớ xác minh mọi sơ đồ xoay bằng ứng dụng Trình xác thực Ghép nối nhanh trước khi chứng nhận để tránh trường hợp chứng nhận bị chậm trễ, phải kiểm tra lại và tốn kém.

Rút ngắn khoảng thời gian kết nối BLE

Để cải thiện hiệu suất kết nối GATT, Nhà cung cấp dự kiến sẽ rút ngắn khoảng thời gian kết nối càng nhiều càng tốt. Giá trị tối ưu dự kiến là 7,5 mili giây và được áp dụng cho hầu hết các Trình tìm kiếm.

Quảng cáo BLE và trạng thái kết nối tai nghe

Việc tai nghe Ghép nối nhanh có quảng cáo mã nhận dạng mô hình hay dữ liệu tài khoản phụ thuộc vào chế độ có thể phát hiện BR/EDR của tai nghe, chứ không phụ thuộc vào trạng thái đã kết nối hay đã ngắt kết nối. Tham khảo Thông số kỹ thuật của dịch vụ Ghép nối nhanh trong các đường liên kết bên dưới:

  • "Khi thiết bị Nhà cung cấp ở chế độ có thể phát hiện BR/EDR (tức là ở chế độ ghép nối), thiết bị đó sẽ quảng cáo Dữ liệu mã nhận dạng mô hình Ghép nối nhanh qua BLE." – đường liên kết
  • "Khi không thể phát hiện (tức là không ở chế độ ghép nối), Nhà cung cấp sẽ quảng cáo Dữ liệu tài khoản Ghép nối nhanh" – đường liên kết

TxPower

Như được xác định trong quy cách, Seeker ước tính khoảng cách theo RSSI dựa trên cấp TxPower đã cho. Khoảng cách ước tính là yếu tố chính để xác định xem có hiển thị thông báo hay không.

Quy trình xác định TxPower là:

  1. Đo đầu ra thực tế của thiết bị bằng điện thoại Android ở khoảng cách 1 mét, sau đó cộng thêm 41 dBm vào giá trị đó.
  2. Đưa giá trị này vào quảng cáo BLE.
  3. Đưa giá trị này vào báo cáo tự kiểm tra cùng với thông tin về điện thoại thử nghiệm.

Đo lường và đặt TxPower bằng Ứng dụng xác thực

Ứng dụng Trình xác thực cung cấp một quy trình kiểm thử để điều chỉnh TxPower theo cách thủ công đến mức thích hợp trên DUT. Đối tác có thể sử dụng bài kiểm thử này để xác định cấp độ TxPower phù hợp trên DUT của họ trước khi tiến hành Tự kiểm tra hoặc Chứng nhận.

Quy trình đo TxPower

Cách đo TxPower bằng Ứng dụng xác thực:

  1. Mở Ứng dụng trình xác thực trên DUT.
  2. Mở trình đơn có biểu tượng dấu chấm ở đầu ứng dụng:
    Thử nghiệm này có tên là "Công cụ hiệu chỉnh mức công suất truyền".
  3. Đặt DUT cách điện thoại 1 mét rồi nhấn nút "BẮT ĐẦU".
    Trang kiểm thử cho thấy khoảng cách ước tính mục tiêu bằng màu vàng.
  4. Chọn DUT trong danh sách thiết bị.
    Các thiết bị được liệt kê theo địa chỉ MAC.
    1. Bạn có thể làm mới danh sách thiết bị bằng cách nhấn vào nút "HUỶ" rồi chọn lại nút "BẮT ĐẦU".
  5. Điều chỉnh đường màu đỏ (đại diện cho TxPower) cho đến khi đường này chạm nhẹ vào đỉnh của vùng màu vàng.
    Việc điều chỉnh chính xác sẽ đặt đường màu Đỏ ở ngay trên cùng của vùng màu Vàng.
    1. Dùng nút "-1" để di chuyển đường màu đỏ về phía vùng màu vàng.
    2. Sử dụng nút "+1" để di chuyển đường màu đỏ ra khỏi vùng màu vàng.
    3. Tín hiệu nhiễu có thể khiến đường màu đỏ không ổn định. Hãy thử di chuyển đến khu vực có ít nhiễu tín hiệu hơn nếu đường màu đỏ hoạt động thất thường.
  6. Lưu giá trị TxPower và cập nhật giá trị này trong cả DUT và Device Console.
    Số này xuất hiện ở đầu màn hình.

Thông báo về pin

Theo quy cách, Nhà cung cấp có thể đưa thông tin về pin vào quảng cáo. Thiết bị theo dõi quyết định có hiện hoặc ẩn thông báo về pin hay không, tuỳ theo loại, 0b0011 để hiện thông báo về pin hoặc 0b0100 để ẩn thông báo đó. Dưới đây là một số nguyên tắc về thời điểm bạn nên đưa thông tin về pin vào quảng cáo và loại thông tin cần sử dụng:

  1. Đưa thông tin về pin vào quảng cáo bằng cách hiển thị thông báo về pin 0b0011 trong ít nhất 8 giây khi hộp sạc được mở và cả hai tai nghe đều được cắm vào.
  2. Đưa thông tin về pin vào quảng cáo kèm theo thông báo ẩn về pin 0b0100 trong ít nhất 5 giây khi hộp sạc đóng và cả hai tai nghe đều được cắm vào.
  3. Để phản hồi việc hiện hoặc ẩn thông báo về pin, quảng cáo phải phản ánh trạng thái thực trong vòng 2 giây.
  4. Có 2 cách để ẩn thông báo về pin:
    1. Ngừng đưa thông tin về pin vào quảng cáo, Trình tìm kiếm sẽ ẩn thông báo sau một khoảng thời gian (hiện được đặt là 20 giây).
    2. Đưa thông tin về pin vào quảng cáo bằng cách ẩn thông báo về pin 0b0100, Người tìm kiếm sẽ ẩn thông báo ngay khi nhận được quảng cáo.
  5. Bạn không bắt buộc phải đưa thông tin về pin vào quảng cáo nếu chỉ có một tai nghe được cắm khi hộp sạc mở hoặc đóng.
  6. Bạn có thể chọn thêm thông tin về pin vào quảng cáo khi tháo tai nghe ra khỏi hộp sạc hoặc khi đặt tai nghe vào hộp sạc.
  7. Để ngăn chặn việc theo dõi, Nhà cung cấp chỉ nên đưa dữ liệu thô về pin vào quảng cáo khi cần (không phải lúc nào cũng cần).

Bạn nên mô tả cách triển khai trong kết quả tự kiểm tra để được Chứng nhận.

Cách bật tính năng ghi nhật ký của Ghép nối nhanh

Đảm bảo bạn đã bật nhật ký theo dõi HCI Bluetooth trên thiết bị trước khi gỡ lỗi. Ngoài ra, để ngăn các nhật ký quan trọng của tính năng Ghép nối nhanh bị che khuất vì lý do bảo mật, hãy tham gia Nhóm thử nghiệm đối tác Ghép nối nhanh của Google (fast-pair-partner-test@googlegroups.com) bằng Tài khoản Google thử nghiệm của bạn.

Để ghi lại thông báo Ghép nối nhanh trong nhật ký gỡ lỗi, hãy chạy:

$ adb logcat -G 16M
$ adb shell setprop log.tag.NearbyMessages VERBOSE
$ adb shell setprop log.tag.NearbyDiscovery VERBOSE
$ adb shell setprop log.tag.FastPair VERBOSE

Google khuyến nghị bạn chạy các lệnh trước đó trong mỗi trình tự khởi động.

Cách trích xuất nhật ký gỡ lỗi

Chạy $ adb bugreport để tạo một tệp zip chứa tất cả dữ liệu. Quá trình tạo tệp zip có thể mất vài phút.

Tuỳ thuộc vào phiên bản Android, hãy chạy một trong các lệnh sau để lấy btsnoop_hic.log:

  • Đối với Android 8.x trở lên: shell $ adb pull data/misc/bluetooth/logs logs
  • Đối với Android 7.x: shell $ adb pull sdcard/btsnoop_hci.log