Ajout de caméras

SkyView ne se connecte nativement qu'en RTSP et ONVIF. Les protocoles propriétaires (Tapo / Xiaomi / Wyze, etc.) sont pontés vers RTSP via go2rtc puis ajoutés. Ce chapitre couvre divers scénarios de connexion et fonctionnalités avancées.

Découverte automatique ONVIF (préférée)

Si la caméra et SkyView sont sur le même réseau local et que la caméra a ONVIF activé (activé par défaut en usine) :

  1. 1

    Scanner

    Web Admin → Caméras → Ajouter → choisissez « Découverte automatique ONVIF » ; après quelques secondes, tous les périphériques ONVIF du réseau local s'affichent

  2. 2

    Choisir la cible

    Trouvez l'IP / MAC / fabricant correspondant à votre caméra et sélectionnez-la

  3. 3

    Entrer les identifiants

    Le nom d'utilisateur et le mot de passe ONVIF (pas nécessairement les mêmes que le mot de passe RTSP ! Les valeurs par défaut d'usine Hikvision/Dahua sont souvent admin/12345 ou similaire)

  4. 4

    Enregistrer

    SkyView négocie automatiquement les adresses des flux principal/secondaire et sonde les ports PTZ / audio bidirectionnel, en stockant le tout ensemble

ONVIF renvoie une mauvaise IP

Certains firmwares non conformes renvoient l'IP interne codée en dur de la caméra (par ex. 192.168.1.99) au lieu de sa véritable adresse sur le réseau local. Lors de l'ajout d'une caméra, SkyView teste automatiquement les flux principal + secondaire et refuse d'enregistrer si l'un des deux est inaccessible. Dans ce cas, vous ne pouvez que passer au RTSP manuel.

RTSP manuel

Utilisez la méthode manuelle quand ONVIF n'est pas pris en charge ou renvoie une mauvaise adresse. Vous devez trouver l'URL RTSP dans le manuel du fabricant ou l'application IPC ; formats courants :

MarqueExemple d'adresse RTSP du flux principal
Hikvisionrtsp://utilisateur:motdepasse@IP:554/Streaming/Channels/101
Dahuartsp://utilisateur:motdepasse@IP:554/cam/realmonitor?channel=1&subtype=0
TP-Link Vigi (IPC, pas Tapo)rtsp://utilisateur:motdepasse@IP:554/stream1
Xiaomi / Aqara / Imou et autres protocoles propriétairesRTSP direct non pris en charge — utilisez l'approche go2rtc ci-dessous

Vérifier avec VLC

Avant d'ajouter, vérifiez que l'URL fonctionne dans VLC (Média → Ouvrir un flux réseau) en la collant. Si VLC peut la lire, SkyView le peut aussi ; si VLC n'y arrive pas, ce n'est pas un problème de SkyView.

Tapo / Xiaomi / Wyze et autres protocoles propriétaires → pont go2rtc

Les caméras grand public comme la TP-Link Tapo C100/C200/C220, Xiaomi Mi Home et Wyze n'activent pas le RTSP standard, mais le projet communautaire go2rtc peut les ponter vers RTSP pour que SkyView puisse s'y connecter.

  1. 1

    Démarrer un conteneur go2rtc

    Sur la même machine que SkyView, c'est très bien ; le port 1984 est l'interface web de go2rtc et 8554 est le RTSP qu'il expose.

    bash
    docker run -d --name go2rtc \
      --restart=always \
      --network host \
      -v $(pwd)/go2rtc.yaml:/config/go2rtc.yaml \
      alexxit/go2rtc
  2. 2

    Configurer les caméras dans go2rtc.yaml

    Exemple Tapo : le compte invité de l'application Tapo suffit.

    yaml
    streams:
      livingroom: tapo://guest_password@cameraIP:554/stream1
      kitchen: tapo://guest_password@anotherIP:554/stream1
  3. 3

    Ajouter la caméra dans SkyView

    Utilisez la méthode RTSP manuelle, définissez l'URL sur rtsp://<IP hôte go2rtc>:8554/livingroom, et laissez les identifiants vides.

go2rtc est hors du périmètre de SkyView ; pour tout problème, consultez le README de go2rtc. SkyView ne voit qu'un flux RTSP et est agnostique quant à la source.

Pourquoi les sous-flux sont importants

Les IPC ONVIF / grand public fournissent deux flux : un flux principal (HD, pour la visualisation en direct) et un sous-flux (basse résolution, pour la détection IA). SkyView obtient automatiquement l'adresse du sous-flux via ONVIF. Avec le RTSP manuel, nous recommandons de renseigner l'URL du sous-flux dans le second champ, ce qui permet à la détection d'économiser plus de 70 % de bande passante et de CPU.

Les sous-flux réduisent l'utilisation des ressources

416x416 est une résolution suffisante pour la détection IA, alimenter la détection avec un flux principal en 1080p est donc du gaspillage. Les sous-flux sont typiquement en 640x360 / 480p — juste ce qu'il faut.

Codec vidéo : privilégier le H.264, éviter le H.265

À qualité égale, le H.265 (HEVC) a un débit inférieur de 40 à 50 % par rapport au H.264, ce qui semble économique, mais le support de lecture dans les navigateurs est médiocre — la plupart des utilisateurs obtiennent un écran noir / une roue de chargement en visualisant le Direct ou la relecture dans le Web Admin. Avant d'activer une caméra, changez son codec en H.264.

ClientH.264H.265 (HEVC)
Chrome / Edge (Windows / Linux)✅ Support parfait❌ Ne décode pas par défaut, écran noir / roue de chargement
Safari (macOS / iOS) / Chrome (macOS)✅ Support parfait✅ Pris en charge, mais certains appareils anciens saccadent
Application SkyView Android / iOS✅ Support parfait✅ Lecteur natif, support parfait

Comment le changer

Connectez-vous à l'interface web propre de la caméra → Paramètres vidéo / d'encodage → changez le codec vidéo en H.264. Changez à la fois le flux principal et le sous-flux. Certains modèles Hikvision ont un format modifié H.264+ ; choisir le H.264 standard est le plus fiable. Après le changement, vérifiez une fois dans VLC que la lecture fonctionne correctement.

Doubler approximativement l'espace d'enregistrement est acceptable

Le H.264 utilise environ deux fois plus de disque que le H.265 (1080p ≈ 21 Go / flux / jour contre ~10 Go pour le H.265), mais en contrepartie vous obtenez un Direct + une relecture qui fonctionnent directement dans tous les navigateurs du Web Admin — un écart d'expérience bien plus important que le coût en disque. 10 flux conservés 30 jours ≈ 6,3 To, ce qui reste tout à fait raisonnable aux prix actuels des disques durs. Si vous utilisez uniquement l'application SkyView et n'ouvrez jamais le Web Admin, le H.265 peut économiser la moitié de l'espace.

Contrôle PTZ (panoramique/inclinaison/zoom)

Pour les caméras connectées en ONVIF prenant en charge le PTZ, les boutons de direction / zoom apparaissent automatiquement en bas à droite de la page Direct. Les caméras RTSP ajoutées manuellement ne l'activent pas automatiquement ; vous devez renseigner le port ONVIF (généralement 80 / 8000) et les identifiants PTZ dans les détails de la caméra.

Audio bidirectionnel (Talkback)

Les caméras prenant en charge le canal de retour ONVIF permettent l'audio bidirectionnel (maintenez le bouton micro dans l'application pour parler, l'autre partie vous entend). Le Web Admin ne prend pas encore en charge le déclenchement du talkback ; seules les applications mobiles (iOS / Android) ont le bouton maintenir pour parler.

Relâcher avant de changer de caméra

Le talkback est une connexion persistante alimentant l'audio. Relâchez toujours avant de changer de caméra ; l'application termine l'ancienne session et en ouvre une nouvelle — maintenir en changeant provoque un désalignement audio.

Remarques sur la modification / suppression de caméras

  • Après avoir changé l'URL RTSP, la détection peut ne pas redémarrer automatiquement : comme il existe un enregistrement de statut « échec de détection » pour cette caméra, vous devez cliquer sur « Effacer l'erreur de détection » dans les détails de la caméra pour qu'elle fonctionne à nouveau
  • Supprimer une caméra retire aussi l'enregistrement en base de données et le chemin de streaming, mais les fichiers d'enregistrement ne sont pas supprimés — pour éviter de détruire accidentellement des preuves. Supprimez-les manuellement sous data/recordings/<id>/
  • Renommer / regrouper n'affecte ni les enregistrements ni l'historique des événements

Ces trois marques sont les principales marques d'IPC commerciales, toutes avec ONVIF + RTSP standard sur toute leur gamme et la meilleure compatibilité avec SkyView. Identifiants par défaut d'usine :

MarqueCompte par défautConseils pour la première connexion
Hikvisionadmin / personnalisé (à définir obligatoirement au premier démarrage)Si ONVIF ne parvient pas à obtenir un flux, connectez-vous à l'interface web de la caméra et activez le protocole ONVIF
Dahuaadmin / adminLe port ONVIF par défaut 80 est partagé avec HTTP
TP-Link Vigiadmin / personnaliséONVIF est désactivé en usine ; activez-le d'abord via l'application Vigi

GB28181 (norme nationale chinoise — NVR·IPC·DVR Hikvision / Dahua / Uniview)

Les appareils GB/T 28181 s'enregistrent eux-mêmes auprès de SkyView — pas besoin de saisir une URL RTSP par caméra, et tous les canaux d'un même NVR peuvent être importés par lots. La plupart des IPC, NVR et DVR aux normes nationales chinoises de Hikvision / Dahua / Uniview proposent une option « plateforme amont (GB28181) ». Nécessite SkyView 0.9.13 ou ultérieur.

Désactivé par défaut — les mises à jour se font en toute transparence

Quand GB28181 est désactivé, le processus reste inactif et n'occupe aucun port, les utilisateurs mettant à jour depuis une ancienne version et ne l'utilisant pas ne sont donc absolument pas affectés. Port de signalisation 25060/udp, port média 30000/udp ; en mode réseau hôte (par défaut pour l'installateur en un clic, l'image unique et docker-compose), ils sont automatiquement exposés sur le réseau local — fonctionne immédiatement.

Étape 1 — Activer GB28181 dans SkyView

  1. 1

    Activer

    Web Admin → Paramètres → GB28181 → basculez Activer.

  2. 2

    Définir un mot de passe d'enregistrement

    La page affiche les paramètres de plateforme à saisir dans vos appareils et vous permet de définir un mot de passe d'enregistrement (partagé par tous les appareils). Les paramètres de plateforme par défaut fonctionnent généralement tels quels.

  3. 3

    Définir extern_host pour l'accès distant

    Si l'appareil et SkyView sont sur des réseaux différents, indiquez dans extern_host l'adresse par laquelle votre appareil peut vous joindre en retour (IP publique ou adresse mappée par le routeur) ; laissez vide pour les connexions directes sur le même sous-réseau.

  4. 4

    Enregistrer

    Après l'enregistrement, le service GB28181 commence à écouter sur le port 25060 et attend l'enregistrement des appareils.

Paramètre de plateformePar défautRemarques
ID SIP de la plateforme / ID amont34020000002000000001À saisir comme « ID GB de la plateforme amont » de l'appareil
Domaine SIP / royaume3402000000Laissez vide pour utiliser automatiquement les 10 premiers chiffres de l'ID SIP
Adresse du serveur SIPIP LAN de l'hôte SkyView (par ex. 192.168.1.50)L'appareil doit pouvoir atteindre cette adresse
Port du serveur SIP25060
Mot de passe d'enregistrementÀ définir vous-mêmePartagé par tous les appareils

Étape 2 — Configurer la « plateforme amont » sur l'appareil / le NVR

Dans l'interface web de l'appareil, trouvez « Accès plateforme / GB28181 / Plateforme amont » (le libellé varie selon le fabricant) et renseignez le tableau ci-dessous. Une fois enregistré, l'appareil s'enregistre lui-même — un NVR signale tous ses canaux en une seule fois :

Champ sur l'appareilQue saisir
ID du serveur SIP amontL'ID SIP de SkyView (34020000002000000001)
Domaine du serveur SIPLe domaine SIP de SkyView (3402000000)
Adresse / IP du serveur SIPAdresse de l'hôte SkyView (IP LAN en local ; l'adresse extern_host via Internet)
Port du serveur SIP25060
Nom d'utilisateur d'enregistrement / ID GB de l'appareilL'ID GB à 20 chiffres intégré de l'appareil, ou inventez-en un
Mot de passe d'enregistrementLe mot de passe d'enregistrement défini dans SkyView
TransportUDP

Étape 3 — Importer les canaux et les utiliser comme n'importe quelle caméra

Retournez dans Web Admin → page GB28181 → « Appareils / canaux à importer » : les appareils enregistrés avec succès et les canaux du NVR y apparaissent. Cochez les canaux souhaités et cliquez sur Importer (sélection multiple ; importez tous les canaux d'un NVR en une fois). Une fois importés, ces canaux se comportent comme des caméras ordinaires — vue en direct, enregistrement, détection IA, instantanés, statut en ligne, PTZ + préréglages, communication bidirectionnelle et relecture sur l'appareil fonctionnent tous, identiques dans l'interface aux caméras RTSP / ONVIF.

Déploiement distant / entre réseaux différents

Quand l'appareil et SkyView sont sur des réseaux différents : ① transférez 25060/udp et 30000/udp via votre routeur / pare-feu vers l'hôte SkyView ; ② extern_host dans les Paramètres doit être une adresse par laquelle l'appareil peut vous joindre en retour (IP publique ou DDNS), sinon vous obtenez « l'appareil s'est enregistré mais il n'y a pas de vidéo ».
PortProtocoleUsage
25060UDPSignalisation SIP GB28181 (enregistrement / catalogue / démarrage-arrêt du flux)
30000UDPMédia RTP GB28181 (envoi par l'appareil ; plusieurs flux partagent un seul port)

Ça ne se connecte pas / pas d'image ?

Ne s'enregistre jamais : l'appareil peut-il pinger l'hôte SkyView ; le port 25060/udp est-il bloqué par un pare-feu ou non redirigé ; l'ID SIP / le domaine / le mot de passe correspondent-ils dans SkyView. Enregistré mais pas d'image : généralement extern_host est manquant ou incorrect (l'appareil ne peut pas vous joindre en retour) ; vérifiez aussi que le port 30000/udp est ouvert. Le NVR n'affiche que certains canaux : les canaux en ligne se synchronisent progressivement selon un calendrier — patientez un instant ou rafraîchissez la page GB28181 ; les canaux hors ligne n'apparaîtront pas.
Ajout de caméras - Documentation SkyView