“水位线”是3d流式加载中动态的时空加载承诺点，代表系统可信的安全加载边界；它通过响应式访问器实时计算距离、时间与优先级，并驱动瓦片加载、卸载及lod切换，实现按需调度。
“水位线”在3D渲染场景的流式按需加载中，并非指真实水文中的水位，而是类比Flink中“水位线（Watermark）”概念所引申出的一种资源调度时序控制机制——它代表“当前加载进度可信的边界”，即：系统已确认可安全加载、渲染且不会因视角突变而失效的最远空间/时间范围。这个“水位线”是动态推进的，驱动加载、卸载、LOD切换等行为，本质是空间-时间双维度的加载承诺点。
要通过访问器属性（Accessor Properties）实现这一机制，关键在于将“水位线”抽象为可响应式读写、带计算逻辑的属性，而非静态值。以下是具体实现路径：
一、定义水位线访问器：封装动态边界逻辑
在场景管理器类（如 SceneLoader 或 CesiumPipelineVisualizer）中，用 get / set 定义 waterline 访问器：
class SceneLoader {
constructor(viewer) {
this._waterline = { distance: 300, timestamp: Date.now() };
this.viewer = viewer;
}
get waterline() {
// 实时计算：基于当前视角、速度、设备性能动态修正
const camera = this.viewer.camera;
const speed = this._estimateCameraSpeed();
const baseRadius = 300 + speed * 20; // 飞行越快，水位线越远
const memLimit = this._getMemoryPressure() > 0.7 ? 0.8 : 1.0;
return {
distance: Math.max(200, Math.min(1000, baseRadius * memLimit)),
timestamp: Date.now(),
priorityThreshold: this._computePriorityCutoff()
};
}
set waterline(value) {
// 触发重调度：仅当新水位显著推进（>50m）或超时（>2s）才真正提交
const deltaDist = Math.abs(value.distance - this._waterline.distance);
const deltaT = Date.now() - this._waterline.timestamp;
if (deltaDist > 50 || deltaT > 2000) {
this._scheduleLoadAround(this.viewer.camera.position, value.distance);
this._waterline = { ...value, timestamp: Date.now() };
}
}
}
✅ 作用：waterline 不再是固定数字，而是实时反映“此刻系统敢承诺加载到哪”的综合判断，访问即计算，赋值即触发调度。
二、水位线驱动按需加载：与空间瓦片索引联动
将水位线距离映射到空间分区（如四叉树/瓦片网格），只加载水位线内高权重瓦片：
// 假设已有瓦片索引 tree（Cesium.QuadtreePrimitive 或自定义）
loadByWaterline() {
const wl = this.waterline;
const frustum = this.viewer.camera.frustum;
// 查询：水位线距离内的瓦片，且在视锥内
const candidates = this.tileTree.queryInRadius(
this.viewer.camera.positionWC,
wl.distance
).filter(tile =>
frustum.intersectSphere(tile.boundingSphere) !== Cesium.Intersect.OUTSIDE
);
// 按权重公式排序：W = ωd·Wd + ωv·Wv + ωp·Wp
candidates.sort((a, b) => b.weight - a.weight);
// 优先加载前N个（受带宽与帧率限制）
const budget = this._getLoadingBudget(); // 如每帧最多加载2个瓦片
candidates.slice(0, budget).forEach(tile => this._loadTile(tile));
}
⚠️ 注意：weight 字段需在瓦片元数据中预置或运行时计算，直接关联水位线——距离越近、视角越正、区域越核心，权重越高。
三、水位线协同卸载：定义“过期”阈值
卸载不等于“超出水位线就删”，而是结合闲置时间与内存压力，用 waterline 作为卸载触发的参考锚点：
checkUnloading() {
const wl = this.waterline;
const now = Date.now();
this.loadedTiles.forEach(tile => {
const distToCam = tile.position.distanceTo(this.viewer.camera.positionWC);
const idleTime = now - tile.lastUsed;
// 卸载条件：① 距离 > 水位线×1.5；② 闲置 > 基础阈值 × 内存系数
const unloadDist = wl.distance * 1.5;
const unloadTime = 30000 + (this._getMemoryPressure() * 20000);
if (distToCam > unloadDist && idleTime > unloadTime) {
this._unloadTile(tile);
tile.lastUsed = 0;
}
});
}
这样，“水位线”既是加载的前沿，也是卸载的后界参考，形成闭环调度节奏。
四、可视化调试水位线（可选但强烈推荐）
为验证水位线行为是否合理，可在Cesium中临时绘制一个半透明球面，半径 = waterline.distance：
showWaterlineSphere() {
const wl = this.waterline;
const sphere = new Cesium.Entity({
name: 'waterline-boundary',
position: this.viewer.camera.position,
ellipsoid: {
radii: new Cesium.Cartesian3(wl.distance, wl.distance, wl.distance),
material: Cesium.Color.CYAN.withAlpha(0.1)
}
});
this.viewer.entities.add(sphere);
}
运行时开启此球面，可直观观察：飞行时球面扩大、步行时收缩、内存紧张时自动压缩——说明水位线逻辑已生效。
水位线不是魔法数字，而是把“用户在哪、看什么、设备如何、网络怎样”这些现实约束，翻译成渲染引擎能理解的、可编程的加载边界。用访问器属性承载它，让每一次读取都反映最新状态，每一次赋值都触发精准动作，这才是流式加载真正“按需”的底层支撑。
