API – 3WDOC FAQ

Voici les questions les plus fréquentes que vous pouvez vous poser à propos de 3WDOC Studio. Si vous souhaitez des explications plus visuelles, nous vous invitons à consulter nos tutoriaux animés dans la rubrique Support.
Une version espagnole des tutoriaux et des FAQs sera bientôt en ligne.

Ce que vous devriez savoir avant de commencer

3WDOC Studio vous permet de créer des nouveaux types de contenus rich media liés à une narration.

Qu’est-ce qu’une séquence?

Une séquence comprend votre travail en cours ou terminé. Elle peut être composée d'une piste, comme d'un nombre illimité de pistes. Votre histoire, ou une partie de votre histoire, peut être narrée dans une séquence. Par analogie, une séquence serait l'équivalent d'un chapitre dans un livre, dont les pistes seraient les lignes !

Qu’est-ce qu’une piste ?

Une piste correspond à chaque élément ajouté dans votre séquence. Les pistes peuvent accueillir des médias (photos, audios, vidéos), des articles et des boutons. Chaque piste sera placée dans le temps (time line) et l'espace (positioner).

Qu’est-ce que l’Editeur 3WDOC ?

Le 3WDOC Editeur est l'espace de travail de chaque séquence. Vous construirez votre histoire rich media en sélectionnant les différents médias, articles et boutons, en les agençant, en leur donnant une durée et en les positionnant dans l'espace (positioner).



Qu’est-ce qu’un WDOC ?

Un WDOC est une production finale composée de différentes séquences qui "racontent" une histoire complète.
Un WDOC pourrait avoir comme équivalent un livre.

Quels formats vidéo peut-on utiliser ?

Pour chaque média vidéo vous devrez créer deux fichiers: le premier avec l'extension .mp4 et le second avec l'extension .ogg.
3WDOC STUDIO a besoin de ces deux extensions pour s'assurer que le média sera lu par tous les navigateurs.
La taille maximum d'un fichier est 50Mo.

Quels formats audio peut-on utiliser ?

Pour chaque média audio vous devrez créer deux fichiers : le premier avec l'extension .mp3 et le second avec l'extension .ogg.
3WDOC STUDIO a besoin de ces deux extensions pour s'assurer que le média sera lu par tous les navigateurs.
La taille maximum d'un fichier est 50Mo.

Quelle est la limite d’espace d’hébergement gratuitement offert par 3WDOC ?

L'espace d'hébergement gratuitement offert par 3WDOC est limité à 1Gb par utilisateur.

Quel est le poids maximum d’un fichier ?

Quelque soit l'extension, le poids maximum d'un media est limité à 50Mo.

Pour commencer : 4 étapes !

Quelques bases pour démarrer du bon pied.

Comment uploader un média ?
  • A partir de votre ordinateur: Media > Create : fenêtre Media Edit
  • ou

  • lier votre média directement à partir du web


Comment importer une vidéo depuis le web ?

Allez dans 3WDOC STUDIO : Ajoutez une piste vidéo, puis copiez/collez le lien dans l'Inspecteur. Attention : vous devez retirer l'extension au nom de fichier, et n'oubliez pas d'uploader deux fichiers : un en .mp4 et l'autre en .ogg, pour qu'ils puissent être lus par tous les navigateurs.

Comment créer une séquence ?

Sequence > Create: fenêtre Sequence Edit:
Il y a 3 champs remplis par défaut :

  • Largeur (Width): 960 px
  • Hauteur (Height): 640 px
  • Ces paramètres vous permettront de jouer la séquence en plein écran au format 4:3.

  • Autoplay: TRUE (la séquence se lance automatiquement)

N'oubliez pas de renseigner le champ Label (le nom).
Vous pouvez aussi renseigner les autres champs : Description, Tags...

> Fermez la fenêtre. Vous êtes dans le 3WDOC STUDIO de la séquence créée. Vous pouvez commencer à travailler.

Quelle est la taille recommandée pour une séquence?

Afin d'optimiser la lecture de votre séquence dans le navigateur, allez dans Sequence Edit et entrez ces paramètres :

Pour une vidéo au format 16:9

  • Largeur (Width) : 960 px
  • Hauteur (Height) : 540 px

Pour une vidéo au format 4:3

  • Largeur (Width) : 960 px
  • Hauteur (Height) : 640 px
Comment paramétrer une séquence en plein écran ?

Si vous souhaitez lire votre séquence en plein écran, allez dans Sequence Edit et entrez ces paramètres :

  • Largeur (Width) : 960 px
  • Hauteur (Height) : 540 px (en 16:9) or 640 px (en 4:3)
  • Native Window: FALSE
  • Ratio Window: 0
Comment gérer la valeur Autoplay ?
  • Si vous entrez "TRUE", la séquence se jouera automatiquement sans aucune action de l'utilisateur.
  • Si vous entrez "FALSE", la séquence sera statique, c'est-à-dire que tous les éléments seront visibles en permanence (comme dans un site web classique).


Comment publier une séquence ?
  • Sauvegardez votre séquence (en cliquant sur le bouton Save dans le menu principal de la séquence).
  • Prévisualisez-la pour être sûr(e) que vous êtes satisfait(e) du résultat (en cliquant sur le bouton Preview dans le menu principal).
  • Cliquez simplement sur le bouton Publish. Et voilà !

Cliquez sur le bouton Home dans le menu principal de 3WDOC Studio, pour accéder à My Stories. Toutes les séquences et les WDOC que vous avez publiés sont là.
Vous pourrez accéder directement à chacun d'entre eux, et les partager sur Facebook et Twitter.

Comment créer et publier un WDOC ?

WDOC > CREATE.

  • Renseignez le champ Label.
  • Allez au champ Active et sélectionnez TRUE. Cette action aura pour effet de publier votre WDOC.

Dans votre Sequence List, sélectionnez chaque séquence assignée à ce WDOC : dans Sequence Edit sélectionnez le Webdocument_id de ce WDOC.

Comment travailler dans 3WDOC Studio ?

Pour commencer à utiliser le logiciel.

Comment ajouter une piste ?

Add track Sélectionnez le type d'élément que vous voulez ajouter (audio, vidéo, article, image ou bouton), cliquez sur Add track.
La piste sera créée automatiquement et visible sur la Timeline. Chaque piste est également visible dans le Positioner.
Chaque nouvelle piste sera automatiquement placée en-dessous des autres dans la Timeline.

A quoi sert la Timeline ?

La timeline vous permet de voir et de modifier toutes les pistes dans le temps.
Cliquez simplement sur la piste pour changer sa durée ou la déplacer dans le temps.

Comment dupliquer une piste ?

Vous pouvez dupliquer une piste très facilement.
Dans la Timeline, sélectionnez la piste que vous souhaitez copier et cliquez sur l'icône "double feuille" qui "clone" la piste.

Pourquoi les pistes sont-elles de couleurs différentes ?

Dans la Timeline, nous avons attribué des couleurs différentes pour vous aider à reconnaître les différents types de médias sur chaque piste.

- La couleur bleue représente les boutons.

- La couleur verte représente les images.

- La couleur rouge représente les vidéos.

- La couleur jaune représente l'audio.

- La couleur rose représente les articles.

A quoi sert le Positioner ?

Vous pouvez déplacer une piste avec votre souris et la positionner où vous voulez. Vous pouvez également changer sa taille.
A tout moment, vous pouvez choisir quelle piste sera visible dans le Positionner en cochant / décochant la case de visibilité dans la Timeline.

A quoi sert l’Inspecteur ?

L'Inspecteur vous permet de modifier chaque piste, grâce à ces onglets: Informations, Propriétés, Effets, Actions et Style.



Quelles actions peut-on appliquer ?

TcLink, TcGoto, TcOverlayed, Native action...



Une image peut-elle avoir une action ?

Oui c'est possible ! Allez dans Inspector > Action.

Quels effets peut-on appliquer ?

Blind, Clip, Fade, Slide, Bounce...



Comment modifier les séquences ?

Modifiez quelques paramètres de séquence.

Peut-on copier une séquence ?

Vous pouvez copier une séquence déjà créée. Cela vous permettra d'avoir le même "écran", la même structure, et vous n'aurez qu'à changer les médias.



Comment créer un menu général pour aller aux différentes séquences ?

Vous devez créer une nouvelle séquence, avec des boutons qui créeront des liens vers les différentes séquences.
Chaque bouton aura une action TCLink. Puis cliquez sur Select pour sélectionner la séquence visée.

Comment créer un lien entre 2 séquences ?

Vous pouvez créer un lien entre 2 séquences grâce à l'action TcLink sur un bouton.
Insérez un bouton dans votre séquence, donnez-lui l'action TcLink et cliquez sur SELECT pour sélectionner la séquence visée.

Comment partager une séquence ?

Cliquez sur le bouton Home dans le menu principal de 3WDOC Studio, pour accéder à My Stories. Toutes les séquences que vous avez publiées sont là.

  • Cliquez sur l'icône Facebook pour partager votre séquence sur votre mur
  • Cliquez sur l'icône Twitter pour partager votre séquence sur votre fil d'actualité
Peut-on travailler sur 2 séquences en même temps ?

Non, on ne peut travailler que sur une seule séquence.
Si vous êtes en train de travailler sur une séquence et décidez d'en ouvrir une deuxième, la première sera fermée automatiquement.

A quelle taille une séquence sera-t-elle lue ?

Dans Sequence Edit configurez ces paramètres:

  • Native Window
    TRUE: Votre séquence sera lue à la taille pré-définie.
    FALSE: Vous pouvez changer la taille de votre séquence dans votre navigateur.
  • Ratio Window
    Ce paramètre est actif seulement si vous sélectionnez "FALSE" dans le champ Native Window.

    Si vous entrez "0", la séquence sera lue en plein écran.
    Si vous entrez "0.5", la taille de la séquence sera réduite de moitié.
    Si vous entrez "2", la taille de la séquence sera doublée.

A quoi sert le style ?

Il vous permettra de créer et d’appliquer différents styles à vos éléments.

Comment créer un Style ?

Style > Create: Vous êtes dans le Style Editor:
* Plus d'informations dans "Comment modifier un Style?"

> Cliquez sur l'icône CONFIG
N'oubliez pas de renseigner le champ Label. Vous pouvez aussi renseigner les champs Description, les Tags...

Comment modifier un Style ?

Allez dans le Style Editor et sélectionnez l'élément que vous désirez styler Background, Player Position, Article, Button, Image, UI Botton et UI color.



Comment appliquer un Style ?
  • Un style est toujours lié à une séquence.
  • Allez dans Sequence Edit: Skin_id, et sélectionnez le style que vous souhaitez modifier.

  • Sélectionnez la piste que vous voulez styler, par exemple un bouton
  • Allez dans l'onglet Style dans l'Inspecteur et sélectionnez un style pour le bouton.

* Les médias vidéos et audios ne peuvent pas être stylés.

Comment gérer son workflow ?

La bonne méthode pour organiser votre workflow.

Qu’est-ce que la Liste des Médias ?

C'est la liste des médias que vous avez téléchargé (upload).
Vous pouvez y gérer vos médias et en télécharger de nouveaux (upload). Chaque média y est représenté par: ID, icône de type de média, label, date de téléchargement (upload) et des tags (mots-clefs).
Chaque média peut y être dupliqué, effacé, visualisé, et édité.

Qu’est-ce que la Liste des Séquences ?

C'est une liste des séquences que vous avez créées.
Chaque séquence est représentée par: ID, icône, label, date de création et des tags (mots-clefs).
Chaque séquence peut être dupliquée, effacée et éditée. Cette liste donne aussi accès au 3WDOC Editeur.

Qu’est-que la Liste WDOC ?

C'est une liste de vos WDOCs. Vous pouvez les éditer et en créer de nouveaux.
Chaque WDOC est représenté par: ID, icône, label, date de création et des tags (mots-clefs).
Chaque WDOC peut être dupliqué, effacé et édité.

Aller plus loin avec le 3WDOC Editeur

Quelques indices…

Comment créer une vidéo en « overlay » ?

En overlay les médias n'ont pas de temporalité. Vous devrez créer un bouton pour lancer la vidéo.

  • ajoutez une piste vidéo et renseignez le champ label. Dans ses propriétés, entrez 0 dans le champ start et 0 dans le champ stop.
    Dans Actions, choisissez TcOverlayed et définissez une valeur (comme un mot-clef, par exemple "ma-video").
  • Choisissez clic ou hover pour gérer le type d’événement associé.
  • Gérez la durée de disparition après la fin du survol (de l'élément déclenché et déclencheur) avec le champs option: exemple 3 secondes, il faut saisir 'ttl':3000 .
  • Ajouter une piste Bouton et renseignez le champ label. Dans Actions choisissez TcOverlay et entrez la même valeur que vous avez défini pour la vidéo ("ma-video").
    Sélectionnez l'action de la souris (clic ou survol, "click/hover") pour lancer l'évènement.

Comment insérer un bouton d’interface utilisateur (comme play, pause, fwd…) ?

Vous devez créer un bouton et lui affecter l'Action Native action.
Dans Value vous pouvez choisir entre Ctime (pour afficher le time code de la séquence), Fwd (pour faire avance rapide dans la timeline), Mute (couper le son), Pause, Play (lancer la séquence), Rwd (retour rapide dans la timeline), Screensize (activer le mode plein écran pour la séquence), Sndminus (réduire le volume), Sndplus (augmenter le volume), Stop (arrêter la lecture). Dans Type, sélectionnez UI, qui veut dire User Interface, soit bouton d'interface utilisateur.
(Cette terminologie est issue du langage JQuery)

Un WDOC est-il visible dans tous les navigateurs, sur toutes les tablettes et les smartphones ?

Le HTML5 est un nouveau langage dont il faut connaître quelques informations.

Quels sont les meilleurs navigateurs internet pour 3WDOC Studio?

Nous vous recommandons d'utiliser la dernière version de chacun de ces navigateurs, bien que ces versions soient déjà compatibles :

  • Safari: 4.1 et +
  • Firefox: 3.5 et +
  • Opera: 10.6 et +
  • Google Chrome: toutes versions
  • Internet Explorer: versions 6, 7, 8 et 9. Les utilisateurs de Internet Explorer devront installer le plugin Google Chrome Frame pour avoir une vision complète d'un WDOC.
Peut-on voir un WDOC sur un iPad ?

Vous pourrez bientôt voir un WDOC sur un iPad. Pour l'instant, 3WDOC a quelques limites que vous devriez connaître :
Les médias audios et vidéos (ayant une durée) ne pourront pas être joués.

Quelle alternative ?
Vous pourrez en revanche lire les médias audios et vidéos en "overlay". Cela signifie que vous devrez créer un bouton pour activer cette action. (Plus d'informations dans "Comment créer une vidéo en overlay?")

Comment gérer son compte ?

A propos du compte utilisateur.

Comment supprimer de façon définitive son compte 3WDOC ?

Pour l'instant, il n'y a pas de procédure automatique. Envoyez-nous un email à info@3wdoc.com en nous demandant de supprimer votre compte, et nous le ferons.

Résolution des problèmes

Que faire (en cas de problèmes)

Mon compte VIP est actif mais je ne parviens pas à accéder à mon 3WDOC Studio ?

Souvenez-vous que lorsque vous inscrivez et que vous choisissez d'utiliser l'espace mis à disposition gratuitement par 3WDOC pour héberger vos créations sur une adresse du type http://studio1.vip1.3wdoc.com/, lactivation de ce compte gratuit prend un peu de temps, environ une 1/2 heure. Lorsque vous y rendez à nouveau sur une adresse http://studio1.vip1.3wdoc.com/, n'oubliez pas vider votre cache ou de rafraichir la page, afin de voir si votre compte est activé.



Pourquoi est-on déconnecté(e) de 3WDOC Studio ?

Il y a un temps de connexion limité si on demeure inactif dans le 3WDOC Studio. Vous serez déconnecté(e) après une durée d'inaction d'environ 25 minutes.

Pourquoi doit-on rafraîchir la page ou vider le cache du navigateur pour voir les modifications ?

Comme pour n'importe quelle page web, nous vous conseillons de vider le cache de votre navigateur de temps en temps. Après une Sauvegarde, avant de cliquer le bouton Preview, videz le cache pour visualiser les modifications.
Après cette action, si vous ne visualisez toujours pas vos modifications, rafraîchissez la page.

J’ai un domaine enregistré et j’ai installé 3WDOC Studio sur ce domaine, mais ça ne marche pas…

Souvenez-vous que si vous enregistrez votre domaine, par exemple, www.mydomain.com et installez 3WDOC Studio à www.mydomain.com/my-studio/, vous devrez y accéder à partir de cette adresse.
Si vous essayez d'y accéder par l'adresse mydomain.com/my-studio/ cela ne marchera pas, car c'est un AUTRE DOMAINE.

J’ai une erreur d’affichage d’image en fond sur les boutons ?

En fonction des évolutions des navigateurs, vous pourrez parfois rencontrer des différences en terme d’affichage. Ce n’est pas à proprement parlé un bug même si cela en a l’apparence. C’est une erreur d’affichage des images de fond sur le « hover » des boutons, c’est à dire lorsque la souris passe sur ces boutons, l’image reste introuvable. [...]