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

      ISDKManager

      此类是MSDK入口管理类,用于初始化和注册MSDK,提供设备连接和设备信息获取等功能。

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

      此类是MSDK入口管理类,用于初始化和注册MSDK,提供设备连接和设备信息获取等功能。

      MSDK 5.0.0开始支持

      成员

      15 个成员

      方法

      7

      枚举

      3

      Class

      5
      method
      method

      init

      Since MSDK 5.20.1
      void init(Context context, InitSettings settings, @NonNull SDKManagerCallback callback)

      MSDK初始化,进行MSDK内部模块初始化操作,初始化完成以后, 需要调用registerApp进行MSDK注册操作。

      注意

      MSDK会一直持有SDKManagerCallback对象的强引用,请勿让SDKManagerCallback去持有程序中短生命周期的对象,比如Activity和Fragment,否则会存在内存泄露问题。

      参数

      名称类型说明
      contextContext 应用的Context实例。
      settingsInitSettings 初始化配置。
      callback@NonNull SDKManagerCallback 返回执行结果的回调。
      method
      method

      init

      已废弃Since MSDK 5.0.0
      @Deprecated
      void init(Context context, @NonNull SDKManagerCallback callback)

      已废弃,建议使用5.20.0新增 init。 MSDK初始化,进行MSDK内部模块初始化操作,初始化完成以后, 需要调用registerApp进行MSDK注册操作。

      注意

      MSDK会一直持有SDKManagerCallback对象的强引用,请勿让SDKManagerCallback去持有程序中短生命周期的对象,比如Activity和Fragment,否则会存在内存泄露问题。

      参数

      名称类型说明
      contextContext 应用的Context实例。
      callback@NonNull SDKManagerCallback 返回执行结果的回调。
      method

      isRegistered

      Since MSDK 5.0.0
      boolean isRegistered()

      获取MSDK注册状态。true表示MSDK已经注册成功。

      返回值

      类型说明
      booleantrue表示MSDK已经注册成功。
      method
      method

      destroy

      Since MSDK 5.0.0
      void destroy()

      释放MSDK对资源的占有,释放后,所有回调接口都不会再收到系统的任何事件更新。注意:init和destroy需要在App中成对出现。

      method

      registerApp

      Since MSDK 5.0.0
      void registerApp()

      MSDK注册,MSDK通过互联网连接DJI服务器验证开发者在官网申请的App KEY。本方法需要在onInitProcess方法中返回INITIALIZE_COMPLETE事件后开始调用,无论是注册成功还是注册失败都会在SDKManagerCallback中返回,成功注册后MSDK会自动开始连接硬件产品,如果硬件产品连接成功,会回调onProductConnect方法。

      注意

      1. 如果开发者在registerApp之前使用离线License文件方式开启LDM,将无需联网就可以完成注册操作。
      2. 如果使用联网下载License文件的方式开启LDM,则需要在enableLDM传入MSDK_INIT_AND_REGISTRATION,才能通过互联网连接DJI服务器验证App KEY,完成注册流程。
      3. MSDK注册成功以后,会把注册信息缓存在本地,再次启动MSDK的时候,MSDK会校验本地的缓存信息完成注册流程,无需连接互联网,直到应用重新安装后才需要重新进行联网注册操作来完成注册流程。

      method

      getSDKVersion

      Since MSDK 5.0.0
      String getSDKVersion()

      获取MSDK的版本号。

      返回值

      类型说明
      String返回MSDK版本号。
      method

      getProductCategory

      Since MSDK 5.0.0
      PackageProductCategory getProductCategory()

      获取MSDK包的类型。

      返回值

      类型说明
      PackageProductCategory返回MSDK类型。
      enum

      PackageProductCategory

      Since MSDK 5.0.0

      MSDK包的类型。

      枚举成员

      名称说明
      AIRCRAFT飞行器类型,此MSDK包只包含MSDK支持的飞行器设备。
      HANDHELD手持类型,此MSDK包只包含MSDK支持的手持设备。
      ALL所有类型,此MSDK包包含MSDK支持的所有设备。
      class

      SDKManagerCallback

      Since MSDK 5.0.0
      interface SDKManagerCallback

      SDKManager回调类。

      class

      InitSettings

      Since MSDK 5.20.1
      class InitSettings

      MSDK初始化参数。

      enum

      SDKLinKMode

      Since MSDK 5.20.1

      MSDK链路模式。

      枚举成员

      名称说明
      LOCAL本地模式。
      REMOTE_PILOT远端Pilot模式。
      class

      PluginAPPConfig

      Since MSDK 5.20.1
      @Keep
      class PluginAPPConfig implements Parcelable

      插件APP信息配置。

      enum

      ServerState

      Since MSDK 5.20.1

      与远端服务的连接状态。

      枚举成员

      名称说明
      UNINITIALIZED服务未初始化。
      CONNECTED已连接服务。
      DISCONNECT服务已断开。
      INCOMPATIBLE服务版本不兼容。
      class

      APPVersion

      Since MSDK 5.20.1
      class APPVersion implements Parcelable

      APP版本信息。

      class

      OpenLocation

      Since MSDK 5.20.1
      @Keep
      class OpenLocation implements Parcelable

      开放地理位置信息,包含纬度、经度和高度数据。