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

    类 UAVFleet

    按业务 ID 管理多架 UAV,支持批量控制和保留进度的航线更新。 机队负责成员生命周期;成员以独立地理对象挂载,机队自身不提供整体变换或显隐。

    const fleet = engine.add(new mapvthree.UAVFleet({url: '/models/uav.glb', speed: 10}));
    await fleet.addOrUpdate({id: '001', path});
    fleet.startAll();
    await fleet.addOrUpdate({id: '001', path: extendedPath});

    层级

    • EngineObject3D
      • UAVFleet
    索引

    构造函数

    • 参数

      • 可选options: { continueTolerance?: number; route?: any } = {}

        新建成员默认配置,支持 UAV 的模型与飞行参数。

        • 可选continueTolerance?: number

          航线更新衔接容差,米。

        • 可选route?: any

          自动管理航线;type 默认 polyline,可选 pipeline 管道。

      返回 UAVFleet

    方法

    • 按 ID 新增或部分更新;新机加载后保持就绪,显式 start 才飞行。

      参数

      • data: {
            id: string | number;
            modelUrl?: string;
            path?: number[][];
            properties?: any;
            route?: any;
        }

        成员配置;新增需有 id、path 和模型(可继承默认模型)。

        • id: string | number

          稳定业务 ID。

        • 可选modelUrl?: string

          新建模型地址,等同 UAV 的 url,二者不可同时指定。

        • 可选path?: number[][]

          更新后的完整航线;省略时保留已有路线。

        • 可选properties?: any

          业务属性,浅合并更新,不允许覆盖内置状态字段。

        • 可选route?: any

          单机航线开关或样式;省略保留原值,对象部分合并。

      • 可选options: { signal?: AbortSignal } = {}

        异步控制配置。

        • 可选signal?: AbortSignal

          取消本次请求。

      返回 Promise<UAV>

      模型就绪后的成员;同 ID 最近已完成的 destroy 路线返回 undefined。

    • 清空当前成员及完成记录,机队仍可继续使用。

      返回 UAVFleet

    • 清除指定 ID 的完成记录;省略 ID 清除全部记录,不改变当前成员。

      参数

      • id: any

      返回 UAVFleet

    • 解除挂载并释放所有成员;重复调用安全。

      返回 void

    • 跟随指定成员,参数与 UAV.follow 相同。

      参数

      • id: any
      • options: any

      返回 UAVFleet

    • 获取成员,不存在时返回 undefined;加载中的成员可等待其 ready。

      参数

      • id: any

      返回 any

    • 返回业务 ID 快照;数字与字符串 ID 分别管理。

      返回 any[]

    • 获取机队拥有的 Polyline 或 TubeLine,未就绪返回 undefined;类型或管道截面变化可替换对象。

      参数

      • id: any

      返回 any

    • 淡出指定 ID/ID 数组的标签;省略隐藏全部,不触发自然到期事件。

      参数

      • ids: any

      返回 UAVFleet

    • 移除指定成员并释放模型、视域及跟随;不存在返回 false。

      参数

      • id: any

      返回 boolean

    • 恢复指定成员,保留暂停位置。

      参数

      • id: any

      返回 UAVFleet

    • 按完整名单同步成员,全部更新成功后删除未出现的 ID,并清除其完成记录。 成员字段沿用 addOrUpdate;新成员不自动启动。相同模型配置可以重复传入,不支持隐式换模型。 失败不执行名单外删除,已成功更新不回滚;新全量调用会取消旧调用。

      参数

      • drones: any[]

        完整成员名单,空数组清空机队及完成记录。

      • 可选options: { signal?: AbortSignal } = {}

        异步控制配置。

        • 可选signal?: AbortSignal

          取消本次同步。

      返回 Promise<UAVFleet>

      同步完成后的机队。

    • 部分更新标签默认配置;时间用于下次显示,外观、距离、避让及高度偏移立即生效,不重新计时。

      参数

      • options: any

      返回 UAVFleet

    • 显示或替换临时标签,一架一条;重复调用重新计时,返回机队。

      参数

      • list: any[]

        每项包含 id 或 ids(数组/'all'),以及 type、title、content、color、duration、icon。 icon 省略时继承默认值,null 取消图标;无图标且无非空文字时清除提示,不计时或通知到期。

      返回 UAVFleet

    • 从指定成员航线起点开始,参数与 UAV.start 相同。

      参数

      • id: any
      • options: any

      返回 UAVFleet

    • 全部从起点开始;有成员尚未就绪时拒绝,不部分启动。

      参数

      • options: any

      返回 UAVFleet

    • 停止指定成员,参数与 UAV.stop 相同。

      参数

      • id: any
      • options: any

      返回 UAVFleet

    • 停止所有成员,参数与 UAV.stop 相同。

      参数

      • options: any

      返回 UAVFleet

    • 解除本机队的相机跟随,不接管其他机队或独立相机巡航。

      返回 UAVFleet

    访问器

    • get dataSource(): DataSource

      机队拥有的稳定点数据源;位置/状态由机队维护,展示组件只借用。

      返回 DataSource

    • get labelDataSource(): any

      临时提示的稳定数据源;位置、内容和透明度由机队维护,不影响 dataSource。

      返回 any

    • get size(): number

      成员数量,包含仍在加载模型的成员。

      返回 number