PTZ ट्रैकिंग (ONVIF)
किसी वस्तु का अनुसरण करने के लिए ONVIF-संगत PTZ कैमरे को नियंत्रित करें
ONVIF-संगत PTZ (Pan-Tilt-Zoom) कैमरे को नियंत्रित करें ताकि वह स्वतः पहचानी गई वस्तुओं का अनुसरण करे, पूर्वनिर्धारित स्थितियों पर जाए, और निगरानी, सुरक्षा मॉनिटरिंग, तथा स्वचालित कैमरा नियंत्रण वर्कफ़्लो के लिए PID नियंत्रण का उपयोग करके सुचारू ट्रैकिंग बनाए रखे।
यह ब्लॉक कैसे काम करता है
यह ब्लॉक ONVIF प्रोटोकॉल के माध्यम से PTZ कैमरों को नियंत्रित करता है ताकि वस्तुओं को वास्तविक समय में स्वतः ट्रैक और फ़ॉलो किया जा सके। यह ब्लॉक:
अपस्ट्रीम ब्लॉक्स से ऑब्जेक्ट डिटेक्शन या इंस्टेंस सेगमेंटेशन प्रेडिक्शन्स प्राप्त करता है
IP पता, पोर्ट, उपयोगकर्ता नाम, और पासवर्ड क्रेडेंशियल्स का उपयोग करके ONVIF-संगत PTZ कैमरे से जुड़ता है
गति मोड निर्धारित करता है (फ़ॉलो या प्रीसेट पर जाएँ):
फ़ॉलो मोड के लिए:
ट्रैक करने के लिए लक्ष्य वस्तु चुनता है: या तो सबसे उच्च विश्वसनीयता वाली डिटेक्शन या कोई विशिष्ट ट्रैक की गई वस्तु (यदि ट्रैकर IDs मौजूद हों)
वस्तु के बाउंडिंग बॉक्स केंद्र की तुलना फ्रेम केंद्र से करके स्थिति त्रुटि की गणना करता है
सुचारू मूवमेंट कमांड की गणना करने के लिए PID (Proportional-Integral-Derivative) नियंत्रण का उपयोग करता है:
आनुपातिक (Kp): वर्तमान स्थिति त्रुटि पर प्रतिक्रिया करता है
समाकलित (Ki): समय के साथ स्थिर-अवस्था त्रुटियों को ठीक करता है
अवकलन (Kd): भविष्य की त्रुटि का अनुमान लगाता है और दोलनों को कम करता है
मूवमेंट कमांड्स को कैमरे की वेग सीमाओं के अनुसार सामान्यीकृत करता है और कमांड फ़्लडिंग रोकने के लिए दर-सीमित करता है
ONVIF ContinuousMove सेवा के माध्यम से कैमरे को निरंतर मूवमेंट कमांड भेजता है
डेड ज़ोन की निगरानी करता है (केंद्र के आसपास का क्षेत्र जहाँ कैमरा हिलना बंद कर देता है) ताकि हंटिंग व्यवहार रोका जा सके
वैकल्पिक रूप से, जब वस्तु केंद्र में हो, तो उस पर ज़ूम करता है, और फ्रेम को भरने के लिए ज़ूम गति समायोजित करता है
ट्रैकर IDs का उपयोग करके किसी विशिष्ट वस्तु की ट्रैकिंग बनाए रखता है, जब तक वह गायब न हो जाए या ट्रैकिंग रीसेट न हो जाए
जब कोई वस्तु नहीं मिलती, तो कॉन्फ़िगर किए जा सकने वाले निष्क्रिय अवधि के बाद स्वचालित रूप से एक प्रीसेट स्थिति पर चला जाता है
प्रीसेट पर जाने के मोड के लिए:
ONVIF GotoPreset सेवा का उपयोग करके कैमरे को पूर्वनिर्धारित प्रीसेट स्थिति पर ले जाता है
आवश्यक है कि कैमरा प्रीसेट कार्यक्षमता का समर्थन करे और प्रीसेट कॉन्फ़िगर किए गए हों
कॉन्फ़िगरेशन में निर्दिष्ट प्रीसेट नाम का उपयोग करता है
वर्कफ़्लो निष्पादन को ब्लॉक होने से बचाने के लिए अलग इवेंट लूप का उपयोग करके कैमरा संचार को असिंक्रोनस रूप से संभालता है
सेकिंग स्थिति, ट्रैक किए गए ऑब्जेक्ट IDs, ज़ूम स्थिति, और मूवमेंट इतिहास सहित कैमरा स्थिति का प्रबंधन करता है
दो आउटपुट लौटाता है:
भविष्यवाणियाँ: ट्रैक की जा रही डिटेक्शन (यदि कोई वस्तु फ़ॉलो नहीं की जा रही है तो खाली)
खोज: एक बूलियन जो दर्शाता है कि क्या कैमरा वर्तमान में किसी वस्तु को मूव/खोज रहा है
यह ब्लॉक वस्तु केंद्र और फ्रेम केंद्र के बीच की दूरी के आधार पर सुचारू, आनुपातिक मूवमेंट कमांड की गणना करने के लिए PID नियंत्रण का उपयोग करता है। मूवमेंट को कैमरे की अधिकतम गति के प्रतिशत के रूप में सामान्यीकृत किया जाता है, और अपडेट्स की अधिकता से कैमरे को बचाने के लिए कमांड्स को दर-सीमित किया जाता है। डेड ज़ोन तब छोटे मूवमेंट को रोकता है जब वस्तु केंद्र के पास हो, जिससे हंटिंग व्यवहार कम होता है। जब ज़ूम सक्षम होता है, तो कैमरा पहले pan/tilt से वस्तु को केंद्र में लाता है, फिर फ्रेम को भरने के लिए ज़ूम इन करता है जबकि वस्तु को दृश्य में बनाए रखता है।
सामान्य उपयोग के मामले
निगरानी और सुरक्षा: निगरानी परिदृश्यों में व्यक्तियों या वाहनों को स्वचालित रूप से ट्रैक करें (जैसे, संदिग्ध गतिविधि का अनुसरण, घुसपैठियों को ट्रैक करना, सुरक्षा परिधि की निगरानी), जिससे स्वचालित निगरानी वर्कफ़्लो सक्षम होते हैं
खेल और इवेंट कवरेज: खेल आयोजनों या प्रदर्शनों के दौरान खिलाड़ियों या वस्तुओं को ट्रैक करें (जैसे, मैदान में खिलाड़ियों का अनुसरण, गेंद की गति को ट्रैक करना, इवेंट एक्शन को कवर करना), जिससे स्वचालित खेल कवरेज वर्कफ़्लो सक्षम होते हैं
वन्यजीव मॉनिटरिंग: प्राकृतिक आवासों में जानवरों या वन्यजीवों का अनुसरण करें (जैसे, पक्षियों की गति को ट्रैक करना, अभयारण्यों में जानवरों का अनुसरण, वन्यजीव व्यवहार की निगरानी), जिससे वन्यजीव अवलोकन वर्कफ़्लो सक्षम होते हैं
औद्योगिक मॉनिटरिंग: औद्योगिक सेटिंग्स में वस्तुओं या कर्मियों का स्वचालित रूप से अनुसरण करें (जैसे, उपकरणों की गति को ट्रैक करना, कर्मचारियों की गतिविधियों की निगरानी, सुविधाओं में वाहनों का अनुसरण), जिससे औद्योगिक स्वचालन वर्कफ़्लो सक्षम होते हैं
ट्रैफ़िक मॉनिटरिंग: ट्रैफ़िक परिदृश्यों में वाहनों या वस्तुओं को ट्रैक करें (जैसे, चौराहों से गुजरते वाहनों का अनुसरण, ट्रैफ़िक उल्लंघनों को ट्रैक करना, सड़क गतिविधि की निगरानी), जिससे स्वचालित ट्रैफ़िक मॉनिटरिंग वर्कफ़्लो सक्षम होते हैं
खुदरा विश्लेषण: रिटेल वातावरण में ग्राहकों या उत्पादों को ट्रैक करें (जैसे, ग्राहक पथों का अनुसरण, उत्पाद इंटरैक्शन को ट्रैक करना, खरीदारी व्यवहार की निगरानी), जिससे रिटेल एनालिटिक्स वर्कफ़्लो सक्षम होते हैं
अन्य ब्लॉकों से जोड़ना
यह ब्लॉक प्रेडिक्शन्स प्राप्त करता है और कैमरा नियंत्रण कमांड तथा ट्रैकिंग स्थिति उत्पन्न करता है:
ऑब्जेक्ट डिटेक्शन या इंस्टेंस सेगमेंटेशन ब्लॉक्स के बाद कैमरे के साथ पहचानी गई वस्तुओं को ट्रैक करने के लिए (जैसे, पहचाने गए लोगों का अनुसरण, पहचाने गए वाहनों को ट्रैक करना, पहचानी गई वस्तुओं की निगरानी), जिससे डिटेक्शन-से-कैमरा-ट्रैकिंग वर्कफ़्लो सक्षम होते हैं
Byte Tracker ब्लॉक्स के बाद सुसंगत IDs वाली विशिष्ट ट्रैक की गई वस्तुओं का अनुसरण करने के लिए (जैसे, फ्रेम्स में ट्रैक किए गए व्यक्ति का अनुसरण, किसी विशिष्ट वाहन का ट्रैक बनाए रखना, ट्रैक की गई वस्तु की निरंतर निगरानी), जिससे ट्रैकिंग-से-कैमरा वर्कफ़्लो सक्षम होते हैं
डिटेक्शन फ़िल्टर ब्लॉक्स के बाद विशिष्ट वस्तु वर्गों या फ़िल्टर की गई डिटेक्शन्स को ट्रैक करने के लिए (जैसे, केवल विशिष्ट वर्गों को ट्रैक करना, फ़िल्टर की गई डिटेक्शन्स का अनुसरण, चयनित वस्तुओं की निगरानी), जिससे फ़िल्टर्ड-ट्रैकिंग वर्कफ़्लो सक्षम होते हैं
विज़ुअलाइज़ेशन ब्लॉकों से पहले कैमरा मूवमेंट स्थिति और ट्रैक की गई वस्तुओं को प्रदर्शित करने के लिए (जैसे, ट्रैकिंग स्थिति को विज़ुअलाइज़ करना, खोज संकेतक दिखाना, कैमरा नियंत्रण फीडबैक दिखाना), जिससे कैमरा नियंत्रण विज़ुअलाइज़ेशन वर्कफ़्लो सक्षम होते हैं
सूचना ब्लॉक्स से पहले जब कैमरा ट्रैकिंग शुरू या बंद करे, तब अलर्ट देने के लिए (जैसे, ट्रैकिंग शुरू होने पर सूचना देना, ट्रैकिंग खोने पर अलर्ट, कैमरा स्थिति रिपोर्ट करना), जिससे कैमरा स्थिति सूचना वर्कफ़्लो सक्षम होते हैं
निगरानी और मॉनिटरिंग पाइपलाइनों में जहाँ स्वचालित कैमरा नियंत्रण किसी बड़े सुरक्षा या मॉनिटरिंग सिस्टम का हिस्सा हो (जैसे, स्वचालित सुरक्षा प्रणालियाँ, मॉनिटरिंग पाइपलाइन्स, कैमरा नियंत्रण चेन), जिससे व्यापक निगरानी वर्कफ़्लो सक्षम होते हैं
आवश्यकताएँ
इस ब्लॉक के लिए नेटवर्क एक्सेस वाला ONVIF-संगत PTZ कैमरा आवश्यक है। कैमरे को Follow मोड के लिए ONVIF ContinuousMove सेवा और preset movement के लिए GotoPreset सेवा का समर्थन करना चाहिए। सर्वोत्तम प्रदर्शन के लिए, परिवर्ती गति (variable speed) मूवमेंट क्षमता वाले कैमरे का उपयोग करें - जिन कैमरों में variable speed नहीं है, वे simulate_variable_speed विकल्प का उपयोग कर सकते हैं, लेकिन उनमें झटकेदार मूवमेंट हो सकता है। ब्लॉक को स्थानीय निष्पादन मोड में चलना चाहिए (दूरस्थ/क्लाउड निष्पादन के लिए उपयुक्त नहीं)। सुचारू ट्रैकिंग प्राप्त करने के लिए, बिना ओवरशूट या हंटिंग के PID ट्यूनिंग की सिफारिश की जाती है - camera responsiveness और video latency के आधार पर pid_kp, pid_ki, और pid_kd पैरामीटर समायोजित करें। सटीक ट्रैकिंग के लिए, कैमरा मूवमेंट और वीडियो फ़ीडबैक के बीच लैग कम करने हेतु eager buffer consumption रणनीति का उपयोग करें। यदि preset movement या auto-reset कार्यक्षमता का उपयोग किया जा रहा हो, तो कैमरे में presets कॉन्फ़िगर किए होने चाहिए।
प्रकार पहचानकर्ता
स्टेप में निम्नलिखित पहचानकर्ता का उपयोग करें "type" फील्ड: roboflow_core/onvif_sink@v1 अपने वर्कफ़्लो में ब्लॉक को एक स्टेप के रूप में जोड़ने के लिए।
गुण
नाम
प्रकार
विवरण
संदर्भ
name
str
इस स्टेप के लिए एक अद्वितीय पहचानकर्ता दर्ज करें..
❌
camera_ip
str
ONVIF कनेक्शन के लिए कैमरे का IP पता या होस्टनाम। यह वर्कफ़्लो निष्पादन वातावरण से पहुँच योग्य होना चाहिए।.
✅
camera_port
int
कैमरे का ONVIF सेवा पोर्ट (आमतौर पर 80, 8080, या कैमरा-विशिष्ट पोर्ट)। यह कैमरे के ONVIF कॉन्फ़िगरेशन से मेल खाना चाहिए।.
✅
camera_username
str
ONVIF प्रमाणीकरण के लिए कैमरे का उपयोगकर्ता नाम। कैमरे पर PTZ नियंत्रण अनुमतियाँ होनी चाहिए।.
✅
camera_password
str
ONVIF प्रमाणीकरण के लिए कैमरे का पासवर्ड। सुरक्षा के लिए इसे सीक्रेट के रूप में संग्रहीत किया जाना चाहिए।.
✅
movement_type
str
कैमरे के लिए मूवमेंट मोड। 'Follow' मोड PID नियंत्रण का उपयोग करके पहचानी गई वस्तुओं को ट्रैक करता है। 'Go To Preset' मोड कैमरे को पूर्वनिर्धारित प्रीसेट स्थिति पर ले जाता है (इसके लिए default_position_preset को कॉन्फ़िगर करना आवश्यक है)।.
❌
simulate_variable_speed
bool
मूल variable speed समर्थन के बिना कैमरों के लिए variable speed सिमुलेशन सक्षम करें। सक्षम होने पर, प्रतिशत गति का अनुमान लगाने के लिए 100% गति कमांड भेजे जाते हैं, फिर stop कमांड भेजे जाते हैं। इससे झटकेदार मूवमेंट हो सकता है - केवल तभी उपयोग करें जब कैमरे में variable speed क्षमता न हो।.
✅
zoom_if_able
bool
ट्रैक की गई वस्तु के साथ फ्रेम भरने के लिए स्वचालित ज़ूम सक्षम करें। सक्षम होने पर, कैमरा पहले pan/tilt से वस्तु को केंद्र में लाता है, फिर तब तक ज़ूम इन करता है जब तक वस्तु फ्रेम को भर न दे। इसके लिए कैमरे में ज़ूम कार्यक्षमता का समर्थन होना चाहिए।.
✅
follow_tracker
bool
ट्रैकर IDs का उपयोग करके स्थायी ट्रैकिंग सक्षम करें। सक्षम होने पर, कैमरा सबसे उच्च विश्वसनीयता वाली डिटेक्शन के ट्रैकर ID पर लॉक हो जाता है और उस विशिष्ट वस्तु का अनुसरण तब तक जारी रखता है जब तक वह गायब न हो जाए या ट्रैकिंग रीसेट न हो जाए। ट्रैकर IDs असाइन करने के लिए वर्कफ़्लो में Byte Tracker ब्लॉक आवश्यक है।.
✅
dead_zone
int
फ्रेम केंद्र के आसपास डेड ज़ोन का आकार, जहाँ कैमरा मूवमेंट रुक जाता है। जब वस्तु केंद्र के पास हो, तब हंटिंग व्यवहार को रोकता है। बड़े मान pan/tilt हंटिंग को कम करते हैं, लेकिन zoom hunting का कारण बन सकते हैं। छोटे मान ज़ूम स्थिरता में सुधार करते हैं, लेकिन pan/tilt दोलन पैदा कर सकते हैं। सामान्य सीमा: 30-100 पिक्सेल।.
✅
default_position_preset
str
डिफ़ॉल्ट/होम स्थिति के लिए प्रीसेट नाम। निष्क्रिय अवधि के बाद (यदि move_to_position_after_idle_seconds सेट है) या Go To Preset मोड का उपयोग करते समय कैमरा इस प्रीसेट पर वापस आएगा। कैमरे पर कॉन्फ़िगर किए गए प्रीसेट नाम से बिल्कुल मेल खाना चाहिए। प्रीसेट मूवमेंट कार्यक्षमता के लिए आवश्यक।.
✅
move_to_position_after_idle_seconds
int
ऑटो-रीसेट समय सेकंड में। इस अवधि तक कैमरा खोज/मूव करना बंद करने के बाद, स्वचालित रूप से default_position_preset पर चला जाता है। ऑटो-रीसेट अक्षम करने के लिए 0 सेट करें। इसके लिए default_position_preset को कॉन्फ़िगर किया होना चाहिए।.
✅
camera_update_rate_limit
int
कैमरा मूवमेंट कमांड्स के बीच न्यूनतम समय, मिलीसेकंड में। कैमरे पर अधिक भार से बचाने के लिए ONVIF अपडेट्स को दर-सीमित करता है। कम मान अधिक प्रतिक्रियाशील ट्रैकिंग देते हैं, लेकिन धीमे कैमरों पर ओवरलोड हो सकता है। अधिक मान कैमरा लोड कम करते हैं, लेकिन मूवमेंट कम सुचारू हो सकता है। सामान्य सीमा: 100-500ms।.
✅
flip_x_movement
bool
क्षैतिज (pan) मूवमेंट दिशा उलटें। यदि कैमरे की छवि क्षैतिज रूप से मिरर की गई है और मूवमेंट उल्टा दिखाई देता है, तो इसे सक्षम करें। छवि फ्लिप होने पर कैमरा मूवमेंट को ठीक करने के लिए उपयोग करें।.
✅
flip_y_movement
bool
ऊर्ध्वाधर (tilt) मूवमेंट दिशा उलटें। कई कैमरों में Y-अक्ष उल्टा होने के कारण यह डिफ़ॉल्ट रूप से सक्षम है। यदि ऊर्ध्वाधर मूवमेंट उल्टा दिखाई देता है, तो इसे अक्षम करें।.
✅
minimum_camera_speed
float
न्यूनतम मूवमेंट गति प्रतिशत के रूप में (0.0-1.0)। इस सीमा से नीचे के मूवमेंट कमांड्स को इस न्यूनतम तक बढ़ाया जाता है। कुछ कैमरे बहुत कम गति को अनदेखा करते हैं - यदि कैमरा छोटे मूवमेंट पर प्रतिक्रिया नहीं देता, तो इसे बढ़ाएँ। सामान्य सीमा: 0.02-0.1 (2%-10%)।.
✅
pid_kp
float
PID आनुपातिक गेन (Kp)। स्थिति त्रुटि के प्रति प्रतिक्रिया को नियंत्रित करता है - अधिक मान कैमरे को तेज़ी से प्रतिक्रिया करने देते हैं, लेकिन ओवरशूटिंग और हंटिंग का कारण बन सकते हैं। कम मान हंटिंग कम करते हैं, लेकिन ट्रैकिंग धीमी करते हैं। डिफ़ॉल्ट से शुरू करें और कैमरे की responsiveness के आधार पर समायोजित करें। सामान्य सीमा: 0.1-0.5।.
✅
pid_ki
float
PID इंटीग्रल गेन (Ki)। समय के साथ त्रुटि को जमा करके स्थिर-अवस्था त्रुटि को हटाता है। आमतौर पर इसे 0 पर रखा जाता है क्योंकि इससे दोलन हो सकते हैं। यदि कैमरा छोटी त्रुटियों के बावजूद लगातार थोड़ा ऑफ-सेंटर रुकता है, तो इसे थोड़ा बढ़ाएँ (0.01-0.1)।.
✅
pid_kd
float
PID डेरिवेटिव गेन (Kd)। भविष्य की त्रुटि का अनुमान लगाता है और दोलनों को कम करता है। अधिक मान वीडियो लैग के साथ स्थिरता सुधारते हैं, लेकिन अत्यधिक मान हंटिंग पैदा कर सकते हैं। यदि कैमरा मूवमेंट और वीडियो फ़ीडबैक के बीच काफी देरी हो, तो इसे बढ़ाएँ (1-5)। यदि ट्रैकिंग झटकेदार लगे, तो इसे घटाएँ।.
✅
यह संदर्भ कॉलम यह दर्शाता है कि प्रॉपर्टी को गतिशील मानों के साथ पैरामीटराइज़ किया जा सकता है, जो वर्कफ़्लो रनटाइम में उपलब्ध हैं। अधिक जानकारी के लिए देखें Bindings ।
रनटाइम संगतता
हार्ड - निष्पादन दूरस्थ : ब्लॉक को step_execution_mode=local की आवश्यकता है; अन्यथा ValueError उठता है। ONVIF कमांड्स उसी प्रोसेस से जारी किए जाने चाहिए जो वर्कफ़्लो चलाता है।
हार्ड - रनटाइम hosted_serverless, dedicated_deployment : ब्लॉक को PTZ कैमरे के लिए LAN एक्सेस की आवश्यकता है। Hosted Serverless और Roboflow Dedicated Deployments ग्राहक LAN तक नहीं पहुँच सकते।
इनपुट और आउटपुट बाइंडिंग्स
उपलब्ध कनेक्शन उसके बाइंडिंग प्रकारों पर निर्भर करते हैं। जाँचें कि कौन-से बाइंडिंग प्रकार PTZ ट्रैकिंग (ONVIF) संस्करण में v1 है।
इनपुट और आउटपुट बाइंडिंग्स
इनपुट
भविष्यवाणियाँ(Union[instance_segmentation_prediction,object_detection_prediction]): ट्रैक करने के लिए ऑब्जेक्ट डिटेक्शन या इंस्टेंस सेगमेंटेशन प्रेडिक्शन्स। Follow मोड में, ब्लॉक सबसे उच्च विश्वसनीयता वाली प्रेडिक्शन या, यदि ट्रैकर IDs मौजूद हों, तो ट्रैक की गई वस्तु का अनुसरण करेगा। प्रेडिक्शन्स में बाउंडिंग बॉक्स निर्देशांक और वैकल्पिक रूप से स्थायी ट्रैकिंग के लिए ट्रैकर IDs शामिल होने चाहिए।.camera_ip(स्ट्रिंग): ONVIF कनेक्शन के लिए कैमरे का IP पता या होस्टनाम। यह वर्कफ़्लो निष्पादन वातावरण से पहुँच योग्य होना चाहिए।.camera_port(integer): कैमरे का ONVIF सेवा पोर्ट (आमतौर पर 80, 8080, या कैमरा-विशिष्ट पोर्ट)। यह कैमरे के ONVIF कॉन्फ़िगरेशन से मेल खाना चाहिए।.camera_username(स्ट्रिंग): ONVIF प्रमाणीकरण के लिए कैमरे का उपयोगकर्ता नाम। कैमरे पर PTZ नियंत्रण अनुमतियाँ होनी चाहिए।.camera_password(secret): ONVIF प्रमाणीकरण के लिए कैमरे का पासवर्ड। सुरक्षा के लिए इसे सीक्रेट के रूप में संग्रहीत किया जाना चाहिए।.simulate_variable_speed(boolean): मूल variable speed समर्थन के बिना कैमरों के लिए variable speed सिमुलेशन सक्षम करें। सक्षम होने पर, प्रतिशत गति का अनुमान लगाने के लिए 100% गति कमांड भेजे जाते हैं, फिर stop कमांड भेजे जाते हैं। इससे झटकेदार मूवमेंट हो सकता है - केवल तभी उपयोग करें जब कैमरे में variable speed क्षमता न हो।.zoom_if_able(boolean): ट्रैक की गई वस्तु के साथ फ्रेम भरने के लिए स्वचालित ज़ूम सक्षम करें। सक्षम होने पर, कैमरा पहले pan/tilt से वस्तु को केंद्र में लाता है, फिर तब तक ज़ूम इन करता है जब तक वस्तु फ्रेम को भर न दे। इसके लिए कैमरे में ज़ूम कार्यक्षमता का समर्थन होना चाहिए।.follow_tracker(boolean): ट्रैकर IDs का उपयोग करके स्थायी ट्रैकिंग सक्षम करें। सक्षम होने पर, कैमरा सबसे उच्च विश्वसनीयता वाली डिटेक्शन के ट्रैकर ID पर लॉक हो जाता है और उस विशिष्ट वस्तु का अनुसरण तब तक जारी रखता है जब तक वह गायब न हो जाए या ट्रैकिंग रीसेट न हो जाए। ट्रैकर IDs असाइन करने के लिए वर्कफ़्लो में Byte Tracker ब्लॉक आवश्यक है।.dead_zone(integer): फ्रेम केंद्र के आसपास डेड ज़ोन का आकार, जहाँ कैमरा मूवमेंट रुक जाता है। जब वस्तु केंद्र के पास हो, तब हंटिंग व्यवहार को रोकता है। बड़े मान pan/tilt हंटिंग को कम करते हैं, लेकिन zoom hunting का कारण बन सकते हैं। छोटे मान ज़ूम स्थिरता में सुधार करते हैं, लेकिन pan/tilt दोलन पैदा कर सकते हैं। सामान्य सीमा: 30-100 पिक्सेल।.default_position_preset(स्ट्रिंग): डिफ़ॉल्ट/होम स्थिति के लिए प्रीसेट नाम। निष्क्रिय अवधि के बाद (यदि move_to_position_after_idle_seconds सेट है) या Go To Preset मोड का उपयोग करते समय कैमरा इस प्रीसेट पर वापस आएगा। कैमरे पर कॉन्फ़िगर किए गए प्रीसेट नाम से बिल्कुल मेल खाना चाहिए। प्रीसेट मूवमेंट कार्यक्षमता के लिए आवश्यक।.move_to_position_after_idle_seconds(integer): ऑटो-रीसेट समय सेकंड में। इस अवधि तक कैमरा खोज/मूव करना बंद करने के बाद, स्वचालित रूप से default_position_preset पर चला जाता है। ऑटो-रीसेट अक्षम करने के लिए 0 सेट करें। इसके लिए default_position_preset को कॉन्फ़िगर किया होना चाहिए।.camera_update_rate_limit(integer): कैमरा मूवमेंट कमांड्स के बीच न्यूनतम समय, मिलीसेकंड में। कैमरे पर अधिक भार से बचाने के लिए ONVIF अपडेट्स को दर-सीमित करता है। कम मान अधिक प्रतिक्रियाशील ट्रैकिंग देते हैं, लेकिन धीमे कैमरों पर ओवरलोड हो सकता है। अधिक मान कैमरा लोड कम करते हैं, लेकिन मूवमेंट कम सुचारू हो सकता है। सामान्य सीमा: 100-500ms।.flip_x_movement(boolean): क्षैतिज (pan) मूवमेंट दिशा उलटें। यदि कैमरे की छवि क्षैतिज रूप से मिरर की गई है और मूवमेंट उल्टा दिखाई देता है, तो इसे सक्षम करें। छवि फ्लिप होने पर कैमरा मूवमेंट को ठीक करने के लिए उपयोग करें।.flip_y_movement(boolean): ऊर्ध्वाधर (tilt) मूवमेंट दिशा उलटें। कई कैमरों में Y-अक्ष उल्टा होने के कारण यह डिफ़ॉल्ट रूप से सक्षम है। यदि ऊर्ध्वाधर मूवमेंट उल्टा दिखाई देता है, तो इसे अक्षम करें।.minimum_camera_speed(float_zero_to_one): न्यूनतम मूवमेंट गति प्रतिशत के रूप में (0.0-1.0)। इस सीमा से नीचे के मूवमेंट कमांड्स को इस न्यूनतम तक बढ़ाया जाता है। कुछ कैमरे बहुत कम गति को अनदेखा करते हैं - यदि कैमरा छोटे मूवमेंट पर प्रतिक्रिया नहीं देता, तो इसे बढ़ाएँ। सामान्य सीमा: 0.02-0.1 (2%-10%)।.pid_kp(float): PID आनुपातिक गेन (Kp)। स्थिति त्रुटि के प्रति प्रतिक्रिया को नियंत्रित करता है - अधिक मान कैमरे को तेज़ी से प्रतिक्रिया करने देते हैं, लेकिन ओवरशूटिंग और हंटिंग का कारण बन सकते हैं। कम मान हंटिंग कम करते हैं, लेकिन ट्रैकिंग धीमी करते हैं। डिफ़ॉल्ट से शुरू करें और कैमरे की responsiveness के आधार पर समायोजित करें। सामान्य सीमा: 0.1-0.5।.pid_ki(float): PID इंटीग्रल गेन (Ki)। समय के साथ त्रुटि को जमा करके स्थिर-अवस्था त्रुटि को हटाता है। आमतौर पर इसे 0 पर रखा जाता है क्योंकि इससे दोलन हो सकते हैं। यदि कैमरा छोटी त्रुटियों के बावजूद लगातार थोड़ा ऑफ-सेंटर रुकता है, तो इसे थोड़ा बढ़ाएँ (0.01-0.1)।.pid_kd(float): PID डेरिवेटिव गेन (Kd)। भविष्य की त्रुटि का अनुमान लगाता है और दोलनों को कम करता है। अधिक मान वीडियो लैग के साथ स्थिरता सुधारते हैं, लेकिन अत्यधिक मान हंटिंग पैदा कर सकते हैं। यदि कैमरा मूवमेंट और वीडियो फ़ीडबैक के बीच काफी देरी हो, तो इसे बढ़ाएँ (1-5)। यदि ट्रैकिंग झटकेदार लगे, तो इसे घटाएँ।.
आउटपुट
भविष्यवाणियाँ(object_detection_prediction): sv.Detections(...) ऑब्जेक्ट के रूप में पहचाने गए बाउंडिंग बॉक्स वाली भविष्यवाणी।खोज(boolean): बूलियन फ़्लैग।
अंतिम अपडेट
क्या यह उपयोगी था?