

מדריך גישה ל-HTTP של AIDA Imaging
למצלמות וידאו IP בלבד
עדכון באוקטובר 2024
מדריך זה נועד לעזור למשתמשים לכתוב וליצור תוכניות משלהם כדי להתחבר ישירות למצלמות שלנו. גמישות זו עוזרת להוסיף ליצירתיות ולפיתול שלך לשליטה במצלמה!
אינך חייב להשתמש במדריך זה כדי להשתמש במצלמה. לא כל ההגדרות במסמך זה מתייחסות לכל דגם, רק אם לדגם יש תכונה מסוימת זו, הגישה לתכונות אלו תפעל.
רשימת מוצרים רלוונטיים:
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-NDI3-IP67, UHD-3NDI, UHD-300 UHD-NDI3-X67
PTZ: PTZ-X12-IP, PTZ-X20-IP, PTZ-NDI-X12, PTZ-NDI-X18, PTZ-NDI-X20, PTZ-NDI3-X20, PTZ4K-NDI-X12, PTZ4K-NDI-X30K4-XDIPTZ12N
*NDI® הוא סימן מסחרי רשום של VIZRT AB
1.1 תחילת העבודה
בעת השימוש במסמך זה צריך להיות בעל הבנה ושליטה מסוימת בפרוטוקול http ובשיטת בקשת ה-POST שלו.
1.2 תקנות דקדוק
HTTP הוא תקן לבקשות ותגובות בין צד הלקוח לשרת. באמצעות א web דפדפן, web סורק, או כלי אחר, הלקוח יוזם בקשת HTTP ליציאה שצוינה בשרת (יציאת ברירת המחדל היא 80). הלקוח מכונה בדרך כלל תוכנית סוכן משתמש. השרת מגיב לבקשת הלקוח ומאחסן כמה משאבים בשרת, כגון HTML files ותמונות. סוג זה של שרת מכונה בדרך כלל א Web שרת.
בקשות בקשת HTTP צריכות לפעול לפי ההנחיות הבאות
כל הפרמטרים מבקשים לעבור דרך "פוסט", עם שתי דרכים שונות להבחין בין קבלת הגדרה להגדרה באמצעות func
הגדר ממשק פרמטר
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
**בקשת כניסה כאקסample**
בקשה זו היא שיטת get, ולכן הבקשה מגדירה את הממשק url, ומשדר את פרמטרי התוכן בפורמט json
תוכן פרמטר
{
"מַעֲרֶכֶת":
{
"login":"משתמש:סיסמה",
}
}
מערכת ה-json string מייצגת את הקריאה לפונקציה הראשית, הכניסה מייצגת את הקריאה לפרמטר. user:password מייצג את הפרמטרים הנכנסים.
למשלample, אם חשבון המצלמה והסיסמה הנוכחיים הם שניהם אדמין, פורמט השידור הסופי הוא
{
"מַעֲרֶכֶת":
{
"login":"admin:admin",
}
}
תוכן החזרה מוחזר לאחר הבקשה, ותוכן החזרה מחזיר פרמטרים שונים בהתאם לשיטה המשמשת לקריאה לפונקציה. שיטת הכניסה מחזירה את תוכן ה-json הבא
הצלחה לחזור
{
"סטטוס": נכון
"מַעֲרֶכֶת":
{
"כניסה":int
}
}
לא מצליחים לחזור
{
"סטטוס": שקר
"מַעֲרֶכֶת":
{
"כניסה": false
}
}
כאשר סטטוס הוא הסטטוס של קריאת הפונקציה , נכון להצלחה ושקר לכישלון.
פורמט ההחזרה הוא בהתאם לפורמט הבקשה, המערכת היא הקריאה לפונקציה הראשית, הכניסה היא הקריאה להחזרת המפתח
הערה: בנוסף לכניסה, כל אינטראקציית פקודה אחרת חייבת לעבור מפתח, התחביר הוא "key":int, והערך של int המצורף ל-"key" הוא הערך המוחזר על ידי פעולת "login" מחזירה את הערך
**קח את ממשק הרשת כאקסample**
ישנם שני ממשקי פרמטרי רשת, שהם קבל פרמטרים של ממשק רשת והגדרת פרמטרים של ממשק רשת. מהאקס לעילample, ניתן לראות את זה
קבל ממשק פרמטרים.
http://192.168.1.180/cgi-bin/web.fcgi?func=get
הגדר ממשק
http://192.168.1.180/cgi-bin/web.fcgi?func=set
**קבל פרמטרי רשת**
{
"key": "הערך המתאים לשדה ההתחברות בממשק ההתחברות",
"ethernet":{"eth0":true}
}
בקשה זו פירושה: אני רוצה להתקשר כדי לקבל את כל הפרמטרים תחת eth0 של ה-ethernet.
החזר רגיל:
{
"סטטוס": נכון,
"אתרנט":
{
"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,
"rtspPort":int,
"rtmpPort":int
}
}
כאשר הממשק תקין, כלומר כאשר המצב הוא 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,
"rtspPort":int,
"rtmpPort":int
}
}
}
כאשר מוגדר בהצלחה, מחרוזת json מוחזרת
{
"סטטוס": נכון,
"אתרנט":
{
"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,
"mainStreamPort”:int,
"subStreamPort”:int
"rtspPort":int
"rtmpPort":int
}
}
1.4 תיאור הבדיקה
ניתן להוריד דוור לבדיקת פרוטוקול (https://www.getpostman.com/downloads/).
את השימוש בתוכנה ניתן למצוא בהוראות הסרטון המצורפות.
2 הגדרות קידוד וידאו
2.1 הגדרת פרמטר קידוד
מַעֲרֶכֶת
בַּקָשָׁה
{
"מפתח":int,
"venc":{
"רָאשִׁי":{
"אפשר":int,
"מוד":"h264", //"h264"、"h265"、"mjpeg"
"col":3840, //int
"line":2160, //int
"bitrate":115200, //int
"frmrate":30, //int
"rcmode":"cbr", //"cbr"、"vbr"
"מִקצוֹעָןfile":"MP", //"baseline"、"MP"、"HP"
"מרווח":30 //int
},
"תַת":{
"אפשר":int,
"mode":"h264",
"col":1280,
"קו":720,
"קצב סיביות":4096,
"frmrate":30,
"rcmode":"cbr",
"מִקצוֹעָןfile":"MP", //"baseline"、"MP"、"HP"
"מרווח": 30
}
}
}
תְגוּבָה
הגדר בהצלחה, החזר את פרמטרי הקידוד העדכניים ביותר
{
"סטטוס": נכון
"venc":{
"רָאשִׁי":{
"אפשר":int,
"mode":"h264",
"col":3840,
"קו":2160,
"קצב סיביות":115200,
"frmrate":30,
"rcmode":"cbr",
"מִקצוֹעָןfile":"MP",
"מרווח": 30
},
"תַת":{
"אפשר":int,
"mode":"h264",
"col":1280,
"קו":720,
"קצב סיביות":4096,
"frmrate":30,
"rcmode":"cbr",
"מִקצוֹעָןfile":"MP",
"מרווח": 30
}
}
}
תצורת קידוד אינה נתמכת
{
"סטטוס": שקר
"venc": false
}
אין תמיכה בזרמים ראשיים או משנה
{
"סטטוס": שקר
"venc":{"main":false,sub":false}
}
שגיאת פרמטר
{
"סטטוס": שקר
"venc":{"main":false}
}
2.2 רכישת פרמטר קידוד
לְקַבֵּל
בַּקָשָׁה
{
"מפתח":int,
"venc":{"main":true,"sub":true}
}
Or
{
"מפתח":int,
"venc":{
"רָאשִׁי":{
"אפשר":נכון,
"מצב": נכון,
"קול": נכון,
"קו": נכון,
"קצב סיביות":נכון,
"frmrate":true,
"rcmode":true,
"מִקצוֹעָןfile":נָכוֹן,
"מרווח": נכון,
"rtspUrl":נָכוֹן
"rtmpUrl":נָכוֹן
},
"תַת":{
"אפשר":נכון,
"מצב": נכון,
"קול": נכון,
"קו": נכון,
"קצב סיביות":נכון,
"frmrate":true,
"rcmode":true,
"מִקצוֹעָןfile":נָכוֹן,
"מרווח": נכון,
"rtspUrl":נָכוֹן
"rtmpUrl":נָכוֹן
}
}
}
תְגוּבָה
{
"סטטוס": נכון,
"venc":{
"רָאשִׁי":{
"אפשר":int,
"mode":"h264",
"col":3840,
"קו":2160,
"קצב סיביות":115200,
"frmrate":30,
"rcmode":"cbr",
"מִקצוֹעָןfile":"MP",
"מרווח":30,
"rtspUrl”:”rtsp://192.168.1.155:554/stream/main”
"rtmpUrl”:”rtmp://192.168.1.155:1935/app/rtmpstream0″
},
"תַת":{
"אפשר":int,
"mode":"h264",
"col":1280,
"קו":720,
"קצב סיביות":4096,
"frmrate":30,
"rcmode":"cbr",
"מִקצוֹעָןfile":"MP",
"מרווח":30,
"rtspUrl":"rtsp://192.168.1.155:554/stream/sub"
"rtmpUrl”:”rtmp://192.168.1.155:1935/app/rtmpstream1″
}
}
}
תצורת קידוד אינה נתמכת
{
"סטטוס":שקר,
"venc":false,
}
אין תמיכה בזרמים ראשיים או משנה
{
"סטטוס":שקר,
"venc":{"main":false}
}
3 קידוד אודיו
3.1 הגדרות קידוד אודיו
מַעֲרֶכֶת
בַּקָשָׁה
{
"מפתח":int,
"שֶׁמַע":{
"אפשר":int,
"samplerate":int,
"רוחב סיביות":int,
"soundMode":"מונו", //"מונו"、"סטריאו"
"encMode":"G711A",
//"G711A"、"G711U"、"ADPCMA"、"G726"、"LPCM"、"AAC"
"bitrate":int //Bps
8000、16000、22000、24000、32000、48000、64000、96000、128000、256000、320000
}
}
תְגוּבָה
הגדר בהצלחה, החזר את הפרמטרים העדכניים ביותר של קידוד האודיו
{
"סטטוס": נכון,
"שֶׁמַע":{
"אפשר":int,
"samplerate":int,
"רוחב סיביות":int,
"soundMode": "מונו",
"encMode":"G711A",
"קצב סיביות":int
}
}
אין תמיכה בקידוד תצורה או שגיאות פרמטרים
{
"סטטוס":שקר,
"אודיו": false
}
3.2 רכישת פרמטרים של קידוד אודיו
לְקַבֵּל
בַּקָשָׁה
{
"מפתח":int,
"אודיו": נכון
}
Or
{
"מפתח":int,
"שֶׁמַע":{
"אפשר":true,
"sampלמסור":נכון,
"רוחב סיביות": נכון,
"soundMode":true,
"encMode":true,
"קצב סיביות": נכון
}
}
הגדר בהצלחה, החזר את הפרמטרים העדכניים ביותר של קידוד האודיו
{
"סטטוס": נכון,
"שֶׁמַע":{
"אפשר":int,
"samplerate":int,
"רוחב סיביות":int,
"soundMode": "מונו",
"encMode":"G711A",
"קצב סיביות":int
}
}
נכשל או לא תמך בפקודה שינוי
{
"סטטוס":שקר,
"אודיו": 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,
"rtspPort":int
"rtmpPort":int
}
}
}
הגדרות רשת אינן נתמכות
{
"סטטוס":שקר,
"ethernet":false,
}
eth0 אינו קיים או אינו תומך בתצורה.
{
"סטטוס":שקר,
"ethernet":{"eth0":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,
"rtspPort":int,
"rtmpPort":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,
"rtspPort":int,
"rtmpPort":int
}
}
4.2 רכישת פרמטרים ברשת
לְקַבֵּל
בַּקָשָׁה:
{
"מפתח":int,
"ethernet":{"eth0":true}
}
or
{
"מפתח":int,
"אתרנט":
{
"eth0":{
"dhcp": נכון,
"ip": נכון,
"מסכת רשת": נכון,
"שער": נכון,
"dns":נכון,
"מק": נכון,
"httpPort":true,
"rtspPort": נכון
"rtmpPort":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,
"rtspPort":int
"rtmpPort":int
}
}
רכישת פרמטרים ברשת אינה נתמכת
{
"סטטוס":שקר,
"ethernet":false,
}
eth0 אינו קיים או אינו תומך בתצורה.
{
"סטטוס":שקר,
"ethernet":{"eth0":false}
}
כמה פרמטרי רשת לא הושגו.
{
"סטטוס":שקר,
"אתרנט":
{
"eth0":{
"dhcp":int // 0 ידני 1 אוטומטי
"ip":false,
"מסכת רשת":"192.168.1.1",
"שער":false,
"dns":"192.168.1.1",
"httpPort":int,
"rtspPort":int
"rtmpPort":int
}
}
}
5 בקרת תמונה
5.1 הגדרות פרמטר תמונה
מַעֲרֶכֶת:
בַּקָשָׁה
{
"מפתח":int,
"תְמוּנָה":
{
"focus_mode":"auto", //"auto","manual"
"focus_distance":"1.5m", //"1.5m","2m","3m","6m","10m"
"exposure_mode":"אוטומטי", //"אוטומטי","ידנית","עדיפות קשתית","עדיפות תריס","עדיפות בהירות"
“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
"iris":int, //0~13
"gain":int, //0~15
"WB_mode":"auto" //"auto","indoor","outdoor","לחיצה אחת","מעקב אוטומטי","ידני"
"R_gain":int, //0~255
"B_gain":int, //0~255
"מראה":int
"להעיף":int,
"kompensation_backlight":int,
"gamma":int, //0~4
"digital_zoom_enable":int,
"WDR_enable":int,
"WDR_level":int, //1~6
"בהירות":int, //0~15
"חדות":int, //0~15
"contrast":int, //0~15
"saturation":int, //0~15
"DC_iris":int, //0: סגור 1: פתוח
"noise_reduction_2D":int,
"noise_reduction_3D":int, //0 auto 1:level1 2:level2 3:level3 4:level4 5:disable
"vo_resolution":"1920X1080P@60Hz"
"איפוס_תמונה":int
"זום": [סוג, מהירות] //סוג 0 זום עצירה 1 הגדלה 2 מהירות הקטנה: 0~7
"פוקוס": [סוג, מהירות] //סוג 0 עצירת מיקוד 1 פוקוס ליד 2 פוקוס מהירות רחוקה: 0~7
"ptz":[type,speed] //type 0 ptz stop 1 up 2 down 3 left 4 right 5 home 6 reset 7 up+left 8 down+left 9 up+right 10 down+right speed:0~0x18
"preset":{"add":int,"del":int,"call":int,"check":int}
"snap":int // לכידת תמונה; =1 enable, לכידה מוצלחת מחזירה true, failure מחזירה false
"abs ctrl":
{
"זום":int,
"פוקוס":int,
"פאן":int,
"הטיה":int
}
}
}
תְגוּבָה
{
"סטטוס": נכון
"תְמוּנָה":
{
"focus_mode":"auto", //"auto","manual"
"focus_distance":"1.5m", //"1.5m","2m","3m","6m","10m"
"exposure_mode":"אוטומטי", //"אוטומטי","ידנית","עדיפות קשתית","עדיפות תריס","עדיפות בהירות"
“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:close 1:50Hz 2:60Hz
"בהירות_חשיפה":int, //0~27
"iris":int, //0~13
"gain":int, //0~15
"WB_mode":"auto" //"auto","indoor","outdoor","לחיצה אחת","מעקב אוטומטי","ידני"
"R-gain":int, //0~255
"B-gain":int, //0~255
"מראה":int
"להעיף":int,
"kompensation_backlight":int,
"gamma":int, //int
"digital_zoom_enable":int,
"WDR_enable":int,
"WDR_level":int, //1~6
"בהירות":int, //0~15
"חדות":int, //0~15
"contrast":int, //0~15
"saturation":int, //0~15
"DC_iris":int, // 0: סגור 1: פתוח
"noise_reduction_2D":int,
"noise_reduction_3D":int, //0 auto 1:level1 2:level2 3:level3 4:level4 5:disable
"vo_resolution":"1920X1080P@60Hz"
"איפוס תמונה": נכון
"זום": נכון
"פוקוס": נכון
"ptz": נכון
"קבע מראש": נכון
"הצמד": נכון
"abs ctrl": נכון
}
}
אם הוא נכשל, פסקת המשנה המתאימה מוגדרת כ-false, למשלample
{
"סטטוס": שקר
"תְמוּנָה":
{
"focus_mode":"auto", //"auto","manual"
"focus_distance":false,
"exposure_mode":"אוטומטי", //"אוטומטי","ידנית","עדיפות קשתית","עדיפות תריס","עדיפות בהירות"
“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:close 1:50Hz 2:60Hz
"חשיפה_בהירות":false,
"iris":int, //0~13
"gain":int, //0~15
"WB_mode":"auto" //"auto","indoor","outdoor","לחיצה אחת","מעקב אוטומטי","ידני"
"R-gain":int, //0~255
"B-gain":int, //0~255
"מראה":false,
"להעיף":int,
"kompensation_backlight":int,
"gamma":int, //int
"digital_zoom_enable":int,
"WDR_enable":int,
"WDR_level":int, //1~6
"בהירות":int, //0~15
"חדות":int, //0~15
"contrast":int, //0~15
"saturation":int, //0~15
"noise_reduction_2D":int,
"noise_reduction_3D":int, //0 auto 1:level1 2:level2 3:level3 4:level4 5:disable
"vo_resolution":"1920X1080P@60Hz"
"איפוס תמונה":true,
"זום": נכון,
"פוקוס": נכון,
"ptz": נכון,
"preset":false,
"snap": false
"abs ctrl":false
}
}
5.2 רכישת פרמטר תמונה
לְקַבֵּל
בַּקָשָׁה
{
"מפתח":int,
"תְמוּנָה":{
"מצב_focus":true,
"מרחק_מיקוד": נכון,
"מצב_חשיפה":true,
"תריס": נכון,
"anti_flicker":true,
"בהירות_חשיפה": נכון,
"איריס": נכון,
"רווח": נכון,
"WB_mode":true,
"R_gain":true,
"B_gain":true,
"מראה":נכון,
"להעיף": נכון,
"פיצוי_מאחורי":true,
"גמא": נכון,
"digital_zoom_enable":true,
"WDR_enable":true,
"WDR_level":true,
"בהירות": נכון,
"חדות": נכון,
"קונטרה":נכון,
"רוויה": נכון,
"DC_iris":true,
"noise_reduction_2D":true,
"noise_reduction_3D":true,
"vo_resolution":true,
"vo_support":true,
"קצב_פריים":true,
"preset":int
"זום": נכון,
"פוקוס": נכון,
"פאן": נכון,
"הטיה": נכון
}
}
תְגוּבָה
להשיג הצלחה, להחזיר ערך יחסי
{
"סטטוס": נכון
"תְמוּנָה":
{
"focus_mode":"auto", //"auto","manual"
"focus_distance":"1.5m", //"1.5m","2m","3m","6m","10m"
"exposure_mode":"אוטומטי", //"אוטומטי","ידנית","עדיפות קשתית","עדיפות תריס","עדיפות בהירות"
“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:close 1:50Hz 2:60Hz
"בהירות_חשיפה":int, //0~27
"iris":int, //0~13
"gain":int, //0~15
"WB_mode":"auto" //"auto","indoor",,"outdoor",,"one push",,"auto_tracking","manual","sodium","fluorescent"
"R_gain":int, //0~255
"B_gain":int, //0~255
"מראה":int
"להעיף":int,
"kompensation_backlight":int,
"gamma":int, //int
"digital_zoom_enable":int,
"WDR_enable":int,
"WDR_level":int, //1~6
"בהירות":int, //0~15
"חדות":int, //0~15
"contrast":int, //0~15
"saturation":int, //0~15
"DC_iris":int, // 0: סגור 1: פתוח
"noise_reduction_2D":int,
"noise_reduction_3D":int, //0 auto 1:level1 2:level2 3:level3 4:level4 5:disable
"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 ביחס לפריטי המשנה, למשל:
{
"סטטוס": שקר
"תְמוּנָה":
{
"focus_mode":"auto", //"auto","manual"
"focus_distance":"1.5m", //"1.5m","2m","3m","6m","10m"
"exposure_mode":"אוטומטי", //"אוטומטי","ידנית","עדיפות קשתית","עדיפות תריס","עדיפות בהירות"
“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:close 1:50Hz 2:60Hz
"בהירות_חשיפה":int, //0~27
"iris":int, //0~13
"gain":int, //0~15
"WB_mode":false,
"R_gain":false,
"B_gain":false,
"מראה":false,
"להעיף":int,
"kompensation_backlight":int,
"gamma":int, //int
"digital_zoom_enable":int,
"WDR_enable":int,
"WDR_level":int, //1~6
"בהירות":int, //0~15
"חדות":int, //0~15
"contrast":int, //0~15
"saturation":int, //0~15
"noise_reduction_2D":int,
"noise_reduction_3D":int, //0 auto 1:level1 2:level2 3:level3 4:level4 5:disable
"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": false
}
}
6 הזרמת RTMP
6.1 הגדרת פרמטר RTMP Streaming
מַעֲרֶכֶת
בַּקָשָׁה
{
"מפתח":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 אינה נתמכת
{
"סטטוס": שקר
"rtmp":false
}
לא תומך בתצורת זרם ראשי או משנה
{
"סטטוס":שקר,
"rtmp":{"main":false,sub":false}
}
שגיאת פרמטר
{
"סטטוס":שקר,
"rtmp":{"main":false}
}
6.2 רכישת פרמטרים של RTMP Streaming
לְקַבֵּל
בַּקָשָׁה
{
"מפתח":int,
"rtmp":{"main":true,"sub":true}
}
or
{
"מפתח":int,
"rtmp":{
"רָאשִׁי":{
"אפשר":נכון,
"url":נָכוֹן,
},
"תַת":{
"אפשר":נכון,
"url":נָכוֹן,
},
}
}
תְגוּבָה
{
"סטטוס": נכון,
"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 אינה נתמכת
{
"סטטוס": שקר
"rtmp":false
}
לא תומך בתצורת זרם ראשי או משנה
{
"סטטוס":שקר,
"rtmp":{"main":false,sub":false}
}
שגיאת פרמטר
{
"סטטוס":שקר,
"rtmp":{"main":false}
}
7 בקרת מערכת
7.1 הגדרות בקרת מערכת
מַעֲרֶכֶת
בַּקָשָׁה:
{
"מפתח":int,
"מַעֲרֶכֶת":
{
"system_control":"image reset",//"image_reset" איפוס פרמטר תמונה, "factory_reset" איפוס יצרן, "system_reboot" אתחול המערכת
"login":"משתמש:סיסמה",
}
}
תְגוּבָה:
הגדר בהצלחה
בַּקָשָׁה:
{
"סטטוס": נכון
"מַעֲרֶכֶת":
{
"בקרת_מערכת": נכון
"login":int // החזר ערך מפתח, כל האינטראקציות של json חייבות לכלול את הפריט "key":int, אחרת הפקודה לא תגיב
}
}
ההגדרה נכשלה
{
"סטטוס": שקר
"מַעֲרֶכֶת":
{
"system_control":false
"כניסה": false
}
}
7.2 רכישת בקרת מערכת
לְקַבֵּל:
בַּקָשָׁה:
{
"מפתח":int,
"מַעֲרֶכֶת":
{
"שם_מכשיר":true,
"מספר_סידורי":true,
"bootloader_version":true,
"system_version":true,
"app_version":true,
"גרסה_חומרה": נכון
"כניסה":"משתמש:סיסמה"
}
}
תְגוּבָה:
הצלחה ברכישה
{
"סטטוס": נכון
"מַעֲרֶכֶת":
{
"device_name":"מצלמת ועידת וידאו FHD",
“serial_number”:”123456789″,
"bootloader_version":"V1.0.0",
"system_version":"V1.0.0",
"app_version":"V1.0.0"
"hardware_version":"V1.0.0"
"login":int // החזר ערך מפתח, כל האינטראקציות של json חייבות לכלול את הפריט "key":int, אחרת הפקודה לא תגיב
}
}
הרכישה נכשלה
{
"סטטוס": שקר
"מַעֲרֶכֶת":
{
"שם_מכשיר":שקר,
“serial_number”:”123456789″,
"bootloader_version":"V1.0.0",
"system_version":"V1.0.0",
"app_version":"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}}}

Example 3: שאילת מיקום ptz

8. מעקב אוטומטי (אם זמין)
8.1 רכישת פרמטרים של מעקב אוטומטי
לְקַבֵּל:
בַּקָשָׁה
{
"ai": נכון
}
or
{
"ai":{
"אפשר": נכון,
"peoplePos": נכון,
"peopleRation": נכון,
"switchTime": נכון,
"boardDetectEn": נכון,
"highLightTarget":true,
"ZoomLock":true,
"PTLimit": נכון
}
}
קבל בהצלחה, חזרה לפרמטרים העדכניים ביותר
{
"ai": {
"אפשר": 1,
"peoplePos": 2,
"PeopleRation": 6,
"SwitchTime": 20,
"boardDetectEn": 1,
"highLightTarget": 0,
"ZoomLock": 1,
"PTLimit": 1
},
"סטטוס": נכון
}
לא תומך בפרמטרים או חריגים
{
"סטטוס":שקר,
"ai": שקר
}
הגדרת מיקום מוגדר מראש מיוחד:
מס' 255 מוגדר מראש: עמדת בית;
הגדרה מראש מס' 254: מיקום הגבלה ימינה למטה;
הגדרה מראש מס' 253: תנוחת גבול שמאלה למעלה;
הגדרה מראש מס' 252: מיקום הלוח
9 הגדרות NDI
9.1 הגדרות פרמטר NDI
בַּקָשָׁה
{
"NDI":{
"אפשר":int,
"שם מכשיר":"HX",
"שם ערוץ":"ערוץ1",
"קבוצות":"ציבורי",
"multicast": {
"אפשר": 0,
"IP": "239.255.0.0",
"מסכה": "255.255.0.0",
"TTL": 1
},
"שרת גילוי":"192.168.1.42"
}
}
תְגוּבָה
ההגדרה הצליחה, ופרמטרי NDI משתנים.
{
"NDI":{
"אפשר":1,
"שם מכשיר":"HX",
"שם ערוץ":"ערוץ1",
"קבוצות":"ציבורי",
"multicast": {
"אפשר": 0,
"IP": "239.255.0.0",
"מסכה": "255.255.0.0",
"TTL": 1
},
"שרת גילוי":"192.168.1.42"
},
"סטטוס": נכון
}
תצורת NDI אינה נתמכת
{
"סטטוס": שקר
"NTP": false
}
שגיאת פרמטר
{
"NDI":{
"אפשר":1,
"שם מכשיר":"HX",
"שם ערוץ":"ערוץ1",
"קבוצות":"ציבורי",
"multicast": {
"אפשר": 0,
"IP": "239.255.0.0",
"מסכה": "255.255.0.0",
"TTL": 1
},
"שרת גילוי": false
},
"סטטוס": שקר
}
9.2 רכישת פרמטרים של NDI
בַּקָשָׁה
{
"NDI":{
"אפשר":true,
"שם מכשיר":true,
"שם ערוץ":true,
"קבוצות": נכון,
"multicast":true,
"שרת גילוי": נכון
}
}
或
{
"NDI": נכון
}
תְגוּבָה
{
"NDI":{
"אפשר":1,
"שם מכשיר":"HX",
"שם ערוץ":"ערוץ1",
"קבוצות":"ציבורי"
"multicast": {
"אפשר": 0,
"IP": "239.255.0.0",
"מסכה": "255.255.0.0",
"TTL": 1
},
"שרת גילוי":"192.168.1.42",
},
"סטטוס": נכון
}
לא תומך ב-NDI
{
"סטטוס": שקר
"NDI": שקר
}
10 הגדרות SRT
10.1 פרמטרים של SRT
בַּקָשָׁה
{
"SRT":{
"מוד":"האזנה", //"להקשיב"、"מתקשר"、"פגישה"
"לְהַקְשִׁיב":
{
"אפשר":int,
"פורט":int,
"חביון":int, // אלפיות שניות
"הצפנה": int,
"אורך מפתח": int, //32、24、16
"key": "012345678",
}
}
}
or
{
"SRT":{
"מצב":"מתקשר", //"האזין"、"מתקשר"、"פגישה"
"מתקשר ראשי":
{
"אפשר":int,
"ip":"192.168.1.158",
"פורט":int,
"חביון":int, //מילישניות
"הצפנה": int,
"אורך מפתח": int, //32、24、16
"key": "012345678eee",
"streamid":"r=0"
},
"מתקשר משנה":
{
"אפשר":int,
"ip":"192.168.1.158",
"פורט":int,
"חביון":int, // אלפית שנייה
"streamid":"r=0"
"הצפנה": int,
"אורך מפתח": int, //32、24、16
"key": "012345678eee",
"streamid":"r=1"
}
}
}
or
{
"SRT":{
"מוד":"פגישה", //"האזנה"、"מתקשר"、"מפגש"
"מפגש ראשי":
{
"אפשר":int,
"ip":"192.168.1.158",
"פורט":int,
"השהיה":int, //millilecond
"הצפנה": int,
"אורך מפתח": int, //32、24、16
"key": "012345678eee",
"streamid":"r=0"
},
"מפגש משנה":
{
"אפשר":int,
"ip":"192.168.1.158",
"פורט":int,
"חביון":int, //מילישניה
"streamid":"r=0"
"הצפנה": int,
"אורך מפתח": int, //32、24、16
"key": "012345678eee",
"streamid":"r=1"
}
}
}
תְגוּבָה
ההגדרה הצליחה, פרמטרי SRT השתנו
{
"SRT":{
"מצב": "האזנה",
"לְהַקְשִׁיב":
{
"אפשר":1,
"נמל":1600,
"חביון":120,
"הצפנה": 1,
"אורך מפתח": 32,
"key": "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,
"key": "012345678eee",
"streamid":"r=0"
},
"מתקשר משנה":
{
"אפשר":1,
"ip":"192.168.1.158",
"נמל":1600,
"חביון":120,
"הצפנה": 1,
"אורך מפתח": 32,
"key": "012345678eee",
"streamid":"r=1"
}
},
"סטטוס": נכון
}
SRT אינו נתמך / שגיאת פרמטר
{
"סטטוס": שקר
"SRT": שקר
}
10.2 רכישת פרמטר SRT
בַּקָשָׁה
{
"SRT": נכון
}
תְגוּבָה
{
"SRT":{
"מצב": "האזנה",
"לְהַקְשִׁיב":
{
"אפשר":1,
"נמל":1600,
"חביון":120,
"הצפנה": 1,
"אורך מפתח": 32,
"key": "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,
"key": "012345678eee",
"streamid":"r=0"
},
"מתקשר משנה":
{
"אפשר":1,
"ip":"192.168.1.158",
"נמל":1600,
"חביון":120,
"הצפנה": 1,
"אורך מפתח": 32,
"key": "012345678eee",
"streamid":"r=1"
}
},
"סטטוס": נכון
}
or
{
"SRT":{
"מוד":"מפגש",
"מפגש ראשי":
{
"אפשר":1,
"ip":"192.168.1.158",
"נמל":1600,
"איחור": 120,
"הצפנה": 1,
"אורך מפתח": 32,
"key": "012345678eee",
"streamid":"r=0"
},
"תת מפגש":
{
"אפשר":1,
"ip":"192.168.1.158",
"נמל":1600,
"חביון":120,
"הצפנה": 1,
"אורך מפתח": 32,
"key": "012345678eee",
"streamid":"r=1"
}
},
"סטטוס": נכון
}
SRT אינו נתמך
{
"סטטוס": שקר
"SRT": שקר
}
מסמכים / משאבים
![]() | הדמיה של גישת HTTP |
הפניות
- 192.168.1.180/cgi-bin/web.fcgi?func=get192.168.1.180
- 192.168.1.180/cgi-bin/web.fcgi?func=set192.168.1.180
- 192.168.1.189/cgi-bin/web.fcgi?func=get192.168.1.189
- 192.168.1.189/cgi-bin/web.fcgi?func=set192.168.1.189
- 192.168.2.141/cgi-bin/web.fcgi?func=get192.168.2.141
- הורד דוור | התחל בחינםwww.getpostman.com
- מדריך למשתמשmanual.tools
