Risolvere gli errori dei componenti aggiuntivi di Meet

Questa guida fornisce istruzioni su come risolvere errori SDK specifici dei componenti aggiuntivi di Google Meet che potresti riscontrare durante la creazione e il test dei componenti aggiuntivi di Meet.

Per visualizzare i dettagli di un errore, utilizza l'oggetto MeetAddonError. Contiene una proprietà errorType che specifica il tipo di errore.

Tipi di errore

Di seguito sono riportati i tipi di errori generati quando l'SDK dei componenti aggiuntivi di Meet genera un errore, oltre a una spiegazione su come interpretarli e indicazioni su cosa fare quando si verificano.

Errore Messaggio di errore Azione
ActivityIsOngoing Impossibile eseguire l'operazione mentre è in corso un'attività. Assicurati che non sia in corso un'attività.
ActivityStartingStateEmpty Lo stato di inizio dell'attività è vuoto. È stato fornito un oggetto ActivityStartingState, ma non contiene attributi.
ActivityStartingStateMissingAttributes Lo stato iniziale dell'attività non contiene attributi riconosciuti. Assicurati che l'oggetto ActivityStartingState contenga almeno uno dei seguenti attributi: mainStageUrl, sidePanelUrl o additionalData.
ActivityStartingStateUnrecognizedAttributes Lo stato iniziale dell'attività contiene attributi non riconosciuti. Assicurati che l'oggetto ActivityStartingState abbia solo i seguenti attributi: mainStageUrl, sidePanelUrl o additionalData.
AddonSessionAlreadyCreated La sessione del componente aggiuntivo è già stata creata. Crea un'istanza di AddonSession una sola volta.
AddonStartingStateMissingAttributes Lo stato di avvio del componente aggiuntivo non contiene attributi riconosciuti. Assicurati che l'oggetto AddonStartingState contenga almeno uno dei seguenti attributi: sidePanelUrl, additionalData.
AddonStartingStateUnrecognizedAttributes Lo stato di avvio del componente aggiuntivo contiene attributi non riconosciuti. Assicurati che l'oggetto AddonStartingState abbia solo i seguenti attributi: sidePanelUrl, additionalData.
ArgumentNullError Il valore dell'oggetto fornito è nullo, dove era previsto un valore. Assicurati di passare un valore del tipo previsto per l'argomento.
ArgumentTypeError Il tipo di oggetto fornito non corrisponde a quello previsto. Assicurati che il tipo di argomento fornito corrisponda a quello previsto.
DestinationNotReady Il frame del destinatario non è connesso utilizzando l'SDK dei componenti aggiuntivi di Meet e non può ricevere la notifica. Assicurati che il frame di destinazione sia connesso prima di inviargli messaggi.
InternalError Si è verificato un errore interno di Meet. Non sono disponibili ulteriori informazioni.
InvalidActivityStartingState Gli URL iframe di ActivityStartingState non corrispondono alle origini degli URL forniti nel file manifest del componente aggiuntivo. Assicurati che le origini degli URL iframe di ActivityStartingState corrispondano a quelle degli URL forniti nel file manifest del componente aggiuntivo. Per ulteriori informazioni, vedi Sicurezza dei componenti aggiuntivi.
InvalidAddonStartingState Gli URL iframe di AddonStartingState non corrispondono alle origini degli URL forniti nel file manifest del componente aggiuntivo. Assicurati che le origini degli URL iframe AddonStartingState corrispondano a quelle degli URL forniti nel file manifest del componente aggiuntivo.
InvalidCloudProjectNumber Il numero del progetto Cloud fornito da Meet non corrisponde a quello passato dall'SDK dei componenti aggiuntivi di Meet. Assicurati che il numero del progetto Cloud corretto venga passato all'SDK come stringa quando chiami la proprietà createAddonSession o il metodo exposeToMeetWhenScreenSharing(). Questo parametro viene aggiunto automaticamente da Meet a tutti gli URL iframe. Prima di utilizzare il valore passato, assicurati che la tua infrastruttura non modifichi i parametri URL (ad esempio nell'ambito di un reindirizzamento).
MissingUrlParameter Manca il parametro URL dell'SDK dei componenti aggiuntivi di Meet obbligatorio. Questo parametro viene aggiunto automaticamente da Meet all'URL iframe. Assicurati che l'infrastruttura non modifichi i parametri URL (ad esempio nell'ambito di un reindirizzamento).
NeedsMainStageContext Questo metodo può essere invocato solo se il componente aggiuntivo è in esecuzione nella fase principale. Prima di invocare questo metodo, utilizza la proprietà getFrameType per verificare se il componente aggiuntivo è in esecuzione nella fase principale.
NeedsSidePanelContext Questo metodo può essere invocato solo se il componente aggiuntivo è in esecuzione nel riquadro laterale. Utilizza la proprietà getFrameType per verificare se il componente aggiuntivo è in esecuzione nel riquadro laterale prima di richiamare questo metodo.
NoActivityFound Nessuna attività trovata durante l'esecuzione di un'operazione. Assicurati che l'attività sia avviata prima di eseguire questa operazione.
NotSupportedInMeetCall Questo metodo non è supportato nella chiamata di Meet. Non chiamare questo metodo durante una chiamata di Meet.
NotSupportedInStandalone Questo metodo non è supportato in modalità autonoma. Non chiamare questo metodo in modalità autonoma.
RequiresEapEnrollment Il metodo richiesto richiede la registrazione EAP. La registrazione per l'accesso in anteprima al componente aggiuntivo Google Meet è chiusa.
SizeLimitExceededActivityStartingState Le dimensioni degli URL di ActivityStartingState e/o dei relativi dati superano i limiti consentiti. Assicurati che le dimensioni dell'URL ActivityStartingState siano inferiori a 512 caratteri e che le dimensioni dei dati aggiuntivi siano inferiori a 4096 caratteri.
SizeLimitExceededAddonStartingState Le dimensioni degli URL di AddonStartingState e/o dei relativi dati superano i limiti consentiti. Assicurati che le dimensioni dell'URL AddonStartingState siano inferiori a 512 caratteri e che le dimensioni dei dati aggiuntivi siano inferiori a 4096 caratteri.
SizeLimitExceededFrameToFrameMessage Le dimensioni del messaggio frame-to-frame superano i limiti consentiti. Assicurati che le dimensioni del messaggio da frame a frame siano inferiori a 1.000.000 di caratteri.
UserCancelled L'utente ha annullato l'avvio dell'attività. L'utente deve fare clic su Continua per avviare l'attività.
UserNotInitiator L'utente non è l'iniziatore dell'attività corrente. Assicurati che l'utente sia l'iniziatore dell'attività corrente o che l'attività sia terminata.