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

Przygotowanie do uzyskania certyfikatu

1. Przygotuj urządzenia testowe.
   • Potrzebujesz 5 urządzeń z Androidem.
     • Urządzenia te muszą zawierać:
       • Co najmniej 1 Android T (13) i 1 Android S (12).
       • Co najmniej jeden telefon Samsung i jeden Pixel.
       • Na przykład:
         • 1 OnePlus (Android 10).
         • 3 Samsung (Android 11, 12, 13).
         • 1 Pixel (Android 13).
   • 1 urządzenie bez przełącznika dźwięku:
     • iPhone, PC, laptop z obsługą Bluetootha (BT) lub telefon z Androidem z wyłączonym przełącznikiem dźwięku.
       • Przełącznik dźwięku możesz wyłączyć w ustawieniach szczegółów urządzenia Bluetooth.
     • Urządzenie testowe Multipoint (MP) 2.8 oprócz 5 telefonów testowych wymaga urządzenia bez przełącznika dźwięku.
2. Dołącz do grupy testowej przełącznika dźwięku ze swoimi kontami testowymi, by wyświetlać powiadomienia o debugowaniu na telefonach testowych.
   • Umożliwia to również Google zbieranie danych testowych za pomocą Google Analytics.
3. Upewnij się, że na wszystkich urządzeniach z Androidem zainstalowano GmsCore w wersji 23.xx.xx lub nowszej.

Kryteria certyfikacji

• Wskaźnik sukcesu zmiany celu musi przekraczać 95% we wszystkich przypadkach testowych.
• W co najmniej 75% przypadków testów wymagających przełącznika stan połączenia profilu i przełączania profilu musi zakończyć się w ciągu 3 sekund od wywołania zdarzeń audio.

Przewodnik testowania

Przygotowanie urządzenia w trakcie testów (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 te czynności, aby wyczyścić parowanie:
    • Na sparowanych urządzeniach:
      • Otwórz ustawienia Bluetooth.
      • Wybierz „Zapomnij urządzenie”.
      • Włącz i wyłącz tryb samolotowy.
  • Upewnij się, że opcja „Automatycznie zapisuj urządzenia” jest włączona.
    • Ten przełącznik jest domyślnie wyłączony.
    • Tę opcję znajdziesz, klikając Ustawienia > Google > Urządzenia > Zapisane urządzenia (po jednym na każdej jednostce DUT).
  • Przełącz urządzenie Bluetooth w tryb parowania.
  • Sparuj pierwsze urządzenie Bluetooth (A).
  • Paruj kolejne urządzenia Bluetooth z innymi urządzeniami (B, C, D itd.).

Zakres

• Wszystkie zestawy słuchawkowe uruchamiają testy na różnych kartach w szablonie autotestu przełącznika dźwięku.
• Zestawy słuchawkowe obsługujące tylko tryb SinglePoint (SP) działają w ten sposób:
  • Karta Ogólne_test.
• W przypadku zestawów słuchawkowych obsługujących tryb MP działają te funkcje:
  • Karta Ogólne_test.
  • Karta Multipoint_only.
• Zestawy słuchawkowe MP, które można przełączyć w tryb dostawcy usług, działają w ten sposób:
  • Karta Ogólne_test z wyłączonym MP.
  • Karta General_test z włączonym MP.
  • Karta Multipoint_only z włączoną funkcją MP.

Wypełnianie raportu dotyczącego samoodpoczynku i samotestu

• Uruchom wszystkie przypadki testowe co najmniej 2 razy.
• Testy należy wykonywać w następującej formie:

1. Urządzenie A=Android S (12) + urządzenie B=Android T (13)
2. Urządzenie A=Android T (13) + urządzenie B=Android S (12)
3. Urządzenie B będzie głównym urządzeniem DUT.
   • 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:

  • Uruchomienie 1. Urządzenie A=Samsung S10+ (12), Urządzenie B=Pixel 7 pro (13) Kolumna D: Telefon=Pixel 7 Pro, OS=Android 13
  • Uruchomienie 2. Urządzenie A=Pixel 7 pro (13), Urządzenie B=Pixel 6(12) Kolumna E: Telefon=Pixel 6, OS=Android 12

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

Wydarzenia audio:

• 4 typy testowanych zdarzeń dźwiękowych i zalecanych aplikacji do testowania to:
  1. Zadzwoń pod numer:
     1. Wbudowana aplikacja Telefon.
  2. VoIP: wszystkie aplikacje VoIP, takie jak:
     1. Aplikacja testowa Przełącznika dźwięku.
     2. FB Messenger
     3. Linia.
     4. WhatsApp.
     5. Google Meet.
     6. Google Meet.
  3. Multimedia: dostępne są dowolne odtwarzacze audio, takie jak:
     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 testowa Switch Audio.

Dane debugowania:

• Powiadomienia są włączane po dołączeniu do grupy fp-sass-partner-test. Oto przykłady:

  1. Najnowsze powiadomienie o stanie:

  2. Brak powiadomienia o przełączniku:

Uwaga: „Najnowszy stan” to stan połączenia w momencie wystąpienia zdarzenia audio, a nie najnowszego zdarzenia.

1. Powiadomienie o opóźnieniu przełączania:

Pomiar czasu oczekiwania

Uwaga: „Seeker” oznacza telefon lub tablet używany do połączenia z testowym zestawem słuchawkowym. W przypadkach testowych jest też nazywany urządzeniem A, B, C, D lub E.

• Są 2 rodzaje opóźnienia przełącznika:
  1. Łączenie profilu Bluetooth z odłączonym Seeker.
     • Obejmuje to wszystkie przypadki SinglePoint i niektóre przypadki MP, których element docelowy Seeker (urządzenie B) jest odłączony.
  2. Przełączam aktywny połączony Seeker.
     • Obejmuje to niektóre przypadki MP, w których docelowe narzędzie Seeker (urządzenie B) jest już połączone.
• Informacje o opóźnieniu możesz pobrać na 2 sposoby:
  1. Cały czas oczekiwania można zrzucić za pomocą polecenia adb.
     • Więcej informacji znajdziesz w sekcji Czas oczekiwania na zrzut.
     • To polecenie umożliwia podanie i rejestrowanie czasu oczekiwania po zakończeniu co najmniej 1 przypadku testowego.
  2. Za pomocą aplikacji testowej Przełączanie dźwięku.
     • Aplikacja uruchomiona na docelowym programie Seeker będzie wyświetlać opóźnienie po przełączeniu.
     • Jeśli nie było przełącznika, aplikacja wyświetli powód braku przełącznika.

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

• Używanie aplikacji do aktywowania zdarzeń VoIP, multimediów lub dźwięku z gry podczas autotestu uprości konfigurację testu i skróci czas oczekiwania na zdarzenia w wyszukiwarce.
  • Wersję 1.03 możesz pobrać tutaj.

Uwaga: aby poprosić o dostęp do linku do pobrania, musisz mieć konto Google. Proces przyznania dostępu to proces ręczny, który może potrwać kilka dni.

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

Ostrzeżenie: przy pierwszym uruchomieniu aplikacji zezwól na wszystkie uprawnienia.

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

Przegląd aplikacji:

Dostawca docelowy

Po kliknięciu tego przycisku wyświetli się lista sparowanych urządzeń Bluetooth. Wybierz tę, którą chcesz przetestować.

Przyciski Połącz i Rozłącz działają tak samo jak te w szczegółach urządzenia w ustawieniach Bluetooth.

Bieżący stan

To pole pokazuje ostatni stan połączenia, który poszukiwacz otrzymał od dostawcy korzystającego z reklam BLE lub strumienia zdarzeń.

W tym miejscu znajdują się również powiadomienia dotyczące debugowania przełącznika dźwięku.

Typ osoby poszukiwającej

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

Typ audio

VoIP Włączenie tego trybu spowoduje zmianę trybu dźwięku na: AudioManager.MODE_IN_COMMUNICATION, nawiązanie połączenia z użytkownikiem AudioManager.startBluetoothSco, a potem odtworzenie dźwięku na koncie USAGE_VOICE_COMMUNICATION.

• Typ strumienia to STREAM_VOICE_CALL.
• Stan połączenia z dostawcą powinien zmienić się na CONNECTED_HFP w ciągu 5 sekund.

Multimedia Gdy wybierzesz ten tryb, będzie można odtwarzać dźwięk obsługujący AVRCP. Typ wykorzystania dźwięku: USAGE_MEDIA.

• Stan połączenia z dostawcą powinien zmienić się na CONNECTED_A2DP_WITH_AVRCP w ciągu 5 sekund.
• Po rozpoczęciu lub zatrzymaniu stan połączenia może się na chwilę przełączyć na CONNECTED_A2DP_ONLY.

Gra W tym trybie jest odtwarzany dźwięk, który nie obsługuje AVRCP. Typ wykorzystania dźwięku: USAGE_GAME.

• Stan połączenia z dostawcą powinien zmienić się na CONNECTED_A2DP_ONLY w ciągu 5 sekund.

Przyciski odtwarzania i zatrzymania

Przyciski ODTWÓRZ i ZATRZYMAJĄ dźwięk.

Przełącz wynik

To pole wyświetla aktywne opóźnienie łączenia i przełączania. Wyświetla on też powód odrzucenia przełącznika, jeśli zostało wywołane zdarzenie dźwiękowe, ale przełącznik nie wystąpił.

• Opóźnienie jest mierzone w milisekundach (ms).
• Ogólnie czas oczekiwania jest mierzony od początku aktywatora przełącznika dźwięku do otrzymania zdarzenia połączenia z profilem BT lub powiadomienia przełącznika wielopunktowego powiadomienia.
• Przełączniki aktywowane przez dostawcę mierzą opóźnienie od włączenia dźwięku.

Opóźnienie zrzutu

• To polecenie umożliwia użytkownikowi przechwytywanie pomiarów czasu oczekiwania w przypadku testów ręcznych:adb shell dumpsys activity service com.google.android.gms/.nearby.discovery.service.DiscoveryService
  • Pomiary czasu oczekiwania są widoczne w sekcji SwitchHistory w NearbyDeviceManager:

            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żdy przełącznik, którego GmsCore nie może zmierzyć (np. aktywny przełącznik dla HFP), zostanie zarejestrowany jako 0 ms opóźnienia.

Odniesienie do wzorców logów:

Znane problemy:

Oto znane błędy spowodowane przez Poszukiwacza:

1. Nieprawidłowe przełączanie dźwięku w grze.
   • Podczas grania telefony Samsung ustawiają stan połączenia na CONNECTED_A2DP_WITH_AVRCP, a nie CONNECTED_A2DP_ONLY.
   • Niektóre gry(np. Candy Crush) mogą odtwarzać muzykę w tle i aktywować nowe zdarzenie dźwiękowe bez udziału użytkownika. Połączone telefony mogą stale przełączać dźwięk na każdym telefonie, na którym gra.