getJPEGStreaming.lua
[返回首页]

API说明

获得当前MotionJPEG编码和Streaming参数

MotionJPEG编码/Streaming在所有KILOVIEW编码产品中均是默认开启的,以辅助于视频抓拍图像用于预览。但MotionJPEG可以配置成不同的模式,如仅用于预览(图像较小、帧率5fps),或与主码流相同,或与子码流相同,以供不同的应用场景。

参数

HTTP提交参数:GET; POST

通过HTTP测试该API调用 (URL):

Config

可选参数。

1

指定要获取MotionJPEG的编码配置参数(参见返回值中的 "Config")

0

(或不指定)[默认] 不获取配置参数

测试值:

Status

可选参数。

1

指定要获取MotionJPEG的实时状态信息(参见返回值中的 "Status")

0

(或不指定)[默认] 不获取状态信息

测试值:

返回

返回JSON格式的结果。该JSON数据的格式如下:

{
/*对象*/

"Result":
数值

200表示OK, 其它错误码含义类似于HTTP Response.

"Status":
"字符串"

状态消息。反馈API执行的结果状态,如有错误,将描述出错的原因。

"Data": {
/*对象*/

"Type":
"字符串"

当前MotionJPEG的配置模式

preview

仅预览模式(720x405大小,5fps)

main

图像大小与主码流相同(帧率可设置)

sub

图像大小与子码流相同(帧率可设置)

"SnapUrl":
"字符串"

http://...,

用于获取预览视频图片的HTTP URL

"Config": {
/*对象*/

当前MotionJPEG的编码配置参数 (请求参数中如果指定Config=1返回)

"Quality":
整数

1-99, 指定JPEG的编码图像质量

"Chrome":
整数

0|1, 0表示彩色,1表示灰度

"FrameRateMode":
"字符串"

编码帧率模式

default

表示全帧率,即输入视频帧率为多少,编码帧率为多少

half

表示当输入视频的帧率 >=50 时,自动降半帧率

custom

表示手动指定帧率

"FrameRate":
数值

数值, 指定的编码帧率(如果FrameRateMode为full/half,则不必要指定FrameRate值)

"BindAudioChannel":
整数

数值, 绑定的音频编码引擎通道号, -1表示无音频绑定

}
"Status": {
/*对象*/

当前实时编码状态信息 (请求参数中如果指定Status=1返回)

"BindAudioChannel":
整数

绑定的音频编码引擎通道号, -1表示无音频绑定(同Config中的同名参数)

"Width":
整数

实际编码的视频宽度

"Height":
整数

实际编码的视频高度

"FrameRate":
数值

实际编码的帧率(fps)

"Bitrate":
整数

视频实际编码的实时码率(Kbps)

}
}
}

说明

注:音频如果需要获取实时状态,请根据BindAudioChannel参数的ID,另行获取音频的实时编码状态,参考 getAudioEngChannel.lua

其它说明

KILOVIEW Device HTTP API, v1.0