Questa guida fornisce istruzioni su come risolvere errori specifici dell'SDK di Google Meet Add-ons che potresti riscontrare durante la creazione e il test di Meet Add-ons.
Per ottenere 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 dei componenti aggiuntivi di Meet genera un errore, insieme alla spiegazione su come interpretarli e alle 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 di inizio dell'attività è vuoto. | È stato fornito un oggetto ActivityStartingState , ma non contiene attributi. |
ActivityStartingStateMissingAttributes |
Lo stato di avvio 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 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 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 tramite 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 dell'URL iframe ActivityStartingState corrispondano alle origini degli URL forniti nel 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 di 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 di Meet Add-ons. | Assicurati che nell'SDK venga passato il numero di progetto Cloud corretto come stringa quando chiami la proprietà createAddonSession o il metodo exposeToMeetWhenScreenSharing() . Questo parametro viene aggiunto automaticamente da Meet a tutti gli 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. |
MissingUrlParameter |
Parametro URL dell'SDK di Meet Add-ons 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 invocato solo se il componente aggiuntivo è in esecuzione nella fase principale. | Utilizza la proprietà getFrameType per verificare se il componente aggiuntivo è in esecuzione nella fase principale prima di richiamare questo metodo. |
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 ai componenti aggiuntivi di Google Meet è chiusa. |
SizeLimitExceededActivityStartingState |
Le dimensioni degli URL di 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 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. |