设置直播清晰度

2022-07-19
暂无评分

设置直播清晰度-live_set_quality

services

通信方式: MQTT

API接口:

PUB Topic: thing/product/{pid}/services
SUB Topic: thing/product/{pid}/services_reply

参数说明:

  • pid:指网关设备的产品ID,一般是用设备的SN号来表示,每台设备都不一样,所以需要服务端订阅Topic的时候用通配符来表示。

Services Payload段参数示例

{
    "tid": "d729f59d83194e3eb62340648ca86e4e",
    "bid": "248b7bba35464489ac42eb8e13c6f596",
    "method": "live_set_quality",
    "data": {
        "video_id": "1ZNDH1D0010098/39-0-7/normal-0",
        "video_quality": 4
    }
}

参数说明:

  • video_id:直播视频流的ID编号,字符串类型

    ​ video_id有格式要求,具体的组合格式为飞机SN号/负载及挂载位置枚举值/负载lens编号

    ​ 示例: 1ZNDH1D0010098/0-39-7/normal-0

  • video_quality:直播质量

    0:自适应

    1:流畅

    2:标清

    3:高清

    4:超清

services_reply

对于消息的应答,服务端需要对tid`bid`保持一致。客户端是根据这两个字段来判断服务端是对哪条消息的应答。

payload段示例

{
    "tid":"fc55099072324bbba9ee7b014d9637de",
    "bid":"9b748a8e00b94d02879e506160cf7ab5",
    "method":"live_set_quality",
    "data":{
        "result":0
    }
}

参数说明:

  • result:错误码,具体的含义见《应用服务错误码》章节

PILOT端手动直播

对于无需后台直播观看,但是需要在用户使用时,开启直播,把码流传回服务端进行存档分析的场景,可以通过该接口组合,让用户在PILOT中手动触发直播功能,详细步骤如下:

  1. PILOT端webview登录第三方云平台后,需要向服务端请求一个流媒体服务器直播地址参数,各个第三方云平台配置不同,也可以直接写死在前端代码中。
  2. 把直播推流参数通过JSBridge接口,发给PILOT进行设置。接口为window.djiBridge.liveshareSetConfig(type: Int, params: String),详见《JSBridge 直播章节》
  3. PILOT收到直播配置后,立即发起直播推流,用户可以进入飞行界面查看直播信息,停止直播,重新开始直播等操作。

注意:采用手动直播方式,推流的画面一直是PILOT主画面码流,当飞手切换相机画面时,推流的画面也会跟着变化。