Files
dreamfly/地景与廊桥/SAM FollowMe 安装与排错(分步指南).md
T

141 lines
7.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# SAM FollowMe 安装 + 排错(分步指南)
> 适用:**X-Plane 11**(SAM 不支持 XP12;XP12 用免费开源的 openSAM,见文末)。
> 本文把「怎么装 SAM Suite → 怎么装/激活 FollowMe → 怎么用 → 出错怎么查」拆成一步步操作,照着做即可。
---
## 0. 先搞清楚概念(1 分钟)
**FollowMe(引导车)不是单独一个插件**,它是 **SAM 套件**里的一个模块。要让它跑起来,必须**三样齐全**,缺哪个都会出现「菜单能点、但没车」:
| 组件 | 作用 | 是否必须 |
|---|---|---|
| **SAM Base Plugin**(本体) | SAM 主程序(3.1.8+,最新 3.1.10) | ✅ 必须 |
| **SAM_Library** | 地景库(放 `Custom Scenery/`) | ✅ 必须 |
| **AirportVehicles** | **引导车模型的来源** | ✅ 必须(**不装就没车**) |
| **FollowMe** | 引导车功能本身(约 1.0.4) | ✅ 必须 |
| WorldJetways | 默认机场动态廊桥 | 选装(付费) |
| GroundService | 地勤车辆 | 选装 |
> SAM 全家桶由 **Stairport** 出品,**Aerosoft 是发行/分发方**。所以「用 Aerosoft 装」= 用 **Aerosoft One** 客户端装,或从 Aerosoft 商店买 Key。
---
## 一、准备
1. 确认是 **X-Plane 11**(XP12 请直接跳到文末用 openSAM)。
2. **Windows 先装 VC++ 2015–2022 x64 运行库**——很多「闪退 / 黑窗口」就是缺它。
下载:微软官网搜 “Visual C++ Redistributable 2015-2022 x64”。
3. 全程**必须联网**(SAM 要在线拉组件、校验授权)。
4. 关掉杀软对 X-Plane 目录的实时扫描(避免安装被拦截)。
---
## 二、方式 A:用 **Aerosoft One** 安装 SAM Suite(推荐,最省事)
> 适用:你在 Aerosoft 商店买过 SAM / 有 Aerosoft 账号。
1. **下载安装 Aerosoft One 客户端**
- 地址:<https://one.aerosoft.com/>(或 <https://www.aerosoft.com/en/one>)
- 装好后**登录你的 Aerosoft 账号**。
2. **设置 X-Plane 路径**
- 进 `Settings(设置)→ Simulator Paths(模拟器路径)`,指向含 **`X-Plane.exe`** 的那层目录(不是子文件夹)。
3. **找到 SAM**
- 进 `Library(库)→ X-Plane → Available / Dependencies → Optional`。
- 搜索 **SAM / SAM Suite / SAM3**。
4. **点 Install 安装**
- 选择安装方式:
- **One Library Install**:文件另存,用符号链接挂进 XP,便于启用/停用;
- **Direct Install**:直接装进 X-Plane 目录(**新手选这个**,最直观)。
- 把要装的组件逐个点 **Download/Install**:
`SAM Base Plugin` → `SAM_Library` → `FollowMe` → `AirportVehicles`(→ 需要的话再装 WorldJetways / GroundService)。
5. **如果是外站购买的(非 Aerosoft 商店)**
- 先在 Aerosoft One 里用 **“Activating an external product(激活外部产品)”** 注册你的产品 Key,再回到第 3~4 步安装。
6. **激活**
- 通过 Aerosoft 商店购买的,通常**自动激活**(授权绑定账号);
- 若提示要 Key:游戏内进 `Plugins → SAM → Content Manager → 输入序列号 → Activate`。
---
## 三、方式 B:用 **SAM Suite 独立安装器**(没走 Aerosoft One 时)
1. 下载 **SAM Suite**(那个独立的安装器程序,**不是**插件本体):
- Stairport 官网 / x-plane.org 文件页 / Aerosoft 商店均有;官方入口可查 <https://stairport-sceneries.com/>。
2. 打开 SAM Suite,把 **X-Plane 主目录路径**指对,联网后它会**自动列出可装组件**。
3. 逐一点击下载安装(同方式 A 第 4 步):
`SAM Base Plugin` → `SAM_Library` → `FollowMe` → `AirportVehicles`。
4. 买了 WorldJetways 的,在 SAM Suite 里**输入序列号激活**。
---
## 四、装完检查目录结构(关键,别多套一层)
| 组件 | 正确位置 |
|---|---|
| SAM 本体 | `X-Plane 11/Resources/plugins/SAM/` |
| SAM 地景库 | `X-Plane 11/Custom Scenery/SAM_Library/` |
| DLC/模块 | `X-Plane 11/Resources/plugins/SAM/lib/` |
- ⚠️ 常见错误:变成 `SAM/SAM/…`(多套一层),插件就加载不了。
- **`scenery_packs.ini` 里 `SAM_Library` 要排在依赖它的机场地景之上**(顺序:自定义机场 → SAM_Library → `*GLOBAL_AIRPORTS*`)。
---
## 五、验证 + 激活
1. 启动 X-Plane 11 → 顶部菜单 `Plugins` 里能看到 **SAM** = 插件加载成功。
2. 进 `Plugins → SAM → Version & License` 检查版本、做一次激活(**FollowMe 有时要单独激活一次**)。
3. 进 `Plugins → SAM → Content Manager`,把上面几个组件**再确认下载/更新到最新**。
---
## 六、使用:叫引导车
1. 载入飞机,停在机场。
2. 进 `Plugins → SAM → FollowMe`(或在 `Settings → Keyboard` 里搜 `SAM` 绑定一个快捷键/摇杆键)。
3. 选 **“进场带路”**(从跑道带到停机位)或 **“去停机位/去跑道”**。
4. 黄色引导车就会开过来带你。
---
## 七、排错(按症状查)
| 症状 | 原因 / 解决 |
|---|---|
| **菜单能点,但没车**(最常见,报 `Failed Starting FollowMe Guidance, Vehicle Instance Error`) | 十有八九是 **AirportVehicles 没下全**:回 `SAM → Content Manager` 补下,并把 SAM 本体更新到最新 |
| 插件菜单是**空白窗口** | 删掉 `X-Plane 11/Output/preferences/SAM/`,重启 XP11 重来 |
| 进游戏**直接闪退** | 先删掉 `Resources/plugins/SAM` 文件夹,启动一次 XP,再用最新版重装 |
| **只有某些机场不行** | 机场地景不兼容 SAM。先在**默认机场**(如 KSEA)测:默认能用 = 是那个地景的问题,不是插件问题 |
| **地景库冲突** | `scenery_packs.ini` 里 `SAM_Library` 要排在相关地景**上面** |
| 找不到 SAM 菜单 | 确认装在 `Resources/plugins/SAM`,且没多套一层;插件管理里已启用 |
| 日志定位 | XP 主日志 `X-Plane 11/Log.txt` 搜 `SAM`;SAM 专用日志 `X-Plane 11/Output/SAM/log.txt` |
---
## 八、和你之前那个报错的关系(重要)
你之前在 **JARDesign FollowMe Car** 里遇到的 **“custom scenery error detected”**,本质是插件**读机场地景数据**时失败(去 `Custom Scenery` 找对应包 → 解析 `Earth nav data/apt.dat`)。
**SAM FollowMe 同样依赖机场的滑行道/停机位数据**。所以:
- 换成 SAM 后,如果**在同一个机场**还是带不了路 → 大概率是**那个地景包本身要修**,跟换不换插件无关;
- 该地景包的正确结构应是 `Custom Scenery/包名/Earth nav data/apt.dat`(别多套一层),且不要与默认 Gateway 机场 ICAO 重复。
---
## 附:XP12 用户 → openSAM
SAM **不支持 X-Plane 12**。XP12 请用免费开源的 **openSAM**:
- 项目地址:<https://github.com/hotbso/openSAM>
- 装法:把插件放进 `X-Plane 12/Resources/plugins/`,重启即可(不再需要 SAM Suite)。
---
## 资源
- Aerosoft One 客户端:<https://one.aerosoft.com/>
- Aerosoft One 用户指南:<https://cdnone.aerosoft.com/client/user-guide/en/>
- Stairport 官网 / 支持中心:<https://stairport-sceneries.com/>
- x-plane.org SAM 文件页:<https://forums.x-plane.org/files/file/59782-scenery-animation-manager-suite/>
- openSAM(XP12 免费替代):<https://github.com/hotbso/openSAM>