SDK初始化

FlightHubSDK

概述

FlightHubSDK 是 Java SDK 的统一入口门面类，负责 SDK 的初始化、鉴权头注入、版本查询及生命周期管理。所有模块实例均通过初始化后的 SDK 获取，使用前必须先完成初始化。

获取方式： 直接调用静态方法 FlightHubSDK.xxx()，无需实例化。

SDK 初始化推荐调用顺序：

1.

setWebSocketAuthHeaders(headers) → 设置 WebSocket 鉴权头

2.

setHttpHeaders(headers) → 设置 HTTP 鉴权头

3.

initialize(config) → 初始化 SDK，建立 WebSocket 连接

4.

getWorkspaceInstance() / getDroneInstance(sn) / getDockInstance(sn) → 获取业务实例

典型应用场景

用户鉴权接入

在调用 initialize() 前，通过 setWebSocketAuthHeaders 和 setHttpHeaders 配置鉴权头，确保后续所有 API 调用携带正确凭证。

多设备统一管理入口

通过 getDroneInstance(sn)、getDockInstance(sn) 分别获取无人机与机场实例，再调用各实例接口实现多设备并发控制。

SDK 版本兼容检查

在应用启动时通过 getVersion() 获取 SDK 版本，与业务需求版本对比，确保功能可用性。

调用示例

SDK 实例获取时序图

相关接口

FlightHubSDK.setWebSocketAuthHeaders(headers) — 设置 WebSocket 鉴权头（必须在 initialize 前调用）

FlightHubSDK.setHttpHeaders(headers) — 设置 HTTP 鉴权头（必须在 initialize 前调用）

FlightHubSDK.initialize(config) — 初始化 SDK（返回 FlightHubSdkErrorCode）

FlightHubSDK.getWorkspaceInstance() — 获取 Workspace 实例

FlightHubSDK.getDroneInstance(sn) — 获取无人机实例

FlightHubSDK.getDockInstance(sn) — 获取机场实例

FlightHubSDK.getBaseStationInstance(sn) — 获取基站实例

FlightHubSDK.getRelayInstance(sn) — 获取中继器实例

FlightHubSDK.getRemoteControllerInstance(sn) — 获取遥控器实例

FlightHubSDK.getStream() — 获取流实例

FlightHubSDK.isInitialized() — 检查是否已初始化

FlightHubSDK.getVersion() — 获取 SDK 版本字符串

FlightHubSDK.getBuildInfo() — 获取构建信息

FlightHubSDK.setLogLevel(level) — 动态修改日志级别

FlightHubSDK.getConfig() — 获取当前 SDK 配置

FlightHubSDK.shutdown() — 关闭 SDK

示例代码

迁移操作步骤