|
une version vidéo de tous vos contenus . |
|
Principe: Vous nous transmettez vos informations, et pour chaque information nous produisons automatiquement puis vous retournons une vidéo. Le flux d'information que vous nous transmettez inclue le scénario de la vidéo désirée, ainsi que sous une forme ou une autre les informations nécessaires à ce scénario (textes, images, …). Le processus est réalisé en quelques dizaines de secondes de façon totalement transparente pour vos utilisateurs (en back office). Par exemple, pour chaque création d'une petite annonce sur un site d'annonce, nous réalisons sa version vidéo. Ou encore nous réalisons une vidéo pour chaque dépêche de votre journal en ligne. Les vidéos sont produites en quasi temps réel. Modalités de mise en oeuvre: a) Nous définissons ensemble vos besoins, c'est-à-dire essentiellement: • D'un coté de quelles informations vous disposez (textes, photos, …), • De l'autre quel(s) sont les scénarios de vidéo que vous souhaitez nous faire réaliser (et qu'il est possible de réaliser à partir de vos données), éventuellement les bruitages musicaux désirés, le format des vidéos et les options de diffusion automatisées vers les plateformes de partage. b) Nous mettons en place l'interface. Nos exemples de codes génériques (cf ci après) vous permettent une intégration simplifiée (vous avez juste à remplacer les liens vers vos programmes dans les cas standards): Appel de l'interface, et récupération des informations transmises. Les informations à transmettre pour la création d'une vidéo sont fournies au sein d'un fichier texte dont les caractéristiques sont fournies dans la cinématique ci après. Une API key vous est fournie (vous pouvez demander plusieurs clés API (une pour la création directe, une pour le mode assisté, … avec des caractéristiques par défaut différentes). c) A chaque appel de l'API, nous récupérons les informations de l'appel (par exemple des textes et URLs de photos), nous générons la vidéo correspondante, la diffusons éventuellement, puis nous vous retournons la vidéo et ou le lecteur vidéo. En dehors de l'initialisation, l'ensemble des opérations est totalement transparent pour vos utilisateurs, ce qui permet une automatisation totale avec de grands volumes de production de qualité (jusqu'à plusieurs milliers de vidéos par jour). Cas particulier des vidéos avec bande vocale: Nous proposons la création automatisée de vidéos à partir de textes en langues françaises et anglaise, avec ou sans bruitage musical (bruitage conseillé, volume relatif paramétrable). Dans le cas générique, le texte correspondant à la bande vocale à réaliser nous est fourni en paramètre pour chaque vidéo à réaliser. S'il s'agit de textes libres, il convient d'étudier une prestation de mise en place pour gérer les exceptions vocales liés aux noms propres et ou aux abréviations courantes. A noter que dans le cas des petites annonces, ce lexique peut en général être évité. Informations nécessaires: a) Dans tous les cas, vous devez fournir les chemins des 2 programmes suivants: * Le path (URL) de votre " programme après création projet vidéo": (à ce stade la vidéo n'est pas créée, mais juste le projet qui servira à la créer). Cette adresse sera utilisée pour vous envoyer une APItransaction (après voir contrôlé votre APIkey) puis communication de la clé interne sur nos serveurs (youveakey) allouée à votre projet. * Le path (URL) de votre "programme après création vidéo". Cette adresse sera utilisée pour vous communiquer votre vidéo, et ou les lecteurs vidéos sur les sites de partage si vous avez décidé d'une diffusion vers ces sites. b) Serveur d'envoi des vidéos et ou des lecteurs vidéos. Nous ne stockons ni vos photos, ni vos vidéos ou lecteurs vidéo (mais notre technologie vous permet de faire héberger gratuitement vos vidéos, et de disposer d'une bande passante gratuite !) . Il convient donc de nous indiquer où les envoyer. Il nous faut pour cela: • Le nom de votre serveur FTP, son login, son mot de passe et le chemin absolu de dépôt de la vidéo et ou des lecteurs vidéo (là où vous les récupèrerez). • Il nous faut bien entendu les droits d'écriture à cet endroit. Il nous est éventuellement possible de vous proposer un tel serveur FTP. Néanmoins, les informations n'y seront conservées que 3 jours maximum. c) Autres informations nécessaires: --> URL logo: Si un logo doit être appliqué aux vidéos produites, URL de ce logo. Cette information peut également être communiquée au cas par cas à chaque appel de l'interface. --> Taille par défaut: Taille par défaut des vidéos produites. Code 8 par défaut (600 * 450). --> Broadcast: :Nombre de plateformes de diffusion demandées. 0 par défaut (c'est à dire pas de diffusion). --> Video and broadcast: Les résultats que vous souhaitez: * Valeur 1: juste la vidéo. (broadcast = 0). Si broadcast est différent de 0: * Valeur 2 (le résultat renvoyé n'est que le lecteur de la vidéo diffusée) * Valeur 3 ( on renvoie la vidéo + le lecteur). Valeur 1 par défaut. --> Impose broadcast: Impose broadcast permet de préciser les paramètres de diffusion que vous souhaitez: * Valeur à 0 si pas de diffusion (dans le cas ou la rubrique broadcast égale 0), * Valeur 1 si plateforme vidéo de diffusion, le compte sur cette plateforme et les infos de diffusion (tags, descriptions, ...) sont imposées, * Valeur 2 si plateforme et compte de diffusion imposés, mais pas les informations de diffusion, * Valeur 3 si diffusion obligatoire mais rien n'est imposé, sauf éventuellement la ou les plateformes * Valeur 4 si la diffusion est facultative, et que rien n'est imposé. Valeur 0 par défaut. --> Impose taille: Taille de player (lecteur vidéo) choisie par le client, s'il souhaite un player suite à une diffusion (video and broadcast = 2 ou 3). Valeurs possibles: 0 (très petite), 1 (petite), 2 (moyenne), 3 (grande) ou 4 (très grande). Valeur 3 par défaut. --> Impose start: Impose start permet de définir si le player de votre vidéo se lancera automatiquement ou pas. Valeur 0 par défaut (pas d'autostart). Valeur 1 si autostart. --> Modération de contenus: Le paramètre Modération vous permet d'imposer une modération avant la production de la vidéo. Par exemple pour vérifier s'il y a des photos de racisme, sexe, ... dans les contenus transmis, pour empécher leur publication. Dans le cas des API en création directe, nous vous conseillons d'effectuer cette modération avant l'appel de l'API dans la mesure du possible. Valeur 0 par défaut. Valeur à 1 si vous souhaitez modérer vos contenus. Les 3 rubriques "Impose taille", "Impose start" et "Moderation" sont actifs si une autre valeur n'est pas passée en paramètres par le Tiers lors de son appel par API. . Ils peuvent donc être débrayés par rapport aux valeurs par défaut. En cas de demande de diffusion (rubrique Impose broadcast = 1, 2 ou 3): Il convient en plus de fournir la ou les plateforme(s) de diffusion (par exemple youtube) , et votre identifiant mot de passe sur chacune des plateformes sur laquelle vous souhaitez diffuser votre vidéo. Scénarios et paramétrages de scénarios: Nous vous ferons choisir parmi les 50 scénarios de vidéos que nous proposons. Il conviendra de nous indiquez lesquels vous souhaitez que nous mettions en production (plusieurs choix possibles). Il en va de même des musiques de fond que nous proposons. |
|
|
1) Appel initial de l'API en création directe: Vous devez nous communiquer en paramètres votre clé API (paramètre APIkey) et la clé de votre projet (paramètre externalkey). Chemin du programme devant être appelé pour toutes les APIs quelle que soit l'étape: http://www.youvea.com/dcarte/projet/youveaiframe/frame.php 2) Youvea rappelle votre programme "après création projet vidéo" avec en paramètres la clé de votre projet (externalkey) et une clé de transaction valable pour cet appel uniquement (transactionkey) 3) Vous rappellez Youvea avec en paramètres "transactionkey" et "externalkey", le mode d'appel "callmode" avec comme valeurs DC (pour création directe) et la langue que vous utilisez (paramètre langutil valeur fr pour le français), ainsi que l'URL d'un fichier dcfile.txt (paramètre dcfile) dans lequel vous aurez stocké les informations nécessaires à la création de la vidéo. Chaque ligne de ce fichier correspond à une vidéo à créer et comprend les 15 rubriques suivantes, séparées chacune d'une double virgule (,,). • Rubrique 1: externalkey (votre clé, par exemple votre identifiant d'annonce, votre Id de dépèche, ...) • Rubrique 2: Numéro du scénario youvea demandé (cf annexes) • Rubrique 3: 1er logo s'il y en a un. Facultatif. • Rubrique 4: 2ème logo s'il y en a un. Facultatif • Rubrique 5: Taille de la vidéo demandée (cf annexes) • Rubrique 6: Musique choisie Facultatif. (cf annexes) • Rubrique 7: Voix de synthèse vocale choisie. Facultatif. Selon scénario choisi. Cf Annexe • Rubrique 8: Texte de synthèse vocale. Facultatif selon scénario • Rubrique 9: Sous titre de séquence pour la vidéo (100 caractères maximum). Facultatif selon scénario • Rubrique 10: extension vidéo. Par défaut .wmv • Rubrique 11: Titre de diffusion. Facultatif. En cas de diffusion imposée sur un de vos comptes sur une plateforme. Les "?" et "&" sont interdits • Rubrique 12: TAG de diffusion. Facultatif. En cas de diffusion imposée sur un de vos comptes sur une plateforme. Au moins 2 tags séparés par un blanc. Les "?" et "&" sont interdits • Rubrique 13: Description de diffusion. Facultatif. En cas de diffusion imposée sur un de vos comptes sur une plateforme. Les "?" et "&" sont interdits • Rubrique 14: Catégorie de diffusion. Facultatif. En cas de diffusion imposée sur un de vos comptes sur une plateforme. Valeur de 1 à 12 (cf annexes) • Rubrique 15: Liste des photos et sous titres de photos selon scénarios cf annexe. Exemple de traitement php contenant les étapes 1 à 3. 4) Une fois la vidéo produite et éventuellement diffusée, Youvea rappelle votre programme "après création vidéo" avec en paramètres la clé de votre projet (externalkey), la clé de votre projet coté youvea (youveakey), un paramètre d'état de l'opération (state) dont la valeur est à 1 si la vidéo a été bien créée, un paramètre d'erreur (errorvid) si state est différent de 1, la durée de la vidéo produite en secondes (paramètre duration), son poids en KO (paramètre weight) et l'extension du fichier vidéo (paramètre extension). • Si vous l'avez demandé, la vidéo est déposée sur votre serveur vidéo et se nomme "externalkey.extension". • Si vous l'avez demandé, le fichier contenant les informations de diffusion est déposé sur votre serveur vidéo et se nomme "broadcastvideo""externalkey".txt. Ce fichier contient plusieurs lignes (une par diffusion de votre vidéo) contenant chacune 6 rubriques séparées séparée par une virgule et un caractère blanc: externalkey, youveakey, nom de la plateforme(par exemple "youtube", "dailymotion", ...), l'URL de la vidéo sur cette plateforme, le player paramétré et enfin l'erreur de diffusion éventuelle. Exemple de traitement php correspondant à l'étape 4. 5) Il vous sera possible plus tard d'appeler l'API en mode suppression, pour par exemple demander la suppression de la vidéo sur toutes les plateformes sur lesquelles elle a été diffusée. Cette demande s'effectue en 2 étapes. Une 1ère étape 1 bis) similaire à l'étape 1) dans laquelle vous demandez une clé de transaction, Une seconde étape où vous appelez Youvea en mode suppression avec les paramètres suivants: votre transactionkey obtenue ci-dessus à l'étape 1bis), externalkey, youveakey (qui vous a été fournie lors de la dernière transaction de création ou mise à jour réussie) et callmode qui prend la valeur "DE" (pour delete). Exemple de traitement php correspondant à l'appel en mode suppression. |
Accueil Qui sommes nous ? Notre technologie Notre blog