Linee guida per la certificazione Cambio Audio

Preparazione per la certificazione

  1. Prepara i dispositivi di test.
    • Sono necessari 5 dispositivi Android.
      • Questi dispositivi devono includere:
        • Almeno un Android T (13) e un Android S (12).
        • Almeno un Samsung e un Pixel.
        • Ad esempio:
          • 1 OnePlus (Android 10).
          • 3 Samsung (Android 11, 12, 13).
          • 1 Pixel (Android 13).
    • Un dispositivo senza Cambio Audio:
      • Un qualsiasi iPhone, PC, laptop abilitato per Bluetooth (BT) o telefono Android su cui la funzionalità Cambio Audio è stata disattivata.
        • Puoi disattivare Cambio Audio dalle impostazioni dei dettagli del dispositivo Bluetooth.
      • Lo scenario di test multipunto 2.8 richiede un dispositivo senza Cambio Audio in aggiunta ai 5 telefoni di test.
  2. Partecipa al gruppo di test Cambio Audio con i tuoi account di prova per mostrare notifiche di debug sui telefoni di prova.
    • In questo modo, Google può raccogliere i dati dei test tramite Google Analytics.
  3. Assicurati che su tutti i dispositivi Android sia installata la versione GmsCore 23.xx.xx o successiva.

Criteri di certificazione

  • La percentuale di successo del cambio target deve superare il 95% in tutti gli scenari di test.
  • Nei test che richiedono un passaggio, la connessione del profilo e il cambio dello stato attivo devono essere completati entro tre secondi dall'attivazione degli eventi audio in almeno il 75% dei casi.

Guida ai test

Preparazione del dispositivo in fase di test (DUT)

  • Verifica che il dispositivo BT non sia stato precedentemente accoppiato con uno smartphone su cui è stato eseguito l'accesso all'Account Google di test.
    • Se il dispositivo è stato associato all'Account Google di test, procedi nel seguente modo per annullare l'accoppiamento:
      • Nei dispositivi accoppiati:
        • Vai alle impostazioni Bluetooth.
        • Scegli "Elimina dispositivo".
        • Attiva e disattiva la modalità aereo.
    • Assicurati che l'opzione "Salva automaticamente 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 sul dispositivo Bluetooth.
    • Accoppia il dispositivo Bluetooth iniziale (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 modello di autotest di Cambio Audio.
  • Le cuffie che supportano solo la modalità SinglePoint (SP) eseguono quanto segue:
    • La scheda Test_generico.
  • Le cuffie che supportano la modalità MP funzionano come segue:
    • La scheda Test_generico.
    • La scheda Solo_multipunto.
  • Le cuffie MP che possono essere attivate in modalità SP eseguono queste operazioni:
    • La scheda Generic_test con MP disattivato.
    • La scheda Generic_test con MP attivato.
    • La scheda Solo multipunto con MP attivato.

Completare il riposo e fare il report di autodiagnosi

  • Esegui tutti gli scenari di test almeno due volte.
  • I test devono essere eseguiti nel seguente formato:
  1. Dispositivo A=Android S (12) + Dispositivo B=Android T (13)
  2. Dispositivo A=Android T (13) + Dispositivo B=Android S (12)
  3. 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 prova:

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

  • Test eseguiti:

    • Esegui 1. Dispositivo A=Samsung S10+ (12), Dispositivo B=Pixel 7 pro (13) colonna D: Telefono=Pixel 7 pro, OS=Android 13
    • Esegui 2. Dispositivo A=Pixel 7 Pro (13), Dispositivo B=Pixel 6(12) colonna E: Telefono=Pixel 6, OS=Android 12

Esempio di test completato nel modello di autotest:

Questa immagine mostra i risultati di un test di esempio

Eventi audio:

  • I quattro tipi di eventi audio testati e le app di test consigliate sono:
    1. Chiama il numero:
      1. L'app del telefono integrata.
    2. VoIP: qualsiasi app VoIP funzionerà, ad esempio:
      1. L'app di test Cambio Audio.
      2. Messenger FB.
      3. Linea.
      4. WhatsApp.
      5. Google Meet.
      6. Google Meet.
    3. Contenuti multimediali: funzionerà qualsiasi lettore audio, ad esempio:
      1. L'app di test Cambio Audio.
      2. YouTube Music.
      3. Apple Music.
      4. Spotify
      5. Google Podcasts.
    4. Gioco:
      1. L'app di test Cambio Audio.

Informazioni di debug:

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

    1. Notifica stato più recente: Figura 1: viene visualizzato il messaggio "Notifica stato più recente".

    2. Nessuna notifica relativa al cambio: Figura 2: viene visualizzato il messaggio "nessuna notifica in caso di cambio".

  1. Cambia notifica di latenza: Figura 3: mostra il messaggio di notifica di latenza del passaggio.

Misurazione della latenza

  • Esistono due tipi di latenza di cambio:
    1. Connessione di un profilo Bluetooth a un Seeker disconnesso.
      • Sono inclusi tutti i casi SinglePoint e alcuni MP in cui l'utente che cerca il target (dispositivo B) è disconnesso.
    2. Modifico il Seeker attivo connesso.
      • Sono inclusi alcuni casi di MP in cui il Seeker target (dispositivo B) è già connesso.
  • Esistono due modi per recuperare le informazioni sulla latenza:
    1. L'intera latenza può essere scaricata dal comando adb.
      • Per informazioni dettagliate, consulta la sezione relativa alla latenza di dump.
      • Questo comando può fornire e registrare la latenza dopo aver completato almeno uno scenario di test.
    2. Utilizzando l'app di test Cambio Audio.
      • L'app in esecuzione sul Seeker target mostrerà la latenza dopo il passaggio.
      • In caso contrario, nell'app verrà visualizzato il motivo "Nessun passaggio".

App di prova Cambio Audio:

  • L'utilizzo dell'app per attivare eventi audio VoIP/media/giochi durante un autotest semplifica la configurazione del test e ridurrà la latenza degli eventi del richiedente.
  • Installazione delle app:
    • Copia l'APK sullo smartphone di prova e aprilo.
    • In alternativa, utilizza adb install audio_test_app.apk.
  • Se viene visualizzata una finestra di dialogo che richiede l'accesso alle notifiche:
    1. fai clic su "OK"
    2. Scegli "FP SASS test" nell'elenco di app
    3. Consenti l'accesso alle notifiche.

Panoramica dell'app:

Questa immagine è un esempio dell'app in esecuzione

Provider di destinazione
Quando viene selezionato, questo pulsante mostra un elenco di dispositivi Bluetooth accoppiati. Seleziona quello che vuoi testare.
I pulsanti Connetti e Disconnetti funzionano come quello nei dettagli del dispositivo delle impostazioni Bluetooth.
Stato attuale
Questo campo mostra l'ultimo stato della connessione che il richiedente ha ricevuto da un provider che utilizza pubblicità o stream di eventi BLE.
Qui vengono mostrate anche le notifiche di debug del cambio audio.
Tipo di ricercatore
Questa opzione consente di passare da uno stream audio all'altro sul dispositivo.
Tipo di audio
VoIP Se selezioni questa modalità, la modalità audio passa a AudioManager.MODE_IN_COMMUNICATION e chiama AudioManager.startBluetoothSco, quindi riproduci l'audio con USAGE_VOICE_COMMUNICATION.
  • Il tipo di stream è STREAM_VOICE_CALL.
  • Lo stato della connessione del provider dovrebbe passare a CONNECTED_HFP entro 5 secondi.
Contenuti multimediali Se selezioni questa modalità, verrà riprodotto l'audio con supporto AVRCP. Il tipo di utilizzo dell'audio è: USAGE_MEDIA.
  • Lo stato della connessione del provider dovrebbe passare a CONNECTED_A2DP_WITH_AVRCP entro 5 secondi.
  • Lo stato della connessione può passare brevemente a CONNECTED_A2DP_ONLY quando viene avviato o arrestato.
Gioco Se selezioni questa modalità, l'audio viene riprodotto che non supporta AVRCP. Il tipo di utilizzo dell'audio è: USAGE_GAME.
  • Lo stato della connessione del provider dovrebbe passare a CONNECTED_A2DP_ONLY entro 5 secondi.
Pulsanti di riproduzione e interruzione
I pulsanti RIPRODUCI e INTERROMPI avvia o interrompono l'audio.
Cambia risultato

Questo campo mostra la latenza Connect and Switch active (Collega e Cambia latenza attiva). Viene inoltre mostrato il motivo per cui il cambio viene rifiutato se è stato attivato un evento audio, ma non è avvenuto.

  • La latenza si misura in millisecondi (ms).
  • In generale, la latenza viene misurata dall'inizio dell'attivatore Cambio Audio alla ricezione di un profilo BT connesso o dell'evento Notifica passaggio multipunto.
  • I sensori attivati dal provider misurano la latenza dall'avvio dell'audio.

Latenza di dump

  • Il seguente comando consente a un utente di acquisire le 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 sono mostrate nella sezione SwitchHistory di 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"
  • Qualsiasi switch che GmsCore non può misurare (ad esempio switch attivo per HFP) verrà registrato come latenza di 0 ms.

Riferimento ai pattern di log:

Esempi di log di test di latenza

Problemi noti:

Di seguito sono riportati i bug noti causati dal Seeker:

  1. Cambio audio di gioco errato.
    • Per i telefoni Samsung, lo stato della connessione verrà impostato su CONNECTED_A2DP_WITH_AVRCP anziché su CONNECTED_A2DP_ONLY quando giochi.
    • Alcuni giochi(ad esempio Candy Crush) potrebbero riprodurre la musica di sottofondo e attivare un nuovo evento audio senza input dell'utente. Gli smartphone collegati possono cambiare continuamente l'audio su ogni smartphone che apre il gioco.