DJI Mobile SDK Documentation
      包:dji.v5.manager.interfaces
      classSince MSDK 5.3.0

      IFlyZoneManager

      此类是限飞解禁管理类,主要支持如下功能:

      Package dji.v5.manager.interfacesAndroid · Java / Kotlin

      此类是限飞解禁管理类,主要支持如下功能:

    • 获取飞行安全相关提示。
    • 获取飞行器周边的限飞区。
    • 解除加强警告区。
    • 解锁授权区。
    • 解禁限飞区:下载限飞区解禁证书,将解禁证书导入到飞行器,使能或者关闭飞行器解禁证书。
    • 飞行安全数据库更新。


    • MSDK 5.3.0开始支持

      成员

      41 个成员

      监听

      6

      方法

      12

      枚举

      13

      Class

      10

      飞行安全通知

      method

      addFlySafeNotificationListener

      Since MSDK 5.3.0
      void addFlySafeNotificationListener(@NonNull FlySafeNotificationListener listener)

      添加飞行安全通知的监听器。飞行安全通知信息包括:提示信息,返航信息,警告信息,严重警告信息,以及飞行器附近限飞区。

      参数

      名称类型说明
      listener@NonNull FlySafeNotificationListener 飞行安全通知的监听器
      method

      removeFlySafeNotificationListener

      Since MSDK 5.3.0
      void removeFlySafeNotificationListener(@NonNull FlySafeNotificationListener listener)

      移除飞行安全通知的监听器。

      参数

      名称类型说明
      listener@NonNull FlySafeNotificationListener 飞行安全通知的监听器
      method

      clearAllFlySafeNotificationListener

      Since MSDK 5.3.0
      void clearAllFlySafeNotificationListener()

      移除所有飞行安全通知的监听器。


      飞行安全提示

      method

      getFlyZonesInSurroundingArea

      Since MSDK 5.3.0
      void getFlyZonesInSurroundingArea(@NonNull LocationCoordinate2D location, @NonNull CommonCallbacks.CompletionCallbackWithParam<List<FlyZoneInformation>> callback)

      获取距离中心位置50公里范围内的限飞区。

      注意

      如果获取到的限飞区数量过多,在地图上绘制限飞区可能存在卡顿问题,建议做相关优化显示。

      参数

      名称类型说明
      location@NonNull LocationCoordinate2D 设置中心位置。
      callback@NonNull CommonCallbacks.CompletionCallbackWithParam<List<FlyZoneInformation>> 返回执行结果的回调。


      加强警告区

      method

      unlockAllEnhancedWarningFlyZone

      Since MSDK 5.3.0
      void unlockAllEnhancedWarningFlyZone(@NonNull CommonCallbacks.CompletionCallback callback)

      解除所有的加强警告区。解除后,飞行器将不会再提示任何加强警告区,重启飞行器后会继续提示。

      参数

      名称类型说明
      callback@NonNull CommonCallbacks.CompletionCallback 返回执行结果的回调。


      授权区

      method

      unlockAuthorizationFlyZone

      Since MSDK 5.3.0
      void unlockAuthorizationFlyZone(int flyZoneID, @NonNull CommonCallbacks.CompletionCallback callback)

      解锁授权区。解锁授权区后,飞行器将可以在授权区正常起飞。

      注意

      M300 RTK,M350 RTK,M30系列,M3E系列等行业类机型,可直接传入flyZoneID进行授权区解禁,重启飞行器后授权区将继续禁飞。
      DJI Mini 3和DJI Mini 3 Pro等消费类机型,需要参考禁飞区解禁流程,在DJI限飞官网申请解禁后, 调用downloadFlyZoneLicensesFromServer和pushFlyZoneLicensesToAircraft进行授权区解禁。

      参数

      名称类型说明
      flyZoneIDint 授权区ID。
      callback@NonNull CommonCallbacks.CompletionCallback 返回执行结果的回调。


      禁飞区

      method

      downloadFlyZoneLicensesFromServer

      Since MSDK 5.3.0
      void downloadFlyZoneLicensesFromServer(@NonNull CommonCallbacks.CompletionCallbackWithParam<List<FlyZoneLicenseInfo>> callback)

      从服务器获取禁飞区解禁证书。请先调用logInDJIUserAccount登陆DJI账号,才能获取相关账号申请的解禁证书。

      注意

      如果你希望在地图上绘制解禁证书中的限飞区,请将限飞区中的areaID传入getFlyZonesByAreaID后就可以获取该areaID的限飞区信息进行绘制。

      参数

      名称类型说明
      callback@NonNull CommonCallbacks.CompletionCallbackWithParam<List<FlyZoneLicenseInfo>> 返回执行结果的回调。
      method

      getFlyZonesByAreaID

      Since MSDK 5.3.0
      @NonNull
      List<FlyZoneInformation> getFlyZonesByAreaID(int areaID)

      获取特定areaID的限飞区信息。

      参数

      名称类型说明
      areaIDint 限飞区的ID。

      返回值

      类型说明
      List<FlyZoneInformation>返回特定areaID的限飞区信息。
      method

      pushFlyZoneLicensesToAircraft

      Since MSDK 5.3.0
      void pushFlyZoneLicensesToAircraft(@NonNull CommonCallbacks.CompletionCallback callback)

      将解禁证书导入到飞行器中。MSDK会把跟飞行器飞控SN匹配的解禁证书导入到飞行器中。 导入成功后,你可以调用pullFlyZoneLicensesFromAircraft获取已经导入到该飞行器的解禁证书列表。如果需要解禁限飞区,你可以调用setFlyZoneLicensesEnabled使能或者关闭解禁证书。

      参数

      名称类型说明
      callback@NonNull CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      pullFlyZoneLicensesFromAircraft

      Since MSDK 5.3.0
      void pullFlyZoneLicensesFromAircraft(@NonNull CommonCallbacks.CompletionCallbackWithParam<List<FlyZoneLicenseInfo>> callback)

      获取飞行器上的解禁证书。

      参数

      名称类型说明
      callback@NonNull CommonCallbacks.CompletionCallbackWithParam<List<FlyZoneLicenseInfo>> 返回执行结果的回调。
      method

      deleteFlyZoneLicensesFromAircraft

      Since MSDK 5.3.0
      void deleteFlyZoneLicensesFromAircraft(@NonNull CommonCallbacks.CompletionCallback callback)

      删除飞行器上的解禁证书。

      参数

      名称类型说明
      callback@NonNull CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      setFlyZoneLicensesEnabled

      Since MSDK 5.3.0
      void setFlyZoneLicensesEnabled(@NonNull FlyZoneLicenseInfo info, boolean isEnabled, @NonNull CommonCallbacks.CompletionCallback callback)

      使能或者关闭解禁证书。使能解禁证书以后,飞行器将可以在限飞区正常起飞。

      参数

      名称类型说明
      info@NonNull FlyZoneLicenseInfo 证书信息。
      isEnabledboolean true表示使能解禁证书。
      callback@NonNull CommonCallbacks.CompletionCallback 返回执行结果的回调。


      飞行安全数据库

      method

      addFlySafeDatabaseListener

      Since MSDK 5.8.0
      void addFlySafeDatabaseListener(@NonNull FlySafeDatabaseListener listener)

      添加飞行安全数据库的监听器。飞行安全数据库信息包括:数据库更新模式,数据库更新状态,手动导入的数据库信息。

      参数

      名称类型说明
      listener@NonNull FlySafeDatabaseListener 飞行安全数据库的监听器
      method

      removeFlySafeDatabaseListener

      Since MSDK 5.8.0
      void removeFlySafeDatabaseListener(@NonNull FlySafeDatabaseListener listener)

      移除飞行安全数据库的监听器。

      参数

      名称类型说明
      listener@NonNull FlySafeDatabaseListener 飞行安全数据库的监听器
      method

      clearAllFlySafeDatabaseListener

      Since MSDK 5.8.0
      void clearAllFlySafeDatabaseListener()

      移除所有飞行安全数据库的监听器。

      method

      setFlySafeDynamicDatabaseUpgradeMode

      Since MSDK 5.8.0
      void setFlySafeDynamicDatabaseUpgradeMode(@NonNull FlySafeDatabaseUpgradeMode flySafeDynamicDatabaseUpgradeMode , @NonNull CommonCallbacks.CompletionCallback callback)

      设置飞行安全动态数据库的更新模式,当前只支持手动导入欧盟地理感知数据。如果你希望在欧盟地区合规飞行无人机,请参照如下流程将欧盟地理感知数据导入到飞行器中。

    • 查阅欧洲航空安全局官网下载地理感知数据导入到飞行器中。
    • 调用setFlySafeDynamicDatabaseUpgradeMode将飞行安全动态数据库更新模式设置为手动导入模式。
    • 调用importFlySafeDynamicDatabaseToMSDK将地理感知数据导入到MSDK中。
    • 调用pushFlySafeDynamicDatabaseToAircraft将地理感知数据同步到飞行器中。
    • 调用getFlyZonesInSurroundingArea获取以飞行器为中心,50公里范围内到地理感知数据。


    • MSDK 5.8.0开始支持

      参数

      名称类型说明
      flySafeDynamicDatabaseUpgradeMode@NonNull FlySafeDatabaseUpgradeMode 飞行安全动态数据库更新模式,当前只支持手动导入模式。
      callback@NonNull CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      importFlySafeDynamicDatabaseToMSDK

      Since MSDK 5.8.0
      void importFlySafeDynamicDatabaseToMSDK(String databaseFilePath, @NonNull CommonCallbacks.CompletionCallbackWithProgress<Double> callback)

      将飞行安全动态数据库导入到MSDK中,当前只支持导入欧盟地理感知数据。如果你希望在欧盟地区合规飞行无人机,请参照如下流程将欧盟地理感知数据导入到飞行器中。

    • 查阅欧洲航空安全局官网下载地理感知数据导入到飞行器中。
    • 调用setFlySafeDynamicDatabaseUpgradeMode将飞行安全动态数据库更新模式设置为手动导入模式。
    • 调用importFlySafeDynamicDatabaseToMSDK将地理感知数据导入到MSDK中。
    • 调用pushFlySafeDynamicDatabaseToAircraft将地理感知数据同步到飞行器中。
    • 调用getFlyZonesInSurroundingArea获取以飞行器为中心,50公里范围内到地理感知数据。


    • MSDK 5.8.0开始支持

      参数

      名称类型说明
      databaseFilePathString 数据库文件路径,数据库文件必须为JSON格式并且需要符合ED-269规范。
      callback@NonNull CommonCallbacks.CompletionCallbackWithProgress<Double> 返回执行结果的回调。
      method

      pushFlySafeDynamicDatabaseToAircraft

      Since MSDK 5.8.0
      void pushFlySafeDynamicDatabaseToAircraft(@NonNull CommonCallbacks.CompletionCallbackWithProgress<Double>  callback)

      将飞行安全动态数据库同步到飞行器中。当前只支持同步欧盟地理感知数据。如果你希望在欧盟地区合规飞行无人机,请参照如下流程将欧盟地理感知数据导入到飞行器中。

    • 查阅欧洲航空安全局官网下载地理感知数据导入到飞行器中。
    • 调用setFlySafeDynamicDatabaseUpgradeMode将飞行安全动态数据库更新模式设置为手动导入模式。
    • 调用importFlySafeDynamicDatabaseToMSDK将地理感知数据导入到MSDK中。
    • 调用pushFlySafeDynamicDatabaseToAircraft将地理感知数据同步到飞行器中。
    • 调用getFlyZonesInSurroundingArea获取以飞行器为中心,50公里范围内到地理感知数据。


    • MSDK 5.8.0开始支持

      参数

      名称类型说明
      callback@NonNull CommonCallbacks.CompletionCallbackWithProgress<Double> 返回执行结果的回调。


      enum

      FlySafeTipEvent

      Since MSDK 5.3.0

      飞行安全提示信息的事件枚举。

      枚举成员

      名称说明
      TAKE_OFF_IN_HEIGHT_LIMIT_ZONE_WITHOUT_GPS飞行器低于限高区,无GPS信号,请注意飞行安全。
      TAKE_OFF_IN_HEIGHT_LIMIT_ZONE飞行器低于限高区,请注意飞行安全。
      TAKE_OFF_IN_WARNING_AREA飞行器处于警告区,请注意飞行安全。
      TOUCH_NO_FLY_ZONE飞行器已接近禁飞区,请注意飞行安全。
      TOUCH_AUTHORIZATION_ZONE飞行器已接近授权区,请注意飞行安全。
      REACH_MAXIMUM_FLIGHT_HEIGHT飞行器已达限高区内的最大飞行高度。
      RTH_AFFECTED_AT_BOUNDARY_OF_GEO_ZONE飞行器已接近限飞区,返航可能会受到影响。请小心飞离限飞区。
      AT_BOUNDARY_OF_CUSTOM_UNLOCK_ZONE飞行器已接近解禁区。
      ENTER_LIMIT_HEIGHT_AREA飞行器已进入限高区。
      COLLISION_WITH_LIMIT_HEIGHT_AREA_SOON_IN_WHITE_LIST_VALID_AREA飞行器已接近解禁区,请注意飞行安全。
      class

      FlySafeTipInformation

      Since MSDK 5.3.0
      class FlySafeTipInformation

      飞行安全提示信息类。包括提示信息的事件枚举和描述,高度限制以及限飞区信息。

      enum

      FlySafeWarningEvent

      Since MSDK 5.3.0

      飞行安全警告信息的事件枚举。

      枚举成员

      名称说明
      TAKE_OFF_FAILED_IN_NO_FLY_ZONE飞行器在禁飞区无法起飞。
      TAKE_OFF_FAILED_IN_NO_FLY_ZONE_WITHOUT_GPS移动设备处于禁飞区,飞行器GPS信号不好,无法起飞。
      TAKE_OFF_FAILED_WITHOUT_CUSTOM_UNLOCKING不能起飞。 您尚未申请在该区域飞行。
      TAKE_OFF_FAILED_IN_AUTHORIZED_AREA_WITHOUT_GPS_AND_UNLOCKING移动设备在授权区,飞行器GPS信号不好,解锁前无法起飞。
      TAKE_OFF_FAILED_IN_AUTHORIZED_ZONE_WITHOUT_UNLOCKING飞行器在授权区,未解锁前不能起飞。
      TAKE_OFF_FAILED_IN_AUTHORIZED_ZONE飞行器在授权区,你未获得飞行授权。
      TAKE_OFF_IN_ENHANCED_WARNING_ZONE飞行器处于加强警告区,请注意飞行安全。
      TAKE_OFF_NEAR_NO_FLY_ZONE附近有禁飞区,请注意飞行限制。
      LIMITED_RESTRICTIONS_NEARBY附近有禁飞区,请注意飞行限制。
      AUTHORIZED_ZONE_WITHOUT_UNLOCKING_NEARBY附近有授权区,请注意飞行限制。
      AUTHORIZED_ZONE_AND_RESTRICTIONS_NEARBY附近有授权区,你已获得飞行授权。
      RESTRICTIONS_IN_LIMITED_FLY_ZONE_NEARBY附近有禁飞区,请注意飞行限制。
      IN_AUTHORIZATION_ZONE飞行器在授权区,你已获得飞行授权。
      TAKE_OFF_FAILED_UNDER_LIMIT_AREA_WITH_GPS_ONCE移动设备在禁飞区,飞行器GPS信号不好,解锁前无法起飞。
      HAVE_ONE_HOUR_WILL_APPLY_TFRS1小时后,7KM内将有临时限飞区生效,请注意飞行安全。
      class

      FlySafeWarningInformation

      Since MSDK 5.3.0
      class FlySafeWarningInformation

      飞行安全警告信息类。包括警告信息的事件枚举和描述,高度限制以及限飞区信息。

      enum

      FlySafeSeriousWarningEvent

      Since MSDK 5.3.0

      飞行安全严重警告信息的事件枚举。

      枚举成员

      名称说明
      IN_NO_FLY_ZONE飞行器处于禁飞区,倒计时结束后会强制自动掉落。你将无法控制飞行器油门,但可以控制飞行器的前后左右以避开障碍物。
      IN_LIMIT_HEIGHT_AREA飞行器处于限高区,倒计时结束后会自动下降到限高高度。你将无法控制飞行器油门,但可以控制飞行器的前后左右以避开障碍物。
      IN_AUTHORIZATION_ZONE_WITHOUT_UNLOCKING飞行器处于授权区,倒计时结束后会强制自动掉落。你将无法控制飞行器油门,但可以控制飞行器的前后左右以避开障碍物。
      HAVE_THREE_MIN_WILL_APPLY_TFRS三分钟后,附近将有临时限飞区生效,请注意飞行安全。
      class

      FlySafeSeriousWarningInformation

      Since MSDK 5.3.0
      class FlySafeSeriousWarningInformation

      飞行安全严重警告信息类。包括严重警告信息的事件枚举和描述,自动降落倒计时,高度限制以及限飞区信息。

      enum

      FlySafeReturnToHomeEvent

      Since MSDK 5.3.0

      飞行安全返航信息的事件枚举。

      枚举成员

      名称说明
      NEAR_NO_FLY_ZONE接近禁飞区。返航可能会受到影响。请小心飞行。
      CROSS_NO_FLY_ZONE当前返航路线将经过禁飞区。返航可能会失败,请注意飞行器位置。
      class

      FlySafeReturnToHomeInformation

      Since MSDK 5.3.0
      class FlySafeReturnToHomeInformation

      飞行安全返航信息类。包括返航信息的事件枚举和描述。

      enum

      FlySafeLicenseType

      Since MSDK 5.3.0

      飞行安全许可证类型枚举。

      枚举成员

      名称说明
      GEO_UNLOCK地理解禁。
      CIRCLE_UNLOCK_AREA圆形解禁。
      COUNTRY_UNLOCK国家解禁。
      PARAMETER_CONFIGURATION限高解禁。
      PENTAGON_UNLOCK_AREA多边形解禁。
      POWER_UNLOCK功率解禁。
      RID_UNLOCKRID解禁。
      UNKNOWN未知。
      enum

      FlyZoneType

      Since MSDK 5.3.0

      限飞区类型。包括机场,公园,学校,体育馆等。

      枚举成员

      名称说明
      AIRPORT机场。
      COMMERCIAL_AIRPORTS商业机场。
      PRIVATE_COMMERCIAL_AIRPORTS私人商业机场。
      RECREATIONAL_AIRPORTS休闲机场。
      PRIVATE_RECREATIONAL_AIRPORTS私人休闲机场。
      HELIPORT直升机场。
      UNPAVED_AIRPORT未使用机场。
      NATIONAL_PARKS公园。
      NOAA美国国家海洋和大气局。
      PARCEL邮局。
      POWER_PLANT发电厂。
      SCHOOL学校。
      STADIUM体育场。
      NUCLEAR_POWER_PLANT核电站。
      PROHIBITED_SPECIAL_USE特殊用途。
      RESTRICTED_SPECIAL_USE特殊用途。
      SPECIAL特殊限飞区。
      TEMPORARY_FLIGHT_RESTRICTIONS临时飞行限制。
      CLASS_B_AIR_SPACEB类管制空域。 有关美国受控空域(B、C、D、E 类)的更多信息,请参见http://www.dji.com/flysafe/geo-system#notes。
      CLASS_C_AIR_SPACEC类管制空域。 有关美国受控空域(B、C、D、E 类)的更多信息,请参见http://www.dji.com/flysafe/geo-system#notes。
      CLASS_D_AIR_SPACED类管制空域。 有关美国受控空域(B、C、D、E 类)的更多信息,请参见http://www.dji.com/flysafe/geo-system#notes。
      CLASS_E_AIR_SPACEE类管制空域。 有关美国受控空域(B、C、D、E 类)的更多信息,请参见http://www.dji.com/flysafe/geo-system#notes。
      PRISON监狱。
      MILITARY军事用地。
      enum

      FlyZoneCategory

      Since MSDK 5.3.0

      限飞区策略。包括禁飞区,授权区,警告区和加强警告区等。

      枚举成员

      名称说明
      WARNING警告区。
      ENHANCED_WARNING加强警告区。
      AUTHORIZATION授权区。
      RESTRICTED禁飞区。
      enum

      FlyZoneShape

      Since MSDK 5.3.0

      限飞区形状类型。包括圆形和多边形。

      枚举成员

      名称说明
      CIRCLE圆形。
      MULTI_POLYGON多边形。包含圆柱和多边形限飞区。
      enum

      MultiPolygonFlyZoneShape

      Since MSDK 5.3.0

      多边形限飞区形状类型。包括圆柱和多边形。

      枚举成员

      名称说明
      CYLINDER圆柱。
      POLYGON多边形。
      class

      MultiPolygonFlyZoneInformation

      Since MSDK 5.3.0
      class MultiPolygonFlyZoneInformation

      多边形限飞区信息。包含圆柱和多边形限飞区信息。

      class

      FlyZoneInformation

      Since MSDK 5.3.0
      final class FlyZoneInformation

      限飞区信息类。包括限飞区ID,限飞区名称,限飞区类型,限飞区形状,限飞区策略等。

      class

      FlyZoneLicenseInfo

      Since MSDK 5.3.0
      class FlyZoneLicenseInfo implements KeepProguard

      限飞区解禁证书类。包括解禁证书基本信息,比如证书类型,有效期,证书绑定的飞行器飞控SN,使能状态等。

      enum

      RidUnlockType

      Since MSDK 5.8.0

      RID解禁类型。

      枚举成员

      名称说明
      EUROPEAN欧盟。
      CHINA中国。
      class

      FlySafeNotificationListener

      Since MSDK 5.3.0
      interface FlySafeNotificationListener

      飞行安全通知的监听器。

      class

      FlySafeDatabaseListener

      Since MSDK 5.8.0
      interface FlySafeDatabaseListener

      飞行安全数据库的监听器。

      class

      FlySafeDatabaseInfo

      Since MSDK 5.8.0
      class FlySafeDatabaseInfo

      飞行安全数据库信息类。包括模块类型,更新模式,数据库名称,大小和导入时间。

      enum

      FlySafeDatabaseUpgradeMode

      Since MSDK 5.8.0

      飞行安全数据库更新模式。包括手动导入和自动更新。MSDK只支持手动导入模式,如需要使用自动更新模式,请使用DJI官方APP。

      枚举成员

      名称说明
      MANUAL_IMPORT手动导入模式。MSDK只支持手动更新模式,如需要使用自动更新模式,请使用DJI官方APP。
      AUTOMATIC_UPGRADE自动更新模式。MSDK只支持手动更新模式,如需要使用自动更新模式,请使用DJI官方APP。自动更新模式只能作为飞行安全的补充,如果你希望在欧盟地区合规飞行无人机,请参照将欧盟地理感知数据手动导入到飞行器中。
      enum

      FlySafeDatabaseComponent

      Since MSDK 5.8.0

      飞行安全数据库模块类型。包括MSDK和飞行器。

      枚举成员

      名称说明
      AIRCRAFT飞行器。
      MSDKMSDK。
      enum

      FlySafeDatabaseState

      Since MSDK 5.8.0

      飞行安全数据库状态。

      枚举成员

      名称说明
      NEED_TO_IMPORT需要导入。表示MSDK当前的数据库没有包含飞行器当前位置的数据。请调用importFlySafeDynamicDatabaseToMSDK导入飞行器位置附近的数据库。
      NEED_TO_SYNC需要同步。表示需要将MSDK中数据库同步给飞行器。请调用pushFlySafeDynamicDatabaseToAircraft将MSDK中的数据库推送给飞行器。
      UP_TO_DATE已更新到最新数据。表示MSDK的数据库已经成功同步给飞行器。