06 直播与录制

Q：上云 API 2 SDK 是否支持设置设备的直播清晰度？

支持。可通过 LiveModule.setLiveQuality(LiveQualitySettingParams, callback) 接口设置设备直播清晰度。

调用流程如下：
listenLiveAvailableRange(callback)
↓
获取 LiveInfo
↓
getLiveStream(LiveInfo)
↓
LiveModule.setLiveQuality(LiveQualitySettingParams, callback)

LiveQualitySettingParams 需要设置以下参数：

参数	说明	获取方式
`sn`	设备序列号	`LiveInfo.getDeviceSn()`
`camera`	摄像头标识	`LiveInfo.getPayloadIndex()`
`video`	视频流标识	`LiveInfo.getVideoId()`
`videoQuality`	视频质量等级	`0`：自适应；`1`：标清；`4`：超清

camera 和 video 参数应从 listenLiveAvailableRange 回调返回的 LiveInfo 对象中获取。

Q：`subscribeLiveStream()` 与 `PullStreamModule` 获得直播流有何区别？如何将直播流转推到第三方平台？

两种取流方式的区别：

方式	视频源	适用场景
`subscribeLiveStream()`	大疆设备推送至平台的视频流	获取机场/无人机的实时航拍画面
`PullStreamModule.start()`	标准 WHEP 流	拉取自有流媒体服务器的视频流

如需将设备视频推送至自有流媒体服务器，使用 subscribeLiveStream() 获取 H.264 裸流后在业务侧推流处理。

PullStreamModule 获取 WHEP 拉流地址：

WHEP 拉流地址由 ISV 自有流媒体服务器提供：

该接口仅支持标准 WHEP 协议流。

转推第三方平台的实现方式：

底座直播转推： 通过 LiveModule 获取视频帧，再使用 FFmpeg 等工具推送到第三方平台。

PullStreamModule： 用于拉取已有 WHEP 地址的视频流，适合接入用户自有媒体服务器提供的 WHEP 流，并进行帧处理、保存或二次转推。

Q：如何判断当前直播流是否在持续？

通过 subscribeLiveStream() 的回调判断：持续收到数据回调表示有码流；若回调停止则表示码流已断开。

Q：驾驶舱页面无法显示直播视频流，应如何排查？

常见原因及处理：

浏览器版本过低：升级至 Chrome 92+、Safari 13+、Firefox 90+ 及以上

HTTP 环境下 WebRTC 受限：非 localhost 的 HTTP 环境下浏览器会限制 WebRTC，需启用 HTTPS

Q：如何在部署底座时时设置 WebRTC 开关？

在 env 配置文件中修改以下参数并重启容器：

执行命令：

Q：直播与录制相关错误码 `213003`、`213020`、`213022` 分别代表什么？

错误码	触发接口	含义	处理方法
`213003`	`LiveModule.start()`	目标飞行器当前不具备直播启动条件	常见场景是飞行器在舱内关机或设备离线，确认飞行器已开机、在线并建立链路后再启动直播
`213020`	`LiveRecordModule.startLiveRecord()`	录制失败：当前镜头尚未建立直播流（设备当前未开启推流）	先启动对应镜头直播，确认设备已在线并成功建立直播推流后，再开启录制
`213022`	`LiveRecordModule.startLiveRecord()`	录制失败：已有录制任务进行中	先停止现有录制

Q：调用 `LiveRecordModule.startLiveRecord` 接口开启直播录制，录制文件存在哪里？

录制结束后调用 MediaServiceModule.getMediaFilesList(params, callback) 接口即可查询到录制的文件。

Q：如何从直播流中获取相机的经纬度、俯仰角、偏航角信息？

通过 SEI 数据获取，步骤如下：

调用 Drone.listenLiveAvailableRange(callback) 获取直播流信息，回调返回 LiveInfo

调用 Drone.getLiveStream(liveInfo) 创建 LiveModule

调用 LiveModule.start() 发起拉流

调用 LiveModule.subscribeArSeiInfo(callback) 订阅 AR SEI 回调

回调中可获取的字段（回调数据类型为 ArSeiInfo）：

ArSeiInfo.getCameraYaw()：偏航角（度）

ArSeiInfo.getCameraPitch()：俯仰角（度）

ArSeiInfo.getLatitude()：纬度

ArSeiInfo.getLongitude()：经度

Q：如何通过 SDK 判断当前直播流对应的镜头类型？

SDK 不直接查询当前直播镜头类型，需结合 payloadIndex 和设备负载类型进行判断。

可通过以下接口获取设备当前挂载的所有负载信息：

drone.listenLiveAvailableRange(callback)：获取所有可用直播流信息（LiveInfo），返回结果中包含 payloadIndex。

drone.listenAircraftPayloadsOsdInfo(callback)：获取所有负载的 OSD 信息，返回结果中包含 payloadIndex。

payloadIndex 的格式如下：

{type}-{subtype}-{gimbalIndex}

例如：

99-0-0
165-0-7

其中，type 字段表示负载类型（设备型号），subtype 表示镜头类型，gimbalIndex 表示云台索引。

以 M4TD（type=99，三光机型）为例，subtype 取值含义如下：

`subtype`	镜头类型
`0`	广角
`1`	变焦
`2`	红外
`3`	多光谱

判断步骤：

通过上述接口获取设备实际上报的所有 payloadIndex。

提取 payloadIndex 中的 type 和 subtype 字段。

对照 DJI 开发者文档中的相机枚举表，确认对应的镜头类型，例如广角镜头、长焦镜头、红外镜头等。

参考文档：https://developer.dji.com/doc/cloud-api-tutorial/cn/overview/product-support.html

Q：使用 `LiveModule.subscribeLiveStream(FlightHubCallback.LiveStreamCallback)` 订阅直播数据帧时，机库画面正常但无人机辅助影像没有数据，如何处理？

辅助影像流需在飞行器开机并建立链路后产生，建议在飞行器起飞后进行验证。

飞行器在舱内关机或离线时，不会产生对应辅助影像流。

Q：一个设备同时会有多个可用的直播源吗？如何获取并选择？

同一设备可能同时存在多路直播源，如负载相机主镜头、辅助镜头或机场相机等，每路直播源对应不同的 video_id。

调用 listenLiveAvailableRange 获取可用直播源列表 List<LiveInfo>，再从目标 LiveInfo 中获取对应直播参数并调用 getLiveStream 起流。

实际可用直播源以回调返回结果为准。

Q：如何使用 SDK 切换红外直播镜头？

调用 listenLiveAvailableRange 获取 LiveInfo，通过 getSwitchableLensTypeSwigValues() 确认设备支持 IR 镜头。

先开启直播并通过 connectDrcLink 建立 DRC 链路。

组装 SwitchLiveLensParams，设置 payloadIndex 和 lensType=CameraLensType.IR。

调用 switchLiveLens 完成切换。

Q：上云 API 2 SDK 是否支持设置设备的直播清晰度？#

Q：subscribeLiveStream() 与 PullStreamModule 获得直播流有何区别？如何将直播流转推到第三方平台？#

Q：如何判断当前直播流是否在持续？#

Q：驾驶舱页面无法显示直播视频流，应如何排查？#

Q：如何在部署底座时时设置 WebRTC 开关？#

Q：直播与录制相关错误码 213003、213020、213022 分别代表什么？#

Q：调用 LiveRecordModule.startLiveRecord 接口开启直播录制，录制文件存在哪里？#

Q：如何从直播流中获取相机的经纬度、俯仰角、偏航角信息？#

Q：如何通过 SDK 判断当前直播流对应的镜头类型？#

Q：使用 LiveModule.subscribeLiveStream(FlightHubCallback.LiveStreamCallback) 订阅直播数据帧时，机库画面正常但无人机辅助影像没有数据，如何处理？#

Q：一个设备同时会有多个可用的直播源吗？如何获取并选择？#

Q：如何使用 SDK 切换红外直播镜头？#