使用上云 API 2 SDK 接口 getDroneInstance 获取不到飞行器实例

说明：本文档中，应用运行与设备管控底座以下统一简称为底座。

问题现象

无人机已在线，通过 getDeviceList 也能查询到设备，但调用：

仍返回 null、not found，或提示“SDK 未初始化”。

有时机场实例可以正常获取，但飞行器实例获取不到。

getDroneInstance 只查询 SDK 本地缓存，不会主动请求设备数据。

飞行器实例依赖以下两个前置步骤：

调用 getWorkspaceInstance(bindingUuid) 获取工作区实例；

调用异步接口 getDeviceList，并等待成功回调完成。

如果未调用 getWorkspaceInstance，可能提示“SDK 未初始化”。

如果调用 getDeviceList 后立即在回调外执行 getDroneInstance，此时设备拓扑尚未写入本地缓存，因此无法获取飞行器实例。

按以下顺序调用：

initialize()
→ getWorkspaceInstance(bindingUuid)
→ getDeviceList(callback)
    └─ 在成功回调中调用 getDroneInstance(sn)

示例：

getDeviceList 是异步接口，必须等待成功回调后再获取飞行器实例。

建议使用回调结果中 sub_devices 返回的 SN，不要使用未经确认的硬编码 SN。

设备拓扑成功写入缓存后，后续可直接获取实例，无需每次重新查询，拓扑发生变化时除外。

获取到飞行器实例不代表设备当前在线。在线状态应通过 getDeviceList 中的设备在线状态或 listenDroneOnlineStatus 判断。