
AIDA Imaging HTTP 存取指南
僅適用於 IP 攝影機
2024 年 XNUMX 月修訂
本指南旨在幫助使用者編寫和製作自己的程式以直接連接到我們的相機。這種靈活性有助於增強您的創造力和控制相機的能力!
您不必使用本指南來使用相機。本文檔中的設定並非都適用於每個型號,只有當該型號具有某些功能時,才能存取這些功能。
適用產品清單:
POV:HD-NDI-200、HD3G-NDI-200l、HD-NDI-X20、HD-NDI-CUBE、HD-NDI-IP67、HD-NDI-MINI、HD-NDI-VF、HD-NDI-TF、HD-NDI3-120、HD-NDINDINDI3、UHD67- X3
雲台:PTZ-X12-IP、PTZ-X20-IP、PTZ-NDI-X12、PTZ-NDI-X18、PTZ-NDI-X20、PTZ-NDI3-X20、PTZ4K-NDI-X12、PTZ4K-NDI-X30、PTZ4K-NDI-X12、PTZ30K-NDI-XXNUMX.
*NDI® 是 VIZRT AB 的註冊商標
1.1 入門
使用本文檔時應對http協定及其POST請求方法有一定的了解與掌握。
1.2 語法規則
HTTP 是客戶端和伺服器端之間請求和回應的標準。使用 web 瀏覽器, web 爬蟲,或其他工具,客戶端向伺服器的指定連接埠發起HTTP請求(預設連接埠為80)。客戶端一般被稱為用戶代理程式。伺服器回應客戶端請求,並在伺服器上儲存一些資源,例如 HTML file和圖像。這種類型的伺服器通常稱為 Web 伺服器.
HTTP Request 請求需要遵循下列指令
所有參數請求都走post方式,透過func取得參數get和設定參數set兩種方式區分
設定參數介面
http://cgi-bin/web.fcgi?func=set
取得參數介面
http://cgi-bin/web.fcgi?func=get
1.3 請求與回應簡單範例ample
假設我們的相機 IP 是 192.168.1.180,根據 1.2 的語法規定
取得參數介面。
http://192.168.1.180/cgi-bin/web.fcgi?func=get
設定介面
http://192.168.1.180/cgi-bin/web.fcgi?func=set
**以前者身分登入請求amp勒**
本次請求是get方法,所以請求設定了介面 url,並以json格式傳輸內容參數
參數內容
「`
{
「系統」:
{
“登入”:“使用者名稱:密碼”,
}
}
「`
json字串system代表呼叫主函數,login代表呼叫參數。 user:password代表傳入的參數。
對於前ample,如果目前攝影機帳號和密碼均為admin,則最終傳輸格式為
「`
{
「系統」:
{
“登入”:“管理員:管理員”,
}
}
「`
傳回內容是請求之後傳回的,返回內容根據呼叫函數的方法不同返回不同的參數。 login方法回傳如下json內容
成功返回
「`
{
「狀態」:真
「系統」:
{
「登入」:int
}
}
「`
無法返回
「`
{
「狀態」:false
「系統」:
{
「登入」:false
}
}
「`
其中 status 是函數呼叫的狀態,true 表示成功,false 表示失敗。
回傳格式跟請求格式一致,system是呼叫main函數,login是呼叫回傳key
注意:除了login之外,其他任何指令互動都必須傳遞一個key,語法為「key」:int,「key」後面附加的int的值就是「login」操作傳回的值
**以網路介面為例amp勒**
網路參數介面有兩個,分別是取得網路介面參數和設定網路介面參數。從上述例子來看ample,可以看出
取得參數介面。
http://192.168.1.180/cgi-bin/web.fcgi?func=get
設定介面
http://192.168.1.180/cgi-bin/web.fcgi?func=set
**取得網路參數**
「`
{
“key”:“登入介面中登入欄位對應的值”,
「乙太網路」:{「eth0」:true}
}
「`
這個請求的意思是:我要呼叫取得乙太網路eth0下的所有參數。
正常退貨:
「`
{
「狀態」:true,
「乙太網路」:
{
“eth0”:{
“dhcp”:int, //0 手動 1 自動
“IP位址”:“192.168.1.155”,
“網路遮罩”:“192.168.1.1”,
“網關”:“192.168.1.1”,
“DNS”:“192.168.1.1”,
“httpPort”:int,
“web連接埠”:int,
「rtsp埠」:int,
“rtmp連接埠”:int
}
}
「`
當介面正常時,即status為ture時,取得網路所有介面參數
**設定網路參數**
「`
{
“key”:“登入介面中登入欄位對應的值”,
「乙太網路」:
{
“eth0”:{
“dhcp”:int //0 手動 1自動
“IP位址”:“192.168.1.155”,
“網路遮罩”:“192.168.1.1”,
“網關”:“192.168.1.1”,
“DNS”:“192.168.1.1”,
“mac”:”01:23:45:67:89:ab”,
“httpPort”:int,
“web連接埠”:int,
「rtsp埠」:int,
“rtmp連接埠”:int
}
}
}
「`
設定成功則傳回json字串
「`
{
「狀態」:true,
「乙太網路」:
{
“eth0”:{
“dhcp”:int //0 手動 1 自動
“IP位址”:“192.168.1.155”,
“網路遮罩”:“192.168.1.1”,
“網關”:“192.168.1.1”,
“DNS”:“192.168.1.1”,
“mac”:”01:23:45:67:89:ab”
“httpPort”:int,
“web連接埠”:int,
“主要amP“ort”:int,
「subStreamP”位置”:
“rtsp連接埠”:int
“rtmp連接埠”:int
}
}
「`
1.4 測試描述
可以下載郵差進行協定測試(https://www.getpostman.com/downloads/).
該軟體的使用方法可參考隨附的影片說明。
2 視訊編碼設定
2.1 編碼參數設定
放
要求
{
“鍵”:int,
「venc」:{
「主要的」:{
「啟用」:int,
“模式”:”h264″, //”h264″、”h265″、”mjpeg”
“col”:3840, //int
“line”:2160, //int
“比特率”:115200,//int
“frmrate”:30, //int
“rcmode”:”cbr”, //”cbr”、”vbr”
「親file”:”MP”, //”baseline”、”MP”、”HP”
“間隔”:30//int
},
「子」:{
「啟用」:int,
“模式”:”h264”,
「col」:1280,
“line”:720,
「比特率」:4096,
“frmrate”:30,
“rc模式”:“cbr”,
「親file”:”MP”, //”baseline”、”MP”、”HP”
「間隔」:30
}
}
}
回覆
設定成功,返回最新的編碼參數
{
「狀態」:真
「venc」:{
「主要的」:{
「啟用」:int,
“模式”:”h264”,
「col」:3840,
“line”:2160,
「比特率」:115200,
“frmrate”:30,
“rc模式”:“cbr”,
「親file”:“國會議員”,
「間隔」:30
},
「子」:{
「啟用」:int,
“模式”:”h264”,
「col」:1280,
“line”:720,
「比特率」:4096,
“frmrate”:30,
“rc模式”:“cbr”,
「親file”:“國會議員”,
「間隔」:30
}
}
}
不支援編碼配置
{
「狀態」:false
“venc”:false
}
不支援主流或子流
{
「狀態」:false
“venc”:{“main”:false,sub”:false}
}
參數錯誤
{
「狀態」:false
“venc”:{“main”:false}
}
2.2 編碼參數獲取
得到
要求
{
“鍵”:int,
「venc」:{「main」:true,「sub」:true}
}
Or
{
“鍵”:int,
「venc」:{
「主要的」:{
“啟用”:true,
“模式”:true,
“col”:true,
“line”:true,
“比特率”:true,
“幀速率”:true,
“rcmode”:true,
「親file「:真的,
「間隔」:true,
「rtspUrl「:真的
「rtmpUrl「:真的
},
「子」:{
“啟用”:true,
“模式”:true,
“col”:true,
“line”:true,
“比特率”:true,
“幀速率”:true,
“rcmode”:true,
「親file「:真的,
「間隔」:true,
「rtspUrl「:真的
「rtmpUrl「:真的
}
}
}
回覆
{
「狀態」:true,
「venc」:{
「主要的」:{
「啟用」:int,
“模式”:”h264”,
「col」:3840,
“line”:2160,
「比特率」:115200,
“frmrate”:30,
“rc模式”:“cbr”,
「親file”:“國會議員”,
「間隔」:30,
「rtspUrl”:”rtsp://192.168.1.155:554/stream/main”
「rtmpUrl”:”rtmp://192.168.1.155:1935/app/rtmpstream0″
},
「子」:{
「啟用」:int,
“模式”:”h264”,
「col」:1280,
“line”:720,
「比特率」:4096,
“frmrate”:30,
“rc模式”:“cbr”,
「親file”:“國會議員”,
「間隔」:30,
「rtspUrl”:”rtsp://192.168.1.155:554/stream/sub”
「rtmpUrl”:”rtmp://192.168.1.155:1935/app/rtmpstream1″
}
}
}
不支援編碼配置
{
「狀態」:false,
“venc”:false,
}
不支援主流或子流
{
「狀態」:false,
“venc”:{“main”:false}
}
3 音頻編碼
3.1 音訊編碼設定
放
要求
{
“鍵”:int,
「聲音的」:{
「啟用」:int,
“Samp容忍”:int,
“位元寬”:int,
“soundMode”:”Mono”, //”單聲道”、”立體聲”
“編碼模式”:“G711A”,
//”G711A”、”G711U”、”ADPCMA”、”G726″、”LPCM”、”AAC”
“比特率”:int //Bps
8000、16000、22000、24000、32000、48000、64000、96000、128000、256000、320000
}
}
回覆
設定成功,返回最新的音訊編碼參數
{
「狀態」:true,
「聲音的」:{
「啟用」:int,
“Samp容忍”:int,
“位元寬”:int,
“聲音模式”:“單聲道”,
“編碼模式”:“G711A”,
“比特率”:int
}
}
不支援編碼配置或參數錯誤
{
「狀態」:false,
「音訊」:false
}
3.2 音訊編碼參數獲取
得到
要求
{
“鍵”:int,
「音訊」:真
}
Or
{
“鍵”:int,
「聲音的」:{
「啟用」:真,
“Samp容忍”:true,
“位元寬”:true,
「聲音模式」:真,
“encMode”:真,
「比特率」:true
}
}
設定成功,返回最新的音訊編碼參數
{
「狀態」:true,
「聲音的」:{
「啟用」:int,
“Samp容忍”:int,
“位元寬”:int,
“聲音模式”:“單聲道”,
“編碼模式”:“G711A”,
“比特率”:int
}
}
無法取得或不支援更改命令
{
「狀態」:false,
「音訊」:false
}
4 網路設定
4.1 網路參數設定
放
要求
{
“鍵”:int,
「乙太網路」:
{
“eth0”:{
“dhcp”:int //0 手動 1 自動
“IP位址”:“192.168.1.155”,
“網路遮罩”:“192.168.1.1”,
“網關”:“192.168.1.1”,
“DNS”:“192.168.1.1”,
“mac”:”01:23:45:67:89:ab”
“httpPort”:int,
“rtsp連接埠”:int
“rtmp連接埠”:int
}
}
}
不支援網路設定
{
「狀態」:false,
「乙太網路」:false,
}
eth0不存在或不支援配置。
{
「狀態」:false,
「乙太網路」:{“eth0”:false}
}
部分網路參數設定失敗。
{
「狀態」:false,
「乙太網路」:
{
“eth0”:{
“dhcp”:int //0 手動 1 自動
“IP位址”:false,
“網路遮罩”:“192.168.1.1”,
「網關」:false,
“DNS”:“192.168.1.1”,
“mac”:”01:23:45:67:89:ab”,
“httpPort”:int,
「rtsp埠」:int,
“rtmp連接埠”:int
}
}
}
設定成功
{
「狀態」:true,
「乙太網路」:
{
“eth0”:{
“dhcp”:int //0 手動 1自動
“IP位址”:“192.168.1.155”,
“網路遮罩”:“192.168.1.1”,
“網關”:“192.168.1.1”,
“DNS”:“192.168.1.1”,
“mac”:”01:23:45:67:89:ab”
“httpPort”:int,
「rtsp埠」:int,
“rtmp連接埠”:int
}
}
4.2 網路參數獲取
得到
要求:
{
“鍵”:int,
「乙太網路」:{「eth0」:true}
}
or
{
“鍵”:int,
「乙太網路」:
{
“eth0”:{
“DHCP”:true,
“IP位址”:true,
「網路遮罩」:true,
“網關”:true,
“DNS”:true,
“mac”:true,
“http埠”:true,
“rtsp連接埠”:true
“rtmp連接埠”:true
}
}
}
回覆
{
「狀態」:true,
「乙太網路」:
{
“eth0”:{
“dhcp”:int // 0 手動 1 自動
“IP位址”:“192.168.1.155”,
“網路遮罩”:“192.168.1.1”,
“網關”:“192.168.1.1”,
“DNS”:“192.168.1.1”,
“httpPort”:int,
“rtsp連接埠”:int
“rtmp連接埠”:int
}
}
不支援網路參數獲取
{
「狀態」:false,
「乙太網路」:false,
}
eth0不存在或不支援配置。
{
「狀態」:false,
「乙太網路」:{“eth0”:false}
}
取得部分網路參數失敗。
{
「狀態」:false,
「乙太網路」:
{
“eth0”:{
“dhcp”:int // 0 手動 1 自動
“IP位址”:false,
“網路遮罩”:“192.168.1.1”,
「網關」:false,
“DNS”:“192.168.1.1”,
“httpPort”:int,
“rtsp連接埠”:int
“rtmp連接埠”:int
}
}
}
5 影像控制
5.1 影像參數設定
放:
要求
{
“鍵”:int,
“圖像”:
{
“focus_mode”:”auto”, //”自動”,“手動”
“焦點距離”:“1.5米”,//”1.5米”,“2米”,“3米”,“6米”,“10米”
“exposure_mode”:”auto”, //”自動”,“手動”,”光圈優先”,”快門優先”,”亮度優先”
“shutter”:int //60/30bpf 5:1/30 6:1/60 7:1/90 8:1/100 9:1/125 10:1/180 11:1/250 12:1/350 13:1/500 14:1/725 15:1/1000 16:1/1500 17:1/2000 18:1/3000 19:1/4000 20:1/6000 21:1/10000
//50/25bpf 5:1/25 6:1/50 7:1/75 8:1/100 9:1/120 10:1/150 11:1/215 12:1/300 13:1/425 14:1/600 15:1/1000 16:1/1250 17:1/1750 18:1/2500 19:1/3500 20:1/6000 21:1/10000
“anti_flicker”:int,//0:1:50Hz 2:60Hz
「曝光亮度」:int,//0~27
「虹膜」:int,//0~13
“增益”:int, //0~15
“WB_mode”:”auto” //”自動”,“室內”,”室外”,”一鍵”,”自動跟踪”,“手動”
“R_gain”:int,//0~255
“B_gain”:int,//0~255
“鏡像”:int
「翻轉」:int,
「背光補償」:int,
「伽瑪」:int,//0~4
“數位變焦啟用”:int,
“WDR_enable”:int,
“WDR_level”:int, //1~6
“亮度”:int,//0~15
“清晰度”:int,//0~15
「對比」:int,//0~15
“飽和度”:int, //0~15
“DC_iris”:int, //0:關閉 1:打開
「降噪_2D」:int,
“noise_reduction_3D”:int, //0 自動 1:等級 1 2:等級 2 3:等級 3 4:等級 4 5:停用
“vo_resolution”:“1920X1080P@60Hz”
“圖像重置”:int
“zoom”:[type,speed] //類型 0 縮放停止 1 放大 2 縮小 速度:0~7
「focus」:[type,speed] //類型 0 對焦停止 1 對焦近 2 對焦遠 speed:0~7
“ptz”:[type,speed] //類型 0 ptz 停止 1 上 2 下 3 左 4 右 5 回家 6 重置 7 上+左 8 下+左 9 上+右 10 下+右 速度:0~0x18
「預設」:{「新增」:int,「刪除」:int,「呼叫」:int,「檢查」:int}
“snap”:int //影像捕捉; =1啟用,捕獲成功返回true,失敗返回false
「絕對控制」:
{
「縮放」:int,
「焦點」:int,
“pan”:int,
「傾斜」:int
}
}
}
回覆
{
「狀態」:真
“圖像”:
{
“focus_mode”:”auto”, //”自動”,“手動”
“焦點距離”:“1.5米”,//”1.5米”,“2米”,“3米”,“6米”,“10米”
“exposure_mode”:”auto”, //”自動”,“手動”,”光圈優先”,”快門優先”,”亮度優先”
“shutter”:int //60/30bpf 5:1/30 6:1/60 7:1/90 8:1/100 9:1/125 10:1/180 11:1/250 12:1/350 13:1/500 14:1/725 15:1/1000 16:1/1500 17:1/2000 18:1/3000 19:1/4000 20:1/6000 21:1/10000
//50/25bpf 5:1/25 6:1/50 7:1/75 8:1/100 9:1/120 10:1/150 11:1/215 12:1/300 13:1/425 14:1/600 15:1/1000 16:1/1250 17:1/1750 18:1/2500 19:1/3500 20:1/6000 21:1/10000
“anti_flicker”:int, //0:關閉 1:50Hz 2:60Hz
「曝光亮度」:int,//0~27
「虹膜」:int,//0~13
“增益”:int, //0~15
“WB_mode”:”auto” //”自動”,“室內”,”室外”,”一鍵”,”自動跟踪”,“手動”
“R增益”:int,//0~255
“B增益”:int,//0~255
“鏡像”:int
「翻轉」:int,
「背光補償」:int,
“gamma”:int,//int
“數位變焦啟用”:int,
“WDR_enable”:int,
“WDR_level”:int, //1~6
“亮度”:int,//0~15
“清晰度”:int,//0~15
「對比」:int,//0~15
“飽和度”:int, //0~15
“DC_iris”:int, // 0: 關閉 1: 打開
「降噪_2D」:int,
“noise_reduction_3D”:int, //0 自動 1:等級 1 2:等級 2 3:等級 3 4:等級 4 5:停用
“vo_resolution”:“1920X1080P@60Hz”
“圖像重置”:true
「縮放」:真
「焦點」:真
「雲台」:真
「預設」:真
“快照”:真
「絕對控制」:真
}
}
如果失敗,則相應的子段落設定為 false,例如ample
{
「狀態」:false
“圖像”:
{
“focus_mode”:”auto”, //”自動”,“手動”
「焦點距離」:false,
“exposure_mode”:”auto”, //”自動”,“手動”,”光圈優先”,”快門優先”,”亮度優先”
“shutter”:int //60/30bpf 5:1/30 6:1/60 7:1/90 8:1/100 9:1/125 10:1/180 11:1/250 12:1/350 13:1/500 14:1/725 15:1/1000 16:1/1500 17:1/2000 18:1/3000 19:1/4000 20:1/6000 21:1/10000
//50/25bpf 5:1/25 6:1/50 7:1/75 8:1/100 9:1/120 10:1/150 11:1/215 12:1/300 13:1/425 14:1/600 15:1/1000 16:1/1250 17:1/1750 18:1/2500 19:1/3500 20:1/6000 21:1/10000
“anti_flicker”:int, //0:關閉 1:50Hz 2:60Hz
「曝光亮度」:false,
「虹膜」:int,//0~13
“增益”:int, //0~15
“WB_mode”:”auto” //”自動”,“室內”,”室外”,”一鍵”,”自動跟踪”,“手動”
“R增益”:int,//0~255
“B增益”:int,//0~255
「鏡像」:false,
「翻轉」:int,
「背光補償」:int,
“gamma”:int,//int
“數位變焦啟用”:int,
“WDR_enable”:int,
“WDR_level”:int, //1~6
“亮度”:int,//0~15
“清晰度”:int,//0~15
「對比」:int,//0~15
“飽和度”:int, //0~15
「降噪_2D」:int,
“noise_reduction_3D”:int, //0 自動 1:等級 1 2:等級 2 3:等級 3 4:等級 4 5:停用
“vo_resolution”:“1920X1080P@60Hz”
“圖像重置”:true,
「縮放」:真,
「焦點」:真,
“ptz”:真,
「預設」:false,
“快照”:false
「絕對控制」:false
}
}
5.2 影像參數獲取
得到
要求
{
“鍵”:int,
“圖像”:{
「焦點模式」:true,
「焦點距離」:true,
「曝光模式」:true,
「快門」:真,
「防閃爍」:真,
「曝光亮度」:true,
「虹膜」:真,
「增益」:真,
「WB_mode」:真,
「R_gain」:真,
「B_gain」:真,
「鏡子」:真,
「翻轉」:真,
「背光補償」:true,
「伽瑪」:真,
“數位變焦啟用”:true,
“WDR_enable”:真,
「WDR_level」:真,
「亮度」:真,
「銳利度」:真,
「對比」:真實,
「飽和度」:真,
“DC_iris”:真,
「噪音降低_2D」:真,
「噪音降低_3D」:真,
「vo_resolution」:真,
“vo_support”: true, 複製程式碼
“幀速率”:true,
「預設」:int
「縮放」:真,
「焦點」:真,
“pan”:真,
「傾斜」:真
}
}
回覆
獲取成功,傳回相對值
{
「狀態」:真
“圖像”:
{
“focus_mode”:”auto”, //”自動”,“手動”
“焦點距離”:“1.5米”,//”1.5米”,“2米”,“3米”,“6米”,“10米”
“exposure_mode”:”auto”, //”自動”,“手動”,”光圈優先”,”快門優先”,”亮度優先”
“shutter”:int //60/30bpf 5:1/30 6:1/60 7:1/90 8:1/100 9:1/125 10:1/180 11:1/250 12:1/350 13:1/500 14:1/725 15:1/1000 16:1/1500 17:1/2000 18:1/3000 19:1/4000 20:1/6000 21:1/10000
//50/25bpf 5:1/25 6:1/50 7:1/75 8:1/100 9:1/120 10:1/150 11:1/215 12:1/300 13:1/425 14:1/600 15:1/1000 16:1/1250 17:1/1750 18:1/2500 19:1/3500 20:1/6000 21:1/10000
“anti_flicker”:int, //0:關閉 1:50Hz 2:60Hz
「曝光亮度」:int,//0~27
「虹膜」:int,//0~13
“增益”:int, //0~15
“WB_mode”:“auto” //“自動”,“室內”,“室外”,“一鍵式”,“自動追蹤”,“手動”,“鈉”,“螢光”
“R_gain”:int,//0~255
“B_gain”:int,//0~255
“鏡像”:int
「翻轉」:int,
「背光補償」:int,
“gamma”:int,//int
“數位變焦啟用”:int,
“WDR_enable”:int,
“WDR_level”:int, //1~6
“亮度”:int,//0~15
“清晰度”:int,//0~15
「對比」:int,//0~15
“飽和度”:int, //0~15
“DC_iris”:int, // 0: 關閉 1: 打開
「降噪_2D」:int,
“noise_reduction_3D”:int, //0 自動 1:等級 1 2:等級 2 3:等級 3 4:等級 4 5:停用
“vo_resolution”:“1920X1080P@60Hz”
“vo_support”:int //bit[0]1920X1080P@25Hz bit[1]1920X1080P@50Hz bit[2]1920X1080P@30Hz bit[3]1920X1080P@60Hz bit[4]1280x720P@25Hz bit[5]1280x720P@50Hz bit[6]1280x720P@30Hz bit[7]1280x720P@60Hz
//bit[8]3840X2160P@25Hz bit[9]3840X2160P@30Hz bit[10]1920X1080I@50Hz bit[11]1920X1080I@60Hz bit[12]1920X1080P@59.94Hz bit[13]1920X1080P@29.97Hz bit[15]1280x720P@59.94Hz bit[16]1280x720P@29.97Hz
“幀速率”:int
“preset”:int //0 存在 1 不存在
「縮放」:0,
「焦點」:4000,
“平移”:0,
「傾斜」:0
}
}
如果失敗,則相對於子項設定為 false,例如:
{
「狀態」:false
“圖像”:
{
“focus_mode”:”auto”, //”自動”,“手動”
“焦點距離”:“1.5米”,//”1.5米”,“2米”,“3米”,“6米”,“10米”
“exposure_mode”:”auto”, //”自動”,“手動”,”光圈優先”,”快門優先”,”亮度優先”
“shutter”:int //60/30bpf 5:1/30 6:1/60 7:1/90 8:1/100 9:1/125 10:1/180 11:1/250 12:1/350 13:1/500 14:1/725 15:1/1000 16:1/1500 17:1/2000 18:1/3000 19:1/4000 20:1/6000 21:1/10000
//50/25bpf 5:1/25 6:1/50 7:1/75 8:1/100 9:1/120 10:1/150 11:1/215 12:1/300 13:1/425 14:1/600 15:1/1000 16:1/1250 17:1/1750 18:1/2500 19:1/3500 20:1/6000 21:1/10000
“anti_flicker”:int, //0:關閉 1:50Hz 2:60Hz
「曝光亮度」:int,//0~27
「虹膜」:int,//0~13
“增益”:int, //0~15
“WB_mode”:false,
「R_gain」:false,
「B_gain」:false,
「鏡像」:false,
「翻轉」:int,
「背光補償」:int,
“gamma”:int,//int
“數位變焦啟用”:int,
“WDR_enable”:int,
“WDR_level”:int, //1~6
“亮度”:int,//0~15
“清晰度”:int,//0~15
「對比」:int,//0~15
“飽和度”:int, //0~15
「降噪_2D」:int,
“noise_reduction_3D”:int, //0 自動 1:等級 1 2:等級 2 3:等級 3 4:等級 4 5:停用
“vo_resolution”:“1920X1080P@60Hz”
“vo_support”:int //bit[0]1920X1080P@25Hz bit[1]1920X1080P@50Hz bit[2]1920X1080P@30Hz bit[3]1920X1080P@60Hz bit[4]1280x720P@25Hz bit[5]1280x720P@50Hz bit[6]1280x720P@30Hz bit[7]1280x720P@60Hz
//bit[8]3840X2160P@25Hz bit[9]3840X2160P@30Hz bit[10]1920X1080I@50Hz bit[11]1920X1080I@60Hz bit[12]1920X1080P@59.94Hz bit[13]1920X1080P@29.97Hz bit[15]1280x720P@59.94Hz bit[16]1280x720P@29.97Hz
“幀速率”:int
“預設”:false
}
}
6 RTMP 串流媒體
6.1 RTMP推流參數設定
放
要求
{
“鍵”:int,
“rtmp”:{
「主要的」:{
「啟用」:int,
“url”:”rtmp://192.168.1.118:1935/app/rtmpstream2″,
},
「子」:{
「啟用」:int,
“url”:”rtmp://192.168.1.118:1935/app/rtmpstream3″,
}
}
}
回覆
設定成功,返回最新的編碼參數
{
「狀態」:真
“rtmp”:{
「主要的」:{
「啟用」:int,
“url”:”rtmp://192.168.1.118:1935/app/rtmpstream2″,
“status”:int, //0 推流失敗 1 推流成功
},
「子」:{
「啟用」:int,
“url”:”rtmp://192.168.1.118:1935/app/rtmpstream3″,
“status”:int, //0 推流失敗 1 推流成功
}
}
}
不支援 RTMP 推流配置
{
「狀態」:false
“rtmp”:false
}
不支援主碼流或子碼流配置
{
「狀態」:false,
“rtmp”:{“main”:false,sub”:false}
}
參數錯誤
{
「狀態」:false,
“rtmp”:{“main”:false}
}
6.2 RTMP推流參數獲取
得到
要求
{
“鍵”:int,
“rtmp”:{“main”:true,“sub”:true}
}
or
{
“鍵”:int,
“rtmp”:{
「主要的」:{
“啟用”:true,
“url「:真的,
},
「子」:{
“啟用”:true,
“url「:真的,
},
}
}
回覆
{
「狀態」:true,
“rtmp”:{
「主要的」:{
「啟用」:int,
“url”:”rtmp://192.168.1.118:1935/app/rtmpstream2″,
“status”:int, //0 推流失敗 1 推流成功
},
「子」:{
「啟用」:int,
“url”:”rtmp://192.168.1.118:1935/app/rtmpstream3″,
“status”:int, //0 推流失敗 1 推流成功
}
}
}
不支援 RTMP 推流配置
{
「狀態」:false
“rtmp”:false
}
不支援主碼流或子碼流配置
{
「狀態」:false,
“rtmp”:{“main”:false,sub”:false}
}
參數錯誤
{
「狀態」:false,
“rtmp”:{“main”:false}
}
7 系統控制
7.1 系統控制設置
放
要求:
{
“鍵”:int,
「系統」:
{
“system_control”:”image reset”,//”image_reset” 圖像參數重置,“factory_reset” 恢復出廠設置,“system_reboot” 系統重啟
“登入”:“使用者名稱:密碼”,
}
}
回覆:
設定成功
要求:
{
「狀態」:真
「系統」:
{
「系統控制」:真
「login」:int //傳回一個key值,所有json互動都必須包含「key」:int項,否則指令不會回應
}
}
安裝失敗
{
「狀態」:false
「系統」:
{
「系統控制」:false
「登入」:false
}
}
7.2 系統控制採集
得到:
要求:
{
“鍵”:int,
「系統」:
{
“設備名稱”:true,
「序號」:true,
“bootloader_version”:true,
「系統版本」:true,
「應用程式版本」:true,
“硬體版本”:true
“登入”:“使用者名稱:密碼”
}
}
回覆:
收購成功
{
「狀態」:真
「系統」:
{
“device_name”:“FHD 視訊會議攝影機”,
“序號”:“123456789”,
“bootloader_version”:“V1.0.0”,
“系統版本”:“V1.0.0”,
“應用程式版本”:“V1.0.0”
“硬體版本”:“V1.0.0”
「login」:int //傳回一個key值,所有json互動都必須包含「key」:int項,否則指令不會回應
}
}
獲取失敗
{
「狀態」:false
「系統」:
{
“設備名稱”:false,
“序號”:“123456789”,
“bootloader_version”:“V1.0.0”,
“系統版本”:“V1.0.0”,
“應用程式版本”:“V1.0.0”
}
}
7.3 瀏覽器控制
支援瀏覽器網址列端控制和查詢攝影機參數,語法與上面的語法相同,差別在於無需登入認證,也就是不需要按鍵或登入那項操作直接依照指令設定的控制。
Example 1:查詢版本號
http://192.168.1.189/cgi-bin/web.fcgi?func=get{“system”:{“app_version”:true}}

Example 2:設定縮放絕對位置
http://192.168.1.189/cgi-bin/web.fcgi?func=set{“image”:{“abs ctrl”:{“zoom”:0}}}

Examp第三步:查詢ptz位置

8. 自動追蹤(如果可用)
8.1 自動追蹤參數獲取
得到:
要求
{
“ai”:真
}
or
{
"人工智慧":{
「啟用」:真,
“peoplePos”: true,
“peopleRation”: true,
“switchTime”:true,
“boardDetectEn”: true,
“highLightTarget”:true,
“縮放鎖定”:true,
“PTLimit”:真
}
}
獲取成功,返回最新參數
{
"人工智慧": {
「啟用」:1,
“peoplePos”: 2,
「人數比例」:6,
「切換時間」: 20,
“boardDetectEn”: 1,
“highLightTarget”:0,
“縮放鎖定”:1,
“PTLimit”: 1
},
「狀態」:真
}
不支援或參數異常
{
「狀態」:false,
“ai”:假
}
特殊預置位定義:
預置點號255:鬥陣特攻位置;
預置點號254:右下限位;
預置點號253:左上極限位置;
預置號252:黑板位置
9 NDI 設定
9.1 NDI 參數設定
要求
{
“NDI”:{
「啟用」:int,
“設備名稱”:“HX”,
“頻道名稱”:“頻道1”,
“群組”:“公開”,
「多播」:{
「啟用」:0,
“IP”:“239.255.0.0”,
“掩碼”:“255.255.0.0”,
“TTL”:1
},
“發現伺服器”:”192.168.1.42”
}
}
回覆
設定成功,NDI參數改變。
{
“NDI”:{
「啟用」:1,
“設備名稱”:“HX”,
“頻道名稱”:“頻道1”,
“群組”:“公開”,
「多播」:{
「啟用」:0,
“IP”:“239.255.0.0”,
“掩碼”:“255.255.0.0”,
“TTL”:1
},
“發現伺服器”:”192.168.1.42”
},
「狀態」:真
}
不支援 NDI 配置
{
「狀態」:false
“NTP”:假
}
參數錯誤
{
“NDI”:{
「啟用」:1,
“設備名稱”:“HX”,
“頻道名稱”:“頻道1”,
“群組”:“公開”,
「多播」:{
「啟用」:0,
“IP”:“239.255.0.0”,
“掩碼”:“255.255.0.0”,
“TTL”:1
},
“發現伺服器”:false
},
「狀態」:false
}
9.2 NDI參數獲取
要求
{
“NDI”:{
「啟用」:真,
“設備名稱”:true,
“頻道名稱”:true,
「群組」:true,
“多播”:true,
“發現伺服器”:true
}
}
或
{
「NDI」:真實
}
回覆
{
“NDI”:{
「啟用」:1,
“設備名稱”:“HX”,
“頻道名稱”:“頻道1”,
“群組”:“公共”
「多播」:{
「啟用」:0,
“IP”:“239.255.0.0”,
“掩碼”:“255.255.0.0”,
“TTL”:1
},
“發現伺服器”:“192.168.1.42”,
},
「狀態」:真
}
不支援 NDI
{
「狀態」:false
“NDI”:假
}
10 SRT 設定
10.1 SRT 參數
要求
{
“SRT”:{
“mode”:”listen”, //”listen”、“caller”、”rendezvous”
「聽」:
{
「啟用」:int,
「連接埠」:int,
“latency”:int, // 毫秒
「加密」:int,
「金鑰長度」: int, //32、24、16
“密鑰”:“012345678”,
}
}
}
or
{
“SRT”:{
“mode”:”caller”, //”listen”、“caller”、”rendezvous”
「主要呼叫者」:
{
「啟用」:int,
“IP位址”:“192.168.1.158”,
「連接埠」:int,
“latency”:int, //毫秒
「加密」:int,
「金鑰長度」: int, //32、24、16
“密鑰”:“012345678eee”,
“streamid”:“r=0”
},
「子調用者」:
{
「啟用」:int,
“IP位址”:“192.168.1.158”,
「連接埠」:int,
“latency”:int, //毫秒
“streamid”:“r=0”
「加密」:int,
「金鑰長度」: int, //32、24、16
“密鑰”:“012345678eee”,
“streamid”:“r=1”
}
}
}
or
{
“SRT”:{
“mode”:”rendezvous”, //”listen”、“caller”、”rendezvous”
「主要會合地點」:
{
「啟用」:int,
“IP位址”:“192.168.1.158”,
「連接埠」:int,
“latency”:int, //毫秒
「加密」:int,
「金鑰長度」: int, //32、24、16
“密鑰”:“012345678eee”,
“streamid”:“r=0”
},
「子會合點」:
{
「啟用」:int,
“IP位址”:“192.168.1.158”,
「連接埠」:int,
“latency”:int, //毫秒
“streamid”:“r=0”
「加密」:int,
「金鑰長度」: int, //32、24、16
“密鑰”:“012345678eee”,
“streamid”:“r=1”
}
}
}
回覆
設定成功,SRT參數已改變
{
“SRT”:{
“模式”:“監聽”,
「聽」:
{
「啟用」:1,
“端口”:1600,
「延遲」:120,
「加密」:1,
「密鑰長度」:32,
“密鑰”:“012345678eee”,
「主要的 url”:”srt://192.168.1.158:1600?streamid=r=0″,
「子 url”:”srt://192.168.1.158:1600?streamid=r=1″,
}
},
「狀態」:真
}
or
{
“SRT”:{
“模式”:“呼叫者”,
「主要呼叫者」:
{
「啟用」:1,
“IP位址”:“192.168.1.158”,
“端口”:1600,
「延遲」:120,
「加密」:1,
「密鑰長度」:32,
“密鑰”:“012345678eee”,
“streamid”:“r=0”
},
「子調用者」:
{
「啟用」:1,
“IP位址”:“192.168.1.158”,
“端口”:1600,
「延遲」:120,
「加密」:1,
「密鑰長度」:32,
“密鑰”:“012345678eee”,
“streamid”:“r=1”
}
},
「狀態」:真
}
不支援SRT/參數錯誤
{
「狀態」:false
“SRT”:假
}
10.2 SRT參數獲取
要求
{
“SRT”:真
}
回覆
{
“SRT”:{
“模式”:“監聽”,
「聽」:
{
「啟用」:1,
“端口”:1600,
「延遲」:120,
「加密」:1,
「密鑰長度」:32,
“密鑰”:“012345678eee”,
「主要的 url”:”srt://192.168.1.158:1600?streamid=r=0″,
「子 url”:”srt://192.168.1.158:1600?streamid=r=1″,
}
},
「狀態」:真
}
or
{
“SRT”:{
“模式”:“呼叫者”,
「主要呼叫者」:
{
「啟用」:1,
“IP位址”:“192.168.1.158”,
“端口”:1600,
「延遲」:120,
「加密」:1,
「密鑰長度」:32,
“密鑰”:“012345678eee”,
“streamid”:“r=0”
},
「子調用者」:
{
「啟用」:1,
“IP位址”:“192.168.1.158”,
“端口”:1600,
「延遲」:120,
「加密」:1,
「密鑰長度」:32,
“密鑰”:“012345678eee”,
“streamid”:“r=1”
}
},
「狀態」:真
}
or
{
“SRT”:{
“模式”:“會合”,
「主要會合地點」:
{
「啟用」:1,
“IP位址”:“192.168.1.158”,
“端口”:1600,
「延遲」:120,
「加密」:1,
「密鑰長度」:32,
“密鑰”:“012345678eee”,
“streamid”:“r=0”
},
「子會合」:
{
「啟用」:1,
“IP位址”:“192.168.1.158”,
“端口”:1600,
「延遲」:120,
「加密」:1,
「密鑰長度」:32,
“密鑰”:“012345678eee”,
“streamid”:“r=1”
}
},
「狀態」:真
}
不支援 SRT
{
「狀態」:false
“SRT”:假
}
文件/資源
![]() |
AIDA 圖像 HTTP 訪問 [pdf] 使用者指南 HD-NDI-200、HD3G-NDI-200l、HD-NDI-X20、HD-NDI-CUBE、HD-NDI-IP67、HD-NDI-MINI、HD-NDI-VF、HDNDI-TF、HD-NDI3-120、HD-NDI3-IP67、UHDNDI-TF、HD-NDI3-300、HD-NDI3-IP67、UHD3-UHD30-NDI12- Z-X20-IP、PTZ-X12-IP、PTZ-NDI-X18、PTZ-NDI-X20、PTZ-NDI-X3、PTZ-NDI20-X4、PTZ12K-NDI-X4、PTZ30KNDI-X4、PTZ12K30-NDI-XXNUMX、PTZXNUMXKNDI-XXNUMX、PTZXNUMXKXNUMX-DI-XXNUMXKXNUMX-DI-X 存取權限 |




