Resolver problemas e corrigir erros no complemento do Meet

Este guia fornece instruções sobre como resolver erros específicos do SDK de complementos do Google Meet que podem ser encontrados ao criar e testar complementos do Meet.

Para conferir detalhes sobre um erro, use o objeto MeetAddonError. Ele contém uma propriedade errorType que especifica o tipo de erro.

Tipos de erro

Confira a seguir os tipos de erro gerados quando o SDK do Meet Add-ons gera um erro, além de explicações sobre como interpretá-los e orientações sobre o que fazer quando eles ocorrerem.

Erro Mensagem de erro Ação
ActivityIsOngoing Não é possível realizar a operação enquanto uma atividade está em andamento. Verificar se uma atividade não está em andamento.
ActivityStartingStateEmpty O estado de início da atividade está vazio. Um objeto ActivityStartingState foi fornecido, mas não contém atributos.
ActivityStartingStateMissingAttributes O estado de início da atividade não contém atributos reconhecidos. Verifique se o objeto ActivityStartingState contém pelo menos um dos seguintes atributos: mainStageUrl, sidePanelUrl ou additionalData.
ActivityStartingStateUnrecognizedAttributes O estado inicial da atividade contém atributos não reconhecidos. Verifique se o objeto ActivityStartingState tem apenas os seguintes atributos: mainStageUrl, sidePanelUrl ou additionalData.
AddonSessionAlreadyCreated A sessão do complemento já foi criada. Instância o AddonSession apenas uma vez.
AddonStartingStateMissingAttributes O estado inicial do complemento não contém atributos reconhecidos. Verifique se o objeto AddonStartingState contém pelo menos um dos seguintes atributos: sidePanelUrl e additionalData.
AddonStartingStateUnrecognizedAttributes O estado inicial do complemento contém atributos não reconhecidos. Verifique se o objeto AddonStartingState tem apenas os seguintes atributos: sidePanelUrl, additionalData.
ArgumentNullError O valor do objeto fornecido é nulo, quando um valor era esperado. Verifique se você está transmitindo um valor do tipo esperado para o argumento.
ArgumentTypeError O tipo do objeto fornecido não corresponde ao esperado. Verifique se o tipo do argumento fornecido corresponde ao esperado.
DestinationNotReady O frame do destinatário não está conectado usando o SDK de complementos do Meet e não pode receber a notificação. Verifique se o frame de destino está conectado antes de enviar mensagens para ele.
InternalError Ocorreu um erro interno do Meet. Não há mais informações disponíveis.
InvalidActivityStartingState Os URLs de iframe ActivityStartingState não correspondem às origens dos URLs fornecidos no manifesto do complemento. Verifique se as origens dos URLs de iframe ActivityStartingState correspondem às origens dos URLs fornecidos no manifesto do complemento. Para mais informações, consulte Segurança do complemento.
InvalidAddonStartingState Os URLs de iframe AddonStartingState não correspondem às origens dos URLs fornecidos no manifesto do complemento. Verifique se as origens dos URLs de iframe AddonStartingState correspondem às origens dos URLs fornecidos no manifesto do complemento.
InvalidCloudProjectNumber O número do projeto do Cloud fornecido pelo Meet não corresponde ao número transmitido pelo SDK de complementos do Meet. Confira se o número correto do projeto do Cloud foi transmitido para o SDK como uma string ao chamar a propriedade createAddonSession ou o método exposeToMeetWhenScreenSharing(). Esse parâmetro é anexado automaticamente pelo Meet a todos os URLs de iframe. Verifique se a infraestrutura não modifica os parâmetros de URL (por exemplo, como parte de um redirecionamento) antes de usar o valor transmitido.
MissingUrlParameter O parâmetro de URL obrigatório do SDK de complementos do Meet está ausente. Esse parâmetro é anexado automaticamente pelo Meet ao URL do iframe. Verifique se a infraestrutura não modifica os parâmetros de URL (por exemplo, como parte de um redirecionamento).
NeedsMainStageContext Esse método só pode ser invocado se o complemento estiver em execução no estágio principal. Use a propriedade getFrameType para verificar se o complemento está sendo executado no estágio principal antes de invocar esse método.
NeedsSidePanelContext Esse método só pode ser invocado se o complemento estiver em execução no painel lateral. Use a propriedade getFrameType para verificar se o complemento está em execução no painel lateral antes de invocar esse método.
NoActivityFound Nenhuma atividade foi encontrada ao realizar uma operação. Verifique se a atividade foi iniciada antes de realizar essa operação.
NotSupportedInMeetCall Esse método não é compatível com a chamada do Meet. Não chame esse método durante uma chamada do Meet.
NotSupportedInStandalone Esse método não é compatível com o modo independente. Não chame esse método no modo independente.
RequiresEapEnrollment O método solicitado requer registro no EAP. As inscrições para o acesso antecipado do complemento do Google Meet estão encerradas.
SizeLimitExceededActivityStartingState O tamanho dos URLs ActivityStartingState e/ou dos dados deles excede os limites permitidos. O tamanho do URL do ActivityStartingState precisa ser menor que 512 caracteres,e os dados adicionais precisam ter menos de 4.096 caracteres.
SizeLimitExceededAddonStartingState O tamanho dos URLs AddonStartingState e/ou dos dados deles excede os limites permitidos. Verifique se o tamanho do URL AddonStartingState é menor que 512 caracteres e se os dados adicionais têm menos de 4.096 caracteres.
SizeLimitExceededFrameToFrameMessage O tamanho da mensagem de frame a frame excede os limites permitidos. O tamanho da mensagem de frame a frame precisa ser menor que 1.000.000 caracteres.
UserCancelled O usuário cancelou a inicialização da atividade. O usuário precisa clicar em "Continuar" para iniciar a atividade.
UserNotInitiator O usuário não é o iniciador da atividade atual. Verifique se o usuário é o iniciador da atividade atual ou se ela foi encerrada.