|
en lui ajoutant nos composants de création vidéo en ligne . |
|
Principe: Cette API vous permet de proposer nos interfaces utilisateur de création de projet vidéo en 4 étapes maximum (choix de scénario, choix de musique, envoi de photos ou de textes, marquages). Vous permet d'ajouter à votre site Internet une fonctionnalité de création vidéo en ligne sophistiquée et très ergonomique, spécialement étudiée pour être accessible au grand public. L'interface est disponible en 6 langues différentes(français, anglais, espagnol, italien, allemand et portugais). Cette API peut également être appelée en mode mise à jour (si votre utilisateur souhaite modifier sa vidéo (par exemple changer une photo ou un panoramique …). Exemple d'usage: Lors d'un dépôt de petite annonce, vous offrez au déposant la possibilité de créer une vidéo à partir de ses photos. 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: • Quels sont les scénarios par défaut que vous souhaitez proposer via notre interface, • La langue dans laquelle vous souhaitez proposer cette interface (français, anglais, espagnol, allemand, portugais ou italien), • Si vous souhaitez laisser libre vos utilisateurs de marquer leurs vidéos, • Si vous souhaitez que les photos utilisés soient issues de votre site Internet (par exemple si vous êtes un site de vente de photos) ou si vous souhaitez que vos clients les récupèrent où ils veulent, • Si vous souhaitez une modération des projets vidéos avant leur création (si par exemple ces vidéos doivent êtres diffusées sur Youtube, il convient de les vérifier avant diffusion), • Si vous souhaitez une diffusion automatisée ou manuelle via nos interfaces, quel type de diffusion vers les sites de partage (youtube, dailymotion, …) vous souhaitez. • … b) Nous mettons en place l'interface. Nos exemples de codes génériques 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, et éventuellement procédure de modération. 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 en mode création ou mise à jour, nos interfaces utilisateur (étudiées pour être d'une grande simplicité, accessibles aux internautes les plus profanes)sont affichées et vos clients peuvent construire leurs vidéos à partir de photos et ou textes en quelques minutes. Une fois leur projet achevé, soit nous produisons la vidéo, soit nous vous prévenons pour modération des contenus avant cette production. Cette modération est conseillée si vous diffusez automatiquement vers des comptes vous appertenant sur les grands sites de partage; Comme vos clients construirons eux mêmes leur projet vidéo, vous ne pouvez connaître ces contenus à l'avance, contrairement aux appels d'APIs en création vidéo directe. Nous générons la vidéo correspondante, la diffusons éventuellement, puis nous vous retournons la vidéo et ou le lecteur vidéo selon vos choix. 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. Ce programme sera également appelé une fois que votre utilisateur validera son projet vidéo si vous avez demandé une modération. * 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 pouvant être nécessaires: --> Serveur FTP_photos: Serveur FTP ou nous stockerons vos photos (par défaut inutile car identique au serveur vidéo) --> Login: Login du serveur photo. --> Password: Mot de passe du serveur photo --> Path absolu miniatures: Chemin absolu où on dépose les miniatures photos sur ledit serveur FTP. Les miniatures sont celles affichées dans la création assistée de projet. --> Path relatif miniatures: Chemin relatif où on dépose les miniatures ( nécessaire pour les déplacements par FTPput) --> Path absolu grandes photos: Chemin absolu où on dépose les photos de grande taille sur ledit serveur FTP --> Path relatif photos --> Site de photos: Si votre service est un site de photos ou pas (permet de récupérer les photos depuis ce site par défaut pour mieux les vendre par exemple. Non par défaut, --> Langue: code langue. en par défaut (fr pour interface en français), --> URL logo: Si votre logo doit être appliqué aux vidéos produites, URL de ce logo. --> Logo users: Si vous autorisez vos clients à apposer leur logo via notre interface (incompatible avec URL logo). --> Taille par défaut: Taille par défaut des vidéos produites. Code 8 par défaut (600 * 450). --> Scénario par défaut: Scénario par défaut qui s'affichera dans l'interface appelé par API. --> 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). Et, 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: Outre le scénario par défaut, il conviendra de nous indiquer les scénarios (12 maximum sur 4 lignes) que vous souhaitez mettre en avant dans votre Best of de scénarios. |
|
|
1) Appel initial de l'API en création assistée: 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 appelez alors Youvea dans une iframe avec en paramètres d'appel "transactionkey" et "externalkey", le mode d'appel "callmode" avec comme valeurs C (pour création assistée) et la langue dans laquelle l'interface de création de projet doit être affichée (paramètre langutil valeur fr pour le français). Si vous avez demandé une diffusion automatique des vidéos produites par vos utilisateurs, il convient en plus de fournir les paramètres suivants: Le titre de la diffusion (titre_diff), au moins 2 TAGs séparés par un blanc (tag_diff), la catégorie de diffusion (cat_diff valeurs possibles de 1 à 12, voir annexes pour les correspondances) et enfin la description de la vidéo (desc_diff). Exemple de traitement php contenant les étapes 1 à 3. L'appel de l'API en mode assisté peut également se faire en mode mise à jour de projet pour corriger une vidéo préalablement produit. Seule l'étape 3 est alors modifiée avec callmode qui prend la valeur "E" au lieu de "C" ci dessus (E= edit pour modifier) et un paramètre supplémentaire: youveakey (qui prend la valeur retournée en étape 6) ci-dessous. Un exemple de traitement en php pour un appel en mode modification contenant les étapes 1 à 3. 4) Etape 1 de la modération. Cette étape est facultative (n'existe pas si vous n'avez pas demandé de modération, vous passez directement à l'étape 6. Auquel cas, Youvea appelle votre "programme après création projet vidéo" (la vidéo n'est donc ni déjà faite, ni diffusée - le projet est bloqué en attendant votre réponse coté Youvea) avec 3 paramètres: * externalkey: La clé de votre projet chez vous. * youveakey: La cle de votre projet chez youvea. C'est ce projet qu'on vous demande de modérer. * moderation: A la valeur "yes" si on vous demande de modérer ce projet. 5) Vous rappelez alors Youvea pour donner votre réponse sur la modération avec les paramètres suivant: * La transactionkey qu'on vous a fourni à l'étape 2, * Externalkey et youveakey fournis à l'étape 4 si dessus * Le paramètre callmode qui contient votre réponse, à savoir: valeur "A" si vous acceptez le projet, et valeur "N" si vous le refusez (il sera alors détruit coté Youvea); Un exemple de traitements en php pour les étapes 4 et 5. 6) 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 6. 7) 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