| 包: | dji.v5.manager.interfaces |
IFlyZoneManager
此类是限飞解禁管理类,主要支持如下功能:
描述:
MSDK 5.3.0开始支持
飞行安全通知
addFlySafeNotificationListener
Since MSDK 5.3.0void addFlySafeNotificationListener(@NonNull |
添加飞行安全通知的监听器。飞行安全通知信息包括:提示信息,返航信息,警告信息,严重警告信息,以及飞行器附近限飞区。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
listener | @NonNull | 飞行安全通知的监听器 |
removeFlySafeNotificationListener
Since MSDK 5.3.0void removeFlySafeNotificationListener(@NonNull |
移除飞行安全通知的监听器。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
listener | @NonNull | 飞行安全通知的监听器 |
clearAllFlySafeNotificationListener
Since MSDK 5.3.0void clearAllFlySafeNotificationListener() |
移除所有飞行安全通知的监听器。
飞行安全提示
getFlyZonesInSurroundingArea
Since MSDK 5.3.0void getFlyZonesInSurroundingArea(@NonNull |
获取距离中心位置50公里范围内的限飞区。
如果获取到的限飞区数量过多,在地图上绘制限飞区可能存在卡顿问题,建议做相关优化显示。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
location | @NonNull | 设置中心位置。 |
callback | @NonNull | 返回执行结果的回调。 |
加强警告区
unlockAllEnhancedWarningFlyZone
Since MSDK 5.3.0void unlockAllEnhancedWarningFlyZone(@NonNull |
解除所有的加强警告区。解除后,飞行器将不会再提示任何加强警告区,重启飞行器后会继续提示。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | @NonNull | 返回执行结果的回调。 |
授权区
unlockAuthorizationFlyZone
Since MSDK 5.3.0void unlockAuthorizationFlyZone(int flyZoneID, @NonNull |
解锁授权区。解锁授权区后,飞行器将可以在授权区正常起飞。
M300 RTK,M350 RTK,M30系列,M3E系列等行业类机型,可直接传入flyZoneID进行授权区解禁,重启飞行器后授权区将继续禁飞。
DJI Mini 3和DJI Mini 3 Pro等消费类机型,需要参考禁飞区解禁流程,在DJI限飞官网申请解禁后, 调用
downloadFlyZoneLicensesFromServer和pushFlyZoneLicensesToAircraft进行授权区解禁。 参数
| 名称 | 类型 | 说明 |
|---|---|---|
flyZoneID | int | 授权区ID。 |
callback | @NonNull | 返回执行结果的回调。 |
禁飞区
downloadFlyZoneLicensesFromServer
Since MSDK 5.3.0void downloadFlyZoneLicensesFromServer(@NonNull |
从服务器获取禁飞区解禁证书。请先调用logInDJIUserAccount登陆DJI账号,才能获取相关账号申请的解禁证书。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | @NonNull | 返回执行结果的回调。 |
getFlyZonesByAreaID
Since MSDK 5.3.0@NonNull |
获取特定areaID的限飞区信息。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
areaID | int | 限飞区的ID。 |
返回值
| 类型 | 说明 |
|---|---|
List | 返回特定areaID的限飞区信息。 |
pushFlyZoneLicensesToAircraft
Since MSDK 5.3.0void pushFlyZoneLicensesToAircraft(@NonNull |
将解禁证书导入到飞行器中。MSDK会把跟飞行器飞控SN匹配的解禁证书导入到飞行器中。 导入成功后,你可以调用pullFlyZoneLicensesFromAircraft获取已经导入到该飞行器的解禁证书列表。如果需要解禁限飞区,你可以调用setFlyZoneLicensesEnabled使能或者关闭解禁证书。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | @NonNull | 返回执行结果的回调。 |
pullFlyZoneLicensesFromAircraft
Since MSDK 5.3.0void pullFlyZoneLicensesFromAircraft(@NonNull |
获取飞行器上的解禁证书。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | @NonNull | 返回执行结果的回调。 |
deleteFlyZoneLicensesFromAircraft
Since MSDK 5.3.0void deleteFlyZoneLicensesFromAircraft(@NonNull |
删除飞行器上的解禁证书。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | @NonNull | 返回执行结果的回调。 |
setFlyZoneLicensesEnabled
Since MSDK 5.3.0void setFlyZoneLicensesEnabled(@NonNull |
使能或者关闭解禁证书。使能解禁证书以后,飞行器将可以在限飞区正常起飞。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
info | @NonNull | 证书信息。 |
isEnabled | boolean | true表示使能解禁证书。 |
callback | @NonNull | 返回执行结果的回调。 |
飞行安全数据库
addFlySafeDatabaseListener
Since MSDK 5.8.0void addFlySafeDatabaseListener(@NonNull |
添加飞行安全数据库的监听器。飞行安全数据库信息包括:数据库更新模式,数据库更新状态,手动导入的数据库信息。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
listener | @NonNull | 飞行安全数据库的监听器 |
removeFlySafeDatabaseListener
Since MSDK 5.8.0void removeFlySafeDatabaseListener(@NonNull |
移除飞行安全数据库的监听器。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
listener | @NonNull | 飞行安全数据库的监听器 |
clearAllFlySafeDatabaseListener
Since MSDK 5.8.0void clearAllFlySafeDatabaseListener() |
移除所有飞行安全数据库的监听器。
setFlySafeDynamicDatabaseUpgradeMode
Since MSDK 5.8.0void setFlySafeDynamicDatabaseUpgradeMode(@NonNull |
设置飞行安全动态数据库的更新模式,当前只支持手动导入欧盟地理感知数据。如果你希望在欧盟地区合规飞行无人机,请参照如下流程将欧盟地理感知数据导入到飞行器中。
setFlySafeDynamicDatabaseUpgradeMode将飞行安全动态数据库更新模式设置为手动导入模式。importFlySafeDynamicDatabaseToMSDK将地理感知数据导入到MSDK中。pushFlySafeDynamicDatabaseToAircraft将地理感知数据同步到飞行器中。getFlyZonesInSurroundingArea获取以飞行器为中心,50公里范围内到地理感知数据。MSDK 5.8.0开始支持
参数
| 名称 | 类型 | 说明 |
|---|---|---|
flySafeDynamicDatabaseUpgradeMode | @NonNull | 飞行安全动态数据库更新模式,当前只支持手动导入模式。 |
callback | @NonNull | 返回执行结果的回调。 |
importFlySafeDynamicDatabaseToMSDK
Since MSDK 5.8.0void importFlySafeDynamicDatabaseToMSDK(String databaseFilePath, @NonNull |
将飞行安全动态数据库导入到MSDK中,当前只支持导入欧盟地理感知数据。如果你希望在欧盟地区合规飞行无人机,请参照如下流程将欧盟地理感知数据导入到飞行器中。
setFlySafeDynamicDatabaseUpgradeMode将飞行安全动态数据库更新模式设置为手动导入模式。importFlySafeDynamicDatabaseToMSDK将地理感知数据导入到MSDK中。pushFlySafeDynamicDatabaseToAircraft将地理感知数据同步到飞行器中。getFlyZonesInSurroundingArea获取以飞行器为中心,50公里范围内到地理感知数据。MSDK 5.8.0开始支持
参数
| 名称 | 类型 | 说明 |
|---|---|---|
databaseFilePath | String | 数据库文件路径,数据库文件必须为JSON格式并且需要符合ED-269规范。 |
callback | @NonNull | 返回执行结果的回调。 |
pushFlySafeDynamicDatabaseToAircraft
Since MSDK 5.8.0void pushFlySafeDynamicDatabaseToAircraft(@NonNull |
将飞行安全动态数据库同步到飞行器中。当前只支持同步欧盟地理感知数据。如果你希望在欧盟地区合规飞行无人机,请参照如下流程将欧盟地理感知数据导入到飞行器中。
setFlySafeDynamicDatabaseUpgradeMode将飞行安全动态数据库更新模式设置为手动导入模式。importFlySafeDynamicDatabaseToMSDK将地理感知数据导入到MSDK中。pushFlySafeDynamicDatabaseToAircraft将地理感知数据同步到飞行器中。getFlyZonesInSurroundingArea获取以飞行器为中心,50公里范围内到地理感知数据。MSDK 5.8.0开始支持
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | @NonNull | 返回执行结果的回调。 |
Related:
FlySafeTipEvent
Since MSDK 5.3.0飞行安全提示信息的事件枚举。
枚举成员
FlySafeTipInformation
Since MSDK 5.3.0class FlySafeTipInformation |
飞行安全提示信息类。包括提示信息的事件枚举和描述,高度限制以及限飞区信息。
FlySafeWarningEvent
Since MSDK 5.3.0飞行安全警告信息的事件枚举。
枚举成员
FlySafeWarningInformation
Since MSDK 5.3.0class FlySafeWarningInformation |
飞行安全警告信息类。包括警告信息的事件枚举和描述,高度限制以及限飞区信息。
FlySafeSeriousWarningEvent
Since MSDK 5.3.0飞行安全严重警告信息的事件枚举。
枚举成员
FlySafeSeriousWarningInformation
Since MSDK 5.3.0class FlySafeSeriousWarningInformation |
飞行安全严重警告信息类。包括严重警告信息的事件枚举和描述,自动降落倒计时,高度限制以及限飞区信息。
FlySafeReturnToHomeEvent
Since MSDK 5.3.0飞行安全返航信息的事件枚举。
枚举成员
| 名称 | 说明 |
|---|---|
NEAR_NO_FLY_ZONE | 接近禁飞区。返航可能会受到影响。请小心飞行。 |
CROSS_NO_FLY_ZONE | 当前返航路线将经过禁飞区。返航可能会失败,请注意飞行器位置。 |
FlySafeReturnToHomeInformation
Since MSDK 5.3.0class FlySafeReturnToHomeInformation |
飞行安全返航信息类。包括返航信息的事件枚举和描述。
FlySafeLicenseType
Since MSDK 5.3.0飞行安全许可证类型枚举。
枚举成员
| 名称 | 说明 |
|---|---|
GEO_UNLOCK | 地理解禁。 |
CIRCLE_UNLOCK_AREA | 圆形解禁。 |
COUNTRY_UNLOCK | 国家解禁。 |
PARAMETER_CONFIGURATION | 限高解禁。 |
PENTAGON_UNLOCK_AREA | 多边形解禁。 |
POWER_UNLOCK | 功率解禁。 |
RID_UNLOCK | RID解禁。 |
UNKNOWN | 未知。 |
FlyZoneType
Since MSDK 5.3.0限飞区类型。包括机场,公园,学校,体育馆等。
枚举成员
FlyZoneCategory
Since MSDK 5.3.0限飞区策略。包括禁飞区,授权区,警告区和加强警告区等。
枚举成员
| 名称 | 说明 |
|---|---|
WARNING | 警告区。 |
ENHANCED_WARNING | 加强警告区。 |
AUTHORIZATION | 授权区。 |
RESTRICTED | 禁飞区。 |
MultiPolygonFlyZoneInformation
Since MSDK 5.3.0class MultiPolygonFlyZoneInformation |
多边形限飞区信息。包含圆柱和多边形限飞区信息。
FlyZoneInformation
Since MSDK 5.3.0final class FlyZoneInformation |
限飞区信息类。包括限飞区ID,限飞区名称,限飞区类型,限飞区形状,限飞区策略等。
FlyZoneLicenseInfo
Since MSDK 5.3.0class FlyZoneLicenseInfo implements KeepProguard |
限飞区解禁证书类。包括解禁证书基本信息,比如证书类型,有效期,证书绑定的飞行器飞控SN,使能状态等。
FlySafeNotificationListener
Since MSDK 5.3.0interface FlySafeNotificationListener |
飞行安全通知的监听器。
FlySafeDatabaseListener
Since MSDK 5.8.0interface FlySafeDatabaseListener |
飞行安全数据库的监听器。
FlySafeDatabaseInfo
Since MSDK 5.8.0class FlySafeDatabaseInfo |
飞行安全数据库信息类。包括模块类型,更新模式,数据库名称,大小和导入时间。