Naprawianie błędów dodatku do Meet

Ten przewodnik zawiera instrukcje rozwiązywania konkretnych błędów w Google Meet Add-ons SDK, które mogą wystąpić podczas tworzenia i testowania dodatków do Google Meet.

Aby uzyskać szczegółowe informacje o błędzie, użyj obiektu MeetAddonError. Zawiera ona właściwość errorType, która określa typ błędu.

Typy błędów

Poniżej znajdziesz typy błędów, które są generowane, gdy pakiet SDK dodatków do Meet zgłasza błąd. Wyjaśniamy też, jak je interpretować, a także podpowiadamy, co zrobić, gdy otrzymasz taki komunikat.

Błąd Komunikat o błędzie Działanie
ActivityIsOngoing Nie można wykonać operacji, gdy trwa działanie. Upewnij się, że jakaś aktywność nie jest aktywna.
ActivityStartingStateEmpty Stan początkowy aktywności jest pusty. Podano obiekt ActivityStartingState, który nie zawiera żadnych atrybutów.
ActivityStartingStateMissingAttributes Stan początkowy aktywności nie zawiera żadnych rozpoznanych atrybutów. Upewnij się, że obiekt ActivityStartingState zawiera co najmniej jeden z tych atrybutów: mainStageUrl, sidePanelUrl lub additionalData.
ActivityStartingStateUnrecognizedAttributes Stan początkowy aktywności zawiera nierozpoznane atrybuty. Upewnij się, że obiekt ActivityStartingState ma tylko te atrybuty: mainStageUrl, sidePanelUrl lub additionalData.
AddonSessionAlreadyCreated Sesja dodatku została już utworzona. instancjować klasę AddonSession tylko raz;
AddonStartingStateMissingAttributes Stan początkowy dodatku nie zawiera żadnych rozpoznawanych atrybutów. Upewnij się, że obiekt AddonStartingState zawiera co najmniej jeden z tych atrybutów: sidePanelUrl lub additionalData.
AddonStartingStateUnrecognizedAttributes Stan początkowy dodatku zawiera nierozpoznane atrybuty. Upewnij się, że obiekt AddonStartingState ma tylko te atrybuty: sidePanelUrl i additionalData.
ArgumentNullError Wartość dostarczonego obiektu jest null, gdzie oczekiwana jest wartość. Upewnij się, że przekazujesz wartość oczekiwanego typu dla argumentu.
ArgumentTypeError Typ przesłanego obiektu nie jest zgodny z oczekiwanym typem. Upewnij się, że typ podanego argumentu jest zgodny z oczekiwanym typem.
DestinationNotReady Ramka odbiorcy nie jest połączona za pomocą pakietu SDK dodatków Meet i nie może otrzymywać powiadomień. Przed wysłaniem wiadomości do ramki docelowej upewnij się, że jest ona połączona.
InternalError Wystąpił wewnętrzny błąd Meet. Nie ma więcej informacji.
InvalidActivityStartingState ActivityStartingState Adresy URL elementów iframe nie pasują do źródeł adresów URL podanych w pliku manifestu dodatku. Upewnij się, że źródła adresów URL iframe ActivityStartingState są zgodne z pierwotnymi adresami URL podanymi w pliku manifestu dodatku. Więcej informacji znajdziesz w artykule Bezpieczeństwo dodatków.
InvalidAddonStartingState AddonStartingState Adresy URL elementów iframe nie pasują do źródeł adresów URL podanych w pliku manifestu dodatku. Upewnij się, że AddonStartingStateźródła adresów URL w ramce iframe są zgodne ze źródłami adresów URL podanych w pliku manifestu dodatku.
InvalidCloudProjectNumber Numer projektu Cloud podany przez Meet nie jest zgodny z numerem przekazanym przez pakiet SDK dodatków Meet. Sprawdź, czy podczas wywoływania właściwości createAddonSession lub metody exposeToMeetWhenScreenSharing() do pakietu SDK przekazywany jest prawidłowy numer projektu Cloud. Ten parametr jest automatycznie dołączany przez Meet do wszystkich adresów URL w ramce. Upewnij się, że Twoja infrastruktura nie modyfikuje parametrów adresu URL (np. w ramach przekierowania) przed użyciem przekazanej wartości.
MissingUrlParameter Brak wymaganego parametru adresu URL w pakiecie SDK dodatków do Meet. Meet automatycznie dodaje ten parametr do adresu URL ramki. Upewnij się, że infrastruktura nie modyfikuje parametrów adresu URL (np. w ramach przekierowania).
NeedsMainStageContext Tej metody można użyć tylko wtedy, gdy dodatek działa w głównej części ekranu. Przed wywołaniem tej metody użyj właściwości getFrameType, aby sprawdzić, czy dodatek działa na etapie głównym.
NeedsSidePanelContext Ta metoda może być wywoływana tylko wtedy, gdy dodatek działa w panelu bocznym. Zanim wywołasz tę metodę, użyj właściwości getFrameType, aby sprawdzić, czy dodatek jest uruchomiony w panelu bocznym.
NoActivityFound Podczas wykonywania operacji nie znaleziono żadnej aktywności. Zanim wykonasz tę operację, upewnij się, że aktywność została rozpoczęta.
NotSupportedInMeetCall Ta metoda nie jest obsługiwana w rozmowie w Meet. Nie wywołuj tej metody podczas połączenia w Meet.
NotSupportedInStandalone Ta metoda nie jest obsługiwana w trybie samodzielnym. Nie wywołuj tej metody w trybie samodzielnym.
RequiresEapEnrollment Żądana metoda wymaga rejestracji EAP. Rejestracja w programie testowania dodatku do Google Meet została zamknięta.
SizeLimitExceededActivityStartingState Rozmiar adresów URL ActivityStartingState lub ich danych przekracza dozwolone limity. Sprawdź, czy rozmiar adresu URL ActivityStartingState jest mniejszy niż 512 znaków, a dodatkowe dane mają mniej niż 4096 znaków.
SizeLimitExceededAddonStartingState Rozmiar adresów URL AddonStartingState lub ich danych przekracza dozwolone limity. Sprawdź, czy rozmiar adresu URL AddonStartingState jest mniejszy niż 512 znaków, a dodatkowe dane mają mniej niż 4096 znaków.
SizeLimitExceededFrameToFrameMessage Rozmiar wiadomości przesyłanej z ramki na ramkę przekracza dozwolone limity. Upewnij się, że rozmiar wiadomości z ramki na ramkę jest mniejszy niż 1 000 000 znaków.
UserCancelled Użytkownik anulował rozpoczęcie aktywności. Użytkownik musi kliknąć „Dalej”, aby rozpocząć aktywność.
UserNotInitiator Użytkownik nie jest inicjatorem bieżącej aktywności. Upewnij się, że użytkownik jest inicjatorem bieżącej aktywności lub że aktywność została zakończona.