Linee guida per la certificazione degli switch audio

Preparazione per la certificazione

• Prepara i dispositivi di test.
  • Avrai bisogno di 5 dispositivi Android.
    • Questi dispositivi devono includere:
      • Almeno un Android T (13) e un Android V (15).
      • Almeno uno smartphone Samsung e uno Pixel.
      • Ad esempio:
        • 1 OnePlus (Android 10).
        • 3 Samsung (Android 11, 12, 13).
        • 1 Pixel (Android 15).
  • Un dispositivo senza cambio audio:
    • Qualsiasi iPhone, PC, laptop con Bluetooth (BT) abilitato o smartphone Android con Cambio Audio disattivato.
      • Puoi disattivare il cambio audio dalle impostazioni dei dettagli del dispositivo Bluetooth.
    • Lo scenario di test 2.8 multipunto (MP) richiede un dispositivo senza cambio audio oltre ai 5 smartphone di test.

• Unisciti al gruppo di test del cambio audio con i tuoi account di test per mostrare le notifiche di debug sugli smartphone di test.

  • In questo modo, Google può anche raccogliere dati di test tramite Google Analytics.

Classico con A2DP+HFP

• Assicurati che su tutti i dispositivi Android sia installata la versione 23.xx.xx o successive di GmsCore.

BLE con LE Audio

• Almeno due degli smartphone di riferimento devono supportare LE Audio.
  • Ad esempio, uno smartphone Samsung e uno smartphone Pixel che supportano LE Audio.
• Assicurati che su tutti i dispositivi Android sia installata la versione 24.33.xx o successive di GmsCore.

Criteri di certificazione

• Il tasso di successo del cambio di target deve superare il 95% in tutti gli scenari di test.

• Nei test che richiedono un cambio, la connessione del profilo e lo stato attivo del cambio devono essere completati entro 3 secondi dall'attivazione degli eventi audio in almeno il 75% dei casi.

Classico con A2DP+HFP

I test automatici devono essere eseguiti nelle seguenti combinazioni:

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

BLE con LE Audio

I test automatici devono essere eseguiti nelle seguenti combinazioni:

• Smartphone A: BT Classic, smartphone B: BT Classic
• Smartphone A: LE Audio, smartphone B: BT Classic
• Smartphone A: BT Classic, smartphone B: LE Audio

(Facoltativo) I fornitori che supportano le connessioni Dual LE Audio devono testare:

• Smartphone A: LE Audio, smartphone B: LE Audio

Guida ai test

Preparazione del dispositivo in esame (DUT)

• Verifica che il dispositivo BT non sia stato precedentemente accoppiato con nessuno smartphone che ha eseguito l'accesso all'Account Google di test.
  • Se il dispositivo è stato accoppiato all'Account Google di test, segui questi passaggi per cancellare l'accoppiamento:
    • Nei dispositivi accoppiati:
      • Vai alle impostazioni Bluetooth.
      • Scegli "Disconnetti dispositivo".
      • Attiva e disattiva la modalità aereo.
  • Assicurati che l'opzione "Salva automaticamente i dispositivi" sia ATTIVA.
    • Questa opzione è disattivata per impostazione predefinita.
    • Puoi trovare questa opzione in Impostazioni > Google > Dispositivi > Dispositivi salvati (uno per DUT).
  • Attiva la modalità di accoppiamento del dispositivo Bluetooth.
  • Accoppia il primo dispositivo Bluetooth (A).
  • Accoppia i dispositivi Bluetooth successivi con altri dispositivi (B, C, D e così via).

Ambito

• Tutte le cuffie eseguono test dalle varie schede del report di autotest BT Classic o BT LE Audio.
• Le cuffie che supportano solo la modalità SinglePoint (SP) eseguono le seguenti operazioni:
  • Scheda Generic_test.
• Le cuffie che supportano la modalità MP eseguono le seguenti operazioni:
  • Scheda Generic_test.
  • La scheda Multipoint_only.
• Le cuffie MP che possono essere attivate in modalità SP eseguono le seguenti operazioni:
  • La scheda Generic_test con MP disattivato.
  • La scheda Generic_test con MP attivato.
  • La scheda Multipoint_only con la connettività multipunto attiva.

Completamento dell'autotest e del report sull'autotest

• Crea una copia dei report di autotest BT Classic o BT LE Audio.
• Esegui tutti gli scenari di test almeno due volte.

• I test devono essere eseguiti nel seguente formato:

Classico con A2DP+HFP

• Il dispositivo B sarà il DUT principale.
  • Inserisci i dettagli del Dispositivo B nei campi "Telefono" e "Sistema operativo" nella parte superiore del modello.

Esempio di scenario di test:

• Smartphone di test:

  • Dispositivo 1: Samsung (Android 13)
  • Dispositivo 2: Pixel (Android 12 o 13) e altri.

• Test eseguiti:

  • Gara 1. Dispositivo A=Samsung S10+ (12), Dispositivo B=Pixel 7 Pro (13) Colonna D: Smartphone=Pixel 7 Pro, OS=Android 13
  • Gara 2. Dispositivo A=Pixel 7 Pro (13), Dispositivo B=Pixel 6(12) Colonna E: Smartphone=Pixel 6, Sistema operativo=Android 12

Esempio di test completato nel modello di autotest:

BLE con LE Audio

1. Dispositivo A=Android V (15) + Dispositivo B=Android T (13)
2. Dispositivo A=Android T (13) + Dispositivo B=Android V (15)
3. Dispositivo A=Android T (13) + Dispositivo B=Android S (12)
4. Dispositivo A=Android T (15) + Dispositivo B=Android V (15)
5. Il dispositivo B sarà il DUT principale.
   • Inserisci i dettagli del Dispositivo B nei campi "Telefono" e "Sistema operativo" nella parte superiore del modello.

Esempio di scenario di test:

• Smartphone di test:

  • Dispositivo 1: Samsung (Android 13)
  • Dispositivo 2: Pixel (Android 15) e altri.

• Test eseguiti:

  • [LEA+BT]: Dispositivo A= Pixel 8 (15), Dispositivo B=Pixel 7 Pro (13) colonna D: Smartphone=Pixel 7 Pro, OS=Android 13
  • [BT+LEA]: Colonna Dispositivo A=Pixel 7 (13), Dispositivo B=Pixel 8 (Android 15) E: Smartphone=Pixel 8, OS=Android 15
  • [BT+BT]: Device A=Pixel 7 Pro (13), Device B=Samsung S10+ (12) column E: Phone=Samsung S10+, OS=Android 12
  • [LEA+LEA]: Dispositivo A=Pixel 8 (15), Dispositivo B=Pixel 8(15) colonna E: Smartphone=Pixel 8, OS=Android 15

Esempio di test completato nel modello di autotest:

Eventi audio:

• I quattro tipi di eventi audio testati e le app di test consigliate sono:

  1. Chiamata:
     1. L'app Telefono integrata.
  2. VoIP: qualsiasi app VoIP funzionerà, ad esempio:
     1. L'app di test Cambio Audio.
     2. FB Messenger.
     3. Linea.
     4. WhatsApp.
     5. Google Meet.
     6. Google Meet.
  3. Contenuti multimediali: funziona qualsiasi lettore audio, ad esempio:
     1. L'app di test Cambio Audio.
     2. YouTube Music.
     3. Apple Music.
     4. Spotify.
     5. Google Podcasts.
  4. Partita:
     1. L'app di test Cambio Audio.

Nota: per ulteriori dettagli, consulta la sezione App di test per il cambio audio.

Informazioni di debug:

• Le notifiche vengono attivate dopo l'iscrizione al gruppo fp-sass-partner-test. Ecco alcuni esempi:

  • Ultima notifica dello stato:

  

  • Nessuna notifica per il sensore:

  

  Nota : "Stato più recente" è lo stato della connessione quando si verifica l'evento audio, NON l'ultimo evento corrente.
  • Notifica di latenza del cambio:

  

Misurazione della latenza

Nota: "Seeker" indica lo smartphone o il tablet che utilizzi per connetterti alle cuffie nel test, noto anche come dispositivo A, B, C, D o E negli scenari di test.

• Esistono due tipi di latenza di commutazione:
  1. Connessione di un profilo Bluetooth a un tracker Seeker disconnesso.
     • Sono inclusi tutti i casi SinglePoint e alcuni casi MP il cui target Seeker (dispositivo B) è disconnesso.
  2. Cambio del cercatore connesso attivo.
     • Sono inclusi alcuni casi di MP a cui il cercatore di destinazione (dispositivo B) è già connesso.
• Esistono due modi per recuperare le informazioni sulla latenza:
  1. Tutta la latenza può essere scaricata tramite il comando adb.
     • Per ulteriori dettagli, consulta la sezione Latenza del dump.
     • Questo comando può fornire e registrare la latenza dopo aver completato almeno uno scenario di test.
  2. Utilizzo dell'app di test Cambio Audio.
     • L'app in esecuzione sul cercatore di target mostrerà la latenza dopo il cambio.
     • Se non è stato effettuato alcun cambio, l'app mostrerà il motivo "nessun cambio".

App di test per il cambio audio:

• L'utilizzo dell'app per attivare eventi audio VoIP/multimediali/di gioco durante un autotest semplificherà la configurazione del test e ridurrà la latenza degli eventi del cercatore.
  • L'ultima versione può essere scaricata qui.
  • Il test VoIP LE Audio richiede l'attivazione manuale di un criterio: > adb root > adb shell settings put global hidden_api_policy 1 > adb reboot

Nota: per richiedere l'accesso al link di download, devi disporre di un Account Google. La concessione dell'accesso è una procedura manuale e potrebbe richiedere diversi giorni.

• Installazione dell'app:
  • Copia il file APK sullo smartphone di test e aprilo.
  • In alternativa, utilizza adb install audio_test_app.apk.

Avviso: consenti tutte le autorizzazioni quando apri l'app per la prima volta.

• Se viene visualizzata una finestra di dialogo che chiede l'accesso alle notifiche:
  1. fai clic su "Ok".
  2. Scegli "FP SASS test" nell'elenco delle app.
  3. Consenti l'accesso alle notifiche.

Panoramica app:

• Fornitore di destinazione

  • Quando viene fatto clic, questo pulsante mostra un elenco dei dispositivi Bluetooth accoppiati. Seleziona quello che vuoi testare.
  • I pulsanti Connetti e Disconnetti funzionano come quelli nella sezione Dettagli dispositivo delle impostazioni Bluetooth.

• Stato attuale

  • Questo campo mostra l'ultimo stato della connessione ricevuto da un provider utilizzando la trasmissione BLE o il flusso di eventi.
  • Qui vengono visualizzate anche le notifiche di debug del cambio audio.

• Tipo di persona in cerca di lavoro

  • Questa opzione viene utilizzata per passare da un flusso audio all'altro.

Tipo di audio

Classico con A2DP+HFP

• VoIP
  • Se selezioni questa modalità, la modalità audio verrà impostata su AudioManager.MODE_IN_COMMUNICATION e la chiamata AudioManager.startBluetoothSco, quindi l'audio verrà riprodotto con USAGE_VOICE_COMMUNICATION.
  • Il tipo di stream è STREAM_VOICE_CALL.
  • Lo stato della connessione del fornitore dovrebbe passare a CONNECTED_HFP entro 5 secondi.
• Media
  • Se selezioni questa modalità, l'audio verrà riprodotto con il supporto di AVRCP. Il tipo di utilizzo dell'audio è: USAGE_MEDIA.
  • Lo stato della connessione del fornitore dovrebbe passare a CONNECTED_A2DP_WITH_AVRCP entro 5 secondi.
  • Lo stato della connessione potrebbe passare brevemente a CONNECTED_A2DP_ONLY quando viene avviata o interrotta.

• Partita

  • Se selezioni questa modalità, viene riprodotto l'audio che non supporta AVRCP. Il tipo di utilizzo dell'audio è: USAGE_GAME.
  • Lo stato della connessione del fornitore dovrebbe passare a CONNECTED_A2DP_ONLY entro 5 secondi.
  Nota: gli smartphone Samsung impostano lo stato della connessione su CONNECTED_A2DP_WITH_AVRCP anziché su CONNECTED_A2DP_ONLY. Per maggiori dettagli, consulta la sezione Problemi noti.

BLE con LE Audio

• VoIP

  • Se selezioni questa modalità, la modalità audio verrà impostata su AudioManager.MODE_IN_COMMUNICATION e l'audio verrà riprodotto con USAGE_VOICE_COMMUNICATION.
  Nota: per le versioni di Android precedenti a Tiramisu (Android 13), l'app di test chiama AudioManager.startBluetoothSco per avviare una connessione audio SCO Bluetooth. In caso contrario, l'app di test chiama AudioManager.setCommunicationDevice per selezionare il dispositivo audio utilizzato per la comunicazione.
  • Il tipo di stream è STREAM_VOICE_CALL.
  • Lo stato della connessione del fornitore dovrebbe passare a CONNECTED_LE_AUDIO_CALL entro 5 secondi.

• Media

  • Se selezioni questa modalità, l'audio verrà riprodotto con il tipo di stream STREAM_MUSIC. Il tipo di utilizzo dell'audio è: USAGE_MEDIA.
  • Lo stato della connessione del fornitore dovrebbe passare a CONNECTED_LE_AUDIO_MEDIA_WITH_CONTROL entro 5 secondi.
  • Lo stato della connessione potrebbe passare brevemente a CONNECTED_LE_AUDIO_MEDIA_WITHOUT_CONTROL quando viene avviata o interrotta.

• Partita

  • Selezionando questa modalità viene riprodotto l'audio su cui l'utente non ha il controllo diretto. Il tipo di utilizzo dell'audio è: USAGE_GAME.
  • Lo stato della connessione del fornitore dovrebbe passare a CONNECTED_LE_AUDIO_MEDIA_WITHOUT_CONTROL entro 5 secondi.

• Pulsanti Riproduci e Interrompi

  • I pulsanti RIPRODUCI e INTERROMPI avviano o interrompono la riproduzione dell'audio.

• Risultato del cambio

  • Questo campo mostra la latenza attiva di Connetti e cambia. Mostra anche il motivo del rifiuto di un cambio se è stato attivato un evento audio ma il cambio non è avvenuto.
  • La latenza si misura in millisecondi (ms).
  • In generale, la latenza viene misurata dall'inizio del trigger del cambio audio alla ricezione di un profilo BT connesso o dell'evento di cambio multipunto di notifica.
  • I cambi attivati dal fornitore misurano la latenza dall'inizio dell'audio.

Latenza di dump

• Il seguente comando consente a un utente di acquisire misurazioni della latenza durante l'esecuzione di test manuali: adb shell dumpsys activity service com.google.android.gms/.nearby.discovery.service.DiscoveryService
  • Le misurazioni della latenza vengono mostrate nella sezione NearbyDeviceManager 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"

• Qualsiasi commutazione che GmsCore non può misurare (ad es. la commutazione attiva per HFP) verrà registrata come latenza di 0 ms.

Riferimento dei pattern di log:

Problemi noti:

Di seguito sono riportati i bug noti causati dal cercatore:

1. Passaggio all'audio di gioco errato.
   • Gli smartphone Samsung imposteranno lo stato della connessione su CONNECTED_A2DP_WITH_AVRCP, anziché CONNECTED_A2DP_ONLY, durante la riproduzione dei giochi.
   • Alcuni giochi (come Candy Crush) potrebbero riprodurre la musica di sottofondo e attivare un nuovo evento audio senza l'intervento dell'utente. Gli smartphone connessi potrebbero attivare costantemente l'audio su ogni smartphone che apre il gioco.