本指南介绍了如何解决您在构建和测试 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 传入的编号不匹配。 | 调用 createAddonSession 属性或 exposeToMeetWhenScreenSharing() 方法时，请确保将正确的 Cloud 项目编号作为字符串传递给 SDK。Meet 会自动将此参数附加到任何 iframe 网址。在使用传递的值之前，请确保您的基础架构不会修改网址参数（例如，在重定向过程中）。 |
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。 | 用户需要点击“继续”才能启动 activity。 |
UserNotInitiator |
用户不是当前 activity 的发起者。 | 确保用户是当前 activity 的发起者，或者 activity 已结束。 |