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

      IUASRemoteIDManager

      无人机系统远程识别管理类。为了满足全球日渐规范的无人机监管诉求,飞行中的无人机需要具备通过无线电的方式向外广播无人机或者操作者的身份和位置信息的能力。

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

      无人机系统远程识别管理类。为了满足全球日渐规范的无人机监管诉求,飞行中的无人机需要具备通过无线电的方式向外广播无人机或者操作者的身份和位置信息的能力。

      MSDK 5.0.0开始支持

      成员

      45 个成员

      监听

      18

      方法

      12

      枚举

      4

      Class

      11

      国家区域码

      method

      setAreaCode

      Since MSDK 5.0.0
      IDJIError setAreaCode(AreaCode areaCode)

      设置国家区域码,设置了相应的国家区域码以后才能使用该国家或地区支持的无人机远程识别(RID)功能。

      目前支持的国家或地区列表和支持的功能列表如下:

    • 美国:无人机远程识别广播
    • 日本:无人机远程识别广播, 无人机注册码
    • 法国:EID开关

    • 注意:
      该接口从MSDK 5.3.0版本开始废弃。请调用setUASRemoteIDAreaStrategy代替此功能。


      MSDK 5.0.0开始支持

      参数

      名称类型说明
      areaCodeAreaCode 国家区域码

      返回值

      类型说明
      IDJIError返回设置国家区域码的执行结果。


      国家区域策略

      method

      setUASRemoteIDAreaStrategy

      Since MSDK 5.3.0
      IDJIError setUASRemoteIDAreaStrategy(AreaStrategy strategy)

      设置国家区域策略,设置了相应的国家区域策略以后才能使用该国家或地区支持的无人机远程识别(RID)功能。MSDK在获取到当前所在地区的国家区域码后,会默认设置相应的国家区域策略。如果你需要设置其他国家区域策略进行开发调试,可以调用此接口设置相应的国家区域码。

      目前支持的国家或地区列表和支持策略如下:

    • 美国:无人机远程识别广播
    • 欧盟:无人机远程识别广播, 欧盟认证C-Class, 操作者注册码
    • 新加坡:无人机远程识别广播, 操作者注册码
    • 阿联酋:无人机远程识别广播, 操作者注册码
    • 日本:无人机远程识别广播, 无人机注册码
    • 中国:无人机远程识别广播, 实名制
    • 法国:EID开关


    • MSDK 5.3.0开始支持

      参数

      名称类型说明
      strategyAreaStrategy 国家区域策略

      返回值

      类型说明
      IDJIError返回设置国家区域策略的执行结果。


      无人机远程识别广播

      method

      getUASRemoteIDStatus

      Since MSDK 5.0.0
      UASRemoteIDStatus getUASRemoteIDStatus()

      获取无人机系统远程识别(RID)广播状态。

      返回值

      类型说明
      UASRemoteIDStatus返回无人机系统远程识别状态。
      method

      addUASRemoteIDStatusListener

      Since MSDK 5.0.0
      void addUASRemoteIDStatusListener(UASRemoteIDStatusListener listener)

      添加无人机系统远程识别广播状态的监听器。

      参数

      名称类型说明
      listenerUASRemoteIDStatusListener 无人机系统远程识别广播状态的监听器
      method

      removeUASRemoteIDStatusListener

      Since MSDK 5.0.0
      void removeUASRemoteIDStatusListener(UASRemoteIDStatusListener listener)

      移除无人机系统远程识别广播状态的监听器。

      参数

      名称类型说明
      listenerUASRemoteIDStatusListener 无人机系统远程识别广播状态的监听器
      method

      clearUASRemoteIDStatusListener

      Since MSDK 5.0.0
      void clearUASRemoteIDStatusListener()

      移除所有无人机系统远程识别状态的监听器。


      EID开关

      method

      setElectronicIDEnabled

      Since MSDK 5.0.0
      void setElectronicIDEnabled(boolean isEnabled, @NonNull CommonCallbacks.CompletionCallback callback)

      开启或者关闭电子ID(EID)功能。开启此功能后,无人机会向外广播EID。
      EID是法国定义的一种电子ID标准,该值为无人机的飞控SN。1581F前缀则表示是DJI生产的无人机。对于非1581F开头的DJI飞控SN,需要把1581F拼在飞控SN前缀。例如:

    • 对于M300 RTK机型,该值为1581F+飞控SN(KeySerialNumber)+0
    • 对于M350 RTK,M30和M3E系列机型,该值为飞控SN(KeySerialNumber)


    • MSDK 5.0.0开始支持

      参数

      名称类型说明
      isEnabledboolean true表示开启EID功能。
      callback@NonNull CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      getElectronicIDEnabled

      Since MSDK 5.0.0
      void getElectronicIDEnabled(@NonNull CommonCallbacks.CompletionCallbackWithParam<Boolean> callback)

      获取EID是否开启。

      参数

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

      addElectronicIDStatusListener

      Since MSDK 5.0.0
      void addElectronicIDStatusListener(ElectronicIDStatusListener listener)

      添加EID状态的监听器。

      参数

      名称类型说明
      listenerElectronicIDStatusListener EID状态的监听器
      method

      removeElectronicIDStatusListener

      Since MSDK 5.0.0
      void removeElectronicIDStatusListener(ElectronicIDStatusListener listener)

      移除EID状态的监听器。

      参数

      名称类型说明
      listenerElectronicIDStatusListener EID状态的监听器
      method

      clearAllElectronicIDStatusListener

      Since MSDK 5.0.0
      void clearAllElectronicIDStatusListener()

      移除所有EID状态的监听器。


      无人机注册码

      method

      setUARegistrationNumber

      Since MSDK 5.0.0
      void setUARegistrationNumber(String number, @NonNull CommonCallbacks.CompletionCallback callback)

      设置无人机注册码。需要根据各国的无人机管制政策法规进行设置。

    • 日本无人机注册码申请入口: https://www.dips.mlit.go.jp,无人机注册码的格式为:{“registration_code”:“xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx”,“key_info”:“xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx”,“nonce_info”:“xxxxxxxxxxxx”},设置了无人机注册码以后,isBroadcastRemoteIdEnabled将会被开启。


    • MSDK 5.0.0开始支持

      参数

      名称类型说明
      numberString 无人机注册码信息。
      callback@NonNull CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      getUARegistrationNumber

      Since MSDK 5.0.0
      void getUARegistrationNumber(@NonNull CommonCallbacks.CompletionCallbackWithParam<String> callback)

      获取设置的无人机注册码。

      参数

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

      addUARegistrationNumberStatusListener

      Since MSDK 5.0.0
      void addUARegistrationNumberStatusListener(UARegistrationNumberStatusListener listener)

      添加无人机注册码状态的监听器。

      参数

      名称类型说明
      listenerUARegistrationNumberStatusListener 无人机注册码状态的监听器
      method

      removeUARegistrationNumberStatusListener

      Since MSDK 5.0.0
      void removeUARegistrationNumberStatusListener(UARegistrationNumberStatusListener listener)

      移除无人机注册码状态的监听器。

      参数

      名称类型说明
      listenerUARegistrationNumberStatusListener 无人机注册码状态的监听器
      method

      clearAllUARegistrationNumberStatusListener

      Since MSDK 5.0.0
      void clearAllUARegistrationNumberStatusListener()

      移除所有无人机注册码状态的监听器。


      欧盟认证C-Class

      method

      addCClassStatusListener

      Since MSDK 5.13.0
      void addCClassStatusListener(CClassStatusListener listener)

      添加欧盟认证C-Class状态的监听器。用于获取C-Class类型,详细描述请参阅:欧洲航空安全局

      参数

      名称类型说明
      listenerCClassStatusListener 欧盟认证C-Class状态的监听器
      method

      removeCClassStatusListener

      Since MSDK 5.13.0
      void removeCClassStatusListener(CClassStatusListener listener)

      移除欧盟认证C-Class状态的监听器。

      参数

      名称类型说明
      listenerCClassStatusListener 欧盟认证C-Class状态的监听器
      method

      clearAllCClassStatusListener

      Since MSDK 5.13.0
      void clearAllCClassStatusListener()

      移除所有欧盟认证C-Class状态的监听器。


      操作者注册码

      method

      setOperatorRegistrationNumber

      Since MSDK 5.8.0
      void setOperatorRegistrationNumber(String number,  @NonNull CommonCallbacks.CompletionCallback callback)

      设置操作者注册码。需要根据各国的无人机管制政策法规进行申请和设置。

    • 欧盟操作者注册码申请入口:https://www.easa.europa.eu/en/domains/civil-drones/naa,设置了操作者注册码以后,isBroadcastRemoteIdEnabled将会被开启。


    • MSDK 5.8.0开始支持

      参数

      名称类型说明
      numberString 操作者注册码信息。
      callback@NonNull CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      getOperatorRegistrationNumber

      Since MSDK 5.8.0
      void getOperatorRegistrationNumber(@NonNull CommonCallbacks.CompletionCallbackWithParam<String> callback)

      获取设置的操作者注册码。

      参数

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

      addOperatorRegistrationNumberStatusListener

      Since MSDK 5.8.0
      void addOperatorRegistrationNumberStatusListener(OperatorRegistrationNumberStatusListener listener)

      添加操作者注册码状态的监听器。

      参数

      名称类型说明
      listenerOperatorRegistrationNumberStatusListener 操作者注册码状态的监听器
      method

      removeOperatorRegistrationNumberStatusListener

      Since MSDK 5.8.0
      void removeOperatorRegistrationNumberStatusListener(OperatorRegistrationNumberStatusListener listener)

      移除操作者注册码状态的监听器。

      参数

      名称类型说明
      listenerOperatorRegistrationNumberStatusListener 操作者注册码状态的监听器
      method

      clearAllOperatorRegistrationNumberStatusListener

      Since MSDK 5.8.0
      void clearAllOperatorRegistrationNumberStatusListener()

      移除所有操作者注册码状态的监听器。


      实名制

      method

      addRealNameRegistrationStatusListener

      Since MSDK 5.8.0
      void addRealNameRegistrationStatusListener(RealNameRegistrationStatusListener listener)

      添加实名制状态的监听器。

      参数

      名称类型说明
      listenerRealNameRegistrationStatusListener 实名制状态的监听器
      method

      removeRealNameRegistrationStatusListener

      Since MSDK 5.8.0
      void removeRealNameRegistrationStatusListener(RealNameRegistrationStatusListener listener)

      移除实名制状态的监听器。

      参数

      名称类型说明
      listenerRealNameRegistrationStatusListener 实名制状态的监听器
      method

      clearAllRealNameRegistrationStatusListener

      Since MSDK 5.8.0
      void clearAllRealNameRegistrationStatusListener()

      移除所有实名制状态的监听器。

      method

      updateRealNameRegistrationStateFromUOM

      Since MSDK 5.8.0
      void updateRealNameRegistrationStateFromUOM(CommonCallbacks.CompletionCallback callback)

      从中国UOM系统上更新实名制状态到飞行器中。应中国大陆的无人驾驶航空器飞行管理条例要求,从2024年1月1日起,任何在此日期后购买激活的飞行无人机在中国大陆飞行,都需要在UOM系统上进行实名制登记,并且需要联网将实名制登记信息更新到无人机中,否则无人机将无法正常起飞。

    • 实名制登记入口:https://uom.caac.gov.cn/#/login,登记了实名制以后可以调用此接口将实名制状态更新到飞行器中。


    • MSDK 5.8.0开始支持

      参数

      名称类型说明
      callbackCommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      setRealNameTag

      Since MSDK 5.18.0
      void setRealNameTag(String tag, CommonCallbacks.CompletionCallback callback)

      设置民航实名制登记标志(后8位数字)。

      参数

      名称类型说明
      tagString 民航实名制登记标志(后8位数字)。
      callbackCommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      getRealNameTag

      Since MSDK 5.18.0
      void getRealNameTag(CommonCallbacks.CompletionCallbackWithParam<String> callback)

      读取民航实名制登记标志(后8位数字)。

      参数

      名称类型说明
      callbackCommonCallbacks.CompletionCallbackWithParam<String> 返回读取结果的回调。


      enum

      AreaStrategy

      Since MSDK 5.3.0

      无人机远程识别国家区域策略。

      枚举成员

      名称说明
      US_STRATEGY美国策略。
      FRANCE_STRATEGY法国策略。
      JAPAN_STRATEGY日本策略。
      EUROPEAN_STRATEGY欧盟策略。
      SINGAPORE_STRATEGY新加坡策略。
      UNITED_ARAB_EMIRATES_STRATEGY阿联酋策略。
      CHINA_STRATEGY中国策略。
      GEORGIA_STRATEGY格鲁吉亚策略。
      enum

      RemoteIdWorkingState

      Since MSDK 5.1.0

      无人机远程识别工作状态。

      枚举成员

      名称说明
      IDLE空闲,初始化状态。
      WORKING工作中,表示RID正在广播中。
      OPERATOR_LOCATION_LOST_ERROR未工作,因为操作者的位置丢失,导致RID未广播。
      FIRMWARE_ERROR未工作,因为固件错误,导致RID未广播。
      NO_BROADCAST未广播。
      NOT_SUPPORTED不支持。
      NOT_SUPPORTED未工作,因为未知错误,导致RID未广播。
      class

      UASRemoteIDStatus

      Since MSDK 5.0.0
      @Keep
      class UASRemoteIDStatus

      无人机远程识别状态。

      class

      UASRemoteIDStatusListener

      Since MSDK 5.0.0
      interface UASRemoteIDStatusListener

      无人机远程识别状态监听器。

      class

      ElectronicIDStatus

      Since MSDK 5.0.0
      class ElectronicIDStatus

      EID状态。

      class

      ElectronicIDStatusListener

      Since MSDK 5.0.0
      interface ElectronicIDStatusListener

      EID状态监听器。

      class

      UARegistrationNumberStatus

      Since MSDK 5.0.0
      class UARegistrationNumberStatus

      无人机注册码状态。

      class

      UARegistrationNumberStatusListener

      Since MSDK 5.0.0
      interface UARegistrationNumberStatusListener

      无人机注册码状态监听器。

      enum

      CClassStatus

      Since MSDK 5.13.0

      欧盟认证C-Class状态。

      枚举成员

      名称说明
      CCLASS_C0C0 类型。
      CCLASS_C1C1 类型。
      CCLASS_C2C2 类型。
      CCLASS_C3C3 类型。
      class

      CClassStatusListener

      Since MSDK 5.13.0
      interface CClassStatusListener

      欧盟认证C-Class状态监听器。

      class

      OperatorRegistrationNumberStatus

      Since MSDK 5.8.0
      class OperatorRegistrationNumberStatus implements KeepProguard

      操作者注册码状态。

      class

      OperatorRegistrationNumberStatusListener

      Since MSDK 5.8.0
      interface OperatorRegistrationNumberStatusListener

      操作者注册码状态监听器。

      class

      RealNameRegistrationStatus

      Since MSDK 5.8.0
      class RealNameRegistrationStatus

      实名制状态类。

      class

      RealNameRegistrationStatusListener

      Since MSDK 5.8.0
      interface RealNameRegistrationStatusListener

      实名制状态监听器。

      enum

      RealNameRegistrationState

      Since MSDK 5.8.0

      飞行器中的实名制状态。

      枚举成员

      名称说明
      NOT_AUTH未认证,飞行器将无法起飞。应中国大陆的无人驾驶航空器飞行管理条例要求,如需要在中国大陆飞行,请在UOM系统上进行实名制登记。 实名制登记入口:https://uom.caac.gov.cn/#/login,登记了实名制以后可以调用此接口将实名制状态更新到飞行器中。
      VAILD_AUTH已认证,飞行器可以正常起飞。
      CANCELLED未认证的情况下,UOM系统上的登记信息已注销,飞行器将无法起飞。应中国大陆的无人驾驶航空器飞行管理条例要求,如需要在中国大陆飞行,请在UOM系统上进行实名制登记。 实名制登记入口:https://uom.caac.gov.cn/#/login,登记了实名制以后可以调用此接口将实名制状态更新到飞行器中。
      NETWORK_ERROR网络错误。
      VERIFIED_AND_CANCLLED飞行器已认证后,UOM系统上的状态已注销,飞行器可以正常起飞。应中国大陆的无人驾驶航空器飞行管理条例要求,如需要在中国大陆飞行,请在UOM系统上进行实名制登记。 实名制登记入口:https://uom.caac.gov.cn/#/login,登记了实名制以后可以调用此接口将实名制状态更新到飞行器中。
      UNSUPPORTED飞行器不支持实名制功能。
      NOT_ACTIVE_YET飞行器未激活,请先用DJI官方APP激活。
      DONT_NEED_CHECK_REALNAME飞行器无需实名制。
      DONT_IN_CHINA_MAINLAND飞行器不在中国大陆。