3D地图 JSAPI 类参考
    正在准备搜索索引...

    无人机对象,提供米制沿线飞行、暂停恢复、第一/第三人称跟随和机载相机视域。 支持 WGS84 椭球高与线性/向心样条航线;航线显示可独立使用 Polyline。

    const uav = engine.add(new mapvthree.UAV({
    url: '/models/uav.glb',
    path: [[113.35, 23.12, 50], [113.36, 23.13, 60]],
    speed: 15,
    }));
    await uav.ready;
    uav.start();
    uav.follow({range: 100, pitch: 60});

    层级

    • EngineObject3D
      • UAV
    索引

    构造函数

    • 参数

      • options: {
            businessId?: string;
            coordType?: "WGS84";
            curve?: "linear" | "centripetal";
            loop?: "pingpong" | "once" | "repeat" | "destroy";
            modelRotation?: number[];
            name?: string;
            object?: Object3D;
            path?: number[][];
            point?: number[];
            rotation?: number[];
            scale?: number | number[];
            speed?: number;
            turnDuration?: number;
            url?: string;
        } = {}

        配置。

        • 可选businessId?: string

          业务标识。

        • 可选coordType?: "WGS84"

          首版仅支持 WGS84。

        • 可选curve?: "linear" | "centripetal"

          航线插值类型。

        • 可选loop?: "pingpong" | "once" | "repeat" | "destroy"

          循环方式,destroy 单程完成后释放对象。

        • 可选modelRotation?: number[]

          模型自身轴向修正,弧度。

        • 可选name?: string

          显示名称。

        • 可选object?: Object3D

          借用模型,内部克隆,不移除原对象。

        • 可选path?: number[][]

          经纬高航点,至少两个不同点。

        • 可选point?: number[]

          初始经纬高,默认航线首点。

        • 可选rotation?: number[]

          地理姿态,弧度。

        • 可选scale?: number | number[]

          模型缩放。

        • 可选speed?: number

          米/秒。

        • 可选turnDuration?: number

          端点调头时长,毫秒。

        • 可选url?: string

          GLB/GLTF 地址,与 object 二选一。

      返回 UAV

    属性

    ready: Promise<any>

    初始模型已挂载且姿态可用时完成;销毁或加载失败会拒绝,移出引擎不影响。

    方法

    • 关闭并释放本机视域,保留飞行与主相机状态;重复关闭安全。

      返回 UAV

      当前对象。

    • 解除挂载并释放自有资源;多次调用安全。

      返回 void

    • 开启机载相机视域;重复调用只更新现有分析,不影响飞行或主相机跟随。

      参数

      • 可选options: {
            distance?: number;
            fov?: number;
            heading?: number;
            offset?: number[];
            opacity?: number;
            pitch?: number;
        } = {}

        相机及显示参数。

        • 可选distance?: number

          分析距离,沿用 ViewShedAnalysis 的地图距离语义。

        • 可选fov?: number

          视场角,度,范围 (0,180),视锥宽高比为 1。

        • 可选heading?: number

          相对机头的水平偏角,度,向右为正。

        • 可选offset?: number[]

          机身坐标系的安装偏移,不随模型缩放。

        • 可选opacity?: number

          染色不透明度,范围 [0,1]。

        • 可选pitch?: number

          相对机身的俯仰角,度,范围 [0,180];0 朝下、90 平视、180 朝上。

      返回 UAV

      当前对象。

    • 第一/第三人称跟随;切换不改变飞行进度,并记住各模式的参数。

      参数

      • 可选options: {
            heading?: number;
            mode?: "firstPerson" | "thirdPerson";
            offset?: number[];
            pitch?: number;
            range?: number;
            transitionDuration?: number;
        } = {}

        跟随参数。

        • 可选heading?: number

          相对机头的逆时针偏角,度。

        • 可选mode?: "firstPerson" | "thirdPerson"

          观察模式。

        • 可选offset?: number[]

          第一人称机身偏移,米,+X 前/+Y 左/+Z 上。

        • 可选pitch?: number

          第三人称俯仰角,0~89 度,0 为俯视。

        • 可选range?: number

          第三人称物理斜距,米,正有限数。

        • 可选transitionDuration?: number

          从当前相机姿态过渡的毫秒数,非负。

      返回 UAV

      当前对象。

    • 返回实际运动采样折线的副本,可直接交给 Polyline 显示。

      返回 any[][]

    • 暂停位移、调头和模型动画。

      返回 UAV

    • 从暂停阶段继续。

      返回 UAV

    • 替换路线,成功后停止原飞行,当前位置保留。

      参数

      • path: number[][]

        经纬高数组。

      • 可选options: any = {}

        取消信号与曲线类型。

      返回 Promise<UAV>

      路线提交完成。

    • 设置正有限米/秒速度,不用 0 表示暂停。

      参数

      • speed: any

      返回 UAV

    • 手动设置 point、rotation、scale;活动飞行时不允许抢写位置和姿态。

      参数

      • transform: {} = {}

      返回 UAV

    • 部分更新已开启的视域参数;非法参数保留原显示,未开启时拒绝。

      参数

      • 可选options: any = {}

        与 enableViewShed 相同的参数,可只提供需要改变的字段。

      返回 UAV

      当前对象。

    • 从航线起点开始新一轮飞行,可覆盖 speed、loop、turnDuration。

      参数

      • options: {} = {}

      返回 UAV

    • 停止飞行并退出本对象跟随;reset=true 时回到起点。

      参数

      • __namedParameters: { reset?: boolean } = {}

      返回 UAV

    • 只解除本对象的相机跟随,不停止飞行。

      返回 UAV

    • 动态更新航线;可衔接时保留进度,否则从新起点继续,暂停/停止和跟随保持。

      参数

      • path: number[][]

        更新后的完整经纬高航线,不是新增点的增量。

      • 可选options: {
            continueTolerance?: number;
            curve?: "linear" | "centripetal";
            loop?: "pingpong" | "once" | "repeat" | "destroy";
            signal?: AbortSignal;
            speed?: number;
            turnDuration?: number;
        } = {}

        更新配置,未指定的飞行参数保留。

        • 可选continueTolerance?: number

          当前位置到新路线的最大衔接距离,米。

        • 可选curve?: "linear" | "centripetal"

          默认保持原曲线类型。

        • 可选loop?: "pingpong" | "once" | "repeat" | "destroy"

          循环方式。

        • 可选signal?: AbortSignal

          取消信号。

        • 可选speed?: number

          米/秒。

        • 可选turnDuration?: number

          调头时长,毫秒。

      返回 Promise<UAV>

      提交后的无人机;pathchange 事件提供衔接结果。

    访问器

    • get followMode(): any

      当前跟随视角,未跟随时为 null。

      返回 any

    • get isFollowing(): boolean

      是否为引擎当前跟随对象。

      返回 boolean

    • get point(): any[]

      当前经纬高快照。

      返回 any[]

    • get runId(): string

      当前飞行轮次标识。

      返回 string

    • get speed(): number

      当前速度,米/秒。

      返回 number

    • get state(): string

      当前飞行状态。

      返回 string