DJI Mobile SDK Documentation

      class IUASRemoteIDManager

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

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

      MSDK 5.0.0开始支持

      类成员:

      国家区域码

      method setAreaCode
      IDJIError setAreaCode(AreaCode areaCode)
      包:dji.v5.manager.interfaces
      描述:

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

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

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

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


      MSDK 5.0.0开始支持

      输入参数:
      AreaCode areaCode国家区域码
      返回值:
      IDJIError返回设置国家区域码的执行结果。


      国家区域策略

      method setUASRemoteIDAreaStrategy
      IDJIError setUASRemoteIDAreaStrategy(AreaStrategy strategy)
      包:dji.v5.manager.interfaces
      描述:

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

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

    • 美国:无人机远程识别广播
    • 欧盟:无人机远程识别广播, 操作者注册码
    • 日本:无人机远程识别广播, 无人机注册码
    • 中国:实名制
    • 法国:EID开关


    • MSDK 5.3.0开始支持

      输入参数:
      AreaStrategy strategy国家区域策略
      返回值:
      IDJIError返回设置国家区域策略的执行结果。


      无人机远程识别广播

      method getUASRemoteIDStatus
      UASRemoteIDStatus getUASRemoteIDStatus()
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.0.0开始支持

      返回值:
      UASRemoteIDStatus返回无人机系统远程识别状态。
      method addUASRemoteIDStatusListener
      void addUASRemoteIDStatusListener(UASRemoteIDStatusListener listener)
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.0.0开始支持

      输入参数:
      UASRemoteIDStatusListener listener无人机系统远程识别广播状态的监听器
      method removeUASRemoteIDStatusListener
      void removeUASRemoteIDStatusListener(UASRemoteIDStatusListener listener)
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.0.0开始支持

      输入参数:
      UASRemoteIDStatusListener listener无人机系统远程识别广播状态的监听器
      method clearUASRemoteIDStatusListener
      void clearUASRemoteIDStatusListener()
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.0.0开始支持


      EID开关

      method setElectronicIDEnabled
      void setElectronicIDEnabled(boolean isEnabled, @NonNull CommonCallbacks.CompletionCallback callback)
      包:dji.v5.manager.interfaces
      描述:

      开启或者关闭电子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开始支持

      输入参数:
      boolean isEnabledtrue表示开启EID功能。
      @NonNull CommonCallbacks.CompletionCallback callback返回执行结果的回调。
      method getElectronicIDEnabled
      void getElectronicIDEnabled(@NonNull CommonCallbacks.CompletionCallbackWithParam<Boolean> callback)
      包:dji.v5.manager.interfaces
      描述:

      获取EID是否开启。

      MSDK 5.0.0开始支持

      输入参数:
      @NonNull CommonCallbacks.CompletionCallbackWithParam<Boolean> callback返回执行结果的回调。
      method addElectronicIDStatusListener
      void addElectronicIDStatusListener(ElectronicIDStatusListener listener)
      包:dji.v5.manager.interfaces
      描述:

      添加EID状态的监听器。

      MSDK 5.0.0开始支持

      输入参数:
      ElectronicIDStatusListener listenerEID状态的监听器
      method removeElectronicIDStatusListener
      void removeElectronicIDStatusListener(ElectronicIDStatusListener listener)
      包:dji.v5.manager.interfaces
      描述:

      移除EID状态的监听器。

      MSDK 5.0.0开始支持

      输入参数:
      ElectronicIDStatusListener listenerEID状态的监听器
      method clearAllElectronicIDStatusListener
      void clearAllElectronicIDStatusListener()
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.0.0开始支持


      无人机注册码

      method setUARegistrationNumber
      void setUARegistrationNumber(String number, @NonNull CommonCallbacks.CompletionCallback callback)
      包:dji.v5.manager.interfaces
      描述:

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

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


    • MSDK 5.0.0开始支持

      输入参数:
      String number无人机注册码信息。
      @NonNull CommonCallbacks.CompletionCallback callback返回执行结果的回调。
      method getUARegistrationNumber
      void getUARegistrationNumber(@NonNull CommonCallbacks.CompletionCallbackWithParam<String> callback)
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.0.0开始支持

      输入参数:
      @NonNull CommonCallbacks.CompletionCallbackWithParam<String> callback返回执行结果的回调。
      method addUARegistrationNumberStatusListener
      void addUARegistrationNumberStatusListener(UARegistrationNumberStatusListener listener)
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.0.0开始支持

      输入参数:
      UARegistrationNumberStatusListener listener无人机注册码状态的监听器
      method removeUARegistrationNumberStatusListener
      void removeUARegistrationNumberStatusListener(UARegistrationNumberStatusListener listener)
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.0.0开始支持

      输入参数:
      UARegistrationNumberStatusListener listener无人机注册码状态的监听器
      method clearAllUARegistrationNumberStatusListener
      void clearAllUARegistrationNumberStatusListener()
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.0.0开始支持


      操作者注册码

      method setOperatorRegistrationNumber
      void setOperatorRegistrationNumber(String number,  @NonNull CommonCallbacks.CompletionCallback callback)
      包:dji.v5.manager.interfaces
      描述:

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

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


    • MSDK 5.8.0开始支持

      输入参数:
      String number操作者注册码信息。
      @NonNull CommonCallbacks.CompletionCallback callback返回执行结果的回调。
      method getOperatorRegistrationNumber
      void getOperatorRegistrationNumber(@NonNull CommonCallbacks.CompletionCallbackWithParam<String> callback)
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.8.0开始支持

      输入参数:
      @NonNull CommonCallbacks.CompletionCallbackWithParam<String> callback返回执行结果的回调。
      method addOperatorRegistrationNumberStatusListener
      void addOperatorRegistrationNumberStatusListener(OperatorRegistrationNumberStatusListener listener)
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.8.0开始支持

      输入参数:
      OperatorRegistrationNumberStatusListener listener操作者注册码状态的监听器
      method removeOperatorRegistrationNumberStatusListener
      void removeOperatorRegistrationNumberStatusListener(OperatorRegistrationNumberStatusListener listener)
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.8.0开始支持

      输入参数:
      OperatorRegistrationNumberStatusListener listener操作者注册码状态的监听器
      method clearAllOperatorRegistrationNumberStatusListener
      void clearAllOperatorRegistrationNumberStatusListener()
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.8.0开始支持


      实名制

      method addRealNameRegistrationStatusListener
      void addRealNameRegistrationStatusListener(RealNameRegistrationStatusListener listener)
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.8.0开始支持

      输入参数:
      RealNameRegistrationStatusListener listener实名制状态的监听器
      method removeRealNameRegistrationStatusListener
      void removeRealNameRegistrationStatusListener(RealNameRegistrationStatusListener listener)
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.8.0开始支持

      输入参数:
      RealNameRegistrationStatusListener listener实名制状态的监听器
      method clearAllRealNameRegistrationStatusListener
      void clearAllRealNameRegistrationStatusListener()
      包:dji.v5.manager.interfaces
      描述:

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

      MSDK 5.8.0开始支持

      method updateRealNameRegistrationStateFromUOM
      void updateRealNameRegistrationStateFromUOM( CommonCallbacks.CompletionCallback callback)
      包:dji.v5.manager.interfaces
      描述:

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

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


    • MSDK 5.8.0开始支持

      输入参数:
      CommonCallbacks.CompletionCallback callback返回执行结果的回调。


      enum AreaStrategy
      enum AreaStrategy
      包:dji.v5.manager.aircraft.uas
      描述:

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

      MSDK 5.3.0开始支持

      Enum Members:
      US_STRATEGY美国策略。
      FRANCE_STRATEGY法国策略。
      JAPAN_STRATEGY日本策略。
      EUROPEAN_STRATEGY欧盟策略。
      CHINA_STRATEGY中国策略。
      Class Members:
      enum RemoteIdWorkingState
      enum RemoteIdWorkingState
      包:dji.v5.manager.aircraft.uas
      描述:

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

      MSDK 5.1.0开始支持

      Enum Members:
      IDLE空闲,初始化状态。
      WORKING工作中,表示RID正在广播中。
      OPERATOR_LOCATION_LOST_ERROR未工作,因为操作者的位置丢失,导致RID未广播。
      FIRMWARE_ERROR未工作,因为固件错误,导致RID未广播。
      NO_BROADCAST未广播。
      NOT_SUPPORTED不支持。
      NOT_SUPPORTED未工作,因为未知错误,导致RID未广播。
      Class Members:
      enum RealNameRegistrationState
      enum RealNameRegistrationState implements JNIProguardKeepTag
      包:dji.sdk.keyvalue.value.flightcontroller
      描述:

      飞行器中的实名制状态。

      MSDK 5.8.0开始支持

      Enum Members:
      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飞行器不在中国大陆。
      Class Members: