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

    类 ObjectTracker

    对象追踪器，用于追踪指定的3D对象或坐标点

    ObjectTracker可以追踪各种Three.js Object3D 对象

    // 基本用法 - 追踪3D模型
    const model = engine.add(new mapvthree.SimpleModel({
        url: 'path/to/model.glb'
    }));

    const tracker = engine.add(new mapvthree.ObjectTracker());
    tracker.track(model, {
        range: 100,
        pitch: 60,
    });

    层级

    • TrackerAbstract
      • ObjectTracker
    索引

    属性

    DEFAULT_INSIDE_MASK onFinish onStart onUpdate

    方法

    onTrackFrame pause stop track

    访问器

    currentState isPaused isRunning

    属性

    DEFAULT_INSIDE_MASK: string = 'assets/images/carInside.png'

    车内视角默认遮罩 PNG 路径，外部可覆盖

    onFinish: any = null
    onStart: any = null
    onUpdate: any = null

    方法

    • 追踪帧回调函数, 在每帧更新时调用

      返回 void

      tracker.onTrackFrame = (lastState, currentState) => {
          console.log('追踪状态更新:', currentState);
          // 自定义逻辑
      };

    • 暂停动画

      返回 any

      当前状态

    • 停止追踪，重置状态

      返回 void

    • 开始追踪指定对象

      参数

      • object: Object3D<Object3DEventMap>

        追踪的对象

        • Object3D: Three.js 3D对象
      • config: {
            duration?: number;
            extraDir?: number;
            heading?: number;
            height?: number;
            inside?: boolean;
            insideMask?: string;
            pitch?: number;
            range?: number;
        } = {}

        追踪配置

        • 可选duration?: number

          持续时间（0表示持续追踪）

        • 可选extraDir?: number

          额外方向修正角度

        • 可选heading?: number

          方位角

        • 可选height?: number

          高度偏移

        • 可选inside?: boolean

          进入车内视角；inside 模式下 radius / range / pitch / heading 被忽略，只有 height 生效（驾驶位高度）

        • 可选insideMask?: string

          车内遮罩 PNG 的 URL，不传则使用默认图

        • 可选pitch?: number

          俯仰角

        • 可选range?: number

          追踪距离

      返回 void

      // 追踪3D模型，设置相机距离和角度
      tracker.track(model, {
          range: 100,    // 距离100米
          pitch: 60,     // 俯仰角60
          heading: 45,   // 方位角45
      });

    访问器

    • get currentState(): any

      获取当前状态

      返回 any

    • get isPaused(): boolean

      获取是否暂停

      返回 boolean

    • get isRunning(): boolean

      获取是否正在运行

      返回 boolean

    显示设置

    成员可见性

    目录

    属性
    方法
    访问器