更新时间:2024-07-22 GMT+08:00

实例视频设置

功能介绍

实例视频设置。 调用此api的前提条件是租户需要先购买koophone云手机实例。 使用该接口可以设置实例每一个清晰度对应的码率和出流的帧率。

URI

PUT /v1/instances/video-setting

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

租户级Token

表2 请求Body参数

参数

是否必选

参数类型

描述

instance_ids

Array of strings

实例列表

最大长度:32

instance_settings

Array of InstanceSetting objects

视频设置内容

表3 InstanceSetting

参数

是否必选

参数类型

描述

network_type

String

网络类型,枚举:MOBILE_NETWORK/WIFI

encoding_type

String

编码类型,目前固定值H264

video_spec_groups

Array of VideoSpecGroup objects

视频规格组

表4 VideoSpecGroup

参数

是否必选

参数类型

描述

definition_540P

VideoSpec object

标清参数设置,540P

definition_720P

VideoSpec object

高清参数设置,720P

definition_1080P

VideoSpec object

超清参数设置,1080P

表5 VideoSpec

参数

是否必选

参数类型

描述

code_rate

Integer

码率,单位kbps,值范围0-10000,需要是100的倍数

fps

Integer

帧率,单位fps,可选 30 ,60

响应参数

状态码: 200

表6 响应Body参数

参数

参数类型

描述

error_code

String

响应码,错误码规范KOOPHONE.API.0001,数字递增 error_code为0时表示成功

error_msg

String

响应描述

状态码: 400

表7 响应Body参数

参数

参数类型

描述

error_code

String

响应码,错误码规范KOOPHONE.API.0001,数字递增 error_code为0时表示成功

error_msg

String

响应描述

状态码: 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

响应码,错误码规范KOOPHONE.API.0001,数字递增 error_code为0时表示成功

error_msg

String

响应描述

请求示例

/v1/instances/video-setting

{
  "instance_ids" : [ "a44uhlf7" ],
  "instance_settings" : [ {
    "network_type" : "WIFI",
    "encoding_type" : "H264",
    "video_spec_groups" : [ {
      "definition_540P" : {
        "code_rate" : 1000,
        "fps" : 30
      },
      "definition_720P" : {
        "code_rate" : 1000,
        "fps" : 60
      },
      "definition_1080P" : {
        "code_rate" : 1000,
        "fps" : 30
      }
    } ]
  } ]
}

响应示例

状态码: 200

正常响应

{
  "error_code" : "0",
  "error_msg" : "ok"
}

状态码

状态码

描述

200

正常响应

400

请求错误

500

内部错误

错误码

请参见错误码