本指南介绍了如何解决您在构建和测试 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 已结束。 |