chenglongsheng/mobile-sdk-android-v5

MSDK V5 Sample

DJI Mobile SDK for Android V5 Latest Version 5.5.0

中文版

What is DJI Mobile SDK V5?

DJI Mobile SDK V5 has a series of APIs to control the software and hardware interfaces of an aircraft. We provide an open source production sample and a tutorial for developers to develop a more competitive drone solution on mobile device. This improves the experience and efficiency of MSDK App development.

Supported Product:

• DJI Mini3 Pro
• DJI Mini3
• Mavic 3 Enterprise Series
• M30 Series
• M300 RTK
• Matrice 350 RTK

Project Directory Introduction

├── Docs
│   ├── API-Diff
│   │   ├── 5.0.0_5.1.0_android_diff.html
│   │   ├── 5.0.0_beta2_5.0.0_beta3_android_diff.html
│   │   ├── 5.0.0_beta3_5.0.0_android_diff.html
│   │   ├── 5.1.0_5.2.0_android_diff.html
│   │   ├── 5.2.0_5.3.0_android_diff.html
│   │   └── 5.4.0_5.5.0_android_diff.html
│   └── Android_API
│       ├── cn
│       └── en
├── LICENSE.txt
├── README.md
├── README_CN.md
└── SampleCode-V5
    ├── android-sdk-v5-as
    ├── android-sdk-v5-sample
    │   ├── app-aircraft
    │   ├── module-aircraft
    │   └── module-common
    └── android-sdk-v5-uxsdk

API Difference

• 5.4.0_5.5.0_android_diff.html
• 5.2.0_5.3.0_android_diff.html
• 5.1.0_5.2.0_android_diff.html
• 5.0.0_5.1.0_android_diff.html
• 5.0.0_beta3_5.0.0_android_diff
• 5.0.0_beta2_5.0.0_beta3_android_diff

Software License

The DJI Android SDK is dynamically linked with unmodified libraries of FFmpeg licensed under the LGPLv2.1. The source code of these FFmpeg libraries, the compilation instructions, and the LGPL v2.1 license are provided in Github. The DJI Sample Code V5 in this repo is offered under MIT License.

Sample Explanation

Sample can be divided into three parts:

• Basic module: Provides basic operation of every poduct package.
• Scenographic Sample: Provides scenographic sample support of aircraft.
• App Module: Offer an Airplane App.

For detailed configuration, please refer to settings.gradle.

Basic module:

• sample-module-common: Common code for sample.
• sample-module-aircraft: Unique code of aircraft App, which depends on sample-module-common.

Scenographic Sample：

• uxsdk: Scenographic Sample. Currently only aircraft(dji-sdk-v5-aircraft) are supported.

App module:

• sample-app-aircraft：Compile aircraft App, which depends on sample-module-aircraft, uxsdk.

Integration

For further detail on how to integrate the DJI Android SDK into your Android Studio project, please check the tutorial:

• Notice of Run MSDK

AAR Explanation

Notice: sdkVersion = 5.5.0

SDK package	Explanation	How to use
dji-sdk-v5-aircraft	Aircraft main package, which provides support for MSDK to control the aircraft.	implementation 'com.dji:dji-sdk-v5-aircraft:{sdkVersion}'
dji-sdk-v5-aircraft-provided	Aircraft compilation package, which provides interfaces related to the aircraft package.	compileOnly 'com.dji:dji-sdk-v5-aircraft-provided:{sdkVersion}'
dji-sdk-v5-networkImp	Network library package, which provides network connection ability for MSDK. Without this dependency, all network functions of MSDK will not work, but the interfaces of hardware control can be used normally.	runtimeOnly 'com.dji:dji-sdk-v5-networkImp:{sdkVersion}'

• If only the aircraft product is in need to support, please use:

  implementation 'com.dji:dji-sdk-v5-aircraft:{sdkVersion}'
  compileOnly 'com.dji:dji-sdk-v5-aircraft-provided:{sdkVersion}'

• If the MSDK have to use network(required by default), please use:

  runtimeOnly 'com.dji:dji-sdk-v5-networkImp:{sdkVersion}'

Support

You can get support from DJI with the following method:

• Post questions in DJI Developer Forums: DEVELOPER SUPPORT

Join Us

DJI is looking for all kinds of Software Engineers to continue building the Future of Possible. Available positions in Shenzhen, China and around the world. If you are interested, please:

• send your resume to [email protected].

For more details, and list of all our global offices, please check https://we.dji.com/jobs_en.html.