星火 2.0 开发文档

主题

GameCore.VisionSystem ​

SceneVisionConfig 双端 ​

命名空间 GameCore.VisionSystem.Data

csharp
public sealed class SceneVisionConfig

场景级视野配置。该配置按 GameDataScene 生效，与 SpaceModel 同级。

构造函数 ​

SceneVisionConfig 双端 ​

csharp
public SceneVisionConfig()

属性 ​

Mode 双端 ​

csharp
public SceneVisionMode Mode { get; set; }

场景视野模式。

ObserverPolicy 双端 ​

csharp
public VisionObserverPolicy ObserverPolicy { get; set; }

精确视野模式下的观察者选择策略。

UseMainUnitAsLocalVisionFocus 双端 ​

csharp
public bool UseMainUnitAsLocalVisionFocus { get; set; }

精确视野模式下，客户端是否自动将本地玩家主控单位作为本地视野遮罩的渲染焦点。 开启后，客户端会随本地玩家主控单位变化更新 Player.LocalVisionFocus； 如果游戏模式没有配置全局自定义渲染管线，还会自动为主视口应用支持视野遮罩的渲染管线。

SceneVisionMode 双端 ​

命名空间 GameCore.VisionSystem.Data

csharp
public enum SceneVisionMode

场景视野模式。

枚举值 ​

  • Normal — 正常视野：按单位视野范围、阵营和地图视野规则计算可见性。
  • Open — 视野全开：所有单位默认互相可见，不按视野距离和阻挡限制。
  • Precise — 启用精确视野：单位之间按距离、视野阻挡和可选扇形角度判定可见性。

UnitVisionConfig 双端 ​

命名空间 GameCore.VisionSystem.Data

csharp
public sealed class UnitVisionConfig

单位默认视野能力配置。该配置是可选的；没有配置时不会自动创建 UnitVision。 该配置目前只影响 Precise 场景视野模式下的观察者选择和形状判定； 客户端本地视野遮罩在设置了本地焦点时也会复用同一份形状参数。 视野距离不在本结构中配置，请在 GameDataUnit 的默认属性里配置 ScopeData.UnitProperty.Sight。

构造函数 ​

UnitVisionConfig 双端 ​

csharp
public UnitVisionConfig()

属性 ​

ObserverEnabled 双端 ​

csharp
public bool ObserverEnabled { get; set; }

在 Explicit 场景策略下，该单位是否默认作为观察者参与精确视野计算。

Shape 双端 ​

csharp
public UnitVisionShape Shape { get; set; }

单位视野形状。默认圆形。

CentralAngle 双端 ​

csharp
public float CentralAngle { get; set; }

扇形中心角，单位为度。小于 360 时才会在精确视野判定中增加扇形角度过滤。

InnerRadius 双端 ​

csharp
public float InnerRadius { get; set; }

扇形内半径，单位为世界距离。目标落在内半径内时不受角度过滤。 该值不是视野距离；视野距离请在 GameDataUnit 的默认属性里配置 ScopeData.UnitProperty.Sight。

DirectionSource 双端 ​

csharp
public UnitVisionDirectionSource DirectionSource { get; set; }

扇形方向来源。

FixedDirection 双端 ​

csharp
public float FixedDirection { get; set; }

当 DirectionSource 为 Fixed 时使用的世界角度，单位为度。

UnitVisionDirectionSource 双端 ​

命名空间 GameCore.VisionSystem.Data

csharp
public enum UnitVisionDirectionSource

扇形视野方向来源。

枚举值 ​

  • Facing — 使用单位当前朝向。
  • Fixed — 使用配置中的固定世界角度。

UnitVisionShape 双端 ​

命名空间 GameCore.VisionSystem.Data

csharp
public enum UnitVisionShape

单位观察形状。该形状目前用于 Precise 场景视野模式下的可见性判定； 客户端本地视野遮罩在设置了本地焦点时也会复用该形状参数。

枚举值 ​

  • Circle — 圆形视野。半径来自 。
  • Cone — 扇形视野。半径仍来自 ，额外应用角度过滤。

VisionObserverPolicy 双端 ​

命名空间 GameCore.VisionSystem.Data

csharp
public enum VisionObserverPolicy

精确视野下哪些单位参与观察者计算。

枚举值 ​

  • AllOwnedUnits — 所有拥有普通视野能力的己方单位都参与计算。
  • Explicit — 只有显式启用 的单位参与计算。
  • MainControlledUnit — 只有玩家的主控单位参与计算。