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

Przygotowanie do certyfikacji

• Przygotuj urządzenia testowe.
  • Potrzebne będą 5 urządzeń z Androidem.
    • Urządzenia muszą spełniać te wymagania:
      • Co najmniej jeden Android T (13) i 1 Android V (15).
      • Co najmniej jeden telefon Samsung i jeden 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.
      • Przełącznik dźwięku możesz wyłączyć w ustawieniach szczegółów urządzenia Bluetooth.
    • Połączenie wielopunktowe (MP) w wersji testowej 2.8 wymaga urządzenia bez przełącznika dźwięku w przypadku 5 telefonów testowych.

• Dołącz do grupy testowej przełącznika dźwięku ze swoimi kontami testowymi, 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 na wszystkich urządzeniach z Androidem jest zainstalowany GmsCore w wersji 23.xx.xx lub nowszej.

BLE z LE Audio

• Co najmniej 2 telefony referencyjne muszą obsługiwać LE Audio.
  • Na przykład 1 telefon Samsung i 1 Pixel z obsługą LE Audio.
• Upewnij się, że na wszystkich urządzeniach z Androidem jest zainstalowany GmsCore w wersji 24.33.xx lub nowszej.

Kryteria certyfikacji

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

• W przypadku testów wymagających przełączenia połączenia profilu i stanu przełącznika w co najmniej 75% przypadków muszą się one zakończyć w ciągu 3 sekund od wywołania zdarzeń audio.

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: klasyczny Bluetooth, telefon B: klasyczny Bluetooth
• 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 poddanego testowi (DUT)

• Sprawdź, czy urządzenie BT nie zostało wcześniej sparowane z żadnym telefonem zalogowanym na testowe konto Google.
  • Jeśli urządzenie zostało sparowane z kontem Google używanym do testowania, wykonaj te czynności, aby anulować parowanie:
    • W sekcji sparowanych urządzeń:
      • Otwórz ustawienia Bluetootha.
      • Wybierz „Zapomnij o tym urządzeniu”.
      • 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.
    • Opcję tę znajdziesz w sekcji Ustawienia > Google > Urządzenia > Zapisane urządzenia (po jednym na DUT).
  • Przełącz urządzenie Bluetooth w tryb parowania.
  • Parowanie początkowego urządzenia 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 szablonu autotestu przełącznika dźwięku.
• Zestawy słuchawkowe obsługujące tylko tryb SinglePoint (SP) działają w ten sposób:
  • Karta General_test.
• Zestawy słuchawkowe obsługujące tryb MP działają:
  • Karta General_test.
  • Karta Multipoint_only.
• Słuchawki MP, które można przełączyć w tryb SP, obsługują:
  • Karta Generic_test z wyłączonym MP.
  • Karta Generic_test z włączonym MP.
  • Karta Multipoint_only z włączonym połączeniem wielopunktowym.

Ukończenie samopoczucia i raport z samotestu

• Utwórz kopię raportu z samodiagnozy Switch.
• 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 do testowania:

  • 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, OS=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 ukończonego 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 polach „Telefon” i „System operacyjny” u góry szablonu.

Przykładowy przypadek testowy:

• Telefony do testowania:

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

• Wykonane testy:

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

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

Zdarzenia audio:

• 4 typy testowanych zdarzeń audio i zalecane aplikacje do testowania:

  1. Połączenie:
     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 do testowania przełącznika dźwięku.

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

Dane debugowania:

• Powiadomienia są włączane po dołączeniu do grupy 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: „poszukiwanie” oznacza telefon lub tablet używany do łączenia z zestawem słuchawkowym, który w przypadku testowania nosi nazwę A, B, C, D lub E.

• Istnieją 2 rodzaje opóźnienia przełączania:
  1. Łączenie profilu Bluetooth z niepołączonym urządzeniem Seeker
     • 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łączam aktywne połączone narzędzie Seeker.
     • 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. Polecenie adb może zapisywać wszystkie czasy oczekiwania.
     • Szczegółowe informacje znajdziesz w sekcji Czas oczekiwania na zrzut.
     • To polecenie może podać i zapisać opóźnienie po zakończeniu co najmniej jednego przypadku testowego.
  2. Za pomocą aplikacji testowej przełącznika dźwięku.
     • Aplikacja uruchomiona na docelowym narzędziu Seeker będzie wyświetlać opóźnienie po przełączeniu.
     • Jeśli nie nastąpiła zmiana, aplikacja wyświetli przyczynę „brak zmiany”.

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

• Użycie aplikacji do wywołania zdarzeń VoIP/Media/Gry podczas testu samodzielnego uprości konfigurację testu i zmniejszy opóźnienie Seekera.
  • Najnowszą wersję możesz pobrać tutaj.
  • Test VoIP LE Audio wymaga ręcznego włączenia zasad: > adb root > ustawienia adb shell put global hide_api_policy 1 > adb restart

Uwaga: aby poprosić o dostęp do linku do pobierania, musisz mieć konto Google. Przyznanie dostępu jest procesem ręcznym i 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: 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. Na liście aplikacji wybierz „Test FP SASS”.
  3. Zezwól na dostęp do powiadomień.

Informacje o aplikacji:

• Dostawca docelowy

  • Po kliknięciu tego przycisku wyświetli się lista sparowanych urządzeń Bluetooth. Wybierz tę, którą chcesz przetestować.
  • Przycisk Połącz i odłącz działa tak jak przycisk w szczegółach urządzenia w ustawieniach Bluetooth.

• Bieżący stan

  • To pole zawiera ostatni stan połączenia, które Użytkownik otrzymał od dostawcy za pomocą reklamy lub strumienia zdarzeń BLE.
  • Tutaj są też wyświetlane powiadomienia o debugowaniu przełącznika dźwięku.

• Typ poszukiwacza

  • Ta opcja służy do przełączania urządzenia między strumieniami audio.

Typ dźwięku

Klasyczny z A2DP+HFP

• VoIP
  • Wybrany tryb spowoduje zmianę trybu dźwięku na AudioManager.MODE_IN_COMMUNICATION i wywołanie AudioManager.startBluetoothSco, a następnie odtwarzanie dźwięku na urządzeniu USAGE_VOICE_COMMUNICATION.
  • Typ strumienia to STREAM_VOICE_CALL.
  • Stan połączenia dostawcy powinien zmienić się na CONNECTED_HFP w ciągu 5 sekund.
• Multimedia
  • Wybranie tego trybu spowoduje odtwarzanie dźwięku obsługującego AVRCP. Typ wykorzystania dźwięku: USAGE_MEDIA.
  • Stan połączenia dostawcy powinien w ciągu 5 sekund zmienić się na CONNECTED_A2DP_WITH_AVRCP.
  • Po rozpoczęciu lub zatrzymaniu stan połączenia może na krótko zmienić się na CONNECTED_A2DP_ONLY.
• Gra
  • Wybranie tego trybu powoduje odtwarzanie dźwięku, który nie obsługuje protokołu AVRCP. Typ użycia dźwięku: USAGE_GAME.
  • Stan połączenia dostawcy powinien zmienić się na CONNECTED_A2DP_ONLY w 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: na urządzeniach z Androidem w wersji starszej niż Tiramisu (13) aplikacja testowa wywołuje metodę AudioManager.startBluetoothSco, aby nawiązać połączenie audio Bluetooth SCO. W przeciwnym razie aplikacja testowa wywołuje funkcję AudioManager.setCommunicationDevice, aby wybrać urządzenie audio używane do komunikacji.
  • Typ strumienia to STREAM_VOICE_CALL.
  • Stan połączenia z dostawcą powinien zmienić się na CONNECTED_LE_AUDIO_CALL w ciągu 5 sekund.

• Media

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

• Gra

  • Wybranie tego trybu powoduje odtwarzanie dźwięku, nad którym użytkownik nie ma bezpośredniego wpływu. Typ wykorzystania audio: USAGE_GAME.
  • Stan połączenia dostawcy powinien się zmienić 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.

• Wynik przełączenia

  • To pole pokazuje aktywne opóźnienie usługi Connect i Switch. 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 czas oczekiwania jest mierzony od rozpoczęcia działania przełącznika dźwięku do momentu otrzymania połączenia z profilem BT lub zdarzenia włączenia połączenia wielopunktowego z powiadomieniem.
  • Przełączenia wywoływane przez dostawcę mierzą opóźnienie od momentu rozpoczęcia 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 sekcji SwitchHistory interfejsu 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 HFP), jest rejestrowany jako czas oczekiwania 0 ms.

Odniesienie do wzorców logów:

Znane problemy:

Oto znane błędy związane z Seekerem:

1. Nieprawidłowe przełączanie dźwięku gry.
   • Podczas grania na telefonach Samsung stan połączenia zostanie ustawiony na CONNECTED_A2DP_WITH_AVRCP, a nie na CONNECTED_A2DP_ONLY.
   • Niektóre gry (takie jak Candy Crush) mogą ponownie odtwarzać muzykę w tle i wyzwalać nowe zdarzenie dźwiękowe bez ingerencji użytkownika. Połączone telefony mogą stale przełączać dźwięk na każdym telefonie, na którym uruchomiono grę.