Wytyczne dotyczące certyfikacji przełącznika dźwięku

Przygotowanie do uzyskania certyfikatu

• Przygotuj urządzenia testowe.
  • Potrzebne będą 5 urządzeń z Androidem.
    • Urządzenia te muszą zawierać:
      • Co najmniej jeden Android T (13) i 1 Android V (15).
      • Co najmniej 1 Samsung i 1 Pixel.
      • Na przykład:
        • 1 OnePlus (Android 10).
        • 3 Samsung (Android 11, 12, 13).
        • 1 Pixel (Android 15).
  • Jedno urządzenie bez przełącznika dźwięku:
    • dowolny iPhone, komputer PC, laptop z Bluetooth (BT) lub telefon z Androidem, na którym wyłączono przełącznik dźwięku.
      • Możesz wyłączyć przełącznik Dźwięk w ustawieniach szczegółów urządzenia Bluetooth.
    • W przypadku testu 2.8 dotyczącego połączenia wielopunktowego (MP) oprócz 5 testowych telefonów potrzebne jest urządzenie bez przełącznika dźwięku.

• Dołącz do grupy testowej przełączników dźwięku ze swoimi kontami testowymi w aby wyświetlać powiadomienia o debugowaniu na telefonach testowych.

  • Umożliwia to Google zbieranie danych testowych w Google Analytics.

Klasyczny z A2DP + HFP

• Upewnij się, że wszystkie urządzenia z Androidem mają GmsCore w wersji 23.xx.xx lub nowszej Zainstalowano.

BLE z LE Audio

• Co najmniej dwa z tych telefonów referencyjnych muszą obsługiwać technologię LE Audio.
  • Na przykład 1 telefon Samsung i 1 Pixel z obsługą LE Audio.
• Upewnij się, że wszystkie urządzenia z Androidem mają GmsCore w wersji 24.33.xx lub nowszej Zainstalowano.

Kryteria certyfikacji

• Wskaźnik sukcesu przełączenia docelowego musi we wszystkich przypadkach testowych przekraczać 95%.

• W testach wymagających przełączenia: połączenie z profilem i przełączenie stanu aktywności musi zakończyć się w ciągu 3 sekund od wywołania zdarzeń dźwiękowych w co najmniej 75%; przypadków.

Klasyczny z A2DP+HFP

Testy samodzielne należy przeprowadzać w tych kombinacjach:

• Telefon A=Android S (12) + telefon B=Android T (13)
• Telefon A=Android T (13) + telefon B=Android S (12)

BLE z LE Audio

Testy samodzielne należy przeprowadzać w tych kombinacjach:

• Telefon A: BT Classic, Telefon B: BT Classic
• Telefon A: LE Audio, telefon B: BT Classic
• Telefon A: BT Classic, Telefon B: LE Audio

Opcjonalnie dostawcy, którzy obsługują połączenia Dual LE Audio, powinni przetestować:

• Telefon A: LE Audio, telefon B: LE Audio

Przewodnik dotyczący testowania

Przygotowanie urządzenia testowanego (DUT)

• Sprawdź, czy urządzenie BT nie zostało wcześniej sparowane z żadnym telefonem zalogowanym na konto Google testowe.
  • Jeśli urządzenie zostało sparowane z testowym kontem Google, wykonaj , aby wyczyścić parowanie:
    • Na sparowanych urządzeniach:
      • Otwórz ustawienia Bluetootha.
      • Wybierz „Zapomnij urządzenie”.
      • Włącz i wyłącz tryb samolotowy.
  • Upewnij się, że opcja „Automatycznie zapisuj urządzenia” jest włączona.
    • Domyślnie ten przełącznik jest wyłączony.
    • Opcję tę znajdziesz w sekcji Ustawienia > Google > Urządzenia > Zapisane urządzenia (po jednym na DUT).
  • Przełącz urządzenie Bluetooth w tryb parowania.
  • Sparuj początkowe urządzenie Bluetooth (A).
  • Parowanie kolejnych urządzeń Bluetooth z innymi urządzeniami (B, C, D itd.).

Zakres

• Wszystkie zestawy słuchawkowe przeprowadzają testy na różnych kartach Szablon autotestu przełącznika dźwięku.
• Słuchawki obsługujące tylko tryb SinglePoint (SP) umożliwiają:
  • Karta Generic_test.
• Zestawy słuchawkowe obsługujące tryb MP działają:
  • Karta Generic_test.
  • Karta Multipoint_only.
• Słuchawki MP, które można przełączyć w tryb SP, obsługują:
  • Karta General_test z wyłączonym trybem MP.
  • Karta Generic_test z włączonym MP.
  • Karta Multipoint_only z włączonym połączeniem wielopunktowym.

Samopoczucie i raport z samotestu

• Utwórz kopię raportu z samodiagnozy Switcha.
• Uruchom wszystkie przypadki testowe co najmniej 2 razy.

• Testy powinny być wykonywane w takiej formie:

Klasyczny z A2DP+HFP

• Urządzenie B będzie głównym urządzeniem testowym.
  • Wpisz szczegóły urządzenia B w polach „Telefon” i „System operacyjny” u góry szablonu.

Przykładowy przypadek testowy:

• Telefony testowe:

  • Urządzenie 1: Samsung (Android 13)
  • Urządzenie 2: Pixel (Android 12 lub 13) i inne.

• Wykonane testy:

  • Bieg 1. Urządzenie A = Samsung S10+ (12), urządzenie B = Pixel 7 Pro (13) kolumna D: telefon = Pixel 7 Pro, system operacyjny = Android 13
  • Bieg 2. Urządzenie A=Pixel 7 Pro (13), Urządzenie B=Pixel 6(12) kolumna E: Telefon=Pixel 6, OS=Android 12

Przykład wypełnionego testu w szablonie testu samodzielnego:

BLE z LE Audio

1. Urządzenie A=Android V (15) + urządzenie B=Android T (13)
2. Urządzenie A=Android T (13) + Urządzenie B=Android V (15)
3. Urządzenie A = Android T (13) + urządzenie B = Android S (12)
4. Urządzenie A = Android T (15) + urządzenie B = Android V (15)
5. Urządzenie B będzie głównym urządzeniem DUT.
   • Wpisz dane urządzenia B w polu „Telefon” i „OS” pól w górnej części szablon.

Przykładowy przypadek testowy:

• Telefony testowe:

  • Urządzenie 1: Samsung (Android 13)
  • Urządzenie 2: Pixel (Android 15) i inne.

• Wykonane testy:

  • [LEA+BT]: Urządzenie A= Pixel 8 (15), Urządzenie B=Pixel 7 Pro (13) kolumna D: Telefon=Pixel 7 Pro, OS=Android 13
  • [BT+LEA]: Kolumna Urządzenie A=Pixel 7 (13), Urządzenie B=Pixel 8 (Android 15) E: Telefon=Pixel 8, OS=Android 15
  • [BT+BT]: kolumna Urządzenie A=Pixel 7 Pro (13), Urządzenie B=Samsung S10+ (12) E: Telefon=Samsung S10+, OS=Android 12.
  • [LEA+LEA]: Device A=Pixel 8 (15), Device B=Pixel 8(15) column E: Phone=Pixel 8, OS=Android 15

Przykład ukończonego testu w szablonie testu samodzielnego:

Zdarzenia audio:

• Oto 4 rodzaje testowanych zdarzeń dźwiękowych i zalecane aplikacje testowe:

  1. Zadzwoń:
     1. Wbudowana aplikacja telefoniczna.
  2. VoIP: działa każda aplikacja VoIP, np.:
     1. Aplikacja do testowania przełącznika dźwięku.
     2. FB Messenger.
     3. Linia.
     4. WhatsApp.
     5. Google Meet.
     6. Google Meet.
  3. Multimedia: dowolny odtwarzacz dźwięku, na przykład:
     1. Aplikacja testowa przełącznika dźwięku.
     2. YouTube Music.
     3. Apple Music,
     4. Spotify.
     5. Podcastach Google
  4. Gra:
     1. Aplikacja testowa przełącznika dźwięku.

Uwaga: więcej informacji znajdziesz w sekcji Aplikacja do testowania przełącznika dźwięku.

Informacje debugowania:

• Po dołączeniu do społeczności powiadomienia są włączone grupę fp-sass-partner-test. Oto przykłady:

  • Najnowsze powiadomienie o stanie:

  

  • Brak powiadomienia o przełączeniu:

  

  Uwaga: „Najnowszy stan” to stan połączenia w momencie wystąpienia zdarzenia audio, a nie bieżące ostatnie zdarzenie.
  • Powiadomienie o opóźnieniu przełączenia:

  

Pomiar czasu oczekiwania

Uwaga: „Szukaj” oznacza telefon lub tablet, którego używasz do podłączenia zestawu słuchawkowego zwany także urządzeniem A, B, C, D lub E w przypadkach testowych.

• Istnieją 2 rodzaje opóźnień przełączników:
  1. Łączenie profilu Bluetooth z odłączonym Seekerem.
     • Obejmuje to wszystkie przypadki dotyczące trybu SinglePoint i niektóre przypadki dotyczące trybu Multipoint, w których urządzenie sterujące (urządzenie B) jest odłączone.
  2. Przełączanie aktywnego połączonego Seekera.
     • Obejmuje to niektóre przypadki MP, w których docelowe urządzenie Seeker (urządzenie B) jest już połączone.
• Informacje o czasie oczekiwania można pobrać na 2 sposoby:
  1. Całą latencję można wyodrębnić za pomocą polecenia adb.
     • Więcej informacji znajdziesz w sekcji dotyczącej opóźnienia zrzutu.
     • To polecenie może zapewnić i zarejestrować opóźnienie po wykonaniu co najmniej tylko jeden przypadek testowy.
  2. za pomocą aplikacji testowej przełącznika dźwięku.
     • Aplikacja działająca na urządzeniu docelowym Seekera po przełączeniu wyświetli opóźnienie.
     • Jeśli nie nastąpiła zmiana, aplikacja wyświetli przyczynę „brak zmiany”.

Aplikacja testowa przełącznika dźwięku:

• Używanie aplikacji do uruchamiania zdarzeń audio VoIP, multimediów lub gier podczas autotestu uprości konfigurację testów i skróci czas oczekiwania na zdarzenie Seeker.
  • Najnowszą wersję możesz pobrać tutaj.
  • Test VoIP w przypadku LE Audio wymaga ręcznego włączenia zasady: > adb root > adb shell settings put global hidden_api_policy 1 > adb reboot

Uwaga: aby poprosić o dostęp do linku do pobrania, musisz mieć konto Google. Przyznanie dostępu odbywa się ręcznie i może potrwać kilka dni.

• Instalacja aplikacji:
  • Skopiuj plik APK na telefon testowy i go otwórz.
  • Możesz też użyć polecenia adb install audio_test_app.apk.

Ostrzeżenie: zezwól na wszystkie uprawnienia podczas pierwszego otwierania aplikacji.

• Jeśli zobaczysz okno z prośbą o dostęp do powiadomień:
  1. kliknij „OK”.
  2. Wybierz „FP SASS test” (Test FP SASS) na liście aplikacji
  3. Zezwól na dostęp do powiadomień.

Informacje o aplikacji:

• Dostawca docelowy

  • Po kliknięciu tego przycisku pojawi się lista sparowanych urządzeń Bluetooth. Wybierz tę, którą chcesz przetestować.
  • Przyciski „Połącz” i „Odłącz” działają tak samo jak w szczegółach urządzenia w ustawieniach Bluetooth.

• Obecny stan

  • To pole zawiera ostatni stan połączenia, który Seeker otrzymał od dostawcy za pomocą reklamy BLE lub strumienia zdarzeń.
  • Tutaj wyświetlają się też powiadomienia o debugowaniu przełącznika audio.

• Typ poszukiwacza

  • Ta opcja umożliwia przełączanie urządzenia między strumieniami audio.

Typ dźwięku

Klasyczny z A2DP+HFP

• VoIP
  • Wybranie tego trybu spowoduje zmianę trybu audio na AudioManager.MODE_IN_COMMUNICATION i wywołanie AudioManager.startBluetoothSco, a następnie odtworzenie dźwięku za pomocą USAGE_VOICE_COMMUNICATION.
  • Typ strumienia to STREAM_VOICE_CALL.
  • Stan połączenia dostawcy powinien zmienić się na CONNECTED_HFP w ciągu 5 sek.
• Media
  • Wybranie tego trybu spowoduje odtwarzanie dźwięku obsługującego AVRCP. Typ wykorzystania dźwięku: USAGE_MEDIA.
  • Stan połączenia dostawcy powinien zmienić się na CONNECTED_A2DP_WITH_AVRCP w ciągu 5 sekund.
  • Stan połączenia może na chwilę przełączyć się na CONNECTED_A2DP_ONLY, gdy uruchomione lub zatrzymane.
• Gra
  • Wybranie tego trybu powoduje odtwarzanie dźwięku, który nie obsługuje AVRCP. Dźwięk typ użycia: USAGE_GAME.
  • Stan połączenia dostawcy powinien zmienić się na CONNECTED_A2DP_ONLYw ciągu 5 sekund.

BLE z LE Audio

• VoIP

  • Wybranie tego trybu spowoduje zmianę trybu audio na AudioManager.MODE_IN_COMMUNICATION i odtwarzanie dźwięku z USAGE_VOICE_COMMUNICATION.
  Uwaga: w wersjach Androida starszych niż Tiramisu (Android 13) aplikacja testowa wywołuje funkcję AudioManager.startBluetoothSco, aby rozpocząć połączenie audio SCO Bluetooth. W przeciwnym razie aplikacja testowa wywołuje AudioManager.setCommunicationDevice, aby wybrać używane urządzenie audio do komunikacji.
  • Typ strumienia to STREAM_VOICE_CALL.
  • Stan połączenia dostawcy powinien zmienić się na CONNECTED_LE_AUDIO_CALL w ciągu 5 sekund.

• Media

  • Po wybraniu tego trybu dźwięk zostanie odtworzony z typem strumienia STREAM_MUSIC. Typ wykorzystania dźwięku: USAGE_MEDIA.
  • Stan połączenia dostawcy powinien zmienić się na CONNECTED_LE_AUDIO_MEDIA_WITH_CONTROL w ciągu 5 sekund.
  • Stan połączenia może na chwilę zmienić CONNECTED_LE_AUDIO_MEDIA_WITHOUT_CONTROL po uruchomieniu lub zatrzymaniu.

• Gra

  • Wybranie tego trybu powoduje odtwarzanie dźwięku, nad którym użytkownik nie ma bezpośredniej kontroli. Typ wykorzystania audio: USAGE_GAME.
  • Stan połączenia dostawcy powinien zmienić się na CONNECTED_LE_AUDIO_MEDIA_WITHOUT_CONTROL w ciągu 5 sekund.

• Przyciski odtwarzania i zatrzymywania

  • Przyciski PLAY i STOP uruchamiają lub zatrzymują dźwięk.

• Przełącz wynik

  • To pole pokazuje opóźnienie w przypadku aktywnych połączeń i przełączeń. Wyświetla też przyczynę odrzucenia przełączenia, jeśli zostało wyzwolone zdarzenie audio, ale przełączenie nie nastąpiło.
  • Opóźnienie jest mierzone w milisekundach (ms).
  • Ogólnie opóźnienie jest mierzone od momentu rozpoczęcia działania przełącznika dźwięku. do potwierdzenia połączenia profilu BT lub połączenia wielopunktowego z powiadomieniem .
  • Przełączniki aktywowane przez dostawcę mierzą opóźnienie od momentu rozpoczęcia odtwarzania dźwięku.

Czas oczekiwania na zrzut

• Poniższe polecenie umożliwia użytkownikowi rejestrowanie pomiarów opóźnień podczas wykonywania testów ręcznych:adb shell dumpsys activity service com.google.android.gms/.nearby.discovery.service.DiscoveryService
  • Pomiary czasu oczekiwania są wyświetlane w kolumnie NearbyDeviceManager Sekcja SwitchHistory:

            NearbyDeviceManager
              Nearby Sass device count: 1
                Sass device - address:XX:XX:XX:XX:XX:XX, name:Googler's Pixel Buds, accountKey:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX, modelId:6edaf7
                  SwitchHistory
                    15:30:21:166 - 15:30:25:201, latency 3035ms, Succeed, SASS_TRIGGERED_CONNECT, SASS switch, A2DP
                    15:34:58:568 - 15:34:58:568, latency 0ms, Succeed, SWITCH_ACTIVE_TO_SELF, SASS switch, HFP
                    15:36:26:615 - 15:36:31:603, latency 1988ms, Succeed, SASS_TRIGGERED_CONNECT, SASS switch, A2DP
                    15:37:56:108 - 15:37:56:250, latency 142ms, Succeed, SWITCH_ACTIVE_TO_SELF, SASS switch, A2DP"

• Każde przełączanie, którego GmsCore nie może zmierzyć (np. aktywne przełączanie w przypadku HFP), zostanie zarejestrowane jako opóźnienie 0 ms.

Odniesienie do wzorców logów:

Znane problemy:

Oto znane błędy powodowane przez Seekera:

1. Nieprawidłowe przełączanie dźwięku gry.
   • Telefony Samsung ustawiają stan połączenia na CONNECTED_A2DP_WITH_AVRCP zamiast CONNECTED_A2DP_ONLY podczas odtwarzania gry.
   • Niektóre gry (takie jak Candy Crush) mogą odtwarzać muzykę w tle i włączać nowe zdarzenie dźwiękowe bez danych wejściowych użytkownika. Połączone telefony mogą stale przełączać dźwięk na każdym telefonie, na którym otwierana jest gra.