Na tej stronie znajdziesz przydatne informacje, których partnerzy potrzebują do planowania projektu szybkiego parowania i integracji systemu.
Materiały i proces szybkiego parowania
Ta sekcja zawiera linki do ogólnych informacji o marketingu i procesach.
Marketing, budowanie marki i przekaz
Odwiedź Partner Marketing Hub, aby uzyskać wskazówki dotyczące budowania marki i komunikacji. Nowi partnerzy muszą poprosić o dostęp, a obecni partnerzy mogą już uzyskać dostęp do treści za pomocą konta w domenie partnera.
Cykl życia projektu szybkiego parowania
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 usługą.
Proces certyfikacji
Urządzenia obsługujące Szybkie parowanie muszą być certyfikowane, zanim produkt będzie mógł być sprzedawany z tą funkcją. W wytycznych dotyczących certyfikacji Szybkiego parowania opisano, jak przygotować się do certyfikacji i przeprowadzić autotesty przed certyfikacją.
W najczęstszych pytaniach dotyczących certyfikacji znajdziesz odpowiedzi na wiele typowych pytań, 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, również muszą mieć certyfikat. Przełącznik dźwięku ma osobne wytyczne dotyczące certyfikacji, które opisują kroki autotestu i przygotowanie do certyfikacji przez zewnętrzne laboratorium.
Laboratoria zewnętrzne mogą certyfikować funkcje Szybkie parowanie i przełącznik dźwięku po kolei. Informacje o tym, które laboratoria oferują poszczególne usługi certyfikacji, znajdziesz na stronie Wysyłanie urządzeń do laboratoriów zewnętrznych.
Uwagi techniczne
W tej sekcji znajdziesz uwagi dotyczące implementacji technicznej, które pomogą partnerom w rozwoju i integracji.
Jak reklamować inne protokoły obok Szybkiego parowania
Niektóre urządzenia mogą obsługiwać dodatkowe funkcje oprócz szybkiego parowania, takie jak Asystent Google czy Eddystone, które wymagają dodatkowego miejsca na reklamy. W takich przypadkach najlepszym rozwiązaniem jest rotacja danych reklamowych. Jednak reklamy Szybkiego parowania muszą być nadal wyświetlane w ramach interwału reklamowego zgodnie z trybem wykrywalnym i trybem niewykrywalnym.
Rotacja reklam jest testowana podczas fazy testów zewnętrznych w procesie certyfikacji. Przed certyfikacją sprawdź wszystkie schematy rotacji za pomocą aplikacji Fast Pair Validator, aby uniknąć potencjalnych opóźnień, ponownych testów i kosztów.
Skracanie interwału połączenia BLE
Aby zwiększyć wydajność nawiązywania połączenia GATT, dostawca powinien maksymalnie skrócić interwał połączenia. Oczekiwana optymalna wartość to 7,5 ms, która jest stosowana w przypadku większości urządzeń poszukujących.
Stan rozgłaszania BLE i połączenia ze słuchawkami
To, czy zestaw słuchawkowy z funkcją Szybkie parowanie rozgłasza identyfikator modelu czy dane na koncie, zależy od trybu wykrywania BR/EDR zestawu słuchawkowego, a nie od stanu połą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), powinno rozgłaszać dane identyfikatora modelu szybkiego parowania przez BLE." - link
- „Gdy urządzenie nie jest wykrywalne (czyli nie jest w trybie parowania), dostawca powinien rozgłaszać dane konta Szybkiego parowania” – link
TxPower
Zgodnie ze specyfikacją urządzenie poszukujące szacuje odległość na podstawie RSSI i podanego poziomu TxPower. Szacowana odległość jest kluczowym czynnikiem decydującym o tym, czy powiadomienie zostanie wyświetlone.
Proces określania TxPower:
- 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.
- Uwzględnij tę wartość w rozgłaszaniu BLE.
- Uwzględnij tę wartość wraz z informacjami o telefonie testowym w raporcie z autotestu.
Pomiar i ustawianie TxPower za pomocą aplikacji Validator
Aplikacja Validator umożliwia ręczne dostosowanie TxPower do odpowiedniego poziomu na telefonie testowym. Partnerzy mogą użyć tego testu, aby określić prawidłowy poziom TxPower na testowanym urządzeniu przed autotestem lub certyfikacją.
Procedura pomiaru TxPower
Aby zmierzyć TxPower za pomocą aplikacji Validator:
- Otwórz aplikację Validator na telefonie testowym.
- Otwórz menu z kropkami u góry aplikacji:
- Umieść testowane urządzenie w odległości 1 metra od telefonu i kliknij przycisk „ROZPOCZNIJ”.
- Wybierz testowane urządzenie z listy urządzeń.
- Możesz odświeżyć listę urządzeń, klikając przycisk „ANULUJ” i ponownie wybierając przycisk „ROZPOCZNIJ”.
- Dostosuj czerwoną linię (reprezentującą TxPower), aż będzie ledwo dotykać górnej części żółtego obszaru.
- Użyj przycisku „-1”, aby przesunąć czerwoną linię w kierunku żółtego obszaru.
- Użyj przycisku „+1”, aby odsunąć czerwoną linię od żółtego obszaru.
- Zakłócenia sygnału mogą powodować niestabilność czerwonej linii. Jeśli czerwona linia zachowuje się nieregularnie, spróbuj przejść w miejsce, gdzie zakłócenia sygnału są mniejsze.
- Zapisz wartość TxPower i zaktualizuj ją zarówno na testowanym urządzeniu, jak i w Konsoli urządzeń.
Powiadomienia o stanie baterii
Zgodnie ze specyfikacją dostawca może uwzględnić w reklamie informacje o baterii. Poszukujący decyduje, czy wyświetlić, czy ukryć powiadomienie o baterii, w zależności od typu: 0b0011, aby wyświetlić powiadomienie o baterii, lub 0b0100, aby je ukryć. Oto kilka wskazówek dotyczących tego, kiedy należy umieścić informacje o baterii w reklamie i jakiego typu informacje należy podać:
- Dołącz informacje o baterii do reklamy z powiadomieniem o wyświetlaniu baterii
0b0011przez co najmniej 8 sekund, gdy etui jest otwarte, a obie słuchawki są zadokowane. - Uwzględnij informacje o baterii w reklamie z powiadomieniem o ukryciu baterii
0b0100przez co najmniej 5 sekund, gdy etui jest zamknięte, a obie słuchawki są zadokowane. - Aby powiadomienia o stanie baterii były wyświetlane lub ukrywane w odpowiednim momencie, reklama powinna odzwierciedlać rzeczywisty stan w ciągu 2 sekund.
- Powiadomienie o baterii możesz ukryć na 2 sposoby:
- przestanie uwzględniać informacje o baterii w reklamie, a Poszukujący po pewnym czasie (obecnie ustawionym na 20 sekund) ukryje powiadomienie.
- Jeśli reklama zawiera informacje o baterii i powiadomienie o ukryciu baterii
0b0100, urządzenie poszukujące ukrywa powiadomienie natychmiast po otrzymaniu reklamy.
- Jeśli po otwarciu lub zamknięciu etui jest w nim tylko jedna słuchawka, nie trzeba podawać informacji o baterii w reklamie.
- Informacje o baterii można opcjonalnie dołączyć do reklamy, gdy słuchawki są wyjmowane z etui lub do niego wkładane.
- Aby zapobiec śledzeniu, dostawca powinien uwzględniać w reklamie nieprzetworzone dane o baterii tylko wtedy, gdy jest to konieczne (nie przez cały czas).
Implementacja powinna zostać opisana w wyniku autotestu na potrzeby certyfikacji.
Jak włączyć logowanie Szybkiego parowania
Przed rozpoczęciem debugowania upewnij się, że na urządzeniu jest włączony dziennik podsłuchiwania Bluetooth HCI. Aby zapobiec usunięciu kluczowych dzienników Szybkiego parowania ze względów bezpieczeństwa, dołącz do grupy dyskusyjnej Google Fast Pair Partner Test (fast-pair-partner-test@googlegroups.com) za pomocą testowych kont Google.
Aby przechwytywać komunikaty Szybkiego parowania w dziennikach 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 poprzednich poleceń przy każdej sekwencji rozruchowej.
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:
- Na urządzeniach z Androidem 8.x lub nowszym:
shell $ adb pull data/misc/bluetooth/logs logs - Android 7.x:
shell $ adb pull sdcard/btsnoop_hci.log