Aller au contenu principal

Vidéo en direct

Affichez le direct d’une caméra accessible sans exposer votre clé API au service vidéo.

Intégration​

  1. Utilisez Préparer les caméras pour le direct multicaméra pour obtenir les UUID de la carte et de la caméra.
  2. Appelez Démarrer une session de direct avec votre clé sv_api_.... Cette opération n’attend aucun corps de requête.
  3. La réponse contient immédiatement deux URL WebSocket temporaires dans media_access.websocket_urls. Vous pouvez ouvrir l’URL choisie sans attendre ; le média commence lorsque la commande caméra prend effet. Utilisez status_url pour suivre cette commande et diagnostiquer un échec d’activation.
  4. Utilisez rtp uniquement lorsque support_live_rtp vaut true dans le contexte caméra et que votre lecteur prend en charge le transport RTP SentiView ; utilisez sinon hls pour le transport fMP4 SentiView.
  5. Dès l’ouverture du WebSocket utilisé, envoyez le message texte UTF-8 ping, puis renvoyez-le toutes les 5 secondes. Il s’agit d’un message applicatif, pas d’une trame Ping RFC 6455, et aucune réponse pong n’est attendue. Avec le transport HLS/fMP4, accusez aussi chaque paquet traité avec le message texte ping sync_no: <numéro>, en reprenant son sync_no.
  6. Tant que le lecteur est ouvert, appelez également Maintenir une session de direct active toutes les 5 secondes avec la clé API permanente. Ces appels sont inclus dans les quotas généraux par IP : la fenêtre de 10 minutes représente environ 83 caméras au maximum théorique, sans aucun autre appel API. Conservez une marge opérationnelle.
  7. À la fermeture, appelez Arrêter une session de direct. En cas de reconnexion après expiration du ticket, redémarrez la session afin d’obtenir une nouvelle URL.

Le ticket sv_media_v1... est limité à une caméra et au direct. Il ne remplace pas la clé développeur et ne doit pas être conservé.

Ouvrir le module de test Live