Questa guida descrive nel dettaglio i requisiti per l'integrazione con la funzionalità di condivisione in tempo reale di Google Meet. Prima che un provider di terze parti possa utilizzare questa funzionalità, devi fornire al team di Meet diverse informazioni per autorizzarla correttamente, poiché al momento è in anteprima e non è in disponibilità generale.
Modulo di accesso
Il primo passaggio consiste nel compilare questo modulo di accesso all'SDK, inclusi i seguenti dettagli:
- Identificatore applicazione: una parola chiave minuscola (ad esempio "youtube") che identifica in modo univoco il provider specifico. Questo identificatore viene utilizzato per agevolare l'identificazione del provider durante l'avvio del nostro SDK per la condivisione in tempo reale di Meet e per consentire la sincronizzazione tra i client. A meno che non venga approvato dal team con il piano di implementazione specifico, l'identificatore non deve essere modificato. Se questa parola chiave non corrisponde a ciò che si aspetta Meet, la condivisione in tempo reale non funzionerà per questo provider. Queste parole chiave sono hardcoded nel programma binario di Meet. Ciò significa che una modifica a questa parola chiave richiede tempo per essere propagata a tutti gli utenti.
- Elenco di account di dominio Google (ad esempio, 222larabrown@gmail.com) utilizzati per testare l'integrazione lato provider: l'elenco di account viene utilizzato per determinare se la funzionalità deve essere attivata per questo account in Meet. Se un account non è presente in questo elenco, il provider non può connettersi al nostro SDK per la condivisione in tempo reale di Meet e la condivisione in tempo reale non è disponibile.
- Nome del pacchetto Android per gestire il lancio da Meet: nell'ambito della funzionalità di condivisione in tempo reale, Meet deve avviare un intent Android per avviare l'applicazione del provider di terze parti. Devi quindi fornire un nome specifico del pacchetto dell'app (ad esempio "com.google.android.youtube"). Questo nome del pacchetto è impostato come hardcoded nel programma binario di Meet e non deve cambiare, a meno che non venga approvato dal team con il piano di implementazione specifico. Eventuali modifiche a questo pacchetto senza garantire che il team di Meet lo abbiano aggiornato di conseguenza disattiveranno di fatto la funzionalità di condivisione in tempo reale.
- Account del dominio Google: il team di Meet condividerà una cartella di Google Drive con tutti i prodotti alpha richiesti per l'integrazione.
- Icona Partner: un'icona da visualizzare accanto al nome dell'applicazione di condivisione in tempo reale. Utilizzato nella schermata di Meet, dove gli utenti possono selezionare l'applicazione di condivisione in tempo reale da avviare.
Procedura per l'onboarding
Configurazione
- Scarica l'SDK per la condivisione in tempo reale di Meet dal repository Maven di Google.
- Scarica e installa Google Meet dal Google Play Store.
- Scarica, crea e installa l'app di esempio.
- Aggiungi l'account del dominio Google selezionato in precedenza al dispositivo di test.
- Avvia l'app Meet e seleziona l'account del dominio Google che hai aggiunto al dispositivo nel passaggio precedente.
- Ripeti i passaggi precedenti per l'installazione e l'accesso su tutti i dispositivi su cui vuoi eseguire il test.
Esegui il test utilizzando l'applicazione di esempio per la condivisione in tempo reale fornita
- Avvia l'applicazione Meet su almeno 2 dispositivi.
- Crea una riunione e assicurati che tutti i dispositivi partecipino alla stessa riunione.
- Seleziona il pulsante "Casa" su entrambi i dispositivi per attivare la modalità Picture in picture (PIP) e la sessione della riunione continua.
- Avvia l'applicazione di esempio per la condivisione in tempo reale su entrambi i dispositivi.
- Nell'applicazione di esempio per la condivisione in tempo reale, tocca Partecipa alla riunione. Esegui questa operazione su entrambi i dispositivi. Il testo del pulsante diventa Esci dalla riunione con una barra verde sotto il testo, a indicare che l'app si è connessa correttamente alla riunione.
- Nell'applicazione di esempio per la condivisione in tempo reale, tocca Guardare insieme. Esegui questa operazione su entrambi i dispositivi. Una volta attivato l'opzione, viene stabilita la comunicazione tra le 2 applicazioni di condivisione in tempo reale.
- Ora puoi iniziare a sperimentare con i vari elementi UI nell'applicazione di esempio per simulare la funzionalità di riproduzione multimediale. Qualsiasi azione eseguita su un'applicazione di esempio si riflette nell'altra.
Integrazione e test del provider
I passaggi riportati di seguito sono necessari se vuoi testare la funzionalità di condivisione in tempo reale con la tua applicazione in qualità di fornitore di contenuti. Richiede che la tua app sia integrata con l'SDK della condivisione in tempo reale di Meet. È fondamentale che le informazioni che hai fornito durante la procedura di onboarding, come "Identificatore applicazione" e "Nome pacchetto Android", sono corrette perché vengono utilizzate per autenticare la tua applicazione durante la comunicazione con l'applicazione Meet.
- Integra l'SDK della Condivisione in tempo reale di Meet nella tua app. Consulta la pagina Inizia di Android per le linee guida sull'utilizzo o la sezione Riferimento API di Android per le specifiche dell'API.
- Assicurati di utilizzare la versione 4.0.0 o successiva del plug-in Android Gradle durante la creazione dell'applicazione. Questa operazione è necessaria per supportare il supporto della desugaring dell'API Java 8 e versioni successive. Per saperne di più, consulta questa guida.
- Avvia l'applicazione Meet su almeno 2 dispositivi.
- Crea una riunione e assicurati che tutti i dispositivi partecipino alla stessa riunione.
- Avvia la condivisione in tempo reale dalla tua applicazione. Una volta che un dispositivo ha iniziato la condivisione in tempo reale, l'altro dispositivo su cui l'applicazione Meet è già in esecuzione riceve un invito all'interno della schermata della chiamata.
Puoi anche avviare la tua applicazione selezionandola dalla finestra di dialogo Attività a cui puoi accedere seguendo questi passaggi:
- Nella schermata delle chiamate dell'applicazione Meet, tocca il menu.
- Tocca il pulsante Attività.
- Seleziona la tua applicazione dall'elenco Attività.
- Ora l'applicazione Meet passa in modalità PIP e l'applicazione viene avviata.
Dipendenze esterne
Nota: l'SDK per la condivisione in tempo reale di Meet specifica le
dipendenze
nel relativo file *.POM. Se non utilizzi Maven e scegli di includere direttamente il file *.AAR dell'SDK per la condivisione in tempo reale di Meet, è tua responsabilità controllare il file *.POM e assicurarti che vengano fornite le dipendenze richieste (ad es.androidx.concurrent:concurrent-futures:1.1.0).