Rozwiązywanie problemów z dodatkami do Meet

W tym przewodniku znajdziesz instrukcje rozwiązywania konkretnych błędów pakietu SDK dodatków Google Meet, które mogą wystąpić podczas tworzenia i testowania dodatków do 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 generowanych, gdy pakiet SDK dodatków do Meet wyrzuca błąd, wraz z wyjaśnieniem, jak je interpretować i co robić, gdy się pojawią.

Błąd Komunikat o błędzie Działanie
ActivityIsOngoing Nie można wykonać operacji podczas trwania aktywności. Upewnij się, że dana aktywność nie jest w trakcie.
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 przesyłasz wartość o oczekiwanym typie argumentu.
ArgumentTypeError Typ przesłanego obiektu nie jest zgodny z oczekiwanym typem. Sprawdź, czy typ argumentu jest zgodny z oczekiwanym typem.
DestinationNotReady Ramka odbiorcy nie jest połączona za pomocą pakietu SDK dodatków Meet i nie może odbierać powiadomień. Zanim wyślesz wiadomość 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 ActivityStartingStateźródła adresów URL w ramce iframe są zgodne ze źródłami adresów URL podanych 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. Podczas wywoływania właściwości createAddonSession lub metody exposeToMeetWhenScreenSharing() upewnij się, że do pakietu SDK jako ciąg znaków przekazywany jest prawidłowy numer projektu Cloud. Ten parametr jest automatycznie dołączany przez Meet do dowolnych 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 pakietu SDK dodatków do Meet. Meet automatycznie dodaje ten parametr do adresu URL ramki iframe. 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 działa 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 połączeniu w Meet. Nie wywołuj tej metody podczas rozmowy w Meet.
NotSupportedInStandalone Ta metoda nie jest obsługiwana w trybie samodzielnym. Nie wywołuj tej metody w trybie samodzielnym.
RequiresEapEnrollment Wybrana metoda wymaga rejestracji EAP. Rejestracja w programie testowania dodatku 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ść się zakończyła.