10.dock-access-to-cloud
概述
机场上云需要借助遥控器内安装的 DJI Pilot 2。如下图示，开发者可按照 Pilot 内的指示一步步操作完成上云。在上云过程中，需要完成设备的检查（如急停按钮的检查、网络是否已经连接等）、将飞行器与机场对频、填写上云配置信息（如填写 MQTT 账号密码以实现 MQTT 连接）等操作。通过 Demo 中的机场上云部分，可以获得机场上云操作的演示，演示视频请查看 功能预览视频 中的机场上云。
机场上云需要校验 License。License 来源为开发者网站的 Cloud API 类型的 App 申请，申请结果如图示。申请成功以后，开发者可以被判定为 DJI 授权的开发者。
注意：
当 DJI Pilot 2 与机场在接入第三方云时，对于安全性要求比较高的场景中，需要对通信链路进行加密，实现数据的安全通信。SSL 链路默认设备会认证服务端，服务端不认证设备端。若服务端开启设备认证，需要在服务端进行 “clientAuth” 的配置。
DJI Pilot 2 与机场支持 Godaddy 颁发的证书，若开发者需要做数据安全加密，可以使用与大疆相同的认证机构证书即可实现 MQTT SSL 认证。
交互时序
sequenceDiagram
participant pilot as DJI Pilot 2
participant client as DJI Dock
participant server as Cloud Server
note over pilot: 填写 MQTT 网关地址、MQTT账号密码
client ->> server: MQTT 连接建立
note over pilot, server: License 校验
client ->> server: 请求License 校验所需参数 Topic: thing/product/{gateway_sn}/requests<br/>Method: config
server -->> client: 返回参数 Topic: thing/product/{gateway_sn}/requests_reply<br/>Method: config
note over client: License 校验成功
opt 若校验失败，后续组织绑定流程不会进行
note over client: License 校验失败
client -x server: MQTT 连接断开
end
note over pilot, server: 组织绑定
pilot ->> client: 请求设备绑定信息
client ->> server: 获取设备绑定信息 Topic: thing/product/{gateway_sn}/requests<br/>Method: airport_bind_status
note over server: 查询设备绑定信息
server -->> client: 返回查询结果 Topic: thing/product/{gateway_sn}/requests_reply<br/>Method: airport_bind_status
opt 若设备未绑定
pilot ->> client: 请求设备绑定码对应的组织信息
client ->> server: 请求对应的组织信息 Topic: thing/product/{gateway_sn}/requests<br/>Method: airport_organization_get
note over server: 查询对应的组织信息
server -->> client: 返回查询结果 Topic: thing/product/{gateway_sn}/requests_reply<br/>Method: airport_organization_get
pilot ->> client: 通过设备绑定码将设备绑定到对应组织
client ->> server: 设备绑定到组织 Topic: thing/product/{gateway_sn}/requests<br/>Method: airport_organization_bind
note over server: 设备绑定到组织
server -->> client: 返回绑定结果 Topic: thing/product/{gateway_sn}/requests_reply<br/>Method: airport_organization_bind
end
接口详细实现
Last updated