JSAPI Three API Reference
    正在准备搜索索引...

    类 MockTwin

    基于路径线数据模拟车辆孪生，在给定线段上按间隔和速度自动生成并驱动车辆沿路径移动。 内部使用 Twin 渲染车辆，通过路径插值计算每辆车的位置并定时 push 到 Twin， 适用于演示、测试或无需真实轨迹数据时的车辆流效果。

    需要通过 Engine 的 add 方法添加到场景中，再调用 start 开始模拟。

    const mockTwin = engine.add(new mapvthree.MockTwin(
        { modelConfig: { 3: mapvthree.twinConstants.REALISTIC_TEMPLATE_MODEL.CAR } },
        [[116.39, 39.9], [116.40, 39.91], [116.41, 39.92]],
        { color: { red: 0.3, blue: 0.7 }, modelType: { 3: 0.5, 6: 0.5 } }
    ));
    mockTwin.start({ speed: 60, gap: 20, initialCount: 5 });

    层级

    • Object3D
      • MockTwin
    索引

    构造函数

    constructor

    方法

    clear dispose start visibleCallback

    访问器

    data gap probabilityConfig speed

    构造函数

    • 构造函数，用于创建 MockTwin

      参数

      • 可选twinConfig: any = {}

        孪生配置，与 Twin 的 options 一致，如 modelConfig、delay 等

      • 可选data: any

        路径数据：GeoJSON 线或 [[lng, lat], ...] 点数组

      • 可选probabilityConfig: any = {}

        概率配置，用于随机颜色和模型类型

      返回 MockTwin

    方法

    • 停止模拟并清空所有车辆，清除定时器，内部 Twin 状态重置

      返回 void

    • 销毁实例：先 clear 再释放内部 Twin 并移出场景

      返回 void

    • 开始沿路径模拟车辆：按间隔在路径上生成车辆，并按速度沿路径移动并推送给内部 Twin

      参数

      • 可选options: { gap?: number; initialCount?: number; speed?: number } = {}

        启动选项

        • 可选gap?: number

          路径上相邻车辆间距（米），不传则使用默认间距10米

        • 可选initialCount?: number

          启动时在路径上预先放置的车辆数量

        • 可选speed?: number

          车辆速度（km/h），不传则使用默认速度80km/h

      返回 void

    • 用于每帧决定内部 Twin 是否可见，可被子类覆盖；默认返回当前 Twin 的 visible

      返回 boolean

      是否显示车辆孪生

    访问器

    • get data(): any

      路径数据：GeoJSON 线或 [[lng, lat], ...] 点数组

      返回 any

    • set data(value: any): void

      参数

      • value: any

      返回 void

    • get gap(): number

      路径上相邻车辆间距，单位米

      返回 number

    • set gap(value: number): void

      参数

      • value: number

      返回 void

    • get probabilityConfig(): any

      随机概率配置，用于 start 时随机颜色和模型类型。格式如 { color: { red: 0.3 }, modelType: { 3: 0.5, 6: 0.5 } }

      返回 any

    • set probabilityConfig(value: any): void

      参数

      • value: any

      返回 void

    • get speed(): number

      车辆沿路径移动速度，单位 km/h

      返回 number

    • set speed(value: number): void

      参数

      • value: number

      返回 void

    显示设置

    成员可见性

    目录

    构造函数
    方法
    访问器