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 ver detalhes sobre um erro, use o objeto
MeetAddonError. Ele contém uma propriedade
errorType
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 uma explicação sobre como interpretá-los e orientações sobre o que fazer quando eles aparecem.
| Erro | Mensagem de erro | Ação |
|---|---|---|
ActivityIsOngoing |
Não é possível realizar a operação enquanto uma atividade está em andamento. | Verifique se não há uma atividade em andamento. |
ActivityStartingStateEmpty |
O estado inicial da atividade está vazio. | Um objeto ActivityStartingState 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 do complemento 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 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 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. | Não há mais informações disponíveis. |
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 do Cloud está sendo 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 usar as configurações de controle do organizador) impede que o usuário inicie a atividade. | Peça para um organizador ou administrador da reunião 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 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 na janela principal. | Use a propriedade getFrameType para verificar se o complemento está sendo executado na etapa principal antes de invocar esse método. |
NeedsSidePanelContext |
Esse método só pode ser invocado se o complemento estiver sendo executado no painel lateral. | Use a propriedade getFrameType para verificar se o complemento está sendo executado 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 inscrição 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 excede os limites permitidos. |
Verifique se o tamanho do URL do ActivityStartingState tem menos de 512 caracteres e se o tamanho dos dados adicionais tem menos de 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 se o tamanho dos dados adicionais é menor que 4.096 caracteres. |
SizeLimitExceededFrameToFrameMessage |
O tamanho da mensagem de frame a frame excede os limites permitidos. | Verifique se o tamanho da mensagem de frame a 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 ela já terminou. |