Este guia fornece instruções sobre como resolver erros específicos do SDK de complementos do Google Meet que podem ocorrer durante a criação e o teste de 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 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 ocorrerem.
| Erro | Mensagem de erro | Ação |
|---|---|---|
ActivityIsOngoing |
Não é possível realizar uma operação enquanto uma atividade está em andamento. | Verifique se uma atividade não está em andamento. |
ActivityStartingStateEmpty |
O estado de início da atividade está vazio. | Um objeto ActivityStartingState foi fornecido, mas ele 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 de início 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, 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 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. | Verifique se o número correto do projeto do Cloud é 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 do SDK de complementos do Meet obrigatório 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 sendo executado 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 a inscrição no EAP. | A inscrição no acesso antecipado do complemento do Google Meet foi encerrada. |
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. |