Qu'est-ce que le composant Enabler de DoubleClick ?
Le composant Enabler constitue la bibliothèque de code centrale de DoubleClick Studio. On peut le comparer au cerveau d'une création. Chaque composant Rich Media et chaque appel d'API doit passer par le composant Enabler.
Pourquoi dois-je ajouter le composant Enabler de DoubleClick ?
Le composant Enabler 
est obligatoire pour toutes les créations Rich Media. Grâce au composant Enabler, votre création :
- intègre les fonctionnalités de suivi de statistiques de base (durée d'affichage, nombre d'impressions et durée d'interaction, par exemple) ainsi que d'autres statistiques standards ;
- est compatible avec des fonctionnalités plus complexes, comme la vidéo et la fonction expand.
Pour les créations diffusées sur des pages HTML, le composant Enabler est référencé dans ActionScript sous le nom HtmlEnabler (nom de la classe Enabler). Le composant Enabler représente physiquement la classe au sein d'une création.
Comment puis-je configurer le composant Enabler ?
La classe HtmlEnabler permet de diffuser des créations au sein d'un environnement HTML dans AS2 et AS3.
- Pour inclure la classe Enabler dans un fichier dans AS2, il convient d'ajouter une instance du composant Enabler
dans l'espace de création du fichier parent. Il est inutile d'ajouter le composant dans le fichier enfant. - Dans AS3, vous devez ajouter la classe Enabler aux fichiers via ActionScript. Par ailleurs, votre bibliothèque Flash doit également inclure une instance du composant Enabler.
Vous devez ajouter le composant Enabler dans le fichier parent de la création, et non dans les fichiers enfants. Sinon, vous obtiendrez l'erreur suivante lors de l'importation des éléments dans l'interface utilisateur Web de Studio : "La création ne peut pas comporter plus de 1 éléments Flash principaux".
Sélectionnez l'une des options suivantes pour ajouter le composant Enabler :
- Option 1 : accédez au menu Flash Commandes > DoubleClick Studio v2 > et sélectionnez Insérer le composant Enabler pour DoubleClick Studio v2. Le composant Enabler est alors automatiquement ajouté à votre bibliothèque.
- Option 2 : faites glisser le composant Enabler sur la première image de la timeline
rootdu fichier parent, juste à côté de l'espace de création.
Une fois le composant Enabler ajouté à la création, vous avez toujours la possibilité d'accéder à la classe HtmlEnabler dans ActionScript via la référence globale Enabler.
Dans AS3, vous devez inclure le composant Enabler dans les fichiers via ActionScript et en ajouter une instance dans votre bibliothèque Flash. Pour ajouter le composant Enabler dans les fichiers, il convient d'inclure la classe HtmlEnabler dans le fichier parent et la classe ProxyEnabler dans chaque fichier enfant.
La classe ProxyEnabler est obligatoire dans tous les fichiers enfants qui effectuent des appels vers l'API du composant Enabler. Cette classe sert de proxy pour toutes les API du véritable composant Enabler parent. Contrairement au composant Enabler parent, le composant Enabler enfant ne nécessite pas d'initialisation, ce qui permet de réduire la taille du fichier de création. Il vous suffit de l'importer avant tout appel vers l'API du composant Enabler. En pratique, la classe ProxyEnabler semble envoyer les mêmes événements que le composant Enabler parent.
Choisissez l'une des options suivantes pour ajouter le composant Enabler :
- Option 1 : pour inclure le composant Enabler dans chaque fichier FLA de votre création, accédez au menu Flash Commandes > DoubleClick Studio v2, et sélectionnez Insérer le composant Enabler pour DoubleClick Studio v2.
- Pour un fichier parent, sélectionnez "Oui" lorsque vous devez indiquer au système s'il s'agit du fichier animé parent.
- Pour un fichier enfant, sélectionnez "Non".
Au final, la classeHtmlEnablerest automatiquement importée dans la création parente. La classeProxyEnabler, quant à elle, est directement incluse dans les créations enfants. Notez également qu'une instance du composant Enabler est ajoutée à votre bibliothèque Flash. - Option 2 : faites glisser le composant Enabler dans l'espace de création du fichier parent. Ajoutez ensuite le code ci-dessous dans le fichier parent :
import com.google.ads.studio.HtmlEnabler;
// Faire référence au composant HtmlEnabler;
var enabler:HtmlEnabler = HtmlEnabler.getInstance();
// Initialiser le composant HtmlEnabler. Le mot clé "this" fait référence à l'espace de création.
enabler.init(this);
Ajoutez le code suivant dans le fichier enfant :
import com.google.ads.studio.ProxyEnabler;
// Faire référence au composant ProxyEnabler;
var enabler:ProxyEnabler = ProxyEnabler.getInstance();
Quelle que soit l'option retenue pour configurer le composant Enabler, vous avez toujours la possibilité d'accéder à la classe HtmlEnabler via la variable enabler.
À vous de jouer !
Ajoutez la classe HtmlEnabler dans le fichier parent et la classe ProxyEnabler dans le ou les fichiers entrants.