De nombreux propriétaires de chaînes souhaitent utiliser le contenu de dartfish.tv sur leurs propres sites web. Cela peut se faire par le biais d'un code d'intégration vidéo. Il s'agit d'un bout de code que vous placez sur votre site web et qui s'affiche sous la forme d'un lecteur vidéo. Un code d'intégration extrait le contenu vidéo de la source originale et l'affiche dans le lecteur, ce qui vous permet d'afficher une vidéo sans avoir à héberger les fichiers sur le site web

Exigences

L'intégration nécessite que certaines options soient activées sur la chaîne. Ces options dépendent du contenu qui doit être intégré. Contactez l'administrateur de votre chaîne pour plus d'information sur ces options:

  • Intégration d'une vidéo publique donnée:
    • Aucune exigence
  • Intégration d'une vidéo privée donnée:
    • Option de la chaîne "Private Embedding"
    • Whitelisting du domaine dans lequel le contenu est intégré
  • Intégration d'une vidéo ou playlist dont le contenu dépend d'un filtrage par mots-clé
    • Option de la chaîne "Private Embedding"
    • Whitelisting du domaine dans lequel le contenu est intégré
    • Option de la chaîne "Dartfish.tv API"

Intégration d'une vidéo publique ou privée donnée

Pour intégrer une vidéo donnée dans un site web, relevez l'url de la vidéo et copiez la section CR de cette url. Cette section inclut 3 paramètres (p, c et m). Exemple avec l'adresse https://dartfish.tv/Videos?CR=p154908c399545m7731057&br=1


Sur le site web, entrez le code suivant:


<div style="position:relative;padding-bottom:calc(56.25% + 16px);">
<div style="position:absolute;inset:0;">
<iframe src="https://dartfish.tv/Embed?{ YOUR PARAMETER HERE }" width="100%" height="100%" allowfullscreen></iframe>
</div>
</div>


Ensuite, remplacez {YOUR PARAMETER HERE} par la section CR:. 


<div style="position:relative;padding-bottom:calc(56.25% + 16px);">
<div style="position:absolute;inset:0;">
<iframe src="https://dartfish.tv/Embed?CR=p154908c399545m7731057" width="100%" height="100%" allowfullscreen></iframe>
</div>
</div>


Par défaut, le lecteur vidéo aura un ratio 16/9 et remplira toute la taille disponible dans l'i frame. Pour définir une taille fixe, utilisez les paramètres "width" et "height" (par exemple width="640px" height="360px")

Intégration de contenu obtenu avec un filtrage de mots-clé

Au lieu d'intégrer une vidéo donnée, il est également possible d'intégrer une vidéo ou playlist résultant d'un filtrage. Pour ce faire, il faut combiner l'intégration de contenu avec les Smart Links. Pour en savoir plus sur le fonctionnement des Smart Links, veuillez consulter la page https://api.dartfish.tv/


Les Smart Links permettent de construire des liens basiques et lisibles vers un contenu dédié hébergé sur une chaîne dartfish.tv, comme par exemple l'ensemble des évènements "Buts"  marqués par le joueur "A" sur tous les matchs de la chaîne. Un Smart Link est constitué d'une url de base et des paramètres de la requête. Dans l'exemple suivant, l'url de base est surlignée en vert et les paramètres en jaune


http://www.dartfish.tv/SmartLink? channelId=1&KW1_1=Athlete&KW1_2=Bob&KW2_1=Discipline&KW2_2=LongJump


Copiez les paramètres de la requête dans le code d'intégration pour intégrer un Smart Link


<div style="position:relative;padding-bottom:calc(56.25% + 16px);">
<div style="position:absolute;inset:0;">
<iframe src="https://dartfish.tv/Embed?channelId=1&KW1_1=Athlete&KW1_2=Bob&KW2_1=Discipline&KW2_2=LongJump" width="100%" height="100%" allowfullscreen></iframe>
</div>
</div> 


Ce code intégrera une playlist d'évènements incluant les évènements "LongJump" de l'athlète "Bob" hébergés sur la chaîne 1


Un Smart Link peut ouvrir 3 résultats différents, définis par le paramètre targetr (cf. documentation Smart Links référencée plus haut. Puisque l'intégration permet uniquement d'intégrer un lecteur vidéo, et non une liste de vidéo ou évènements dans une vue de bibliothèque:

  • Les Smart Links intégrés avec le paramètre target "video" ouvrent la vidéo la plus récente remplissant les paramètres de la requête
  • Les Smart Links intégrés avec le paramètre target "event" ouvrent une playlist dans le lecteur vidéo


Autres outils de connectivité dartfish.tv

Veuillez consulter cet article pour découvrir les autres outils de connectivité de dartfish.tv