| Package: | dji.v5.manager.interfaces |
IFlyZoneManager
Class to manage unlock fly zone, which mainly supports the following functions:
Description:
Supported since MSDK 5.3.0
Fly Safety Notification
addFlySafeNotificationListener
void addFlySafeNotificationListener(@NonNull |
Add a listener for fly safety notification. Fly safety n notification information includes: tips information, return home information, warning information, serious warning information, and fly zone near the aircraft.
Parameters
| Name | Type | Description |
|---|---|---|
listener | @NonNull | Fly safety notification listener. |
removeFlySafeNotificationListener
void removeFlySafeNotificationListener(@NonNull |
remove the listener for fly safety notification.
Parameters
| Name | Type | Description |
|---|---|---|
listener | @NonNull | Fly Safety Notification listener. |
clearAllFlySafeNotificationListener
void clearAllFlySafeNotificationListener() |
Clear all listeners for fly safety notification.
getFlyZonesInSurroundingArea
void getFlyZonesInSurroundingArea(@NonNull |
Gets the fly zones within 50 kilometers from the central location.
If there are too many fly zones obtained, drawing the fly zones on the map may cause ANR problems. It is recommended to optimize the display.
Parameters
| Name | Type | Description |
|---|---|---|
location | @NonNull | Set the the central location. |
callback | @NonNull | Return the callback of execution result. |
Enhanced Warning Fly Zone
unlockAllEnhancedWarningFlyZone
void unlockAllEnhancedWarningFlyZone(@NonNull |
Unlock all enhanced warning fly zones. After unlocking, the aircraft will no longer prompt any enhanced warning zone, and will continue to warn after reboot the aircraft.
Parameters
| Name | Type | Description |
|---|---|---|
callback | @NonNull | Return the callback of execution result. |
Authorization Fly Zone
unlockAuthorizationFlyZone
void unlockAuthorizationFlyZone(int flyZoneID, @NonNull |
Unlock the authorization fly zone. After unlocking the authorization fly zone, the aircraft will be able to take off normally in the authorization fly zone.
M300 RTK, M350 RTK, M30 series, M3E series and other enterprise aircraft can be directly transferred to flyZoneID to unlock the authorized area, and the authorization fly zone will continue to be banned after reboot the aircraft.
DJI Mini 3 and DJI Mini 3 Pro and other consumer aircraft, you need to refer to the unlocking process of the restricted fly zone. After applying for unlocking on the official website of DJI, call
downloadFlyZoneLicensesFromServer and pushFlyZoneLicensesToAircraft to unlock the authorization fly zone.Parameters
| Name | Type | Description |
|---|---|---|
flyZoneID | int | Authorization fly zone ID. |
callback | @NonNull | Return the callback of execution result. |
Restricted Fly Zone
downloadFlyZoneLicensesFromServer
void downloadFlyZoneLicensesFromServer(@NonNull |
Gets the licenses for restricted fly zone from the server. In order to get the unlock licenses for the relevant account, please call logInDJIUserAccount to log in to the DJI account first,
If you want to draw the restricted fly zone in the license on the map, please pass the areaID in the restricted fly zone to
getFlyZonesByAreaID, then you can get the restricted fly zone information of the areaID for drawing. Parameters
| Name | Type | Description |
|---|---|---|
callback | @NonNull | Return the callback of execution result. |
getFlyZonesByAreaID
@NonNull |
Gets the restricted fly zone information for a specific areaID.
Parameters
| Name | Type | Description |
|---|---|---|
areaID | int | Restricted fly zone ID. |
Return
| Name | Description |
|---|---|
List<FlyZoneInformation> | Returns the restricted fly zone information for a specific areaID. |
pushFlyZoneLicensesToAircraft
void pushFlyZoneLicensesToAircraft(@NonNull |
Push the unlock licenses into the aircraft. MSDK will push the licenses matching the SN of the flight controller into the aircraft.
After the push is successful, you can call pullFlyZoneLicensesFromAircraft to get the list of licenses that have been pushed to the aircraft. If you need to unlock the restricted zone, you can call setFlyZoneLicensesEnabled to enable or disable the unlock licenses.
Parameters
| Name | Type | Description |
|---|---|---|
callback | @NonNull | Return the callback of execution result. |
pullFlyZoneLicensesFromAircraft
void pullFlyZoneLicensesFromAircraft(@NonNull |
Gets the licenses pushed to the aircraft.
Parameters
| Name | Type | Description |
|---|---|---|
callback | @NonNull | Return the callback of execution result. |
deleteFlyZoneLicensesFromAircraft
void deleteFlyZoneLicensesFromAircraft(@NonNull |
Delete the licenses pushed to the aircraft.
Parameters
| Name | Type | Description |
|---|---|---|
callback | @NonNull | Return the callback of execution result. |
setFlyZoneLicensesEnabled
void setFlyZoneLicensesEnabled(@NonNull |
Enable or disable unlock license. After enabling the license, the aircraft will be able to take off normally in the restricted fly zone.
Parameters
| Name | Type | Description |
|---|---|---|
info | @NonNull | license information. |
isEnabled | boolean | true means enabled the licence. |
callback | @NonNull | Return the callback of execution result. |
Fly Safety Database
addFlySafeDatabaseListener
void addFlySafeDatabaseListener(@NonNull |
Add a listener for the fly safety database. Fly safety database information includes: database upgrade mode, database upgrade status, and manually imported database information.
Parameters
| Name | Type | Description |
|---|---|---|
listener | @NonNull | Fly safety database listener. |
removeFlySafeDatabaseListener
void removeFlySafeDatabaseListener(@NonNull |
Remove the listener for fly safety database.
Parameters
| Name | Type | Description |
|---|---|---|
listener | @NonNull | Fly safety database listener. |
clearAllFlySafeDatabaseListener
void clearAllFlySafeDatabaseListener() |
Clear all listeners for fly safety database.
setFlySafeDynamicDatabaseUpgradeMode
void setFlySafeDynamicDatabaseUpgradeMode(@NonNull |
Set the upgrade mode of the fly safety dynamic database. Currently, only manual import of EU GeoZone data is supported. If you want to fly your drone compliantly in the EU, please refer to the following process to import EU GeoZone data into the aircraft.
setFlySafeDynamicDatabaseUpgradeMode to set the fly safety dynamic database upgrade mode to manual import mode. importFlySafeDynamicDatabaseToMSDK to import GeoZone data into MSDK. pushFlySafeDynamicDatabaseToAircraft to synchronize GeoZone data to the aircraft. getFlyZonesInSurroundingArea to obtain GeoZone data within a range of 50 kilometers centered on the aircraft. Supported since MSDK 5.8.0
Parameters
| Name | Type | Description |
|---|---|---|
flySafeDynamicDatabaseUpgradeMode | @NonNull | Fly safety dynamic database upgrade mode. Currently only supports manual import mode. |
callback | @NonNull | Return the callback of execution result. |
importFlySafeDynamicDatabaseToMSDK
void importFlySafeDynamicDatabaseToMSDK(String databaseFilePath, @NonNull |
Import the fly safety dynamic database into the MSDK. Currently, only only support to import the EU GeoZone data. If you want to fly your drone compliantly in the EU, please refer to the following process to import EU GeoZone data into the aircraft.
setFlySafeDynamicDatabaseUpgradeMode to set the fly safety dynamic database upgrade mode to manual import mode. importFlySafeDynamicDatabaseToMSDK to import GeoZone data into MSDK. pushFlySafeDynamicDatabaseToAircraft to synchronize GeoZone data to the aircraft. getFlyZonesInSurroundingArea to obtain GeoZone data within a range of 50 kilometers centered on the aircraft. Supported since MSDK 5.8.0
Parameters
| Name | Type | Description |
|---|---|---|
databaseFilePath | String | Database file path, the database file must be in JSON format and needs to comply with the ED-269 specification. |
callback | @NonNull | Return the callback of execution result. |
pushFlySafeDynamicDatabaseToAircraft
void pushFlySafeDynamicDatabaseToAircraft(@NonNull |
Synchronize the fly safety dynamic database to the aircraft. Currently only support to synchronize the EU GeoZone data. If you want to fly your drone compliantly in the EU, please refer to the following process to import EU GeoZone data into the aircraft.
setFlySafeDynamicDatabaseUpgradeMode to set the fly safety dynamic database upgrade mode to manual import mode. importFlySafeDynamicDatabaseToMSDK to import GeoZone data into MSDK. pushFlySafeDynamicDatabaseToAircraft to synchronize GeoZone data to the aircraft. getFlyZonesInSurroundingArea to obtain GeoZone data within a range of 50 kilometers centered on the aircraft. Supported since MSDK 5.8.0
Parameters
| Name | Type | Description |
|---|---|---|
callback | @NonNull | Return the callback of execution result. |
Related:
FlySafeTipEvent
Event enumeration of fly safety prompt information.
Enum Members
FlySafeTipInformation
Since MSDK 5.3.0class FlySafeTipInformation |
Fly safety tips information.
FlySafeWarningEvent
Event enumeration of fly safety warning information.
Enum Members
FlySafeWarningInformation
Since MSDK 5.3.0class FlySafeWarningInformation |
Fly safety warning information.
FlySafeSeriousWarningEvent
Event enumeration of fly safety serious warning information.
Enum Members
FlySafeSeriousWarningInformation
Since MSDK 5.3.0class FlySafeSeriousWarningInformation |
Fly safety serious warning information.
FlySafeReturnToHomeEvent
Event enumeration of fly safety return to home information.
Enum Members
FlySafeReturnToHomeInformation
Since MSDK 5.3.0class FlySafeReturnToHomeInformation |
Fly safety return to home information.
FlySafeLicenseType
Type of flysafe license.
Enum Members
FlyZoneType
Type of restricted fly zone. Including airports, parks, schools, stadium, etc.
Enum Members
FlyZoneCategory
Restricted Fly Zone category. Including restricted zone, authorization zone, warning zone and enhanced warning zone, etc.
Enum Members
| Name | Description |
|---|---|
WARNING | Warning. |
ENHANCED_WARNING | Enhanced warning. |
AUTHORIZATION | authorization fly zone. |
RESTRICTED | Restricted fly zone. |
FlyZoneShape
Restricted fly zone shape type. Includes circles and polygons.
Enum Members
| Name | Description |
|---|---|
CIRCLE | circle. |
MULTI_POLYGON | Polygon. Contains cylindrical and polygonal restricted fly zones. |
MultiPolygonFlyZoneShape
The shape type of polygonal restricted fly zone. Includes cylinders and polygons.
Enum Members
| Name | Description |
|---|---|
CYLINDER | Cylinder. |
POLYGON | Polygon. |
MultiPolygonFlyZoneInformation
Since MSDK 5.3.0class MultiPolygonFlyZoneInformation |
Polygon restricted fly zone information.
FlyZoneInformation
Since MSDK 5.3.0final class FlyZoneInformation |
Restricted fl zone information class.
FlyZoneLicenseInfo
Since MSDK 5.3.0class FlyZoneLicenseInfo implements KeepProguard |
Restricted fly zone licenses class.
FlySafeNotificationListener
Since MSDK 5.3.0interface FlySafeNotificationListener |
Fly safety notification listener.
FlySafeDatabaseListener
Since MSDK 5.8.0interface FlySafeDatabaseListener |
Fly safety database listener.
FlySafeDatabaseInfo
Since MSDK 5.8.0class FlySafeDatabaseInfo |
Fly safety database information class.
FlySafeDatabaseUpgradeMode
Fly safety database upgrade mode. Includes manual import and automatic upgrade. MSDK only supports manual import mode. If you need to use automatic upgrade mode, please use DJI official APP.
Enum Members
FlySafeDatabaseComponent
Fly safety database component type. Includes MSDK and aircraft.
Enum Members
| Name | Description |
|---|---|
AIRCRAFT | Aircraft. |
MSDK | MSDK. |
FlySafeDatabaseState
Fly safety database state.