| 包: | dji.v5.manager.interfaces |
classSince MSDK 5.0.0
ISDKManager
此类是MSDK入口管理类,用于初始化和注册MSDK,提供设备连接和设备信息获取等功能。
描述:
method
method
init
Since MSDK 5.20.1void init(Context context, InitSettings settings, @NonNull |
MSDK初始化,进行MSDK内部模块初始化操作,初始化完成以后, 需要调用registerApp进行MSDK注册操作。
注意
MSDK会一直持有
MSDK会一直持有
SDKManagerCallback对象的强引用,请勿让SDKManagerCallback去持有程序中短生命周期的对象,比如Activity和Fragment,否则会存在内存泄露问题。参数
| 名称 | 类型 | 说明 |
|---|---|---|
context | Context | 应用的Context实例。 |
settings | InitSettings | 初始化配置。 |
callback | @NonNull | 返回执行结果的回调。 |
method
method
init
已废弃Since MSDK 5.0.0@Deprecated |
已废弃,建议使用5.20.0新增 。 MSDK初始化,进行MSDK内部模块初始化操作,初始化完成以后, 需要调用initregisterApp进行MSDK注册操作。
注意
MSDK会一直持有
MSDK会一直持有
SDKManagerCallback对象的强引用,请勿让SDKManagerCallback去持有程序中短生命周期的对象,比如Activity和Fragment,否则会存在内存泄露问题。参数
| 名称 | 类型 | 说明 |
|---|---|---|
context | Context | 应用的Context实例。 |
callback | @NonNull | 返回执行结果的回调。 |
method
method
isRegistered
Since MSDK 5.0.0boolean isRegistered() |
获取MSDK注册状态。true表示MSDK已经注册成功。
返回值
| 类型 | 说明 |
|---|---|
boolean | true表示MSDK已经注册成功。 |
method
method
destroy
Since MSDK 5.0.0void destroy() |
释放MSDK对资源的占有,释放后,所有回调接口都不会再收到系统的任何事件更新。注意:init和destroy需要在App中成对出现。
method
method
registerApp
Since MSDK 5.0.0void registerApp() |
MSDK注册,MSDK通过互联网连接DJI服务器验证开发者在官网申请的App KEY。本方法需要在onInitProcess方法中返回INITIALIZE_COMPLETE事件后开始调用,无论是注册成功还是注册失败都会在SDKManagerCallback中返回,成功注册后MSDK会自动开始连接硬件产品,如果硬件产品连接成功,会回调onProductConnect方法。
注意
1. 如果开发者在
2. 如果使用联网下载License文件的方式开启LDM,则需要在
3. MSDK注册成功以后,会把注册信息缓存在本地,再次启动MSDK的时候,MSDK会校验本地的缓存信息完成注册流程,无需连接互联网,直到应用重新安装后才需要重新进行联网注册操作来完成注册流程。
1. 如果开发者在
registerApp之前使用离线License文件方式开启LDM,将无需联网就可以完成注册操作。 2. 如果使用联网下载License文件的方式开启LDM,则需要在
enableLDM传入MSDK_INIT_AND_REGISTRATION,才能通过互联网连接DJI服务器验证App KEY,完成注册流程。 3. MSDK注册成功以后,会把注册信息缓存在本地,再次启动MSDK的时候,MSDK会校验本地的缓存信息完成注册流程,无需连接互联网,直到应用重新安装后才需要重新进行联网注册操作来完成注册流程。
method
method
getSDKVersion
Since MSDK 5.0.0String getSDKVersion() |
获取MSDK的版本号。
返回值
| 类型 | 说明 |
|---|---|
String | 返回MSDK版本号。 |
method
method
getProductCategory
Since MSDK 5.0.0PackageProductCategory getProductCategory() |
获取MSDK包的类型。
返回值
| 类型 | 说明 |
|---|---|
PackageProductCategory | 返回MSDK类型。 |
Related:
enum
PackageProductCategory
Since MSDK 5.0.0MSDK包的类型。
枚举成员
| 名称 | 说明 |
|---|---|
AIRCRAFT | 飞行器类型,此MSDK包只包含MSDK支持的飞行器设备。 |
HANDHELD | 手持类型,此MSDK包只包含MSDK支持的手持设备。 |
ALL | 所有类型,此MSDK包包含MSDK支持的所有设备。 |
class
class
SDKManagerCallback
Since MSDK 5.0.0interface SDKManagerCallback |
SDKManager回调类。
class
class
InitSettings
Since MSDK 5.20.1class InitSettings |
MSDK初始化参数。
enum
class
class
PluginAPPConfig
Since MSDK 5.20.1@Keep |
插件APP信息配置。
enum
enum
ServerState
Since MSDK 5.20.1与远端服务的连接状态。
枚举成员
| 名称 | 说明 |
|---|---|
UNINITIALIZED | 服务未初始化。 |
CONNECTED | 已连接服务。 |
DISCONNECT | 服务已断开。 |
INCOMPATIBLE | 服务版本不兼容。 |
class
class
APPVersion
Since MSDK 5.20.1class APPVersion implements Parcelable |
APP版本信息。
class
class
OpenLocation
Since MSDK 5.20.1@Keep |
开放地理位置信息,包含纬度、经度和高度数据。