infobit iCam VB80 平台 API 指令

產品資訊

規格：

• 產品名稱： 攝像頭VB80
• 文件版本： V1.0.3
• 平台： API指令手冊
• Web地點： www.infobitav.com
• 電子郵件： info@infobitav.com

產品使用說明

介紹

1. 準備
   若要開始使用 iCam VB80，請依照下列步驟操作：
   • 在您的電腦中設定 IP 位址
   • 啟用 Telnet 用戶端
2. 透過命令列介面登入
   存取命令列介面以與設備互動。
3. API 指令結束view
   了解可用於設定和控制的不同 API 命令。

命令集

gbconfig 指令
使用以下命令配置與相機和視訊相關的設定：

相機：

• gbconfig --camera-mode
• gbconfig -s camera-mode

影片:

• gbconfig --hdcp-enable

常見問題 (FAQ)

• Q：iCam VB80如何更新韌體？
  答：要更新固件，請訪問我們的 web網站提供詳細說明和下載。
• Q：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為例amp勒。您也可以使用其他控制設備。

在您的電腦中設定 IP 位址
詳細操作步驟此處不再贅述。

啟用 Telnet 用戶端
透過命令列介面登入設備前，請確保Telnet用戶端已開啟。預設情況下，Windows 作業系統中會停用 Telnet 用戶端。若要開啟 Telnet 用戶端，請執行下列操作。

1. 選擇“開始 > 控制台 > 程式”。
2. 在「程式與功能」區域方塊中，按一下「開啟或關閉 Windows 功能」。
3. 在「Windows 功能」對話方塊中，選取「Tel the net Client」複選框。

透過命令列介面登入

1. 選擇“開始”>“運行”。
2. 在「執行」對話方塊中輸入cmd，然後按一下「確定」。
3. 輸入telnet xxxx 23。
   對於前amp文件中，如果設備IP位址為192.168.20.140，則輸入telnet 192.168.20.140 23，再按下「Enter」。
4. 當設備提示登入時，輸入admin並回車，設備會提示密碼，直接回車即可，因為admin用戶沒有預設密碼。

「設備已準備好執行 CLI API 命令。狀態將顯示歡迎使用 VB10/VB80。

API 指令結束view

本設備的API指令主要分為以下幾類。

• gb配置： 管理設備的配置。
• 國標控制： 控制設備做某事。

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 –發送cmd hdmi	發送 CEC 命令來控制顯示開/關。
gbconfig –麥克風靜音	設定麥克風靜音開/關。
gbconfig -s 麥克風靜音	取得麥克風靜音開/關狀態。
gbconfig –卷	設定音量。
gbconfig -s 卷	取得音訊音量。
gbconfig –自動捲	調整音量（增大/減小）。

gbcontrol 指令

命令	描述
gbcontrol –發送cmd hdmi	立即向顯示器發送 CEC 命令。

命令集

gbconfig 指令

相機：

gbconfig –相機模式

命令	gbconfig –相機模式{正常|自動取景|說話者跟蹤 | 演講者追蹤}
回覆	相機將更改為指定的追蹤模式。
描述	從以下選項設定相機的追蹤模式： • 正常：使用者需要手動調整攝影機到適當的角度。 • 自動取景：攝影機會根據人臉辨識自動追蹤人物。 • 說話者追蹤：攝影機會根據語音辨識自動追蹤說話者。 • 演示者追蹤：攝影機始終自動追蹤演示者。

Examp樂：
將追蹤模式設定為自動取景：

命令：
gbconfig –相機模式自動取景

回覆:
相機追蹤模式將設定為自動取景。

gbconfig -s 相機模式

命令	gbconfig -s 相機模式
回覆	{正常|自動取景|說話者追蹤 |演講者追蹤}
描述	取得相機的追蹤模式。

Examp樂：
要取得相機的追蹤模式：

• 命令：
  gbconfig -s 相機模式
• 回覆:
  普通的

這表示追蹤模式設定為“正常”。

gbconfig –相機縮放

命令	gbconfig –camera-zoom {[100，gbconfig -scamera-phymaxzoom]}

回覆	相機變焦將會改變。
描述	設定相機的變焦。可用值範圍從100%（1x）到相機的 最大物理變焦。 對於前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 –相機儲存座標 1
• 回覆:
  座標將儲存到預設 1。

gbconfig -s –相機保存座標

命令	gbconfig –s 相機儲存座標 {1 | 2}
回覆	真/假
描述	取得座標是否儲存到指定預設。 • 真：座標已儲存到指定的預設位置。 • False：座標不會儲存到指定的預設。

Examp樂：
取得目前座標是否儲存到預設 1：

• 命令：
  gbconfig –s 相機保存座標 1
• 回覆:
  錯誤的

座標不會儲存到預設 1。

gbconfig –相機載入座標

命令	gbconfig –相機載入座標{1 | 2}
回覆	指定的預設將被載入到相機中。
描述	將預設 1/2 載入到攝影機。

Examp樂：
將預設 1 載入到攝影機：

• 命令：
  gbconfig –相機載入座標 1
• 回覆:
  預設 1 將載入至相機。

gbconfig –相機鏡像

命令	gbconfig –相機鏡像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 –camera-powerfreq 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。 • auto：HDCP 將根據實際情況自動開啟/關閉。例如，設定為「auto」時，如果來源和 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 Out 的 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 Out 發送到 連接的顯示器。
描述	發送CEC命令來控制顯示的開啟或關閉。 On：傳送 CEC 指令來控制顯示。 Off：發送CEC命令控制顯示關閉。

Examp樂：
發送 CEC 命令來控制顯示：

• 命令：
  gbcontrol –sinkpower 打開
• 回覆:
  用於開啟支援 CEC 的顯示器電源的 CEC 命令將從 HDMI 輸出發送。

gbconfig –cec-cmd hdmi

命令	gbconfig –cec-cmd hdmi {上|關閉} {CmdStr}
回覆	用於控制顯示開/關的 CEC 命令將被設定並保存在

	裝置.
描述	設定並儲存用於控制設備上顯示開啟或關閉的 CEC 命令。 On：設定CEC指令以控制顯示開啟。 Off：設定CEC指令來控制顯示關閉。 CmdStr：字串或十六進位格式的 CEC 命令。對於前amp文件中，開啟顯示器電源的CEC指令可以是「40 04」。

Examp樂：
配置並儲存 CEC 命令“40 04”以開啟設備上的顯示電源：

• 命令：
  4004 上的 gbconfig –cec-cmd hdmi
• 回覆:
  用於開啟支援 CEC 的顯示器「40 04」的 CEC 命令將保存在裝置上。

gbconfig -s cec-cmd

命令	gbconfig -s cec-cmd
回覆	HDMI 開啟：xxxx HDMI 關閉：xxxx
描述	取得用於控制顯示開啟和關閉的 CEC 命令。 Ÿ on：設定CEC指令，用於控制顯示開啟。 Ÿ Off：設定CEC指令來控制顯示關閉。 Ÿ CmdStr：字串或十六進位格式的CEC指令。對於前amp樂，CEC 開啟顯示器電源的命令可以是“40 04”。

Examp樂：
若要取得用於控制顯示開啟和關閉的 CEC 命令：

• 命令：
  gbconfig -s -cec-cmd
• 回覆:
  • HDMI 開啟：4004
  • HDMI 關閉：ff36

開啟支援 CEC 的顯示器的 CEC 指令：為「40 04」；關閉顯示器電源的命令：是“ff 36”。

gbcontrol –發送cmd hdmi

命令	gbcontrol –send-cmd hdmi {CmdStr}
回覆	CEC指令{CmdStr}將立即傳送到顯示器進行測試。
描述	立即發送 CEC 指令 {CmdStr} 到顯示器。 注意：該指令不會保存在裝置上。

Examp樂：
若要將 CEC 命令“44 04”傳送到顯示器：

• 命令：
  gbcontrol –send-cmd hdmi 4004
• 回覆:
  CEC 指令「40 04」將立即傳送到顯示器。

gbconfig – 滑鼠啟用

命令	gbconfig –mice-enable {n |y}
回覆	啟用或停用基於基礎設施的 Miracast 功能
描述	n、禁用。 是，已啟用。

Examp樂：
若要將 Miracast over Infrastructure 設定為啟用：

• 命令：
  gbconfig –mice-enable y
• 回覆:
  將啟用基於基礎設施的 Miracast 功能。

gbconfig -s 滑鼠啟用

命令	gbconfig -s 滑鼠啟用
回覆	不適用/是
描述	n、禁用。 是，已啟用。

Examp樂：
要取得 Miracast over Infrastructure 狀態：

• 命令：
  gbconfig -s 滑鼠啟用
• 回覆:
  n

基於基礎設施的 Miracast 已停用。

gbconfig –顯示模式

命令	gbconfig –顯示模式{單一|雙重的}
回覆	將顯示佈局設定為單一、分割
描述	Single 和 Split 是自動佈局，

Examp樂：
將顯示佈局設定為手動模式：

• 命令：
  gbconfig –顯示模式單一
• 回覆:
  顯示佈局模式變為單一。

gbconfig -s 顯示模式

命令	gbconfig -s 顯示模式
回覆	單/雙/手動
描述	single，自動單佈局 Dual，自動分割佈局 Manual，用於手動佈局設置

Examp樂：
若要取得顯示模式狀態：

• 命令：
  gbconfig -s 顯示模式
• 回覆:
  單身的

顯示方式為單一。

聲音的：

gbconfig –麥克風靜音

命令	gbconfig –麥克風靜音 {n|} y}
回覆	所有麥克風將設定為靜音開/關。
描述	將所有麥克風（包括 VB10 和可擴充麥克風）設定為靜音開/關。 n：靜音關閉。 y：靜音。

Examp樂：
若要將所有麥克風靜音關閉：

• 命令：
  gbconfig –麥克風靜音 n
• 回覆:
  麥克風將被設定為靜音。

gbconfig -s 麥克風靜音

命令	gbconfig -s 麥克風靜音
回覆	不適用/是
描述	使所有麥克風（包括 VB10 和可擴展麥克風）靜音 開/關狀態。 n：靜音關閉。 y：靜音。

Examp樂：
若要取得所有麥克風靜音開/關狀態：

• 命令：
  gbconfig -s 麥克風靜音
• 回覆:
  n

麥克風已靜音。

gbconfig –自動音量

命令	gbconfig –自動捲 {公司|十二月}
回覆	每步音量增益將增加或減少 2。
描述	增大或減小音量。 inc：將輸出音量的增益每步驟增加 2。 dec：每步將輸出音量的增益減少 2。

Examp樂：
增加音量：

• 命令：
  gbconfig –autovolume inc
• 回覆:
  每一步音量將增加 2。

gbconfig –卷

命令	gbconfig –卷 {0,12,24,36,50,62,74,88,100}
回覆	設定音量值。
描述	音量只能配置為指定值

Examp樂：
設定音量：

• 命令：
  gbconfig –卷 50
• 回覆:
  音量將設定為 50。

gbconfig -s 卷

命令	gbconfig -s 卷
回覆	0~100
描述	取得體積值。

Examp樂：
取得音量：

• 命令：
  gbconfig -s 卷
• 回覆:
  50

體積為50。

gbconfig –揚聲器靜音

命令	gbconfig –揚聲器靜音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、啟用 是的，已停用

Examp樂：
若要將麥克風設定為停用：

• 命令：
  gbconfig –vb10-mic-停用 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 –休眠

命令	gbconfig –hibernate {n |y}
回覆	將設備設定為睡眠狀態。
描述	n、醒來 y，睡覺

Examp樂：
設定設備睡眠：

• 命令：
  gbconfig –hibernate y
• 回覆:
  設備將進入休眠狀態。

gbconfig -s 休眠

命令	gbconfig -s 休眠
回覆	不適用/是
描述	獲取睡眠狀態。

Examp樂：
取得設備的睡眠狀態：

• 命令：
  gbconfig -s 休眠
• 回覆:
  n

設備正在運行。

gbconfig –顯示指南

命令	gbconfig –顯示指南 {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 指令，指令

參考

• 使用者手冊