Meet 부가기능 오류 문제 해결하기

이 가이드에서는 Meet 부가기능을 빌드하고 테스트하는 동안 발생할 수 있는 특정 Google Meet 부가기능 SDK 오류를 해결하는 방법을 안내합니다.

오류에 대한 세부정보를 가져오려면 MeetAddonError 객체를 사용하세요. 이 메서드에는 오류 유형을 지정하는 errorType 속성이 포함됩니다.

오류 유형

다음은 Meet 부가기능 SDK에서 오류가 발생할 때 생성되는 오류 유형과 이를 해석하는 방법, 오류가 발생할 때 취해야 할 조치에 관한 안내입니다.

오류 오류 메시지 작업
ActivityIsOngoing 활동이 진행 중일 때는 작업을 실행할 수 없습니다. 활동이 진행 중이 아닌지 확인합니다.
ActivityStartingStateEmpty 활동 시작 상태는 비어 있습니다. ActivityStartingState 객체가 제공되었지만 속성이 포함되어 있지 않습니다.
ActivityStartingStateMissingAttributes 활동 시작 상태에 인식된 속성이 없습니다. ActivityStartingState 객체에 mainStageUrl, sidePanelUrl, additionalData 속성 중 하나 이상이 포함되어 있는지 확인합니다.
ActivityStartingStateUnrecognizedAttributes 활동 시작 상태에 인식할 수 없는 속성이 포함되어 있습니다. ActivityStartingState 객체에 mainStageUrl, sidePanelUrl 또는 additionalData 속성만 있어야 합니다.
AddonSessionAlreadyCreated 부가기능 세션이 이미 생성되었습니다. AddonSession는 한 번만 인스턴스화합니다.
AddonStartingStateMissingAttributes 부가기능 시작 상태에 인식된 속성이 없습니다. AddonStartingState 객체에 sidePanelUrl, additionalData 속성 중 하나 이상이 포함되어 있는지 확인합니다.
AddonStartingStateUnrecognizedAttributes 부가기능 시작 상태에 인식할 수 없는 속성이 포함되어 있습니다. AddonStartingState 객체에 sidePanelUrl, additionalData 속성만 있는지 확인합니다.
ArgumentNullError 값이 예상되는 위치에서 제공된 객체의 값이 null입니다. 인수에 예상되는 유형의 값을 전달해야 합니다.
ArgumentTypeError 제공된 객체의 유형이 예상 유형과 일치하지 않습니다. 제공된 인수의 유형이 예상 유형과 일치하는지 확인합니다.
DestinationNotReady 수신자 프레임이 Meet 부가기능 SDK를 사용하여 연결되어 있지 않으므로 알림을 수신할 수 없습니다. 대상 프레임에 메시지를 보내기 전에 대상 프레임이 연결되어 있는지 확인합니다.
InternalError Meet 내부 오류가 발생했습니다. 추가 정보는 없습니다.
InvalidActivityStartingState ActivityStartingState iframe URL이 부가기능 매니페스트에 제공된 URL의 출처와 일치하지 않습니다. ActivityStartingState iframe URL 출처가 부가기능 매니페스트에 제공된 URL의 출처와 일치하는지 확인합니다. 자세한 내용은 부가기능 보안을 참고하세요.
InvalidAddonStartingState AddonStartingState iframe URL이 부가기능 매니페스트에 제공된 URL의 출처와 일치하지 않습니다. AddonStartingState iframe URL 출처가 부가기능 매니페스트에 제공된 URL의 출처와 일치하는지 확인합니다.
InvalidCloudProjectNumber Meet에서 제공한 클라우드 프로젝트 번호가 Meet 부가기능 SDK에서 전달한 번호와 일치하지 않습니다. createAddonSession 속성 또는 exposeToMeetWhenScreenSharing() 메서드를 호출할 때 올바른 Cloud 프로젝트 번호가 문자열로 SDK에 전달되는지 확인합니다. 이 매개변수는 Meet에서 모든 iframe URL에 자동으로 추가됩니다. 전달된 값을 사용하기 전에 인프라가 URL 매개변수를 수정하지 않도록 합니다 (예: 리디렉션의 일부로).
MissingUrlParameter 필수 Meet 부가기능 SDK URL 매개변수가 누락되었습니다. 이 매개변수는 Meet에서 iframe URL에 자동으로 추가됩니다. 인프라가 URL 매개변수를 수정하지 않는지 확인합니다 (예: 리디렉션의 일부).
NeedsMainStageContext 이 메서드는 부가기능이 기본 단계에서 실행 중인 경우에만 호출할 수 있습니다. 이 메서드를 호출하기 전에 getFrameType 속성을 사용하여 부가기능이 기본 스테이지에서 실행 중인지 확인합니다.
NeedsSidePanelContext 이 메서드는 부가기능이 측면 패널에서 실행 중인 경우에만 호출할 수 있습니다. 이 메서드를 호출하기 전에 getFrameType 속성을 사용하여 부가기능이 측면 패널에서 실행 중인지 확인합니다.
NoActivityFound 작업을 실행할 때 활동이 발견되지 않았습니다. 이 작업을 실행하기 전에 활동이 시작되었는지 확인합니다.
NotSupportedInMeetCall 이 메서드는 Meet 통화에서 지원되지 않습니다. Meet 통화 중에 이 메서드를 호출하지 마세요.
NotSupportedInStandalone 이 메서드는 독립형 모드에서 지원되지 않습니다. 독립형 모드에서는 이 메서드를 호출하지 마세요.
RequiresEapEnrollment 요청된 방법에는 EAP 등록이 필요합니다. Google Meet 부가기능 사전 체험판 등록이 종료되었습니다.
SizeLimitExceededActivityStartingState ActivityStartingState URL 또는 데이터의 크기가 허용된 제한을 초과합니다. ActivityStartingState URL 크기가 512자(영문 기준) 미만이고 추가 데이터 크기가 4,096자(영문 기준) 미만인지 확인합니다.
SizeLimitExceededAddonStartingState AddonStartingState URL 또는 데이터의 크기가 허용된 제한을 초과합니다. AddonStartingState URL 크기가 512자(영문 기준) 미만이고 추가 데이터 크기가 4,096자(영문 기준) 미만인지 확인합니다.
SizeLimitExceededFrameToFrameMessage 프레임 간 메시지의 크기가 허용된 한도를 초과합니다. 프레임 간 메시지 크기가 1,000,000자(영문 기준) 미만이어야 합니다.
UserCancelled 사용자가 활동 시작을 취소했습니다. 사용자가 '계속'을 클릭해야 활동이 시작됩니다.
UserNotInitiator 사용자가 현재 활동의 시작자가 아닙니다. 사용자가 현재 활동의 시작자인지 또는 활동이 종료되었는지 확인합니다.