本指南提供了相关说明，可帮助您解决在构建和测试 Meet 加载项时可能遇到的特定 Google Meet 加载项 SDK 错误。
如需获取有关错误的详细信息，请使用 MeetAddonError 对象。它包含一个 errorType 属性，用于指定错误类型。
错误类型
以下是 Meet 插件 SDK 抛出错误时生成的错误类型，以及有关如何解读这些错误的说明和有关遇到这些错误时应采取的措施的指南。
| 错误 | 错误消息 | 操作 |
|---|---|---|
ActivityIsOngoing |
在 activity 正在进行时，无法执行操作。 | 确保没有正在进行的活动。 |
ActivityStartingStateEmpty |
activity 的初始状态为空。 | 系统提供了 ActivityStartingState 对象，但该对象不包含任何属性。 |
ActivityStartingStateMissingAttributes |
activity 启动状态不包含任何可识别的属性。 | 确保 ActivityStartingState 对象包含以下属性之一：mainStageUrl、sidePanelUrl 或 additionalData。 |
ActivityStartingStateUnrecognizedAttributes |
启动 activity 的状态包含无法识别的属性。 | 确保 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 网址与插件清单中提供的网址来源不一致。 |
确保 ActivityStartingState iframe 网址来源与插件清单中提供的网址来源一致。如需了解详情，请参阅附加安全功能。 |
InvalidAddonStartingState |
AddonStartingState iframe 网址与插件清单中提供的网址来源不一致。 |
确保 AddonStartingState iframe 网址来源与插件清单中提供的网址来源一致。 |
InvalidCloudProjectNumber |
Meet 提供的 Cloud 项目编号与 Meet 插件 SDK 中传入的 Cloud 项目编号不一致。 | 确保在调用 createAddonSession 属性或 exposeToMeetWhenScreenSharing() 方法时，将正确的 Cloud 项目编号作为字符串传递到 SDK 中。此参数由 Meet 自动附加到任何 iframe 网址。请确保您的基础架构在使用传递的值之前不会修改网址参数（例如，作为重定向的一部分）。 |
MeetingPolicyPreventsStartingActivity |
会议政策（例如使用主持人控制设置）禁止用户开始活动。 | 让会议主持人或管理员修改必要的设置，以允许当前用户开始活动。 |
MissingUrlParameter |
缺少必需的 Meet 插件 SDK 网址参数。 | 此参数由 Meet 自动附加到 iframe 网址。确保您的基础架构不会修改网址参数（例如，在重定向过程中）。 |
NeedsMainStageContext |
只有当插件在主舞台中运行时，才能调用此方法。 | 在调用此方法之前，请使用 getFrameType 属性检查插件是否在主阶段运行。 |
NeedsSidePanelContext |
只有当插件在侧边栏中运行时，才能调用此方法。 | 在调用此方法之前，请使用 getFrameType 属性检查插件是否在侧边栏中运行。 |
NoActivityFound |
执行操作时未找到任何活动。 | 请确保在执行此操作之前已启动相应 activity。 |
NotSupportedInMeetCall |
Meet 通话不支持此方法。 | 请勿在 Meet 通话期间调用此方法。 |
NotSupportedInStandalone |
独立模式不支持此方法。 | 请勿在独立模式下调用此方法。 |
RequiresEapEnrollment |
所请求的方法需要加入 EAP。 | Google Meet 加购项抢先体验计划已结束。 |
SizeLimitExceededActivityStartingState |
ActivityStartingState 网址和/或其数据的大小超出了允许的限制。 |
确保 ActivityStartingState 网址的大小不超过 512 个字符，并且附加数据的大小不超过 4,096 个字符。 |
SizeLimitExceededAddonStartingState |
AddonStartingState 网址和/或其数据的大小超出了允许的限制。 |
确保 AddonStartingState 网址的大小不超过 512 个字符，而附加数据的大小不超过 4,096 个字符。 |
SizeLimitExceededFrameToFrameMessage |
帧间消息的大小超出了允许的限制。 | 确保帧间消息大小小于 1,000,000 个字符。 |
UserCancelled |
用户取消了启动 activity。 | 用户需要点击“继续”才能开始活动。 |
UserNotInitiator |
用户不是当前活动的发起者。 | 确保用户是当前 activity 的发起者，或者该 activity 已结束。 |