이 가이드에서는 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() 메서드를 호출할 때 올바른 클라우드 프로젝트 번호가 문자열로 SDK에 전달되는지 확인합니다. 이 매개변수는 Meet에서 모든 iframe URL에 자동으로 추가됩니다. 전달된 값을 사용하기 전에 인프라에서 URL 매개변수를 수정하지 않는지 확인하세요 (예: 리디렉션의 일부로). |
MeetingPolicyPreventsStartingActivity |
회의 정책 (예: 호스트 제어 설정 사용)으로 인해 사용자가 활동을 시작할 수 없습니다. | 회의 호스트 또는 관리자가 현재 사용자가 활동을 시작할 수 있도록 필요한 설정을 수정합니다. |
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 |
사용자가 현재 활동의 시작자가 아닙니다. | 사용자가 현재 활동의 시작자이거나 활동이 종료되었는지 확인합니다. |