infobit iCam VB80 平台 API 命令
产品信息
规格：
- 产品名称： 摄像头VB80
- 文件版本： V1.0.3
- 平台： API 命令手册
- Web地点： www.infobitav.com
- 电子邮件： info@infobitav.com
产品使用说明
介绍
- 准备
要开始使用 iCam VB80，请按照以下步骤操作：- 在您的计算机中设置 IP 地址
- 启用 Telnet 客户端
- 通过命令行界面登录
访问命令行界面与设备交互。 - API 命令结束view
了解可用于配置和控制的不同 API 命令。
命令集
gbconfig 命令
使用以下命令配置与相机和视频相关的设置：
相机：
gbconfig --camera-modegbconfig -s camera-mode
视频：
gbconfig --hdcp-enable
常见问题 (FAQ)
- 问：如何更新iCam VB80的固件？
答：要更新固件，请访问我们的 web网站获取详细说明和下载。 - 问：我可以将 iCam VB80 与第三方软件一起使用吗？
答：是的，iCam VB80 支持使用提供的 API 命令与第三方软件集成。
修订历史
| 文档版本 | 日期 | 内容 | 评论 |
| V1.0.0 | 2022/
04/02 |
最初的 | |
| V1.0.1 | 2022/
04/22 |
修改了错别字 | |
| V1.0.2 | 2023/
06/05 |
添加新 API | |
| V1.0.3 | 2024/
03/22 |
修改的 |
介绍
准备
本节以第三方控件Windows 7为例ample. 您也可以使用其他控制设备。
在您的计算机中设置 IP 地址
具体操作步骤这里就不再赘述了。
启用 Telnet 客户端
通过命令行界面登录设备之前，请确保已启用 Telnet 客户端。默认情况下，Windows 操作系统中禁用 Telnet 客户端。要打开 Telnet 客户端，请执行以下操作。
- 选择“开始”>“控制面板”>“程序”。
- 在“程序和功能”区域框中，单击“打开或关闭 Windows 功能”。
- 在 Windows 功能对话框中，选中“致电网络客户端”复选框。
通过命令行界面登录
- 选择“开始”>“运行”。
- 在运行对话框中，输入 cmd，然后单击确定。
- 输入telnet xxxx 23。23是端口号。
例如amp例如，如果设备的IP地址是192.168.20.140，则输入telnet 192.168.20.140 23，然后按Enter键。
- 设备提示登录时，输入admin，回车，然后设备提示输入密码，由于admin用户没有默认密码，直接回车即可。
“设备已准备好执行 CLI API 命令。状态将显示欢迎使用 VB10/VB80。”
API 命令结束view
本设备的API命令主要分为以下几种。
- gb配置： 管理设备的配置。
- gbcontrol： 控制设备做某事。
gbconfig 命令
gbconfig命令主要分为两类gbconfig和gbconfig –s命令。
| 命令 | 描述 |
| gbconfig –相机模式 | 设置设备的摄像机跟踪模式。 |
| gbconfig -s 相机模式 | 获取设备的相机跟踪模式。 |
| gbconfig –相机变焦 | 设置相机的变焦倍数。 |
| gbconfig -s 相机变焦 | 获取相机的变焦能力。 |
| gbconfig –相机保存坐标 | 将坐标保存为预置点1或预置点2。 |
| gbconfig -s –相机保存坐标 | 获取该坐标对应的预置位。 |
| gbconfig –相机加载坐标 | 将特定预设加载至相机。 |
| gbconfig –相机镜像 | 打开/关闭相机的镜像。 |
| gbconfig -s 相机镜子 | 获取相机的镜像状态。 |
| gbconfig –相机电源频率 | 设置电力线频率。 |
| gbconfig -s 摄像机电源频率 | 获取电力线频率。 |
| gbconfig –相机-geteptz | 获取 eptz 信息。 |
| gbconfig –hdcp 启用 hdmi | 设置 HDMI 输出的 HDCP 开启/关闭 |
| gbconfig -s hdcp 启用 | 获取 HDMI 输出的 HDCP 状态 |
| gbconfig –cec 启用 | 设置 CEC 启用/禁用。 |
| gbconfig -s cec 启用 | 获取 CEC 状态。 |
| gbconfig –cec-cmd hdmi | 配置 CEC 命令来控制显示器的开/关。 |
| gbconfig-s cec-cmd | 获取用于控制显示开/关的 CEC 命令。 |
| gbcontrol –发送命令 hdmi | 发送 CEC 命令来控制显示器的开/关。 |
| gbconfig –mic 静音 | 设置麦克风静音打开/关闭。 |
| gbconfig -s 麦克风静音 | 获取麦克风静音开/关状态。 |
| gbconfig –卷 | 设置音频音量。 |
| gbconfig -s 卷 | 获取音频音量。 |
| gbconfig –自动音量 | 调整音量（增加/减少）。 |
gbcontrol 命令
| 命令 | 描述 |
| gbcontrol –发送命令 hdmi | 立即向显示器发送 CEC 命令。 |
命令集
gbconfig 命令
相机：
gbconfig –相机模式
|
命令 |
gbconfig –摄像头模式 {正常 | 自动取景 | 扬声器跟踪 |
主持人跟踪} |
| 回复 | 摄像机将改变为指定的跟踪模式。 |
|
描述 |
从以下选项设置摄像机的跟踪模式：
• 正常：用户需要手动调整摄像头到合适的角度。 • 自动取景：摄像机根据脸部识别自动跟踪人物。 • 说话人追踪：摄像机根据语音识别自动追踪说话人。 • 演示者跟踪：摄像机始终自动跟踪演示者。 |
Examp乐：
要将跟踪模式设置为自动取景：
命令：
gbconfig –相机模式自动取景
回复：
摄像机跟踪模式将设置为自动取景。
gbconfig -s 相机模式
| 命令 | gbconfig -s 相机模式 |
| 回复 | {正常 | 自动取景 | 扬声器跟踪 | 演示者跟踪} |
| 描述 | 获取相机的跟踪模式。 |
Examp乐：
获取相机的跟踪模式：
- 命令：
gbconfig -s 相机模式 - 回复：
普通的
这表明跟踪模式设置为“正常”。
gbconfig –相机变焦
| 命令 | gbconfig –camera-zoom {[100, gbconfig -s camera-phymaxzoom]} |
| 回复 | 相机变焦将会改变。 |
| 描述 | 设置相机的缩放比例，可设置范围为 100%（1 倍）至相机的
最大物理变焦。 例如amp例如，相机最大物理变焦为500倍，则变焦可设置范围为[100, 500]。（1倍至5倍） |
Examp乐：
要将相机变焦设置为 100：
- 命令：
gbconfig –相机变焦 100 - 回复：
相机变焦将设置为 1 倍。
gbconfig -s 相机变焦
| 命令 | gbconfig -s 相机变焦 |
| 回复 | xxx |
| 描述 | 获取相机的变焦能力。 |
Examp乐：
要获得相机变焦：
- 命令：
gbconfig -s 相机变焦 - 回复：
100
相机变焦为 1 倍。
gbconfig –相机保存坐标
| 命令 | gbconfig –相机保存坐标 {1|2} |
| 回复 | 当前坐标将保存至预置点 1 或 2。 |
| 描述 | 将当前坐标保存到指定的预设点。提供预设点 1 和 2。 |
Examp乐：
要将当前坐标设置为预置点 1：
- 命令：
gbconfig –camera-savecoord 1 - 回复：
坐标将保存至预置点 1。
gbconfig -s –相机保存坐标
| 命令 | gbconfig –s 相机保存坐标 {1 | 2} |
| 回复 | 真/假 |
|
描述 |
获取坐标是否保存到指定预设。
• True：坐标已保存至指定预置位。 • False：坐标未保存到指定的预置位。 |
Examp乐：
获取当前坐标是否保存到预置位 1：
- 命令：
gbconfig –s 相机保存坐标 1 - 回复：
错误的
坐标未保存到预置点 1。
gbconfig –相机加载坐标
| 命令 | gbconfig –相机加载坐标 {1 | 2} |
| 回复 | 指定的预设将被加载到摄像机中。 |
| 描述 | 将预置位 1/2 加载至摄像机。 |
Examp乐：
要将预置位 1 加载到摄像机：
- 命令：
gbconfig –相机加载坐标 1 - 回复：
预置 1 将加载至相机。
gbconfig –相机镜像
| 命令 | gbconfig –相机镜像 {n | y} |
| 回复 | 相机镜像功能将被打开或关闭。 |
|
描述 |
打开或关闭相机的镜像功能。
• n：镜像关闭。 • y：镜像开启。 |
Examp乐：
要打开镜像：
- 命令：
gbconfig –相机镜像 - 回复：
相机镜像功能将会开启。
gbconfig -s 相机镜子
| 命令 | gbconfig -s 相机镜子 |
| 回复 | 否/是 |
|
描述 |
获取镜像状态。
• n：镜像关闭。 • y：镜像开启。 |
Examp乐：
获取镜像状态：
- 命令：
gbconfig -s 相机镜子 - 回复：
y
相机镜像功能已开启。
gbconfig –相机电源频率
| 命令 | gbconfig –相机电源频率 {50 | 60} |
| 回复 | 频率将更改为 50/60。 |
|
描述 |
改变电力线频率以防止视频闪烁。
• 50：将频率更改为50Hz。 • 60：将频率更改为60Hz。 |
Examp乐：
要将电力线频率更改为 60Hz：
- 命令：
gbconfig –相机电源频率 60 - 回复：
电力线频率将改为60Hz。
gbconfig –s 相机电源频率
| 命令 | gbconfig –s 相机电源频率 |
| 回复 | n/50/60 |
|
描述 |
获取电力线频率。
• 50：将频率更改为50Hz。 • 60：将频率更改为60Hz。 |
Examp乐：
获取电力线频率：
- 命令：
gbconfig –s 相机电源频率 - 回复：
60
防闪烁功能为60Hz。
视频：
gbconfig –hdcp 启用
| 命令 | gbconfig –hdcp 启用 hdmi { n | 自动 | hdcp14 | hdcp22} |
| 回复 | HDMI 输出的 HDCP 将被启用或禁用。 |
| 描述 | 为 HDMI 输出配置 HDCP 功能。
• n：关闭HDCP。 • 自动：根据实际情况自动打开/关闭HDCP。例如，当设置为“自动”时，如果源设备和HDMI显示设备都支持HDCP 2.2，则HDMI输出信号将进行HDCP 2.2加密；如果源设备不支持HDCP，则HDMI输出信号的HDCP将关闭。 • hdcp14：HDMI 输出的 HDCP 将设置为 1.4。 • hdcp22：HDMI 输出的 HDCP 将设置为 2.2。 |
Examp乐：
要将 HDMI 输出的 HDCP 设置为 2.2：
- 命令：
gbconfig –hdcp 启用 hdmi hdcp22 - 回复：
HDMI 输出的 HDCP 设置为 2.2。
gbconfig -s hdcp 启用
| 命令 | gbconfig -s hdcp 启用 |
| 回复 | n/自动/hdcp14/hdcp22 |
| 描述 | 获取 HDMI 输出的 HDCP 状态。 |
Examp乐：
要获取 HDMI 输出的 HDCP 状态：
- 命令：
gbconfig -s hdcp 启用 - 回复：
n
HDMI 输出的 HDCP 已关闭。
gbconfig –cec 启用
| 命令 | gbconfig –cec 启用 {n | y} |
| 回复 | CEC 将被打开或关闭。 |
|
描述 |
设置 CEC 打开/关闭。
n：关闭 CEC。 y：打开 CEC。 |
Examp乐：
要打开 CEC：
- 命令：
gbconfig –cec 启用 y - 回复：
CEC 将被开启。
gbconfig -s cec 启用
| 命令 | gbconfig -s cec 启用 |
| 回复 | 否/是 |
|
描述 |
获取 CEC 状态。
n：CEC 已关闭。 y：CEC 已打开。 注意：一旦CEC关闭，命令“GB control –sink power”将不可用，并且VB10的正常工作和待机之间的切换也将无效。 |
Examp乐：
要获取 CEC 状态：
- 命令：
gbconfig -s cec 启用 - 回复：
y
CEC 已打开。
gbcontrol –sinkpower
| 命令 | gbcontrol –sinkpower {开|关} |
|
回复 |
控制显示器开/关的 CEC 命令将从 HDMI 输出发送到
连接的显示器。 |
|
描述 |
发送CEC命令来控制显示器的打开或关闭。
开：发送CEC命令来控制显示器。 关闭：发送CEC命令控制显示器关闭。 |
Examp乐：
发送 CEC 命令来控制显示：
- 命令：
gbcontrol –sinkpower on - 回复：
打开支持 CEC 的显示器的 CEC 命令将从 HDMI 输出发送。
gbconfig –cec-cmd hdmi
| 命令 | gbconfig –cec-cmd hdmi {开|关} {CmdStr} |
| 回复 | 控制显示器开/关的 CEC 命令将配置并保存在 |
| 设备。 | |
| 描述 | 配置和保存用于控制设备显示开启或关闭的 CEC 命令。
开：配置CEC命令来控制显示器开启。 关闭：配置 CEC 命令来控制显示关闭。 CmdStr：字符串或十六进制格式的 CEC 命令。例如amp例如，打开显示器的CEC命令可能是“40 04”。 |
Examp乐：
要配置并保存用于打开设备显示屏的 CEC 命令“40 04”：
- 命令：
gbconfig –cec-cmd hdmi 开启 4004 - 回复：
打开支持 CEC 的显示器“40 04”的 CEC 命令将保存在设备上。
gbconfig-s cec-cmd
| 命令 | gbconfig-s cec-cmd |
|
回复 |
HDMI 开启：xxxx
HDMI 关闭：xxxx |
|
描述 |
获取用于控制显示器开启和关闭的 CEC 命令。
Ÿ on：配置CEC命令来控制显示器开启。 Ÿ Off：配置CEC命令来控制显示器关闭。 Ÿ CmdStr：字符串或十六进制格式的 CEC 命令。例如amp中央选举委员会 打开显示器的命令可能是“40 04”。 |
Examp乐：
要获取控制显示器开启和关闭的 CEC 命令：
- 命令：
gbconfig-s-cec-cmd - 回复：
- HDMI 开启：4004
- HDMI 关闭：ff36
打开支持CEC的显示器的CEC命令：为“40 04”；关闭显示器的命令：为“ff 36”。
gbcontrol –发送命令 hdmi
| 命令 | gbcontrol –发送命令 hdmi {CmdStr} |
| 回复 | CEC 命令 {CmdStr} 将立即发送到显示器进行测试。 |
|
描述 |
立即发送 CEC 命令 {CmdStr} 到显示器。
注意：此命令不会保存在设备上。 |
Examp乐：
要将 CEC 命令“44 04”发送到显示器：
- 命令：
gbcontrol –发送命令 hdmi 4004 - 回复：
CEC 命令“40 04”将立即发送到显示器。
gbconfig –mice-enable
| 命令 | gbconfig –mice-enable {n |y} |
| 回复 | 已启用或禁用通过基础设施进行 Miracast 功能 |
|
描述 |
n，已禁用。
y，已启用。 |
Examp乐：
要将基础设施上的 Miracast 设置为已启用：
- 命令：
gbconfig –mice-enable y - 回复：
基础设施上的 Miracast 功能将被启用。
gbconfig -s 鼠标启用
| 命令 | gbconfig -s 鼠标启用 |
| 回复 | 否/是 |
|
描述 |
n，已禁用。
y，已启用。 |
Examp乐：
要获取基础设施上的 Miracast 状态：
- 命令：
gbconfig -s 鼠标启用 - 回复：
n
基础设施上的 Miracast 已被禁用。
gbconfig –显示模式
| 命令 | gbconfig –显示模式 {单|双} |
| 回复 | 将显示布局设置为单一、分割 |
| 描述 | Single 和 Split 是自动布局， |
Examp乐：
将显示布局设置为手动模式：
- 命令：
gbconfig –显示模式单一 - 回复：
显示布局模式变为单一。
gbconfig -s 显示模式
| 命令 | gbconfig -s 显示模式 |
| 回复 | 单/双/手动 |
| 描述 | 单、自动单一布局双、自动分割布局手动，用于手动布局设置 |
Examp乐：
获取显示模式状态：
- 命令：
gbconfig -s 显示模式 - 回复：
单身的
显示模式单一。
声音的：
gbconfig –mic 静音
| 命令 | gbconfig –mic 静音 {n | y} |
| 回复 | 所有麦克风将设置为静音开/关。 |
|
描述 |
设置所有麦克风（包括 VB10 和可扩展麦克风）的静音开/关。
n：关闭静音。 y：静音开启。 |
Examp乐：
要关闭所有麦克风静音：
- 命令：
gbconfig –mic 静音 n - 回复：
麦克风将被设置为静音。
gbconfig -s 麦克风静音
| 命令 | gbconfig -s 麦克风静音 |
| 回复 | 否/是 |
| 描述 | 使所有麦克风（包括 VB10 和可扩展麦克风）静音
开/关状态。 n：关闭静音。 y：静音开启。 |
Examp乐：
获取所有麦克风静音开/关状态：
- 命令：
gbconfig -s 麦克风静音 - 回复：
n
麦克风已静音。
gbconfig –自动卷
| 命令 | gbconfig –自动音量 {增加|减少} |
| 回复 | 音量增益每步将增加或减少 2。 |
|
描述 |
增加或减少音量。
inc：每步将输出音量的增益增加 2。 dec：每一步将输出音量的增益减少2。 |
Examp乐：
增加音量：
- 命令：
gbconfig –自动音量增加 - 回复：
每一步音量都会增加 2。
gbconfig –卷
| 命令 | gbconfig –卷 {0,12,24,36,50,62,74,88,100} |
| 回复 | 设置音量值。 |
| 描述 | 音量只能配置为指定值 |
Examp乐：
设置音量：
- 命令：
gbconfig –volume 50 - 回复：
音量将设置为 50。
gbconfig -s 卷
| 命令 | gbconfig -s 卷 |
| 回复 | 0~100 |
| 描述 | 获取音量值。 |
Examp乐：
获取音量：
- 命令：
gbconfig -s 卷 - 回复：
50
音量是50。
gbconfig –扬声器静音
| 命令 | gbconfig –扬声器静音 {n | y} |
| 回复 | 设置扬声器静音/取消静音。 |
|
描述 |
n，取消静音
y，静音 |
Examp乐：
要设置扬声器静音：
- 命令：
gbconfig –扬声器静音 y - 回复：
扬声器将静音。
gbconfig -s 扬声器静音
| 命令 | gbconfig -s 扬声器静音 |
| 回复 | 否/是 |
| 描述 | 获取扬声器状态。 |
Examp乐：
获取扬声器的静音状态：
- 命令：
gbconfig -s 扬声器静音 - 回复：
n
扬声器已取消静音。
gbconfig –vb10-mic-禁用
| 命令 | gbconfig –vb10-mic-disable {n |y} |
| 回复 | 设置 vb10 的内置麦克风启用/禁用。 |
|
描述 |
n，已启用
y，已禁用 |
Examp乐：
要将麦克风设置为禁用：
- 命令：
gbconfig –vb10-mic-disable y - 回复：
vb10 的麦克风将被禁用。
gbconfig -s vb10-mic-禁用
| 命令 | gbconfig -s vb10-mic-禁用 |
| 回复 | 否/是 |
| 描述 | 获取麦克风状态。 |
Examp乐：
获取麦克风状态：
- 命令：
gbconfig -s vb10-mic-禁用 - 回复：
n
麦克风已启用。
系统：
gbcontrol –设备信息
| 命令 | gbcontrol –设备信息 |
| 回复 | 获取固件版本 |
| 描述 | VB10 的固件版本 |
Examp乐：
获取固件版本：
- 命令：
gbcontrol –设备信息 - 回复：
V1.3.10
gbconfig –hibernate
| 命令 | gbconfig –hibernate {n |y} |
| 回复 | 将设备设置为睡眠状态。 |
|
描述 |
n. 醒来
y，睡觉 |
Examp乐：
要设置设备睡眠：
- 命令：
gbconfig –hibernate y - 回复：
设备将进入睡眠状态。
gbconfig-s 休眠
| 命令 | gbconfig-s 休眠 |
| 回复 | 否/是 |
| 描述 | 获取睡眠状态。 |
Examp乐：
获取设备的睡眠状态：
- 命令：
gbconfig-s 休眠 - 回复：
n
设备正在运行。
gbconfig –显示指南
| 命令 | gbconfig –show-guide {n |y} |
| 回复 | 显示指南屏幕手册。 |
|
描述 |
n, 关闭
y，显示 |
Examp乐：
显示指南屏幕：
- 命令：
gbconfig –显示指南 y - 回复：
将显示指南屏幕。
gbconfig -s 显示指南
| 命令 | gbconfig -s 显示指南 |
| 回复 | 否/是 |
|
描述 |
获取引导屏幕状态。
注意，仅反馈手动设置的指南屏幕的状态。 |
Examp乐：
获取设备引导屏状态：
- 命令：
gbconfig-s 休眠 - 回复：
n
不显示指南屏幕。
文件/资源
 |
infobit iCam VB80 平台 API 命令 [pdf] 指示 VB80、iCam VB80 平台 API 命令、iCam VB80、平台 API 命令、平台命令、API 命令、iCAM VB80 命令、命令 |