Risolvere gli errori dei componenti aggiuntivi di Meet

Questa guida fornisce istruzioni su come risolvere errori specifici dell'SDK per i 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 errore generati quando l'SDK per i componenti aggiuntivi di Meet genera un errore, insieme alla spiegazione su come interpretarli e indicazioni su cosa fare quando li ricevi.

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 iniziale 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. Istanzia AddonSession una sola volta.
AddonStartingStateMissingAttributes Lo stato iniziale del componente aggiuntivo non contiene attributi riconosciuti. Assicurati che l'oggetto AddonStartingState contenga almeno uno dei seguenti attributi: sidePanelUrl, additionalData.
AddonStartingStateUnrecognizedAttributes Lo stato iniziale 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 dell'oggetto fornito non corrisponde al tipo previsto. Assicurati che il tipo di argomento fornito corrisponda al tipo previsto.
DestinationNotReady Il frame del destinatario non è connesso tramite l'SDK dei componenti aggiuntivi di Meet e non può ricevere la notifica. Assicurati che il frame di destinazione sia connesso prima di inviare messaggi.
InternalError Si è verificato un errore interno di Meet. Non sono disponibili ulteriori informazioni.
InvalidActivityStartingState Gli URL iframe ActivityStartingState non corrispondono alle origini degli URL forniti nel manifest del componente aggiuntivo. Assicurati che le origini dell'URL dell'iframe ActivityStartingState corrispondano alle origini degli URL forniti nel file manifest del componente aggiuntivo. Per ulteriori informazioni, vedi Sicurezza dei componenti aggiuntivi.
InvalidAddonStartingState Gli URL iframe AddonStartingState non corrispondono alle origini degli URL forniti nel manifest del componente aggiuntivo. Assicurati che le origini dell'URL dell'iframe AddonStartingState corrispondano alle origini degli URL forniti nel file manifest del componente aggiuntivo.
InvalidCloudProjectNumber Il numero di progetto cloud fornito da Meet non corrisponde a quello passato dall'SDK dei componenti aggiuntivi di Meet. Assicurati che il numero di 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 qualsiasi URL iframe. Assicurati che la tua infrastruttura non modifichi i parametri URL (ad esempio, nell'ambito di un reindirizzamento) prima di utilizzare il valore trasmesso.
MeetingPolicyPreventsStartingActivity Un criterio per le riunioni (ad esempio l'utilizzo delle impostazioni di controllo dell'organizzatore) impedisce all'utente di avviare l'attività. Chiedi all'organizzatore della riunione o all'amministratore di modificare le impostazioni necessarie per consentire all'utente attuale di avviare l'attività.
MissingUrlParameter Parametro URL dell'SDK per i componenti aggiuntivi di Meet obbligatorio mancante. Questo parametro viene aggiunto automaticamente da Meet all'URL dell'iframe. Assicurati che la tua infrastruttura non modifichi i parametri URL (ad esempio nell'ambito di un reindirizzamento).
NeedsMainStageContext Questo metodo può essere richiamato solo se il componente aggiuntivo è in esecuzione nella schermata principale. Utilizza la proprietà getFrameType per verificare se il componente aggiuntivo è in esecuzione nel palco principale prima di richiamare questo metodo.
NeedsSidePanelContext Questo metodo può essere richiamato 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 iniziata 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 al programma EAP. La registrazione per l'accesso in anteprima al componente aggiuntivo Google Meet è chiusa.
SizeLimitExceededActivityStartingState Le dimensioni degli URL ActivityStartingState e/o dei relativi dati superano i limiti consentiti. Assicurati che la dimensione dell'URL ActivityStartingState sia inferiore a 512 caratteri e che la dimensione dei dati aggiuntivi sia inferiore a 4096 caratteri.
SizeLimitExceededAddonStartingState Le dimensioni degli URL AddonStartingState e/o dei relativi dati superano i limiti consentiti. Assicurati che la dimensione dell'URL AddonStartingState sia inferiore a 512 caratteri e che la dimensione dei dati aggiuntivi sia inferiore a 4096 caratteri.
SizeLimitExceededFrameToFrameMessage Le dimensioni del messaggio frame per frame superano i limiti consentiti. Assicurati che le dimensioni del messaggio frame per 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 iniziare 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.