이 가이드에서는 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 |
사용자가 현재 활동의 시작자가 아닙니다. | 사용자가 현재 활동의 시작자인지 또는 활동이 종료되었는지 확인합니다. |