終止支援通知： 將於 2026 AWS 年 5 月 20 日結束對 的支援 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)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 的快速入門教學課程 SimSpace Weaver
<a name="getting-started_quickstart"></a>

本教學課程會引導您完成在 上 SimSpace Weaver 建置和執行模擬的程序。我們建議您從本教學課程開始，然後進行[詳細的教學課程](getting-started_detailed.md)。

**要求**  
開始之前，請確定您已完成 中的步驟[設定 SimSpace Weaver](setting-up.md)。

**注意**  
 此處使用的指令碼是為了方便起見，並非必要。請參閱[詳細教學](getting-started_detailed.md)課程，了解如何手動完成這些步驟。

## 步驟 1：啟用記錄 （選用）
<a name="getting-started_quickstart_enable-logging"></a>

**開啟記錄**

1. 導覽至：

   ```
   {{sdk-folder}}/Samples/PathfindingSample/tools
   ```

1. 在文字編輯器中開啟結構描述檔案：

   ```
   pathfinding-single-worker-schema.yaml
   ```

1. 尋找 檔案開頭的 `simulation_properties:`區段：

   ```
   simulation_properties:
     default_entity_index_key_type: "Vector3<f32>"
   ```

1. 在行 後面插入以下 2 行`simulation_properties:`：

   ```
     log_destination_service: "logs"
     log_destination_resource_name: "MySimulationLogs"
   ```

1. 確認您的 `simulation_properties:` 區段與下列項目相同：

   ```
   simulation_properties:
     log_destination_service: "logs"
     log_destination_resource_name: "MySimulationLogs"
     default_entity_index_key_type: "Vector3<f32>"
   ```

1. 儲存檔案並結束您的文字編輯器。

## 步驟 2：使用主控台用戶端快速入門 （選項 1)
<a name="getting-started_quickstart_console-client"></a>

 導覽至：

```
sdk-folder/Samples/PathfindingSample/tools/cloud
```

請執行下列其中一個命令：
+ Docker： `python quick-start.py --consoleclient`
+ WSL： `python quick-start.py —-consoleclient --al2`

 根據預設，這將在單一工作者上啟動具有單一分割區的模擬。其他組態可以透過`--schema {file name}.yaml`從 `/Samples/PathfindingSample/tools/` 資料夾傳遞 來啟動。

**注意**  
[詳細教學課程：了解建置範例應用程式時的詳細資訊](getting-started_detailed.md) 如需此指令碼功能的深入說明，請參閱 。

## 步驟 2：使用 Unreal Engine 用戶端快速入門 （選項 2)
<a name="getting-started_quickstart_unreal-client"></a>

請參閱 [啟動 Unreal Engine 檢視用戶端](working-with_unreal-client.md)。

## 停止並刪除模擬
<a name="getting-started_quickstart_stop"></a>

導覽至：

```
sdk-folder/Samples/PathfindingSample/tools/cloud
```

尋找模擬的名稱：

```
aws simspaceweaver list-simulations
```

停止並刪除模擬

```
python stop-and-delete.py --simulation {{simulation-name}}
```

## 故障診斷
<a name="getting-started_quickstart_troubleshooting"></a>
+  **FileNotFoundError：cmake** 

  ```
  subprocess.run('cmake')
  ...
   FileNotFoundError: The system cannot find the file specified
  ```
  +  **解決方案：**指令碼找不到命令 `cmake`。請確定您已安裝最低建議的 CMake 版本，並且可以使用 PATH 中的 `cmake`命令來呼叫。使用 命令`cmake -version`來驗證。
+  **ImportError：匯入 libweaver\_app\_sdk\_python\_v1 時 DLL 載入失敗：找不到指定的模組。 **
  +  **解決方案：**當 Python 3.9 未用於啟動 Weaver Python SDK 時，會發生此錯誤。請確保與「python」命令相關聯的 Python 版本為 Python 3.9。您可以執行 `python --version`命令來檢查 。
+  **快速入門指令碼在啟動 Docker Build 後卡在 。**
  +  **解決方法：**有時候 Docker 需要幾分鐘的時間來暖機。如果此問題持續超過 \~5 分鐘，請重新啟動 Docker 或您的系統。
+  **target\_compile\_features 沒有 CXX 編譯器 "GNU" 的已知功能：**
  +  **解決方案：**清除 Docker 快取、刪除 Weaverappbuilder Docker 映像、刪除專案建置成品，然後重新執行 `setup.py`。這應該會重設 Docker 環境並解決錯誤。