DJI Mobile SDK Documentation

      class IWaypointMissionManager

      interface IWaypointMissionManager
      包:dji.v5.manager.interfaces
      描述:

      此类是航线任务管理类,用于航线任务的上传,执行,暂停,恢复以及航线任务执行状态的监听等功能。

      MSDK 5.0.0开始支持

      类成员:
      method addWaypointMissionExecuteStateListener
      void addWaypointMissionExecuteStateListener(WaypointMissionExecuteStateListener listener)
      包:dji.v5.manager.interfaces
      描述:

      设置航线任务执行状态的监听器。可以用来监听航线任务的执行状态,比如:航线任务文件上传中,进入航线任务飞行,航线任务完成等状态。

      MSDK 5.0.0开始支持

      输入参数:
      WaypointMissionExecuteStateListener listener航线任务执行状态的监听器。
      method removeWaypointMissionExecuteStateListener
      void removeWaypointMissionExecuteStateListener(WaypointMissionExecuteStateListener listener)
      包:dji.v5.manager.interfaces
      描述:

      移除航线任务执行状态的监听器。

      MSDK 5.0.0开始支持

      输入参数:
      WaypointMissionExecuteStateListener listener航线任务执行状态的监听器。
      method clearAllWaypointMissionExecuteStateListener
      void clearAllWaypointMissionExecuteStateListener()
      包:dji.v5.manager.interfaces
      描述:

      移除所有航线任务执行状态的监听器。

      MSDK 5.0.0开始支持

      method addWaylineExecutingInfoListener
      void addWaylineExecutingInfoListener(WaylineExecutingInfoListener listener)
      包:dji.v5.manager.interfaces
      描述:

      设置航线信息的监听器。航线信息包括当前执行的航线ID和当前执行的航点序号。

      MSDK 5.0.0开始支持

      输入参数:
      WaylineExecutingInfoListener listener航线信息的监听器。
      method removeWaylineExecutingInfoListener
      void removeWaylineExecutingInfoListener(WaylineExecutingInfoListener listener)
      包:dji.v5.manager.interfaces
      描述:

      移除航线信息的监听器。

      MSDK 5.0.0开始支持

      输入参数:
      WaylineExecutingInfoListener listener航线信息的监听器。
      method clearAllWaylineExecutingInfoListener
      void clearAllWaylineExecutingInfoListener()
      包:dji.v5.manager.interfaces
      描述:

      移除所有航线信息的监听器。

      MSDK 5.0.0开始支持

      method pushKMZFileToAircraft
      void pushKMZFileToAircraft(String missionFilePath, CommonCallbacks.CompletionCallbackWithProgress<Double> callback)
      包:dji.v5.manager.interfaces
      描述:

      上传航线任务。

    • 航线任务定义在KMZ文件中,KMZ文件采用DJI自定义的航线文件格式(WPML)进行编写。WPML格式遵循XML和KML规范,更详细信息请参阅:航线文件格式
    • 用户可根据DJI Pilot 2中提供的模板生成航线文件,也可使用DJI WPML格式根据业务需要自定义waylines.wpml中的内容,并将该文件压缩为KMZ文件后上传。
    • 你可以多次调用此接口上传多个航线任务KMZ文件,如果上传相同的文件名的KMZ文件,将会覆盖上一次上传的同名文件。
    • 你可以通过设置航线任务KMZ文件名来选择航线任务的执行startMission和停止stopMission
    • 一个KMZ文件包括一个航线任务,一个航线任务里面可以包含多个航线。


    • MSDK 5.0.0开始支持

      输入参数:
      String missionFilePath航线任务KMZ文件路径。
      CommonCallbacks.CompletionCallbackWithProgress<Double> callback返回执行结果的回调。返回KMZ文件上传状态,包括上传进度和错误信息。
      method startMission
      void startMission(String missionFileName, CommonCallbacks.CompletionCallback callback)
      包:dji.v5.manager.interfaces
      描述:

      开始执行航线任务。

      MSDK 5.0.0开始支持

      输入参数:
      String missionFileName需要执行的航线任务文件名。
      CommonCallbacks.CompletionCallback callback返回执行结果的回调。
      method getAvailableWaylineIDs
      List<Integer> getAvailableWaylineIDs(String missionFileName)
      包:dji.v5.manager.interfaces
      描述:

      返回指定的航线任务文件中可用的航线ID列表。获取到这个ID列表以后可以选择需要执行的航线ID,作为参数传入到startMission执行航线任务。

      MSDK 5.1.0开始支持

      输入参数:
      String missionFileName指定的航线任务文件名。
      返回值:
      List<Integer>获取指定的航线任务文件中可用的航线ID列表。
      method startMission
      void startMission(String missionFileName, List<Integer> waylineIDs, CommonCallbacks.CompletionCallback callback)
      包:dji.v5.manager.interfaces
      描述:

      开始执行指定的航线ID列表的航线任务。可通过getAvailableWaylineIDs获取到可用的航线ID列表。获取到这个航线ID列表以后可以选择需要执行的航线ID作为参数传入到此接口,飞行器将按照航线ID列表的顺序依次执行航线任务。如果航线ID列表参数传空或者航线ID列表长度为0,飞行器将执行航线任务中的所有航线。

      MSDK 5.1.0开始支持

      输入参数:
      String missionFileName需要执行的航线任务文件名。
      List<Integer> waylineIDs需要执行的航线ID列表。
      CommonCallbacks.CompletionCallback callback返回执行结果的回调。
      method pauseMission
      void pauseMission(CommonCallbacks.CompletionCallback callback)
      包:dji.v5.manager.interfaces
      描述:

      暂停执行航线任务。

      MSDK 5.0.0开始支持

      输入参数:
      CommonCallbacks.CompletionCallback callback返回执行结果的回调。
      method resumeMission
      void resumeMission(CommonCallbacks.CompletionCallback callback)
      包:dji.v5.manager.interfaces
      描述:

      从暂停处恢复执行航线任务。

      MSDK 5.0.0开始支持

      输入参数:
      CommonCallbacks.CompletionCallback callback返回执行结果的回调。
      method stopMission
      void stopMission(String missionFileName, CommonCallbacks.CompletionCallback callback)
      包:dji.v5.manager.interfaces
      描述:

      停止执行航线任务。

      MSDK 5.0.0开始支持

      输入参数:
      String missionFileName需要停止的航线任务文件名。
      CommonCallbacks.CompletionCallback callback返回执行结果的回调。
      enum WaypointMissionExecuteState
      enum WaypointMissionExecuteState
      包:dji.v5.manager.aircraft.waypoint3.model
      描述:

      航线任务执行状态。

      MSDK 5.0.0开始支持

      Enum Members:
      DISCONNECTED飞行器断开连接。
      NOT_SUPPORED此机型不支持航线任务3.0。
      READY航线任务准备状态,此状态下可上传航线任务文件,也可执行已上传的航线任务。
      UPLOADING航线任务文件上传中。
      EXECUTING_PRE_PRARING航线任务执行准备中。调用startMission启动执行航线任务后,飞行器在准备执行航线任务中。
      ENTER_WAYLINE进入航线飞行,飞往第一个航线的第一个航点。
      INTERRUPTED航线任务执行中断,表示用户调用pauseMission暂停航线或者飞控异常。
      RECOVERING航线任务恢复中。
      FINISHED航线任务完成。表示航线任务执行完成或者调用stopMission停止执行航线任务。
      Class Members: