> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dwe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# dweOS vers OBS Studio

> Ce guide vous aide à configurer le streaming depuis dweOS vers OBS Studio.

<Warning>
  dweOS ne prend pas officiellement en charge le streaming vers OBS. Les étapes suivantes ne s'appliquent qu'à Linux et Windows.
</Warning>

<Steps>
  <Step title="Vérifier dweOS">
    Après avoir suivi la configuration de dweOS, passez aux étapes suivantes.

    <Note>
      Notez le(s) port(s) vers lesquels la diffusion est effectuée.
    </Note>
  </Step>

  <Step title="Installer OBS Studio">
    <Card title="Télécharger OBS Studio" icon="video" href="https://obsproject.com/">
      Cliquez ici pour télécharger OBS Studio pour ordinateur de bureau sur votre portable/PC.
    </Card>
  </Step>

  <Step title="Installer GStreamer">
    <Tabs>
      <Tab title="Pour Linux">
        Dans le terminal, exécutez :

        ```sh theme={null}
        sudo apt install gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-tools                
        ```

        Installez également les en-têtes de développement pour l'utilisation des plugins :

        ```sh theme={null}
        sudo apt install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
        ```
      </Tab>

      <Tab title="Pour Windows">
        <Steps>
          <Step title="Installer GStreamer">
            <Card title="Télécharger le framework GStreamer" icon="stream" href="https://gstreamer.freedesktop.org/download/#windows">
              Cliquez ici pour télécharger GStreamer pour ordinateur de bureau sur votre portable/PC.

              <Note>
                Assurez-vous de télécharger la version MinGW, et installez à la fois le runtime et le développement.
              </Note>
            </Card>

            <Tip>
              Dans le doute, installez la version 64 bits, car c'est la plus courante.
            </Tip>

            <Warning>
              GStreamer s'installerait automatiquement sur le lecteur D si vous avez plus d'un lecteur sur votre PC. Vous pouvez le changer vers le lecteur C en effectuant une installation personnalisée.

              Si vous l'installez sur le lecteur D, gardez-le simplement à l'esprit lorsque vous configurez vos variables d'environnement ci-dessous.
            </Warning>
          </Step>

          <Step title="Configurer les variables d'environnement">
            <Steps>
              <Step>
                Pour accéder aux variables d'environnement, appuyez sur `Win + R`
              </Step>

              <Step>
                Tapez :

                ```
                SystemPropertiesAdvanced
                ```

                et appuyez sur `Entrée`
              </Step>

              <Step>
                Cliquez sur `Variables d'environnement...`

                <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/system-properties-dialog.png?fit=max&auto=format&n=NrWVR9Qe6FWmBE6d&q=85&s=e43b7911ce525ec2b854c971afa1266b" width="80%" alt="Boîte de dialogue Propriétés système" data-path="dwe-os/legacy/images/system-properties-dialog.png" />
              </Step>

              <Step>
                Mettez en surbrillance la variable `Path` sous `Variables utilisateur` en cliquant dessus, puis cliquez sur `Modifier…` sous la zone `Variables utilisateur`.

                <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/environment-variables-dialog.png?s=2d7ac09a6778fd1ceafd7a177335a9eb" width="80%" alt="Boîte de dialogue Variables d'environnement" data-path="dwe-os/legacy/images/environment-variables-dialog.png" />
              </Step>

              <Step>
                Une nouvelle fenêtre devrait apparaître et vous devez cliquer sur `Nouveau` et ajouter un chemin vers votre dossier bin à la liste. Dans ce cas, c'est :

                ```
                C:\gstreamer\1.0\mingw_x86_64\bin
                ```

                Le chemin de votre bin peut varier et se trouve à l'emplacement où vous avez installé GStreamer dans les étapes précédentes.

                <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/environment-variables-dialog-2.png?fit=max&auto=format&n=NrWVR9Qe6FWmBE6d&q=85&s=84f2d6d273839b4a87e6f3346a66014b" width="80%" alt="Deuxième boîte de dialogue Variables d'environnement" data-path="dwe-os/legacy/images/environment-variables-dialog-2.png" />
              </Step>

              <Step>
                Ensuite, cliquez sur `OK` dans les deux fenêtres et tout devrait être prêt !
              </Step>
            </Steps>
          </Step>

          <Step title="Succès !">
            Vous devriez maintenant avoir GStreamer configuré et prêt pour les étapes suivantes !
          </Step>
        </Steps>

        <Tip>
          Pour vérifier l'installation de GStreamer, ouvrez `CMD` et exécutez :

          ```sh theme={null}
          gst-launch-1.0 --version
          ```

          Cela devrait afficher quelque chose comme :

          ```sh theme={null}
          gst-launch-1.0 version 1.16.2
          GStreamer 1.16.2
          https://launchpad.net/distros/ubuntu/+source/gstreamer1.0
          ```
        </Tip>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Installer le plugin OBS GStreamer">
    <Tabs>
      <Tab title="Pour Linux">
        <Steps>
          <Step>
            Téléchargez la dernière version du plugin [ici](https://github.com/fzwoch/obs-gstreamer/releases/).
          </Step>

          <Step>
            Dans le fichier `.zip`, extrayez et localisez le fichier `obs-gstreamer.so` dans le dossier `linux`.
          </Step>

          <Step>
            Dans un autre explorateur de fichiers, localisez le dossier `obs-plugins`, ou exécutez cette commande dans le terminal pour obtenir le chemin :

            ```sh theme={null}
            sudo find /usr/lib -name "obs-plugins" -type d
            ```

            <Tip>
              Cela sera probablement similaire à `/usr/lib/x86../obs-plugins`.
            </Tip>
          </Step>

          <Step>
            Déplacez le fichier `.so` dans le dossier `obs-plugins`, ou depuis le terminal, exécutez :

            ```sh theme={null}
            sudo mv ~/Downloads/linux/obs-gstreamer.so /usr/lib/x86_64-linux-gnu/obs-plugins/
            ```

            <Warning>
              Dans ce cas, l'emplacement de mon `obs-gstreamer.so` est `~/Downloads/linux/obs-gstreamer.so`. Veillez à le remplacer par le chemin où vous avez extrait le fichier `obs-gstreamer.so`.

              N'oubliez pas non plus de remplacer `/usr/lib/x86../obs-plugins` par le chemin de votre dossier `obs-plugin`.
            </Warning>
          </Step>

          <Step>
            Redémarrez OBS Studio si vous l'aviez ouvert.
          </Step>
        </Steps>
      </Tab>

      <Tab title="Pour Windows">
        <Steps>
          <Step>
            Téléchargez la dernière version du plugin [ici](https://github.com/fzwoch/obs-gstreamer/releases/).
          </Step>

          <Step>
            Dans le fichier `.zip`, extrayez et localisez le fichier `obs-gstreamer.dll` dans le dossier `windows`.
          </Step>

          <Step>
            Dans un autre explorateur de fichiers, localisez le dossier `obs-plugins\64-bit` (ou la taille en bits que vous avez installée).

            <Tip>
              Cela sera probablement similaire à `C:\Program Files\obs-studio\obs-plugins\64bit`.

              Si vous ne le trouvez pas, cliquez avec le bouton droit sur votre raccourci OBS Studio sur le bureau ou dans le menu Démarrer, sélectionnez `Ouvrir l'emplacement du fichier`, et remontez d'un niveau jusqu'au dossier principal `obs-studio`, où vous trouverez le dossier `obs-plugins`.
            </Tip>
          </Step>

          <Step>
            Déplacez le fichier `.dll` dans le dossier `obs-plugins\64-bit`.

            <Note>
              Windows demandera probablement l'autorisation administrateur pour déplacer des fichiers dans C:\Program Files. Cliquez sur `Continuer` ou `Oui`.
            </Note>
          </Step>

          <Step>
            Redémarrez OBS Studio si vous l'aviez ouvert.
          </Step>
        </Steps>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Configurer le flux">
    À partir d'ici, le processus est pratiquement identique sur tous les systèmes d'exploitation.

    <Steps>
      <Step>
        Dans OBS Studio, sous l'onglet `Sources`, appuyez sur le bouton `+` et ajoutez une source GStreamer.

        <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/add-gstreamer.png?fit=max&auto=format&n=NrWVR9Qe6FWmBE6d&q=85&s=39211fa2050be04adcf73369809e8ea8" width="50%" alt="Ajouter une source GStreamer" data-path="dwe-os/legacy/images/add-gstreamer.png" />

        Sous `Créer nouveau`, nommez-la comme vous voulez et confirmez.
      </Step>

      <Step>
        Une fenêtre comme celle-ci vous sera ensuite présentée :

        <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/add-gstreamer-code.png?fit=max&auto=format&n=NrWVR9Qe6FWmBE6d&q=85&s=e77c79eb26e7664556f14242431dded0" width="80%" alt="Ajouter le code GStreamer" data-path="dwe-os/legacy/images/add-gstreamer-code.png" />

        Dans l'entrée `Pipeline`, remplacez le code existant par :

        ```sh theme={null}
        udpsrc port=5600 ! application/x-rtp,media=(string)video,clock-rate=(int)90000,encoding-name=(string)H264 ! rtph264depay ! avdec_h264 output-corrupt=false ! videoconvert ! video.
        ```

        <Warning>
          Remplacez le `5600` dans `port=5600` par le port vers lequel dweOS 2 diffuse.
        </Warning>

        <Note>
          Windows peut afficher un avertissement, dans ce cas, veuillez activer OBS pour les réseaux privés et publics.

          <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/gstreamer-windows-prompt.jpg?fit=max&auto=format&n=NrWVR9Qe6FWmBE6d&q=85&s=6319bd32c55564f834fd1c70f9072b67" width="80%" alt="Invite de la fenêtre GStreamer" data-path="dwe-os/legacy/images/gstreamer-windows-prompt.jpg" />
        </Note>
      </Step>
    </Steps>
  </Step>

  <Step title="Ajouter des flux supplémentaires">
    Si vous souhaitez ajouter plus d'un flux, répétez simplement à partir de l'étape `5`.

    <Warning>
      N'oubliez pas de remplacer le numéro de port comme spécifié à l'étape précédente !
    </Warning>

    D'autres flux devraient apparaître dans la fenêtre principale d'OBS. Vous pouvez cliquer sur l'affichage vidéo pour le redimensionner à votre convenance.
    Voici un exemple de configuration avec 3 exploreHD !

    <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/gstreamer-setup-example.jpg?fit=max&auto=format&n=NrWVR9Qe6FWmBE6d&q=85&s=da82fbd3df7e69a122e13f2bf65a9ae9" alt="Exemple de configuration GStreamer" width="1981" height="1128" data-path="dwe-os/legacy/images/gstreamer-setup-example.jpg" />
  </Step>

  <Step title="Optimisation">
    Pour optimiser la configuration, naviguez vers `Fichier > Paramètres > Sortie`.

    Dans Sortie, réglez le `Mode de sortie` sur `Avancé` pour accéder à des paramètres supplémentaires.

    Étant donné que chaque caméra est configurée par défaut à 10 Mo/s comme débit, le streaming et l'enregistrement devraient correspondre à cela. Dans le cas de 3 caméras, fournir au moins 30 Mo/s de débit de streaming et d'enregistrement devrait vous offrir une haute qualité.

    <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/obs-settings.jpg?fit=max&auto=format&n=NrWVR9Qe6FWmBE6d&q=85&s=32db2daea921d912b7bdbd778c93f3d0" alt="Paramètres OBS" width="974" height="752" data-path="dwe-os/legacy/images/obs-settings.jpg" />
  </Step>

  <Step title="Succès !">
    Magnifique ! Vous devriez maintenant voir les flux configurés avec OBS Studio.
  </Step>
</Steps>

<Warning>
  Avertissement : <br />
  Avec une configuration à 3 flux, cette configuration nécessitera un GPU puissant pour lire
  les vidéos en douceur. Nous avons constaté qu'OBS est beaucoup plus exigeant à utiliser que
  Discovery. Assurez-vous que votre ordinateur portable est suffisamment puissant pour l'exécuter, ou
  vous pouvez réduire la résolution de certains flux à 720p.
</Warning>
