概述
一般而言，对接大疆的无人机的目标有如下方面：
- 获取无人机飞行过程中的及时画面，用来直播
- 获取飞机飞行数据（如及时高度，及时经纬度，及时飞机姿态等）
- 获取飞机静态数据（如飞机基本信息、飞行纪录、电池信息等）
- 操控飞机飞行（如起飞、降落，改变高度，操作操控杆，设定航飞任务，照相，录视频等）
- 媒体管理（下载飞机纪录内存卡中的文件等）
- 其它业务功能开辟（如态势感知，固件升级，多飞机会合管控等）
至于应用场景，那就太广泛了，如消防、测绘、林业等等，可以赋能各行各业。
从开辟者官网可以看到对接方式有如下：
- 应用开辟：MobileSDK，UXSDK，WindowsSDK
- 设备开辟：PayloadSDK，EdgeSDK，OnBoardSDK
- 云开辟：大疆智图API，上云API
- 私有化服务：4G私有化增强图传服务
其中有些已颠末时，停止维护（如WindowsSDK，IOSSDK，OnBoardSDK），本文着重先容MobileSDK和上云API，MobileSDK也仅仅围绕Android，因为IOS版本已经废弃。
大疆无人机的构成由飞机和遥控器组成，对接大疆的无人机本质是对接遥控器，因为无人机和遥控器通信是私有协议而且是近场通信，官方叫法是“图传”。大致的流程如下：
飞机 <—> 遥控器 <—> 三方平台
其中：
- 飞机和遥控器是私有协议进行近场通信
- 遥控器和三方平台是IP链路进行通信，遥控器中有一个定制版的安卓体系
- 三方平台指非大疆软件体系，即对接方体系
别的，另有一个叫大疆机场（dock）的产品，它是一个硬件产品，顾名思义就是用来停放飞机的，一个机场对应一个飞机。那么这种情况下游程就变成了：
飞机 <—> 机场（dock） <—> 三方平台
MSDK对接
MSDK简介
Mobile SDK是一款软件开辟套件，旨在让开辟者可以或许访问DJI无人机和手持相机产品的丰富功能。该SDK通过分身更底层的功能，诸如飞行稳固，电池管理，信号传输和通信等，简化了应用程序开辟的过程。如许，开辟者就不必要具备丰富的呆板人或嵌入式体系背景知识，而可以专注于DJI产品相干的行业应用开辟。适用于基于android和ios的应用软件集成，目标是利用android/ios应用软件控制飞行器；获取飞行器数据（视频、图片、传感器数据）。移动应用、飞机遥控器、飞机的连接方式如下：
MSDK集成步骤
● sdk版本：V4和V5不兼容，自20220321开始主推V5，V4将封存仅修改严峻bug
● V5仅支持android，必要android studio IDE
● 申请appkey：https://developer.dji.com/user/apps/#all
● 将官方Sample 跑起来：用来学习和理解（github地点：https://github.com/dji-sdk/Mobile-SDK-Android-V5）
● 将MSDK集成到自己的android项目中
● 编写代码和MSDK的接口进行交互
● 打包成APK，安装到遥控器上面利用
● APK可以通过ip链路和私有云服务交互
直播推流
- V4\V5不可以背景推流，当前页面必须有Surface画面渲染，不得最小化，跳转页面。
- V5支持RTMP（不支持RTMPS）、国标GB28181、RTSP和Agora声网（WebRTC），V4仅支持RTMP
- 直播协议设置
- RTMP，必要setUrl。
- GB28181，必要setServerIP，setServerPort，setServerID，setAgentID，setPassword，setLocalPort和setChannel。
- RTSP，必要setUserName，setPassword和setPort（必要设置为8554）。
- Agora，必要setChannelId，setUid，setToken和enableSafety。
- 拓展：本身DJI的H.264码流中的SEI字段在行业版V3固件以前是空的，在V3固件之后添加了信息，由于维护资本等诸多因素，我们不对外开放DJI的H.264码流的SEI的剖析。我们相识到有的用户希望在H.264码流中的SEI中剖析出无人机的地理位置和姿态信息，我们提供了更好的办理方案。
- 假如你利用Mobile SDK与私有云连接，你可以通过Mobile SDK的接口获取这些信息通过移动设备的网络传输到私有云平台。
- 假如你利用DJI Pilot 2与私有云连接，你可以通过上云API将这些信息通过移动设备的网络传输到私有云平台。
获取飞机及时数据
- 通过KeyAircraftLocation3D可以获取飞行器的三维坐标，坐标系为WGS84，高度为相对起飞点高度。
- 通过KeyAircraftAttitude和KeyAircraftVelocity可以获取飞行器的姿态和速率，坐标系为NED。
- 通过KeyTakeoffLocationAltitude可以获取起飞点的海拔高度，该数据不准确。
- 通过KeyUltrasonicHeight可以获取飞行器底部的超声波模块的测距高度
- 调用KeyStartTakeoff将使飞行器起飞。
- 调用KeyStartAutoLanding将开始降落，飞行器降落到离地0.7米左右悬停。此时KeyIsLandingConfirmationNeeded将变为true，调用KeyConfirmLanding确认最终降落。
UX SDK
仅适用于android，ios，旨在加快移动应用的开辟，提供了UI元素及开箱即用的组件。UXSDK实际上是利用MSDK的接口封装出来的具备MSDK功能的UI控件，所以它同样依赖MSDK。
制作UXSDK的目标是为了缩短开辟者开辟MSDK相干app的开辟周期，通过我们预先制作好的控件，可以让开辟者快速地开辟出类似DJI Pilot的app。UXSDK 4.X，这个版本的UXSDK利用了很多MSDK内部（未开放）的方法，所以这个版本的UXSDK无法开源，由于UI控件无法做到高度的定制化，所以只能给啥用啥，4.16将会成为它的最后一个版本，后续再发版本只会发4.16.X的维护版本。
UXSDK 5.X，这个版本的UXSDK会被设置为开源版本，它将利用MSDK 5.X版本的所有对外接口、Key来实现。未来我们也会持续更新UXSDK 5.X版本，为其提供更加丰富的控件，由于其为开源版本，欢迎开辟者对其进行定制化大概制作新的UI控件更新到公共社区。
UXSDK V5将会以开源框架的情势存在于官方Sample中，以后不再有UXSDK V5这个概念存在，开辟者可以在MSDK V5的官方Sample中看到一个开源的类似DJI Pilot 2的UI开源框架。
上云API
上云API简介
DJI 上云 API 主要是采用业界通用的 MQTT、HTTPS 和 WebSocket 协议，把飞机的本领抽象成物联网设备的物模子，开辟者可以很方便的基于这个物模子进行业务开辟，同时不用去关心飞机本身复杂的飞行控制问题。此外，上云 API 内置到 DJI Pilot 2 和大疆机场中，开辟者无需重新开辟 App，即可把无人机接入云平台。
业务架构图
目前对于 DJI 无人机接入第三方云平台，主要是基于 MSDK 开辟定制 App，然后自己界说私有上云通信协议连接到云平台中。如许对于核心业务是开辟云平台，无人机只是其中一个接入硬件设备的开辟者来说，重新基于 MSDK 开辟 App 工作量大、资本高，同时还必要花很多精神在无人机功能接口适配上，从而导致团体的方案开辟进度较为痴钝。
上云 API 的推出主要期望办理开辟者重新造轮子的苦恼。对于没有 App 深度定制需求的开辟者，直接可以采用 DJI Pilot 2 来和云平台通信，使开辟商可以更加专注于上云业务接口的开辟与实现。
软件架构图
上云API主要用来对接专业级、行业级无人机，消费级无人机并不支持，机型支持如下：
上云API对接步骤
- 类型：目前有两种方式可以和三方云进行对接，第一个是pilot2，它是遥控器上面的一个安卓程序；第二个是dock，它是大疆机场。
- 信息传递流程为：飞机—>网关（带pilot2的遥控器 or 机场）—>三方云
- 环境清单；
- 前端（ts，vue，websocker,linux，高德地图开放平台js api）
- 后端（java，mysql，mqtt，redis，websocket）；
- 版本（java >=11,mysql8.0.26，EMQX4.4.0，redis6.2，nginx1.20.2，vue3.0.5，nodejs17.8）；
- docker可选
- 在大疆开辟者网站注册成为开辟者（https://developer.dji.com/cn/user/apps/#all）
- 在大疆开辟者网站创建应用，拿到API交互所需的APP ID、APP 秘钥、APP License
- 将官方Sample 跑起来：用来学习和理解（github地点：https://github.com/dji-sdk/Cloud-API-Demo-Web，https://github.com/dji-sdk/ DJI-Cloud-API-Demo）
- 开辟三方云平台（登录页面；http服务；mqtt服务；推拉流服务等）
- 在pilot中配置第三方云平台登录地点，并登录，token会存储到pilot中
- 在pilot中配置其它第三方云平台的信息
- pilot和第三方云进行数据的传输和业务功能的处理；dock和第三方云进行数据的传输和业务功能的处理
- pilot程序退出大概飞机下线，断开和第三方云的链接
- 目前一个机场只能用一个飞机，当飞机下线后，dock和三方云平台的链接也将终止
Pilot上云
Pilot怎么安装
Pilot2 不提供单独的安装包，无法单独获取安装包，只能通过升级固件安装Pilot。目前Pilot2 不提供单独的安装包，必要升级遥控器固件到指定的版本，遥控器固件中提供了内置的安装包。假如升级了遥控器，但是Pilot2 没有升级，必要进入遥控器的设置，手动卸载当前Pilot2 版本。升级方式：通过上方下载地点下载离线安装包进行离线升级，通过调参软件DJI Assistant 2(行业系列)升级对应的遥控器固件版本。
配置三方云平台地点
如下图所示，在DJI Pilot 2的主页面云服务栏目中有“开放平台”入口，然后在开放平台页面中输入访问的URL链接即可发起连接。由于初次请求H5页面，并没有Token信息，所以必要服务器端开辟一个H5登录页面，DJI Pilot 2在每次配置完访问链接，都先去拉取该页面，然后后续的获取Token动作均由该H5页面完成
直播
仅关注 DJI PILOT 交互流程，先不用理会“机场”交互流程，机场的交互流程下面会详细讲
获取飞机数据
Dock上云
Dock上云简介
机场上云必要借助遥控器内安装的 DJI Pilot 2。如下图示，开辟者可按照 Pilot 内的指示一步步操作完成上云。在上云过程中，必要完成设备的查抄（如急停按钮的查抄、网络是否已经连接等）、将飞行器与机场对频、填写上云配置信息（如填写 MQTT 账号暗码以实现 MQTT 连接）等操作。
目前一个机场只能用一个飞机
dock上云必要先通过Pilot2配置三方云平台登录界面，登录完成后拿到了三方云平台信息（mqtt服务地点，流媒体服务地点等），这些信息下发到dock，后续dock和三方云平台进行交互。
直播方案
直播功能主要是把无人机相机负载和大疆机场的监控视频码流发给第三方云平台进行播放，用户可以方便的在远程web页面点击直播。直播功能支持直播的开始、停止、清晰度设置、镜头切换。第三方云平台必要预先部署MQTT网关以及流媒体服务器，DJI推流协议支持 Agora/RTMP/GB28181 等模式，其中MQTT网关主要用来做消息通信，配置信息设置和读取。
设备管理
设备管理功能支持设备向云端上报拓扑信息、推送设备属性、以及云端对设备的属性进行设置。让用户可以在云端查看以及调整设备状态，更为方便地睁开工作。mqtt协议进行通信，通过此方式三方云平台可以获取到飞机的及时经纬度高度，云台三个角度等数据。
其中设备属性中可以获取到高度、云台三个角度信息、飞机三个角度信息、经纬度等，详见：https://developer.dji.com/doc/cloud-api-tutorial/cn/api-reference/dock-to-cloud/mqtt/aircraft/properties.html
怎样对接多个飞机
- 上云api：每一个飞机都通过各自的网关（Pilot2app大概dock）连接到三方云平台
- MSDK：每一个飞机都通过与之配对的遥控器中的app（此app由非大疆公司开辟）和私有云服务连接
- 对接现成的平台：大疆司空2平台（目前为公有云产品无法私有化部署）；已经实现了GBT28181的平台
引用
- 大疆开辟者平台：https://developer.dji.com/cn/
- 开辟者支持中央：https://sdk-forum.dji.net/hc/zh-cn
- 在线客服：https://www.dji.com/cn/support?site=brandsite&from=nav
- 新空安消防案例：https://www.bilibili.com/video/BV1FD4y1a7Ax/?spm_id_from=333.1350.jump_directly&vd_source=5a0bdb26f67e959b0ff9c8e5954d0070
- DJI SDK停止更新公告：https://sdk-forum.dji.net/hc/zh-cn/articles/25786229596057-%E9%83%A8%E5%88%86DJI-SDK%E5%81%9C%E6%AD%A2%E6%9B%B4%E6%96%B0%E5%85%AC%E5%91%8A
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。 |
