Resolver e corrigir erros de complementos do Meet

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

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

Tipos de erro

A seguir, estão os tipos de erro gerados quando o SDK de complementos do Meet gera um erro, além de explicações sobre como interpretá-los e orientações sobre o que fazer quando eles ocorrem.

Erro Mensagem de erro Ação
ActivityIsOngoing Não é possível realizar a operação enquanto uma atividade está em andamento. Verifique se uma atividade não está em andamento.
ActivityStartingStateEmpty O estado inicial da atividade está vazio. Um ActivityStartingState objeto foi fornecido, mas não contém atributos.
ActivityStartingStateMissingAttributes O estado inicial 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 de complementos já foi criada. Instancie 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, 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, mas 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 tipo esperado. Verifique se o tipo do argumento fornecido corresponde ao tipo 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. Nenhuma outra informação está disponível.
InvalidActivityStartingState Os URLs do iframe ActivityStartingState não correspondem às origens dos URLs fornecidos no manifesto do complemento. Verifique se as origens do URL do iframe ActivityStartingState correspondem às origens dos URLs fornecidos no manifesto do complemento. Para mais informações, consulte Segurança de complementos.
InvalidAddonStartingState Os URLs do iframe AddonStartingState não correspondem às origens dos URLs fornecidos no manifesto do complemento. Verifique se as origens do URL do 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 transmitido pelo SDK de complementos do Meet. Verifique se o número correto do projeto na nuvem é 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 sua infraestrutura não modifica os parâmetros de URL (por exemplo, como parte de um redirecionamento) antes de usar o valor transmitido.
MeetingPolicyPreventsStartingActivity Uma política de reunião (como o uso de configurações de controle do organizador) impede que o usuário inicie a atividade. Peça a um organizador ou administrador da reunião para modificar as configurações necessárias para permitir que o usuário atual inicie a atividade.
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 sua 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 palco principal. Use a propriedade getFrameType para verificar se o complemento está em execução no palco 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 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 exige a inscrição no EAP. A inscrição no acesso antecipado do complemento do Google Meet está fechada.
SizeLimitExceededActivityStartingState O tamanho dos URLs ActivityStartingState e/ou dos dados excede os limites permitidos. Verifique se o tamanho do URL ActivityStartingState é menor que 512 caracteres e o tamanho dos dados extras é menor que 4.096 caracteres.
SizeLimitExceededAddonStartingState O tamanho dos URLs AddonStartingState e/ou dos dados excede os limites permitidos. Verifique se o tamanho do URL AddonStartingState é menor que 512 caracteres e o tamanho dos dados extras é menor que 4.096 caracteres.
SizeLimitExceededFrameToFrameMessage O tamanho da mensagem de frame para frame excede os limites permitidos. Verifique se o tamanho da mensagem de frame para frame é menor que 1.000.000 de caracteres.
UserCancelled O usuário cancelou o início 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 a atividade foi encerrada.