终止支持通知:2026 年 5 月 20 日, AWS 将终止对的支持。 AWS SimSpace Weaver 2026 年 5 月 20 日之后,您将无法再访问 SimSpace Weaver 控制台或 SimSpace Weaver 资源。有关更多信息,请参阅AWS SimSpace Weaver 终止支持。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
消息错误和疑难解答
使用消息时,您可能会遇到以下错误 APIs。
端点解析错误
这些错误可能发生在应用程序发送消息之前。
域名检查
向无效端点发送消息会导致以下错误:
ManifoldError::InvalidArgument {"No DomainId found for the given domain name" }
当您尝试向定制化 App 发送消息,但该定制化 App 尚未加入模拟时,就会发生这种情况。使用该 DescribeSimulation
API 确保您的定制化应用程序已启动,然后再向其发送消息。这种行为在中是一样的 SimSpace Weaver Local 还有 AWS 云。
位置检查
尝试解析具有有效域名但位置无效的端点会导致以下错误。
ManifoldError::InvalidArgument {"Could not resolve endpoint from domain : DomainId { value:domain-id
} and position: Vector2F32 { x:x-position
, y:y-position
}" }
我们建议使用 SimSpace Weaver 应用程序 SDK 中包含的MessageUtils
库中的。MessageEndpointResolver
消息发送错误
应用程序发送消息时可能会出现以下错误。
已超过每个应用程序、每次点击的消息发送限制
目前,每个应用程序每次仿真跳动可以发送的消息数量限制为 128。同一报价的后续调用将失败,并出现以下错误:
ManifoldError::CapacityExceeded {"At Max Outgoing Message capacity: {}", 128}
SimSpace Weaver 尝试在下次勾选时发送未发送的消息。降低发送频率以解决此问题。合并小于 256 字节限制的消息负载,以减少出站消息的数量。
这种行为在中是一样的 SimSpace Weaver Local 然后在 AWS 云.
已超出消息有效负载大小限制
消息有效载荷大小的当前限制均为 256 字节 SimSpace Weaver Local 然后在 AWS 云. 发送有效载荷大于 256 字节的消息会导致以下错误:
ManifoldError::CapacityExceeded {"Message data too large! Max size: {}", 256}
SimSpace Weaver 会检查每条消息,只拒绝超过限制的消息。例如,如果您的应用程序尝试发送 10 条消息,但有 1 条未通过检查,则只有这 1 条消息被拒绝。 SimSpace Weaver 发送其他 9 条消息。
这种行为在中是一样的 SimSpace Weaver Local 还有 AWS 云。
目的地与源相同
应用程序无法向其拥有的分区发送消息。如果应用程序向其拥有的分区发送消息,则会出现以下错误。
ManifoldError::InvalidArgument { "Destination is the same as source" }
这种行为在中是一样的 SimSpace Weaver Local 还有 AWS 云。
尽力发送消息
SimSpace Weaver 不能保证消息的传送。该服务将尝试在随后的模拟滴答中完成消息的传送,但消息可能会丢失或延迟。