

终止支持通知：2026 年 5 月 20 日， AWS 将终止对的支持。 AWS SimSpace Weaver 2026 年 5 月 20 日之后，您将无法再访问 SimSpace Weaver 控制台或 SimSpace Weaver 资源。有关更多信息，请参阅[AWS SimSpace Weaver 终止支持](https://docs.aws.amazon.com/simspaceweaver/latest/userguide/simspaceweaver-end-of-support.html)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 将实体转移到空间域
<a name="working-with_app-sdk_ent_transfer"></a>

自定义应用程序或服务应用程序创建实体后，必须将实体转移到空间域中，实体才能在模拟中以空间形式存在。空间域中的实体可以由其他应用程序读取，并且可以由空间应用程序更新。使用 `ModifyEntityDomain()` API 可将实体转移到空间域中。

```
AWS_WEAVERRUNTIME_API Result<void> ModifyEntityDomain(Transaction& txn, const Entity& entity, DomainId domainId) noexcept;
```

如果 `DomainId` 与调用的应用程序分配的 `Partition` 不匹配，则 `DomainId` 必须为 `DomainType::Spatial` `Domain`。在 `Commit(Transaction&&)` 过程中，所有权会转移到新的 `Domain`。参数

`txn`  
当前 `Transaction`。

`entity`  
更改 `Entity` 的目标 `Domain`。

`domainId`  
`Entity` 的目标 `Domain` 的 `DomainId`。

如果已成功更改实体域，此 API 会返回 `Success`。