Rozwiązywanie problemów z dodatkami do Meet

Ten przewodnik zawiera instrukcje rozwiązywania konkretnych błędów pakietu SDK dodatków do 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 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 zgłasza błąd, wraz z wyjaśnieniem, jak je interpretować, oraz wskazówkami, co zrobić, gdy się pojawią.

Błąd Komunikat o błędzie Działanie
ActivityIsOngoing Nie można wykonać operacji podczas trwania aktywności. Sprawdź, czy aktywność nie jest w toku.
ActivityStartingStateEmpty Stan początkowy aktywności jest pusty. Podano obiekt ActivityStartingState, ale nie zawiera on ż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. Utwórz instancję AddonSession tylko raz.
AddonStartingStateMissingAttributes Stan początkowy dodatku nie zawiera żadnych rozpoznanych atrybutów. Upewnij się, że obiekt AddonStartingState zawiera co najmniej jeden z tych atrybutów: sidePanelUrl, additionalData.
AddonStartingStateUnrecognizedAttributes Stan początkowy dodatku zawiera nierozpoznane atrybuty. Upewnij się, że obiekt AddonStartingState ma tylko te atrybuty: sidePanelUrl, additionalData.
ArgumentNullError Wartość podanego obiektu ma wartość null, mimo że oczekiwano wartości. Upewnij się, że przekazujesz argument o oczekiwanym typie.
ArgumentTypeError Typ podanego obiektu nie jest zgodny z oczekiwanym typem. Sprawdź, czy typ podanego argumentu jest zgodny z oczekiwanym typem.
DestinationNotReady Ramka odbiorcy nie jest połączona za pomocą pakietu SDK dodatków do Meet i nie może odbierać powiadomień. Zanim wyślesz wiadomości do ramki docelowej, upewnij się, że jest ona połączona.
InternalError Wystąpił wewnętrzny błąd Meet. Brak dalszych informacji.
InvalidActivityStartingState Adresy URL elementów iframe ActivityStartingState nie pasują do źródeł adresów URL podanych w pliku manifestu dodatku. Sprawdź, czy źródła adresów URL elementu iframe ActivityStartingState są zgodne ze źródłami adresów URL podanymi w pliku manifestu dodatku. Więcej informacji znajdziesz w artykule Dodatkowe zabezpieczenia.
InvalidAddonStartingState Adresy URL elementów iframe AddonStartingState nie pasują do źródeł adresów URL podanych w pliku manifestu dodatku. Sprawdź, czy źródła adresów URL elementu iframe AddonStartingState są zgodne ze źródłami adresów URL podanymi w pliku manifestu dodatku.
InvalidCloudProjectNumber Numer projektu Cloud podany przez Meet nie jest zgodny z numerem przekazanym przez pakiet SDK dodatków do Meet. Upewnij się, że podczas wywoływania właściwości createAddonSession lub metody exposeToMeetWhenScreenSharing() do pakietu SDK przekazywany jest prawidłowy numer projektu w Google Cloud w postaci ciągu znaków. Ten parametr jest automatycznie dołączany przez Meet do wszystkich adresów URL iframe. Zanim użyjesz przekazanej wartości, upewnij się, że Twoja infrastruktura nie modyfikuje parametrów adresu URL (np. w ramach przekierowania).
MeetingPolicyPreventsStartingActivity Zasady dotyczące spotkań (np. korzystanie z ustawień kontroli gospodarza) uniemożliwiają użytkownikowi rozpoczęcie aktywności. Poproś gospodarza spotkania lub administratora o zmodyfikowanie niezbędnych ustawień, aby umożliwić bieżącemu użytkownikowi rozpoczęcie aktywności.
MissingUrlParameter Brak wymaganego parametru adresu URL pakietu SDK dodatków do Meet. Ten parametr jest automatycznie dodawany przez Meet do adresu URL elementu iframe. Upewnij się, że Twoja infrastruktura nie modyfikuje parametrów adresu URL (np. w ramach przekierowania).
NeedsMainStageContext Tę metodę można wywołać tylko wtedy, gdy dodatek jest uruchomiony w głównej części ekranu. Przed wywołaniem tej metody użyj właściwości getFrameType, aby sprawdzić, czy dodatek jest uruchomiony na głównym etapie.
NeedsSidePanelContext Tę metodę można wywołać tylko wtedy, gdy dodatek jest uruchomiony w panelu bocznym. Użyj właściwości getFrameType, aby sprawdzić, czy dodatek jest uruchomiony w panelu bocznym, zanim wywołasz tę metodę.
NoActivityFound Podczas wykonywania operacji nie wykryto ż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 autonomicznym.
RequiresEapEnrollment Żądana metoda wymaga rejestracji w programie EAP. Rejestracja w programie wcześniejszego dostępu do dodatków do Google Meet została zamknięta.
SizeLimitExceededActivityStartingState Rozmiar adresów URL ActivityStartingState lub powiązanych z nimi danych przekracza dozwolone limity. Sprawdź, czy rozmiar adresu URL ActivityStartingState jest mniejszy niż 512 znaków, a rozmiar danych dodatkowych jest mniejszy niż 4096 znaków.
SizeLimitExceededAddonStartingState Rozmiar adresów URL AddonStartingState lub powiązanych z nimi danych przekracza dozwolone limity. Sprawdź, czy rozmiar adresu URL AddonStartingState jest mniejszy niż 512 znaków, a rozmiar danych dodatkowych jest mniejszy niż 4096 znaków.
SizeLimitExceededFrameToFrameMessage Rozmiar wiadomości między klatkami przekracza dozwolony limit. Sprawdź, czy rozmiar wiadomości między klatkami jest mniejszy niż 1 000 000 znaków.
UserCancelled Użytkownik anulował rozpoczęcie aktywności. Aby rozpocząć aktywność, użytkownik musi kliknąć „Dalej”.
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.