Materiały dotyczące szybkiego parowania i informacje techniczne

Na tej stronie znajdziesz przydatne informacje dla partnerów, które pomogą im w planowaniu projektu Szybkie parowanie i integracji systemu.

Materiały i proces Szybkiego parowania

W tej sekcji znajdziesz linki do ogólnych informacji o marketingu i procesach.

Marketing, budowanie marki i komunikacja

Wskazówki dotyczące brandingu i komunikatów znajdziesz na naszej stronie Partner Marketing Hub. Nowi partnerzy muszą złożyć wniosek o dostęp, a obecni partnerzy mogą już uzyskać dostęp do treści za pomocą konta domeny partnera.

Cykl życia projektu Szybkie parowanie

Na stronie Role i obowiązki integratora systemów znajdziesz ogólny opis cyklu życia projektu i obowiązków partnerów integrujących Szybkie parowanie z produktem.

Proces certyfikacji

Urządzenia obsługujące szybkie parowanie muszą mieć certyfikat, zanim produkt będzie mógł być sprzedawany z tą funkcją. W wytycznych dotyczących certyfikacji Szybkiego parowania znajdziesz informacje o tym, jak przygotować się do certyfikacji i przeprowadzić testy samodzielne przed certyfikacją.

Najczęstsze pytania dotyczące certyfikacji obejmują różne typowe pytania, w tym ogólny opis sytuacji, w których wymagana jest pełna certyfikacja (lub ponowna certyfikacja).

Urządzenia, które implementują lub używają rozszerzeń Szybkiego parowania, takich jak przełącznik dźwięku, muszą też mieć certyfikat. Przełącznik dźwięku ma osobne wytyczne dotyczące certyfikacji, w których opisano kroki autotestu i przygotowania do certyfikacji w laboratorium zewnętrznym.

Laboratoria zewnętrzne mogą certyfikować Szybkie parowanie i przełącznik dźwięku kolejno. Na stronie Wysyłanie urządzeń do laboratoriów zewnętrznych znajdziesz informacje o tym, które laboratoria oferują które usługi certyfikacyjne.

Uwagi techniczne

W tej sekcji znajdziesz kilka uwag dotyczących wdrożenia technicznego, które pomogą Partnerom w opracowywaniu i integrowaniu rozwiązań.

Jak reklamować inne protokoły wraz z szybkim parowaniem

Niektóre urządzenia mogą obsługiwać dodatkowe funkcje poza szybkim parowaniem, takie jak Asystent Google czy Eddystone, które wymagają dodatkowej przestrzeni reklamowej. W takich przypadkach najlepszym rozwiązaniem jest rotacja danych reklamowych. Reklamy Szybkiego parowania muszą być jednak nadal wyświetlane w interwale reklamowym zgodnie z trybem wykrywalnym i trybem niewykrywalnym.

Rotacja reklam jest testowana podczas fazy testów zewnętrznych w procesie certyfikacji. Przed uzyskaniem certyfikatu sprawdź schematy rotacji za pomocą aplikacji Walidator Szybkiego parowania, aby uniknąć potencjalnych opóźnień w certyfikacji, ponownych testów i dodatkowych kosztów.

Skracanie interwału połączenia BLE

Aby poprawić wydajność połączenia GATT, dostawca powinien skrócić interwał połączenia do minimum. Oczekiwana optymalna wartość to 7,5 ms, która jest stosowana w przypadku większości wyszukiwarek.

Stan reklamy BLE i połączenia zestawu słuchawkowego

To, czy słuchawki Szybkie parowanie rozgłaszają identyfikator modelu czy dane na koncie, zależy od trybu wykrywania BR/EDR słuchawek, a nie od stanu połączenia lub rozłączenia. Zapoznaj się ze specyfikacją usługi Szybkie parowanie, korzystając z linków poniżej:

  • Gdy urządzenie dostawcy jest wykrywalne w trybie BR/EDR (czyli w trybie parowania), musi ono rozgłaszać dane identyfikatora modelu Szybkiego parowania przez BLE. - link
  • Gdy urządzenie nie jest wykrywalne (tzn. nie jest w trybie parowania), dostawca musi rozgłaszać dane konta Szybkiego parowania” – link

TxPower

Zgodnie z specyfikacją lokalizator szacuje odległość na podstawie wskaźnika RSSI i podanego poziomu mocy nadajnika. Szacowana odległość jest kluczowym czynnikiem decydującym o tym, czy wyświetlić powiadomienie.

Proces określania mocy TxPower wygląda tak:

  1. Zmierz rzeczywistą moc wyjściową urządzenia za pomocą telefonu z Androidem z odległości 1 metra, a następnie dodaj do niej 41 dBm.
  2. Uwzględnij tę wartość w reklamie BLE.
  3. Uwzględnij tę wartość w informacjach o testowym telefonie w raporcie z autotestu.

Pomiar i ustawianie mocy transmisji za pomocą aplikacji weryfikacyjnej

Aplikacja Validator App umożliwia ręczne dostosowanie mocy nadawczej (TxPower) na testowanym urządzeniu do odpowiedniego poziomu. Partnerzy mogą użyć tego testu, aby określić odpowiedni poziom TxPower na testowanym urządzeniu przed przeprowadzeniem Autotestu lub uzyskaniem certyfikatu.

Procedura pomiaru TxPower

Aby zmierzyć moc TxPower za pomocą aplikacji Validator:

  1. Otwórz aplikację weryfikacyjną na testowanym urządzeniu.
  2. Otwórz menu z 3 kropkami u góry aplikacji:
    Test nosi nazwę „Narzędzie do kalibracji poziomu mocy transmisji”.
  3. Umieść urządzenie w odległości 1 metra od telefonu i kliknij przycisk „START”.
    Na stronie testowej docelowa szacowana odległość jest wyświetlana na żółto.
  4. Wybierz DUT z listy urządzeń.
    Urządzenia są wymienione według adresów MAC.
    1. Listę urządzeń możesz odświeżyć, klikając przycisk „ANULUJ”, a następnie ponownie wybierając przycisk „ROZPOCZNIJ”.
  5. Dopasuj czerwoną linię (reprezentującą moc TxPower), aż będzie się ledwo stykać z górną krawędzią żółtego obszaru.
    Prawidłowe ustawienie powoduje, że czerwona linia znajduje się na samym szczycie żółtego obszaru.
    1. Użyj przycisku „-1”, aby przesunąć czerwoną linię w kierunku żółtego obszaru.
    2. Użyj przycisku „+1”, aby odsunąć czerwoną linię od żółtego obszaru.
    3. Zakłócenia sygnału mogą powodować niestabilność czerwonej linii. Jeśli czerwona linia zachowuje się nieregularnie, spróbuj przenieść się w miejsce, w którym sygnał jest mniej zakłócany.
  6. Zapisz wartość TxPower i zaktualizuj ją zarówno na urządzeniu, jak i w konsoli urządzenia.
    Numer jest wyświetlany u góry ekranu.

Powiadomienia o baterii

Zgodnie ze specyfikacją dostawca może umieścić w reklamie informacje o baterii. Urządzenie wyszukujące decyduje, czy wyświetlić powiadomienie o baterii, w zależności od typu: 0b0011, aby wyświetlić powiadomienie o baterii, lub 0b0100, aby je ukryć. Oto wskazówki dotyczące tego, kiedy należy podawać informacje o baterii w reklamie i jakiego typu informacji należy używać:

  1. Umieść w reklamie informacje o baterii z powiadomieniem o stanie baterii 0b0011 przez co najmniej 8 sekund po otwarciu etui i zadokowaniu obu słuchawek.
  2. Umieść informacje o baterii w reklamie z ukrytym powiadomieniem o baterii0b0100 na co najmniej 5 sekund, gdy etui jest zamknięte, a obie słuchawki są zadokowane.
  3. Aby powiadomienia o baterii były wyświetlane lub ukrywane w odpowiedni sposób, reklama powinna odzwierciedlać rzeczywisty stan w ciągu 2 sekund.
  4. Powiadomienie o baterii możesz ukryć na 2 sposoby:
    1. Przestań uwzględniać informacje o baterii w reklamie. Wyszukiwarka po pewnym czasie ukryje powiadomienie (obecnie jest to 20 sekund).
    2. Jeśli w reklamie uwzględnisz informacje o baterii i ukryjesz powiadomienie o baterii 0b0100, wyszukujący natychmiast ukryje powiadomienie po otrzymaniu reklamy.
  5. Jeśli po otwarciu lub zamknięciu etui w stacji dokującej znajduje się tylko jedna słuchawka, nie musisz podawać informacji o baterii w reklamie.
  6. Podczas wyjmowania słuchawek z etui lub umieszczania ich w etui podawanie informacji o baterii w reklamie jest opcjonalne.
  7. Aby zapobiec śledzeniu, dostawca powinien uwzględniać w reklamie tylko nieprzetworzone dane o baterii, gdy jest to konieczne (nie cały czas).

Implementacja powinna być opisana w wyniku autotestu na potrzeby certyfikacji.

Jak włączyć logowanie Szybkiego parowania

Przed rozpoczęciem debugowania upewnij się, że na urządzeniu włączono dziennik snoopingu interfejsu HCI Bluetooth. Aby zapobiec redagowaniu kluczowych logów Szybkiego parowania ze względów bezpieczeństwa, dołącz do grupy testowej Szybkiego parowania dla partnerów w Google (fast-pair-partner-test@googlegroups.com) za pomocą testowych kont Google.

Aby przechwytywać wiadomości Szybkiego parowania w logach debugowania, uruchom:

$ 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 zaleca uruchamianie powyższych poleceń przy każdej sekwencji rozruchu.

Jak wyodrębnić dziennik debugowania

Uruchom $ adb bugreport, aby wygenerować plik ZIP, który powinien zawierać wszystkie dane. Wygenerowanie pliku ZIP może potrwać kilka minut.

W zależności od wersji Androida uruchom jedno z tych poleceń, aby uzyskaćbtsnoop_hic.log:

  • Android 8.x lub nowszy:shell $ adb pull data/misc/bluetooth/logs logs
  • Android 7.x: shell $ adb pull sdcard/btsnoop_hci.log