For the complete documentation index, see llms.txt. This page is also available as Markdown.

कनेक्टर इंस्टॉल करें

Roboflow Video Connector को macOS, Linux, Windows, या Docker पर इंस्टॉल और चलाएँ।

Roboflow Video Connector आपके कंप्यूटर या स्थानीय नेटवर्क पर मौजूद कैमरों को Cloud Streaming से जोड़ता है। इसे ऐसे मशीन पर चलाएँ जो कैमरों तक पहुँच सके और उनके उपयोग के दौरान ऑनलाइन रहे। मॉडल का इन्फ़रेंस Roboflow के क्लाउड में चलता है, कनेक्टर में नहीं।

इंस्टॉल करने के बाद, किसी स्रोत को कनेक्ट करें.

शुरू करने से पहले

आपको वर्कस्पेस API key, कैमरे के नेटवर्क तक पहुँच और उसका वीडियो रिकॉर्ड करके भेजने की अनुमति चाहिए। सेटअप कमांड और कनेक्शन की स्थिति देखने के लिए "Deployments" → "Cloud Streaming" → "Add Video Source" → "Connect a Camera" खोलें। डायलॉग में macOS, Linux और Windows के लिए टैब हैं, और यह आपके कंप्यूटर वाले टैब पर खुलता है। आप अपनी वर्कस्पेस key को "Settings" → "API Keys" में भी पा सकते हैं। Keys को चैट, सोर्स कंट्रोल या स्क्रीनशॉट में न डालें।

नेटिव आर्काइव macOS और Linux के लिए x86-64 और ARM64 पर, तथा Windows के लिए x86-64 पर उपलब्ध हैं। Linux के लिए glibc 2.28 या उसके बाद का संस्करण और सिस्टम GnuTLS रनटाइम आवश्यक है: libgnutls30 या Debian/Ubuntu पर इसका डिस्ट्रीब्यूशन उत्तराधिकारी, अथवा gnutls RHEL-संगत डिस्ट्रीब्यूशन पर। कनेक्टर में FFmpeg शामिल है; नेटिव Linux आर्काइव निर्भरता-मुक्त नहीं है।

समर्थित macOS और Linux कैमरा इंटरफ़ेस पर USB डिवाइस खोज उपलब्ध है। Windows इंस्टॉलेशन से USB कैमरा खोजने की सुविधा नहीं जुड़ती; वहाँ नेटवर्क कैमरा इस्तेमाल करें। Linux में खोज USB V4L2 कैप्चर इंटरफ़ेस तक सीमित है, CSI, वर्चुअल या मालिकाना औद्योगिक कैमरा इंटरफ़ेस तक नहीं।

CLI

macOS या Linux पर इंस्टॉल करें

सार्वजनिक इंस्टॉलर चलाएँ:

curl --proto =https --proto-redir =https -fsSL https://repo.roboflow.com/rfv-connector/latest/install.sh | sh
~/.rfv-connector/rfv-connector --version

इंस्टॉलर आपके ऑपरेटिंग सिस्टम और आर्किटेक्चर का पता लगाता है, फिर इंस्टॉल करने से पहले चुने गए रिलीज़ के चेकसम जाँचता है। एक्ज़ीक्यूटेबल है ~/.rfv-connector/rfv-connector; ~/.rfv-connector अकेले एक डायरेक्टरी है।

इंस्टॉलर एक्ज़ीक्यूटेबल को आपके PATH में नहीं जोड़ता। मौजूदा टर्मिनल में छोटा कमांड इस्तेमाल करने के लिए:

export PATH="$HOME/.rfv-connector:$PATH"
rfv-connector --version

आगे के टर्मिनलों में इस्तेमाल के लिए, इस export को अपनी शेल की स्टार्टअप फ़ाइल में एक बार जोड़ें, जैसे ~/.zshrc या ~/.bashrc। अगर आपने कस्टम RFV_INSTALL_DIRसेट किया है, तो उसके बजाय उसका पूर्ण पाथ जोड़ें।

EU डाउनलोड मिरर भी उपलब्ध है:

इससे केवल इंस्टॉलेशन फ़ाइलें डाउनलोड होने की जगह बदलती है। इससे प्रोसेसिंग क्षेत्र नहीं चुना जाता और API एंडपॉइंट भी नहीं बदलता।

Windows पर इंस्टॉल करें

PowerShell में इंस्टॉलर चलाएँ, फिर संस्करण जाँचें:

आप सेटअप डायलॉग के "Windows" टैब पर "Download Installer" पर क्लिक करके roboflow-connector.batभी डाउनलोड कर सकते हैं। उस पर डबल-क्लिक करें। यह आपसे वर्कस्पेस API key माँगता है और कनेक्टर शुरू करता है। यह key को डिस्क पर सेव नहीं करता।

इसके बजाय ZIP आर्काइव से इंस्टॉल करने के लिए:

  1. से एक संस्करण चुनें rfv-connector_windows_amd64.zip और checksums.txt उसी संस्करणित डायरेक्टरी से डाउनलोड करें, https://repo.roboflow.com/rfv-connector/<VERSION>/। पॉइंटर में दिए गए संस्करण का उपयोग करें, जिसमें उसका v उपसर्ग (उदा.: v0.10.0).

  2. PowerShell में, आर्काइव का चेकसम निकालें:

  1. इसकी तुलना इसमें दिए गए सटीक ZIP फ़ाइलनाम के SHA256 से करें: checksums.txt. चेकसम मौजूद न हो या मेल न खाए, तो आर्काइव न चलाएँ।

  2. पूरा आर्काइव किसी स्थायी फ़ोल्डर में निकालें। ffmpeg.exeको स्रोत फ़ाइलों और सूचनाओं के साथ एक ही जगह रखें।

नेटिव रिलीज़ पर डिजिटल हस्ताक्षर नहीं होते। सत्यापित ब्राउज़र डाउनलोड से macOS Gatekeeper या Windows SmartScreen चेतावनी दे सकता है। अपने संगठन की सॉफ़्टवेयर नीति का पालन करें; ज़रूरत पड़ने पर व्यवस्थापक द्वारा स्वीकृत इंस्टॉलेशन का उपयोग करें। अगर आपकी नीति सत्यापित, बिना हस्ताक्षर वाली रिलीज़ की अनुमति देती है, तो macOS में "सिस्टम सेटिंग्ज़" → "गोपनीयता और सुरक्षा" → "फिर भी खोलें" विकल्प दिख सकता है, और Windows SmartScreen में "अधिक जानकारी" → "फिर भी चलाएँ" विकल्प दिख सकता है। सिस्टम की सुरक्षा जाँचों को पूरी तरह बंद न करें। चेकसम डाउनलोड की गई रिलीज़ के बाइट्स की पुष्टि करता है, कोड-साइनिंग या नोटराइज़ेशन की नहीं।

कनेक्टर शुरू करें और कॉन्फ़िगर करें

वर्कस्पेस कुंजी को ROBOFLOW_API_KEY में अपने सामान्य स्थानीय सीक्रेट-प्रबंधन तरीके से सेट करें, फिर कनेक्टर शुरू करें:

Windows पर, PowerShell में:

अगर आपने ZIP आर्काइव से इंस्टॉल किया है, तो निकाले गए फ़ोल्डर से .\rfv-connector.exe चलाएँ।

जब आपका OS अनुमति माँगे, तो कनेक्टर लॉन्च करने वाले ऐप्लिकेशन या टर्मिनल को कैमरे तक पहुँच की अनुमति दें। Linux पर, लॉन्च करने वाले उपयोगकर्ता को कैमरे के कैप्चर डिवाइस को पढ़ने की अनुमति होनी चाहिए। सभी डिवाइसों को लिखने योग्य बनाने के बजाय, अपने सिस्टम की डिवाइस-एक्सेस नीति का उपयोग करें।

सेटअप डायलॉग पर वापस जाएँ और जाँचें कि कनेक्टर कनेक्ट है। अगर कोई कनेक्टर पहले से ऑनलाइन था, तो उससे नया कैमरा दिखाई देने पर डायलॉग इसकी पुष्टि करेगा। इसके कैमरे फिर स्रोत सूची में दिखेंगे। आगे बढ़ने के लिए स्रोत सेटअप.

Connector setup dialog with its API key redacted and a successful connection.
कनेक्टर चलाएँ और कनेक्शन की पुष्टि होने तक प्रतीक्षा करें।

इसे चालू रखें

नेटिव कमांड फ़ोरग्राउंड में चलता है। इसका टर्मिनल बंद करने, प्रक्रिया रोकने, मशीन को स्लीप मोड में डालने या नेटवर्क कनेक्शन टूटने से इसके स्रोत बाधित हो सकते हैं। केवल इंस्टॉल करने से बैकग्राउंड सेवा इंस्टॉल नहीं होती। बिना निगरानी के चलाने के लिए, व्यवस्थापक द्वारा प्रबंधित OS सेवा या Docker का उपयोग करें और मशीन को चालू रखें।

मौजूदा इंस्टॉलेशन को पुनः चालू करने के लिए इसकी दूसरी प्रति न चलाएँ। इसकी स्थिति जाँचें और मौजूदा प्रक्रिया को रीस्टार्ट करें। नियोजित रखरखाव से पहले इसके क्लाउड जॉब रोकें और रीस्टार्ट के बाद इच्छित स्रोत की पुष्टि करें।

Docker

परिवर्तनशील टैग के बजाय अपरिवर्तनीय रिलीज़ टैग या डाइजेस्ट का उपयोग करें। यह उदाहरण 0.10.0 को पिन करता है और कॉन्फ़िगरेशन तथा इंस्टॉलेशन की पहचान को नामित वॉल्यूम में रखता है:

कमांड चलाने से पहले ROBOFLOW_API_KEY को अपने सामान्य सीक्रेट-प्रबंधन तरीके से सेट करें। कनेक्टर कनेक्ट है, इसकी पुष्टि करने और कैमरे जोड़ने.

ब्रिज नेटवर्किंग में ONVIF मल्टीकास्ट डिस्कवरी कैमरा LAN नहीं देख सकती; प्लेटफ़ॉर्म के माध्यम से कोई ज्ञात RTSP URL जोड़ें। अगर आपको LAN डिस्कवरी चाहिए, तो नेटिव कनेक्टर का उपयोग करें।

Linux USB कैमरों के लिए आवश्यक कैप्चर डिवाइस उपलब्ध कराएँ, जैसे --device /dev/video0, और सुनिश्चित करें कि कंटेनर उनकी sysfs पहचान पढ़ सके। macOS पर Docker, होस्ट के वेबकैम को अपने-आप उपलब्ध नहीं कराता। अगर आपको उस कैमरे की ज़रूरत है, तो नेटिव कनेक्टर का उपयोग करें।

/state को स्थायी स्टोरेज पर रखें। पूरी डायरेक्टरी माउंट करें, सिर्फ़ connector.jsonनहीं। एक ही स्टेट वॉल्यूम को एक साथ चल रहे कई इंस्टॉलेशन को न दें।

अपडेट करते समय स्थिति सुरक्षित रखें

इंस्टॉलेशन डायरेक्टरी में बाइनरी फ़ाइलें होती हैं। डेटा डायरेक्टरी में अलग से कॉन्फ़िगरेशन और पहचान की जानकारी रहती है:

इंस्टॉलेशन
डिफ़ॉल्ट डेटा डायरेक्टरी

macOS

~/Library/Application Support/rf-video-connector

Linux

$XDG_STATE_HOME/rf-video-connector, or ~/.local/state/rf-video-connector

Windows

%LOCALAPPDATA%/rf-video-connector

Docker

/state

--data-dir को ओवरराइड करता है RFV_DATA_DIR और डिफ़ॉल्ट को। --config किसी अलग कॉन्फ़िगरेशन फ़ाइल की ओर संकेत कर सकता है। पूरी डेटा डायरेक्टरी और किसी भी अलग कॉन्फ़िगरेशन—दोनों का बैकअप लें। बैकअप को निजी रखें, क्योंकि उसमें कुंजियाँ और कैमरे के पासवर्ड हो सकते हैं।

  1. अपग्रेड करने से पहले क्लाउड जॉब और पुराना कनेक्टर रोक दें।

  2. उसकी डेटा डायरेक्टरी, इंस्टॉलेशन पहचान और स्टोरेज माउंट सुरक्षित रखें। पुराने कंटेनरों के लिए, उन्हें बदलने से पहले पुष्टि करें कि कॉन्फ़िगरेशन और पहचान—दोनों कहाँ संग्रहीत हैं; केवल पुराना कॉन्फ़िगरेशन माउंट पहचान की जानकारी को शामिल न करता हो।

  3. नेटिव इंस्टॉलर को फिर से चलाएँ, सत्यापित Windows रिलीज़ निकालें, या Docker का नया इम्यूटेबल संस्करण चुनें। स्थायी स्थिति को ओवरराइट न करें और न ही हटाएँ।

  4. एक कनेक्टर शुरू करें और पुष्टि करें कि अपेक्षित कैमरे और इंस्टॉलेशन अब भी पहचाने जा रहे हैं। कंटेनरों के लिए, केवल रीस्टार्ट के बाद नहीं, बल्कि बदलने के बाद भी डेटा के बने रहने की पुष्टि करें।

पुराने Linux इंस्टॉलेशन में usb:videoN स्रोत ID का उपयोग हो रहा हो, तो अपग्रेड से पहले कैमरा और Workflow के बीच की बाइंडिंग की पुष्टि करें। मौजूदा डिवाइस नंबर का अनुमान लगाकर नए हार्डवेयर-आधारित ID पुराने कैमरों को न दें। बैकअप रखें और प्रोसेसिंग फिर से शुरू करने से पहले अपने एडमिनिस्ट्रेटर के साथ माइग्रेशन की समीक्षा करें।

इंस्टॉलेशन हटाने के लिए, पहले उसके जॉब और प्रोसेस या सेवा को रोकें। क्लाउड कनेक्टर का रजिस्ट्रेशन तभी हटाएँ जब उसकी ज़रूरत न रहे, फिर इंस्टॉल की गई बाइनरी फ़ाइलें हटाएँ। स्थानीय स्थिति तभी हटाएँ जब आप उसकी पहचान और सहेजी गई सेटिंग्स खोना चाहते हों; उस स्थिति के बिना दोबारा इंस्टॉल करने पर नया इंस्टॉलेशन बनता है।

नेटवर्क आवश्यकताएँ

कनेक्टर Roboflow API और उसे असाइन किए गए मीडिया गंतव्य से आउटबाउंड कनेक्शन खोलता है। कैमरे तक पहुँचने के लिए इंटरनेट से आने वाला पोर्ट फ़ॉरवर्ड करने की ज़रूरत नहीं है। फिर भी, कनेक्टर की मशीन को कैमरे की RTSP या ONVIF सेवा तक स्थानीय पहुँच और HTTPS API पहुँच के अलावा आउटबाउंड मीडिया पहुँच चाहिए।

ONVIF डिस्कवरी में स्थानीय मल्टीकास्ट का उपयोग होता है, जो VLAN या कंटेनर ब्रिज के पार शायद न पहुँच पाए। प्रतिबंधित नेटवर्क पर, अपने नेटवर्क एडमिनिस्ट्रेटर से असाइन किए गए मीडिया एंडपॉइंट और अनुमत ट्रांसपोर्ट की पुष्टि करवाएँ। फ़ायरवॉल को बायपास करने के लिए कैमरे के पोर्ट इंटरनेट पर उपलब्ध न करें।

अगर कनेक्टर ऑनलाइन है, लेकिन कैमरा या वीडियो दिखाई नहीं दे रहा, तो देखें समस्या निवारण.

अंतिम अपडेट

क्या यह उपयोगी था?