> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/hi/self-hosted/enterprise/deployment-manager/services/rtsp-simulator.md).

# RTSP सिम्युलेटर

कैमरे के बिना inference pipelines का परीक्षण करने के लिए अपलोड की गई video file को looping RTSP source के रूप में स्ट्रीम करें।

RTSP Simulator एक एज कंटेनर सेवा है, जो अपलोड की गई वीडियो फ़ाइल को लाइव RTSP स्ट्रीम में बदलती है। किसी डिवाइस पर भौतिक कैमरा इंस्टॉल करने से पहले इन्फ़रेंस पाइपलाइन बनाने और उनकी जाँच करने के लिए, या किसी ज्ञात क्लिप को Workflow पर फिर से चलाने के लिए इसका उपयोग करें।

आप एक `.mp4` फ़ाइल वेब इंटरफ़ेस या REST API के ज़रिए अपलोड करते हैं, या Deployment Manager से अपलोड करते हैं। सेवा इसे RTSP-संगत फ़ॉर्मैट में ट्रांसकोड करती है और आपके इसे रोकने तक लगातार लूप में स्ट्रीम करती रहती है।

{% hint style="info" %}
RTSP Simulator केवल Enterprise ग्राहकों के लिए उपलब्ध है। [अधिक जानकारी के लिए Roboflow की बिक्री टीम से](https://roboflow.com/sales) संपर्क करें।
{% endhint %}

## कनेक्शन विवरण

इसे बदलें `<device-ip>` Deployment Manager में डिवाइस पेज पर दिखाए गए IP पते से।

<table data-search="false"><thead><tr><th>उद्देश्य</th><th>पता</th></tr></thead><tbody><tr><td>RTSP स्ट्रीम</td><td><code>rtsp://&#x3C;device-ip>:8554/stream</code></td></tr><tr><td>वेब UI, REST API और Swagger दस्तावेज़</td><td><code>http://&#x3C;device-ip>:8080</code></td></tr></tbody></table>

<table data-search="false"><thead><tr><th>पोर्ट</th><th>प्रोटोकॉल</th><th>उद्देश्य</th></tr></thead><tbody><tr><td>8080</td><td>HTTP</td><td>वेब UI, REST API और Swagger दस्तावेज़ यहाँ उपलब्ध हैं: <code>/docs</code></td></tr><tr><td>8554</td><td>RTSP (TCP)</td><td>वीडियो स्ट्रीम आउटपुट। UDP ट्रांसपोर्ट अक्षम है; UDP को प्राथमिकता देने वाले क्लाइंट TCP-interleaved पर स्विच कर लेते हैं।</td></tr></tbody></table>

एक ही समय में कई क्लाइंट स्ट्रीम पढ़ सकते हैं।

## वीडियो फ़ॉर्मैट

वेब UI, CLI और API केवल `.mp4` फ़ाइलें स्वीकार करते हैं। स्ट्रीम को किसी भी RTSP क्लाइंट के साथ काम करने योग्य बनाने के लिए अपलोड अपने आप ट्रांसकोड हो जाते हैं:

* कोडेक: H.264, Baseline प्रोफ़ाइल
* पिक्सेल फ़ॉर्मैट: yuv420p
* ऑडियो: हटाया जाता है; केवल वीडियो
* अधिकतम फ़ाइल आकार: डिफ़ॉल्ट रूप से 5 GB

## Roboflow वीडियो का उपयोग करना

जब आप डिवाइस के स्थानीय नेटवर्क पर उस तक नहीं पहुँच सकते, तब Deployment Manager से वीडियो सेट करें। डिवाइस वीडियो डाउनलोड करके उसे स्ट्रीम करता है।

{% stepper %}
{% step %}

## Settings खोलें

डिवाइस के Configuration टैब में, RTSP Simulator कार्ड पर "Configure" (गियर आइकन) चुनें।
{% endstep %}

{% step %}

## अपलोड करें

"Video source" के अंतर्गत, "Roboflow video" चुनें, फिर "Upload Video" चुनकर कोई `.mp4` या `.mov` फ़ाइल चुनें। वीडियो आपके Workspace की Asset Library में सहेजा जाता है।
{% endstep %}

{% step %}

## सहेजें

वैकल्पिक रूप से, रूपांतरण और स्ट्रीमिंग सेटिंग बदलें। यदि साइट Secure Gateway के ज़रिए Roboflow तक पहुँचती है, तो उसका पता "Secure Gateway (optional)" में दर्ज करें। विंडो में "Save Configuration" चुनें, फिर Configuration टैब पर "Save Configuration" चुनें। डिवाइस नई कॉन्फ़िगरेशन लागू करने पर RTSP Simulator सेवा को रीस्टार्ट करता है, वीडियो डाउनलोड करता है और स्ट्रीमिंग शुरू करता है।
{% endstep %}
{% endstepper %}

वीडियो सेट करने और एक ही चरण में Stream को सिम्युलेटर पर भेजने के लिए, Add Stream फ़ॉर्म से [कोई परीक्षण वीडियो स्ट्रीम करें](https://docs.roboflow.com/deployment/hi/self-hosted/enterprise/deployment-manager/setting-up/stream-a-test-video.md) । यदि डिवाइस पर सिम्युलेटर नहीं है, तो इससे वह भी जुड़ जाता है।

कार्ड में वीडियो का नाम, RTSP URL और डाउनलोड व स्ट्रीम की स्थिति दिखाई देती है। Roboflow वीडियो सेट होने पर, स्थानीय वेब UI में "Managed from Roboflow" दिखता है, स्थानीय वेब UI और CLI के नियंत्रण लॉक हो जाते हैं, और `/upload`, `/play`, `/stop`, `/delete`, और `POST /stream-settings` लौटाता है `409`। स्थानीय अपलोड पर वापस जाने के लिए, "स्थानीय अपलोड" चुनें और सहेजें।

## वेब इंटरफ़ेस का उपयोग

ब्राउज़र में `http://<device-ip>:8080` खोलें।

{% stepper %}
{% step %}

## अपलोड करें

एक `.mp4` फ़ाइल को पेज पर खींचकर छोड़ें। फ़ाइल अपलोड होकर स्ट्रीमिंग फ़ॉर्मैट में बदल जाती है।
{% endstep %}

{% step %}

## चलाएँ

स्ट्रीमिंग शुरू करने के लिए "चलाएँ" चुनें। वीडियो लगातार लूप में चलता है और RTSP सर्वर पर प्रकाशित होता है।
{% endstep %}

{% step %}

## कनेक्ट करें

अपनी इन्फ़रेंस पाइपलाइन, Deployment Manager स्ट्रीम या किसी भी RTSP क्लाइंट को इस पर निर्देशित करें: `rtsp://<device-ip>:8554/stream`.
{% endstep %}

{% step %}

## रोकें

स्ट्रीम समाप्त करने और अपलोड किया गया वीडियो मिटाने के लिए "रोकें" चुनें।
{% endstep %}
{% endstepper %}

डिप्लॉयमेंट में सिम्युलेटेड स्ट्रीम का उपयोग करने के लिए, उसे डिवाइस पर स्ट्रीम स्रोत के रूप में उसी तरह जोड़ें जैसे आप कैमरा जोड़ते हैं। देखें [स्ट्रीम जोड़ें](https://docs.roboflow.com/deployment/hi/self-hosted/enterprise/deployment-manager/setting-up/add-a-stream.md).

## CLI का उपयोग

हेडलेस या केवल SSH के माध्यम से पहुँच के लिए, `rtsp-cli` टूल डिवाइस पर एक इंटरैक्टिव टर्मिनल इंटरफ़ेस उपलब्ध कराता है।

```bash
docker exec -it rtsp-simulator rtsp-cli
```

वेब UI के बिना वीडियो इंपोर्ट करने के लिए, पहले उसे इनपुट डायरेक्टरी में कॉपी करें, फिर CLI लॉन्च करें और दबाएँ `I`.

```bash
scp video.mp4 user@<device-ip>:/var/lib/rfdm/rtsp-simulator/data/input/
```

<table data-search="false"><thead><tr><th>कुंजी</th><th>कमांड</th><th>विवरण</th></tr></thead><tbody><tr><td><code>I</code></td><td>इंपोर्ट करें</td><td>यहाँ से कोई वीडियो चुनें और उसे कन्वर्ट करें: <code>/data/input/</code></td></tr><tr><td><code>P</code></td><td>चलाएँ</td><td>RTSP स्ट्रीमिंग शुरू करें</td></tr><tr><td><code>S</code></td><td>रोकें</td><td>स्ट्रीमिंग रोकें और कन्वर्ट की गई फ़ाइलें मिटाएँ</td></tr><tr><td><code>D</code></td><td>मिटाएँ</td><td>वीडियो फ़ाइलें मिटाएँ</td></tr><tr><td><code>C</code></td><td>कॉन्फ़िगरेशन</td><td>स्ट्रीम सेटिंग समायोजित करें (बिटरेट, बफ़र, विलंब)</td></tr><tr><td><code>R</code></td><td>रीफ़्रेश करें</td><td>स्थिति डिस्प्ले रीफ़्रेश करें</td></tr><tr><td><code>Q</code></td><td>बाहर निकलें</td><td>CLI से बाहर निकलें</td></tr></tbody></table>

## स्ट्रीम का परीक्षण

स्ट्रीम लाइव है या नहीं, इसकी पुष्टि करने के लिए किसी भी RTSP प्लेयर से कनेक्ट करें।

{% tabs %}
{% tab title="VLC" %}

```bash
vlc rtsp://<device-ip>:8554/stream
```

{% endtab %}

{% tab title="ffplay" %}
स्ट्रीम केवल TCP पर उपलब्ध कराई जाती है, इसलिए ffplay को पहले UDP आज़माने देने के बजाय TCP ट्रांसपोर्ट ज़बरन चुनें।

```bash
ffplay -rtsp_transport tcp rtsp://<device-ip>:8554/stream
```

{% endtab %}
{% endtabs %}

## HTTP API

सभी एंडपॉइंट JSON लौटाते हैं। इंटरैक्टिव Swagger दस्तावेज़ यहाँ उपलब्ध हैं: `http://<device-ip>:8080/docs`। सभी ऑन-डिवाइस सेवा API पर लागू नियमों के लिए देखें [Services](https://docs.roboflow.com/deployment/hi/self-hosted/enterprise/deployment-manager/services.md#using-the-apis) ।

{% hint style="warning" %}
इस API के लिए प्रमाणीकरण आवश्यक नहीं है; यह चल रही स्ट्रीम रोक सकता है और अपलोड किया गया वीडियो मिटा सकता है। पोर्ट 8080 तक पहुँच रखने वाला कोई भी व्यक्ति ये दोनों काम कर सकता है।
{% endhint %}

### सामान्य प्रक्रिया

वीडियो अपलोड करने के लिए `/upload`का उपयोग करें, स्ट्रीम शुरू करने के लिए `/play`का उपयोग करें, इसकी जाँच `/status`से करें और इसे रोकने के लिए `/stop`.

{% hint style="warning" %}
का उपयोग करें। `rtsp_url` जो `/play` और `/status` लौटाते हैं, उसमें हमेशा `localhost`होता है, क्योंकि सेवा URL को अपने नज़रिए से बताती है। डिवाइस पर चल रहा उपभोक्ता ही इसका हूबहू उपयोग कर सकता है। अन्य जगहों पर डिवाइस का पता डालें: `rtsp://<device-ip>:8554/stream`.

पोर्ट है `RTSP_PORT`, जिसका डिफ़ॉल्ट मान है `8554` लेकिन इसे हर डिवाइस के लिए कॉन्फ़िगर किया जा सकता है। डिफ़ॉल्ट मान मानकर चलने के बजाय `rtsp_port` को `/info` से पढ़ें।
{% endhint %}

`/stop` डिस्क स्थान खाली करने के लिए मूल और कन्वर्ट की गई, दोनों फ़ाइलें भी मिटा देता है। इसलिए अगली बार `/play`.

### अपलोड करें

चलाने से पहले नया अपलोड करना ज़रूरी है। केवल `.mp4` स्वीकार किया जाता है, और अपलोड शुरू होने से पहले सक्रिय स्ट्रीम रोक दी जाती है। वैकल्पिक `settings` भाग, ट्रांसकोडिंग के दौरान लागू की जाने वाली रूपांतरण सेटिंग का JSON स्ट्रिंग है। चूँकि ये रूपांतरित फ़ाइल में शामिल हो जाती हैं, इसलिए बाद में इन्हें बदलने के लिए फ़ाइल फिर से अपलोड करनी होगी।

{% openapi src="/files/38f2ac279fadefd47201eb049d89c557181e43a7" path="/upload" method="post" %}
[edge-rtsp-simulator.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-1608d6873191fab7e4d614a21aa77a56bab11279%2Fedge-rtsp-simulator.yaml?alt=media)
{% endopenapi %}

### स्ट्रीमिंग

{% openapi src="/files/38f2ac279fadefd47201eb049d89c557181e43a7" path="/play" method="post" %}
[edge-rtsp-simulator.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-1608d6873191fab7e4d614a21aa77a56bab11279%2Fedge-rtsp-simulator.yaml?alt=media)
{% endopenapi %}

{% openapi src="/files/38f2ac279fadefd47201eb049d89c557181e43a7" path="/stop" method="post" %}
[edge-rtsp-simulator.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-1608d6873191fab7e4d614a21aa77a56bab11279%2Fedge-rtsp-simulator.yaml?alt=media)
{% endopenapi %}

`/delete` स्ट्रीम चालू होना ज़रूरी किए बिना वीडियो फ़ाइलें हटाता है; अगर कोई स्ट्रीम चालू है, तो पहले उसे रोकता है।

{% openapi src="/files/38f2ac279fadefd47201eb049d89c557181e43a7" path="/delete" method="post" %}
[edge-rtsp-simulator.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-1608d6873191fab7e4d614a21aa77a56bab11279%2Fedge-rtsp-simulator.yaml?alt=media)
{% endopenapi %}

### स्थिति

`streaming` का मान true होता है, जब `components.mediamtx.healthy` (स्ट्रीमिंग सर्वर) और `components.ffmpeg_process.running` (ट्रांसकोड और पब्लिश प्रक्रिया) दोनों का मान true हो। `components.stream` एंट्री इसके लिए शर्त नहीं है: `components.stream.source_ready` स्टार्टअप के दौरान थोड़ी देर के लिए false हो सकता है, जबकि `streaming` पहले से true दिखा रहा हो; यह सामान्य है। विफल स्ट्रीम की समस्या का पता लगाने का सबसे तेज़ तरीका यह विवरण है: कुछ भी रीस्टार्ट करने से पहले यह देखने के लिए `components` जाँचें कि कौन-सा हिस्सा ठीक से काम नहीं कर रहा है।

{% openapi src="/files/38f2ac279fadefd47201eb049d89c557181e43a7" path="/status" method="get" %}
[edge-rtsp-simulator.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-1608d6873191fab7e4d614a21aa77a56bab11279%2Fedge-rtsp-simulator.yaml?alt=media)
{% endopenapi %}

`/info` सेवा के साथ चल रही सीमाओं की जानकारी देता है, जिसमें खाली डिस्क स्थान और अधिकतम अपलोड आकार शामिल हैं। बड़ी फ़ाइल भेजने से पहले इन्हें जाँचना उपयोगी है।

{% openapi src="/files/38f2ac279fadefd47201eb049d89c557181e43a7" path="/info" method="get" %}
[edge-rtsp-simulator.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-1608d6873191fab7e4d614a21aa77a56bab11279%2Fedge-rtsp-simulator.yaml?alt=media)
{% endopenapi %}

### स्ट्रीम सेटिंग एंडपॉइंट

प्लेबैक सेटिंग, अपलोड सेटिंग से अलग होती हैं: ये स्ट्रीमिंग के समय लागू होती हैं और इन्हें दोबारा अपलोड किए बिना, अलग-अलग सत्रों के बीच बदला जा सकता है। अपडेट अगली बार `/play`पर लागू होगा, अभी चल रही स्ट्रीम पर नहीं।

{% openapi src="/files/38f2ac279fadefd47201eb049d89c557181e43a7" path="/stream-settings" method="get" %}
[edge-rtsp-simulator.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-1608d6873191fab7e4d614a21aa77a56bab11279%2Fedge-rtsp-simulator.yaml?alt=media)
{% endopenapi %}

{% openapi src="/files/38f2ac279fadefd47201eb049d89c557181e43a7" path="/stream-settings" method="post" %}
[edge-rtsp-simulator.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-1608d6873191fab7e4d614a21aa77a56bab11279%2Fedge-rtsp-simulator.yaml?alt=media)
{% endopenapi %}

## कॉन्फ़िगरेशन

### पर्यावरण वैरिएबल

इन्हें डिवाइस के Configuration टैब में सेवा पर सेट करें। देखें [डिवाइस कॉन्फ़िगरेशन अपडेट करें](https://docs.roboflow.com/deployment/hi/self-hosted/enterprise/deployment-manager/making-changes/update-device-configuration.md).

<table data-search="false"><thead><tr><th>वैरिएबल</th><th>डिफ़ॉल्ट</th><th>विवरण</th></tr></thead><tbody><tr><td><code>MAX_FILE_SIZE</code></td><td><code>5368709120</code></td><td>बाइट में अधिकतम अपलोड आकार (5 GB)</td></tr><tr><td><code>RTSP_PORT</code></td><td><code>8554</code></td><td>RTSP सर्वर पोर्ट</td></tr><tr><td><code>WEB_PORT</code></td><td><code>8080</code></td><td>वेब UI और API पोर्ट</td></tr><tr><td><code>LOG_LEVEL</code></td><td><code>INFO</code></td><td>लॉगिंग का विवरण स्तर: <code>DEBUG</code>, <code>INFO</code>, <code>WARNING</code>, या <code>ERROR</code></td></tr></tbody></table>

### अपलोड सेटिंग

ये रूपांतरण के दौरान लागू होती हैं, इसलिए इन्हें बदलने के लिए वीडियो फिर से अपलोड करना होगा।

<table data-search="false"><thead><tr><th>सेटिंग</th><th>डिफ़ॉल्ट</th><th>विवरण</th></tr></thead><tbody><tr><td><code>target_fps</code></td><td>मूल</td><td>लक्ष्य फ़्रेम दर, 1 से 120। मूल मान बनाए रखने के लिए इसे छोड़ दें</td></tr><tr><td><code>crf_quality</code></td><td><code>23</code></td><td>गुणवत्ता स्तर, 0 से 51 (18 उच्च, 23 मध्यम, 28 निम्न है)</td></tr><tr><td><code>max_width</code></td><td>मूल</td><td>डाउनस्केलिंग के लिए अधिकतम चौड़ाई, 320 से 7680। मूल मान बनाए रखने के लिए इसे छोड़ दें</td></tr></tbody></table>

### स्ट्रीम सेटिंग्स

ये प्लेबैक के दौरान लागू होती हैं और स्ट्रीमिंग सत्रों के बीच CLI कॉन्फ़िगरेशन मेनू या `/stream-settings` एंडपॉइंट से बदली जा सकती हैं।

<table data-search="false"><thead><tr><th>सेटिंग</th><th>डिफ़ॉल्ट</th><th>विवरण</th></tr></thead><tbody><tr><td><code>max_bitrate_kbps</code></td><td><code>5000</code></td><td>अधिकतम बिटरेट kbps में, 100 से 100,000</td></tr><tr><td><code>buffer_size_kb</code></td><td><code>3000</code></td><td>बफ़र का आकार KB में, 100 से 50,000</td></tr><tr><td><code>max_delay_ms</code></td><td><code>500</code></td><td>अधिकतम विलंब मिलीसेकंड में, 50 से 5,000</td></tr></tbody></table>
