Média Mixte mixed-media

La visionneuse de médias mixtes est une visionneuse de médias. Elle prend en charge les visionneuses de médias qui contiennent des images, des visionneuses d’échantillons, des visionneuses à 360°, des vidéos et des visionneuses de vidéos adaptatives.

Une miniature dans la partie inférieure de la visionneuse représente chaque élément de visionneuse de médias, ainsi que son indicateur de type de ressource. Lorsqu’un élément d’échantillon est sélectionné, une deuxième ligne d’échantillons semble permettre la sélection de la variation de couleur dans l’échantillon. Les images et les éléments d’échantillon prennent en charge le zoom en mode continu ou en ligne ; les visionneuses à 360° prennent en charge le zoom et la rotation. Les vidéos et les visionneuses de vidéos adaptatives prennent en charge tous les contrôles de lecture de base à condition que les sous-titres facultatifs s’affichent au-dessus du contenu vidéo. Un utilisateur peut basculer vers le plein écran à tout moment en cliquant sur le bouton Plein écran . La visionneuse dispose d’un bouton de fermeture facultatif. Il est conçu pour fonctionner sur les ordinateurs de bureau et les appareils mobiles.

La visionneuse de médias mixtes utilise la lecture vidéo en flux continu HTML5 au format HLS dans sa configuration par défaut chaque fois que le système sous-jacent le prend en charge. Sur les systèmes qui ne prennent pas en charge la diffusion en continu d’HTML5, la visionneuse revient à la diffusion vidéo progressive d’HTML5.

NOTE
Les images qui utilisent le rendu d’image (IR) ou le contenu créé par l’utilisateur (UGC) ne sont pas pris en charge par cette visionneuse.

Type de visionneuse 505.

Voir Configuration requise et conditions préalables.

URL de démonstration section-e1c3106f5b3e445d9b95be337c2f94e2

https://landing.adobe.com/en/na/dynamic-media/ctir-2755/live-demos.html

Utilisation de la visionneuse de médias mixtes section-f21ac23d3f6449ad9765588d69584772

La visionneuse de médias mixtes représente un fichier JavaScript principal et un ensemble de fichiers d’assistance (un JavaScript unique inclus avec tous les composants SDK de la visionneuse utilisés par cette visionneuse particulière, ressources, CSS) téléchargés par la visionneuse au moment de l’exécution.

Vous pouvez utiliser la visionneuse de médias mixtes en mode pop-up à l’aide de la page HTML prête pour l’exploitation fournie avec les visionneuses de médias mixtes. Vous pouvez également utiliser la visionneuse en mode incorporé, où elle est intégrée à une page web cible à l’aide de l’API documentée.

La tâche de configuration et d’application de la peau à la visionneuse est similaire aux autres visionneuses. Toute application de la peau est réalisée au moyen d’un CSS personnalisé.

Voir ​ Référence des commandes commune à toutes les visionneuses - Attributs de configuration ​ et ​ Référence des commandes commune à toutes les visionneuses - URL

Interaction avec la visionneuse de médias mixtes section-ab66eb6955aa4a8aa6d14a3b3acfed3f

La visionneuse de médias mixtes prend en charge les gestes tactiles et multipoint courants dans d’autres applications mobiles. Lorsque la visionneuse ne peut pas traiter le mouvement de balayage d’un utilisateur, elle transfère l’événement au navigateur web pour effectuer un défilement natif de la page. Cette fonctionnalité permet à l’utilisateur de parcourir la page même si la visionneuse occupe la majeure partie de la zone de l’écran de l’appareil.

Mouvement
Description
Clic unique
Active la vue déroulante ou les modifications entre le niveau de zoom principal et secondaire.
Appuyer deux fois
En mode zoom continu, effectue un zoom d’un niveau jusqu’à ce que le zoom maximal soit atteint, puis le double appui suivant réinitialise le mouvement à l’état initial.
Toucher et maintenir
En mode zoom intégré, active l’image zoomée.
Pincer
En mode de zoom continu, effectue un zoom avant ou arrière sur l’image.
Balayage horizontal ou clic

Lorsque la ressource active est une visionneuse à 360° et que l’image est dans un état réinitialisé, elle traverse la visionneuse à 360° horizontalement.

Lorsque la ressource active est une visionneuse à 360° ou une image et que l’image fait l’objet d’un zoom avant, elle déplace l’image horizontalement. Si l’image est déplacée vers le bord de la vue et que le balayage est toujours effectué dans cette direction, le mouvement effectue un défilement natif de la page.

Fait défiler la liste des échantillons dans la barre d’échantillons.

Balayage vertical ou battement

Si l’image est réinitialisée, elle modifie l’angle d’affichage vertical si une visionneuse à 360° multidimensionnelle est utilisée. Dans une visionneuse à 360° unidimensionnelle ou lorsqu’une visionneuse à 360° multidimensionnelle se trouve sur le dernier ou le premier axe, de sorte que le balayage vertical n’entraîne pas de changement d’angle de vue vertical, le mouvement effectue un défilement natif de la page.

Lorsque la ressource actuelle est une visionneuse à 360° ou une image et que l’image fait l’objet d’un zoom avant, déplace l’image verticalement. Si l’image est déplacée vers le bord d’affichage et que le balayage est toujours effectué dans cette direction, le mouvement effectue un défilement natif de la page.

Si le mouvement est effectué dans la zone d’échantillons, il effectue un défilement natif de la page.

La visionneuse prend également en charge l’entrée tactile et l’entrée souris sur les appareils Windows dotés d’un écran tactile et d’une souris. Cette prise en charge se limite toutefois aux navigateurs web Chrome, Internet Explorer 11 et Edge uniquement.

Cette visionneuse est entièrement accessible à partir du clavier.

Voir Accessibilité clavier et navigation.

Incorporation de la visionneuse de médias mixtes section-6bb5d3c502544ad18a58eafe12a13435

Les différentes pages web ont des besoins différents en termes de comportement des observateurs. Parfois, une page web fournit un lien qui, lorsqu’il est sélectionné, ouvre la visionneuse dans une fenêtre de navigateur distincte. Dans d’autres cas, il est nécessaire d’incorporer la visionneuse directement dans la page d’hébergement. Dans ce dernier cas, la page web peut avoir une mise en page statique ou utiliser une conception réactive qui s’affiche différemment sur différents appareils ou pour différentes tailles de fenêtre du navigateur. Pour répondre à ces besoins, la visionneuse prend en charge trois modes de fonctionnement principaux : pop-up, incorporation de taille fixe et incorporation de conception réactive.

À propos du mode pop-up section-77d5aa03b8b94566958a179b1a2cd474

En mode pop-up, la visionneuse s’ouvre dans une fenêtre ou un onglet distinct du navigateur web. Elle occupe toute la zone de la fenêtre du navigateur et s’ajuste au cas où le navigateur serait redimensionné ou si l’orientation d’un appareil mobile était modifiée.

Le mode pop-up est le plus courant pour les appareils mobiles. La page web charge la visionneuse à l’aide de window.open()’appel JavaScript, correctement configuré A l’élément HTML ou de toute autre méthode appropriée.

Il est recommandé d’utiliser une page HTML prête à l’emploi pour le mode de fonctionnement des fenêtres pop-up. Dans ce cas, il s’appelle MixedMediaViewer.html et se trouve dans le sous-dossier html5/ de votre déploiement d’observateurs IS standard :

<s7viewers_root>/html5/MixedMediaViewer.html

Vous pouvez effectuer une personnalisation visuelle en appliquant un CSS personnalisé.

Voici un exemple de code HTML qui permet d’ouvrir la visionneuse dans une nouvelle fenêtre :

<a href="http://s7d1.scene7.com/s7viewers/html5/MixedMediaViewer.html?asset=Scene7SharedAssets/Mixed_Media_Set_Sample" target="_blank">Open popup viewer</a>

À propos de l’incorporation de formats fixes et de conceptions réactives section-ec86b100ba5943d0b16694268520bbde

En mode incorporé, la visionneuse est ajoutée à la page web existante, qui peut déjà comporter du contenu client non lié à la visionneuse. L’observateur n’occupe normalement qu’une partie de l’espace d’une page web.

Les principaux cas d’utilisation sont des pages web orientées pour les ordinateurs de bureau ou les tablettes, ainsi que des pages en responsive design qui ajustent automatiquement la disposition en fonction du type d’appareil.

L’incorporation de taille fixe est utilisée lorsque la visionneuse ne modifie pas sa taille après le chargement initial. Cette action est le meilleur choix pour les pages web avec une disposition statique.

L’incorporation de conception réactive suppose que la visionneuse doit être redimensionnée au moment de l’exécution en réponse au changement de taille de son DIV de conteneur. Le cas d’utilisation le plus courant consiste à ajouter une visionneuse à une page web qui utilise une disposition de page flexible.

En mode d’incorporation de responsive design, la visionneuse se comporte différemment selon la manière dont la page web dimensionne son DIV de conteneur. Si la page web définit uniquement la largeur du DIV de conteneur, sans restriction de hauteur, la visionneuse choisit automatiquement sa hauteur en fonction des proportions de la ressource utilisée. Cette fonctionnalité garantit que la ressource s’adapte parfaitement à la vue sans marge intérieure sur les côtés. Ce cas d’utilisation est le plus courant pour les pages web utilisant des structures de disposition en responsive design telles que Bootstrap ou Foundation.

Dans le cas contraire, si la page web définit à la fois la largeur et la hauteur du DIV de conteneur de la visionneuse, celle-ci remplit exactement cette zone et suit la taille fournie par la disposition de la page web. Un bon exemple consiste à incorporer la visionneuse dans une superposition modale, où la superposition est dimensionnée en fonction de la taille de la fenêtre du navigateur web.

Incorporation de taille fixe section-17d162f76ffa4804b27928f51e7bea1d

Ajoutez la visionneuse à une page web en procédant comme suit :

  1. Ajout du fichier JavaScript de la visionneuse à votre page web.

  2. La définition du DIV de conteneur.

  3. Définition de la taille de la visionneuse.

  4. Création et initialisation de la visionneuse.

  5. Ajout du fichier JavaScript de la visionneuse à votre page web.

    La création d’une visionneuse nécessite l’ajout d’une balise de script dans l’en-tête HTML. Avant de pouvoir utiliser l’API de visionneuse, veillez à inclure MixedMediaViewer.js. Le fichier MixedMediaViewer.js se trouve sous le sous-dossier html5/js/ de votre déploiement d’observateurs IS standard :

<s7viewers_root>/html5/js/MixedMediaViewer.js

Vous pouvez utiliser un chemin relatif si la visionneuse est déployée sur l’un des serveurs d’Adobe Dynamic Media Classic et qu’elle est diffusée à partir du même domaine. Sinon, vous spécifiez un chemin d’accès complet à l’un des serveurs Adobe Dynamic Media Classic sur lesquels les visionneuses IS sont installées.

Le chemin d’accès relatif ressemble à ce qui suit :

<script language="javascript" type="text/javascript" src="/s7viewers/html5/js/MixedMediaViewer.js"></script>
NOTE
Référencez uniquement le fichier de include JavaScript de la visionneuse principale sur votre page. Ne référencez aucun fichier JavaScript supplémentaire dans le code de page web qui pourrait être téléchargé par la logique de la visionneuse au moment de l’exécution. En particulier, ne référencez pas directement la bibliothèque de Utils.js SDK HTML5 chargée par la visionneuse à partir /s7viewers chemin de contexte (appelé include consolidée de SDK). En effet, l’emplacement des bibliothèques de visionneuse d’exécution Utils.js ou similaires est entièrement géré par la logique de la visionneuse et l’emplacement change entre les versions de la visionneuse. Adobe ne conserve pas les anciennes versions des includes secondaires de la visionneuse sur le serveur.
Par conséquent, le fait de placer une référence directe à toute include JavaScript secondaire utilisée par la visionneuse sur la page interrompt la fonctionnalité de la visionneuse à l’avenir lorsqu’une nouvelle version du produit est déployée.
  1. Définition du DIV du conteneur.

    Ajoutez un élément DIV vide à la page sur laquelle vous souhaitez que la visionneuse apparaisse. L’identifiant de l’élément DIV doit être défini, car cet identifiant est transmis ultérieurement à l’API de visionneuse. La taille du DIV est spécifiée via CSS.

    L’espace réservé DIV est un élément positionné, ce qui signifie que la propriété CSS position est définie sur relative ou absolute.

    Assurez-vous que la fonction Plein écran fonctionne correctement dans Internet Explorer. Vérifiez qu’aucun autre élément du DOM n’a un ordre d’empilement supérieur à celui de votre DIV d’espace réservé.

    Exemple d’élément DIV d’espace réservé défini :

    code language-html
    <div id="s7viewer" style="position:relative"></div>
    
  2. Définition de la taille de la visionneuse

    Cette visionneuse affiche des miniatures lorsque vous utilisez des visionneuses d’éléments multiples. Sur les ordinateurs de bureau, les miniatures sont placées sous la vue principale. Dans le même temps, la visionneuse permet de permuter la ressource principale au moment de l’exécution à l’aide de l’API setAsset(). En tant que développeur ou développeuse, vous avez un contrôle sur la manière dont la visionneuse gère la zone des miniatures en bas lorsque la nouvelle ressource ne comporte qu’un seul élément. Il est possible de conserver la taille de la visionneuse extérieure intacte et de laisser la vue principale augmenter sa hauteur et occuper la zone des miniatures. Vous pouvez également conserver la taille de l’affichage principal statique et réduire la zone de visionneuse externe, laissant le contenu de la page web se déplacer vers le haut. Ensuite, utilisez l’espace disque disponible sur la page qui reste dans les miniatures.

    Pour conserver les limites de la visionneuse externe intactes, définissez la taille de .s7mixedmediaviewer classe CSS de niveau supérieur en unités absolues. Le dimensionnement dans CSS peut être placé directement sur la page HTML ou dans un fichier CSS de visionneuse personnalisé, puis affecté ultérieurement à un enregistrement de paramètre prédéfini de visionneuse dans Dynamic Media Classic, ou transmis explicitement à l’aide de la commande de style.

    Consultez Personnalisation des visionneuses de médias mixtes pour plus d’informations sur la mise en forme de la visionneuse avec CSS.

    Voici un exemple de définition de la taille statique de la visionneuse externe dans une page HTML :

    code language-html
    #s7viewer.s7mixedmediaviewer {
     width: 640px;
     height: 480px;
    }
    

Pour rendre les dimensions de la vue principale statiques, définissez la taille de la visionneuse en unités absolues pour le composant SDK Container interne à l’aide .s7mixedmediaviewer .s7container sélecteur CSS ou à l’aide du modificateur stagesize.

Voici un exemple de définition de la taille de la visionneuse pour le composant SDK Container interne afin que la zone d’affichage principale ne modifie pas sa taille lors du changement de ressource :

#s7viewer.s7mixedmediaviewer .s7container {
 width: 640px;
 height: 480px;
}

Vous pouvez définir le modificateur stagesize dans l’enregistrement du paramètre prédéfini de la visionneuse dans Dynamic Media Classic ou le transmettre explicitement avec le code d’initialisation de la visionneuse avec la collection params. Ou, par le biais d’un appel API, comme décrit dans la section Référence des commandes de cette aide, comme dans ce qui suit :

mixedMediaViewer.setParam("stagesize", "640,480");

Une approche basée sur CSS est recommandée et est utilisée dans cet exemple.

  1. Création et initialisation de la visionneuse.

    Une fois les étapes ci-dessus terminées, vous créez une instance de s7viewers.MixedMediaViewer classe, transmettez toutes les informations de configuration à son constructeur et appelez init() méthode sur une instance de visionneuse. Les informations de configuration sont transmises au constructeur en tant qu’objet JSON. Au minimum, cet objet doit comporter le champ containerId qui contient le nom de l’ID de conteneur de visionneuse et de l’objet JSON params imbriqué avec les paramètres de configuration pris en charge par la visionneuse. Dans ce cas, l’objet params doit avoir au moins l’URL du service d’images transmise en tant que propriété serverUrl, l’URL du serveur vidéo transmise en tant que propriété videoserverurl et la ressource initiale en tant que paramètre asset. L’API d’initialisation basée sur JSON vous permet de créer et de démarrer la visionneuse avec une seule ligne de code.

    Il est important d’ajouter le conteneur de visionneuse au DOM afin que le code de la visionneuse puisse trouver l’élément de conteneur à l’aide de son identifiant. Certains navigateurs retardent la création du DOM jusqu’à la fin de la page web. Pour une compatibilité maximale, appelez la méthode init() juste avant la balise BODY de fermeture ou sur l’événement body onload().

    Dans le même temps, l’élément de conteneur ne doit pas nécessairement encore faire partie de la mise en page web. Par exemple, elle peut être masquée à l’aide display:none style qui lui est affecté. Dans ce cas, la visionneuse retarde son processus d’initialisation jusqu’au moment où la page web ramène l’élément de conteneur dans la mise en page. Lorsque cette action se produit, le chargement de la visionneuse reprend automatiquement.

    Voici un exemple de création d’une instance de visionneuse, de transmission des options de configuration minimales nécessaires au constructeur et d’appel de la méthode init(). L’exemple suppose que mixedMediaViewer est l’instance de visionneuse, s7viewer est le nom de l’espace réservé DIV, http://s7d1.scene7.com/is/image/ est l’URL du service d’images, http://s7d1.scene7.com/is/content/ est l’URL du serveur vidéo et Scene7SharedAssets/Mixed_Media_Set_Sample est la ressource :

<script type="text/javascript">
var mixedMediaViewer = new s7viewers.MixedMediaViewer({
 "containerId":"s7viewer",
"params":{
 "asset":"Scene7SharedAssets/Mixed_Media_Set_Sample",
 "serverurl":"http://s7d1.scene7.com/is/image/",
 "videoserverurl":"http://s7d1.scene7.com/is/content/"
}
}).init();
</script>
<script type="text/javascript">
mixedMediaViewer.init();
</script>

Le code suivant est un exemple complet de page web triviale qui intègre la visionneuse de médias mixtes à une taille fixe :

<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="http://s7d1.scene7.com/s7viewers/html5/js/MixedMediaViewer.js"></script>
<style type="text/css">
#s7viewer.s7mixedmediaviewer {
 width: 640px;
 height: 480px;
}
</style>
</head>
<body>
<div id="s7viewer" style="position:relative"></div>
<script type="text/javascript">
var mixedMediaViewer = new s7viewers.MixedMediaViewer({
 "containerId":"s7viewer",
"params":{
 "asset":"Scene7SharedAssets/Mixed_Media_Set_Sample",
 "serverurl":"http://s7d1.scene7.com/is/image/",
 "videoserverurl":"http://s7d1.scene7.com/is/content/"
}
}).init();
</script>
</body>
</html>

Incorporation réactive avec hauteur illimitée section-056cb574713c4d07be6d07cf3c598839

Avec l’incorporation de responsive design, la page web dispose normalement d’un type de disposition flexible qui détermine la taille d’exécution du DIV de conteneur de la visionneuse. Dans l’exemple suivant, supposons que la page web permette au DIV de conteneur de la visionneuse de prendre 40 % de la taille de la fenêtre du navigateur web, sans restriction de hauteur. Le code d’HTML de la page web se présente comme suit :

<!DOCTYPE html>
<html>
<head>
<style type="text/css">
.holder {
 width: 40%;
}
</style>
</head>
<body>
<div class="holder"></div>
</body>
</html>

L’ajout de la visionneuse à une telle page est similaire aux étapes d’incorporation à taille fixe. La seule différence réside dans le fait que vous n’avez pas besoin de définir explicitement la taille de la visionneuse.

  1. Ajout du fichier JavaScript de la visionneuse à votre page web.
  2. Définition du DIV du conteneur.
  3. Création et initialisation de la visionneuse.

Toutes les étapes ci-dessus sont identiques à l’incorporation de taille fixe. Ajoutez le conteneur DIV au DIV "holder" existant. Le code suivant en est un exemple complet. Notez comment la taille de la visionneuse change lorsque le navigateur est redimensionné et comment les proportions de la visionneuse correspondent à la ressource.

<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="http://s7d1.scene7.com/s7viewers/html5/js/MixedMediaViewer.js"></script>
<style type="text/css">
.holder {
 width: 40%;
}
</style>
</head>
<body>
<div class="holder">
<div id="s7viewer" style="position:relative"></div>
</div>
<script type="text/javascript">
var mixedMediaViewer = new s7viewers.MixedMediaViewer({
 "containerId":"s7viewer",
"params":{
 "asset":"Scene7SharedAssets/Mixed_Media_Set_Sample",
 "serverurl":"http://s7d1.scene7.com/is/image/",
 "videoserverurl":"http://s7d1.scene7.com/is/content/"
}
}).init();
</script>
</body>
</html>

La page d’exemples suivante illustre d’autres utilisations réelles de l’incorporation Responsive Design avec une hauteur illimitée :

Démonstrations en direct

Intégration de taille flexible avec largeur et hauteur définies section-0a329016f9414d199039776645c693de

S’il existe une incorporation de taille flexible avec la largeur et la hauteur définies, le style de la page web est différent. Il fournit les deux tailles au DIV "holder" et le centre dans la fenêtre du navigateur. En outre, la page web définit la taille de l’élément HTML et BODY sur 100 %.

<!DOCTYPE html>
<html>
<head>
<style type="text/css">
html, body {
 width: 100%;
 height: 100%;
}
.holder {
 position: absolute;
 left: 20%;
 top: 20%;
 width: 60%;
height: 60%;
}
</style>
</head>
<body>
<div class="holder"></div>
</body>
</html>

Le reste des étapes d’incorporation est identique aux étapes utilisées pour l’incorporation de Responsive Design avec une hauteur illimitée. L’exemple qui en résulte est le suivant :

<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="http://s7d1.scene7.com/s7viewers/html5/js/MixedMediaViewer.js"></script>
<style type="text/css">
html, body {
 width: 100%;
 height: 100%;
}
.holder {
 position: absolute;
 left: 20%;
 top: 20%;
 width: 60%;
height: 60%;
}
</style>
</head>
<body>
<div class="holder">
<div id="s7viewer" style="position:relative"></div>
</div>
<script type="text/javascript">
var mixedMediaViewer = new s7viewers.MixedMediaViewer({
 "containerId":"s7viewer",
"params":{
 "asset":"Scene7SharedAssets/Mixed_Media_Set_Sample",
 "serverurl":"http://s7d1.scene7.com/is/image/",
 "videoserverurl":"http://s7d1.scene7.com/is/content/"
}
}).init();
</script>
</body>
</html>

Incorporation à l’aide de l’API Setter section-af26f0cc2e5140e8a9bfd0c6a841a6d1

Au lieu d’utiliser l’initialisation basée sur JSON, il est possible d’utiliser l’API basée sur setter et le constructeur sans args. L’utilisation de ce constructeur d’API ne prend aucun paramètre et les paramètres de configuration sont spécifiés à l’aide des méthodes d’API setContainerId(), setParam() et setAsset(), avec des appels JavaScript distincts.

L’exemple suivant illustre l’utilisation de l’incorporation de taille fixe avec l’API setter :

<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="http://s7d1.scene7.com/s7viewers/html5/js/MixedMediaViewer.js"></script>
<style type="text/css">
#s7viewer.s7mixedmediaviewer {
 width: 640px;
 height: 480px;
}
</style>
</head>
<body>
<div id="s7viewer" style="position:relative"></div>
<script type="text/javascript">
var mixedMediaViewer = new s7viewers.MixedMediaViewer();
mixedMediaViewer.setContainerId("s7viewer");
mixedMediaViewer.setParam("serverurl", "http://s7d1.scene7.com/is/image/");
mixedMediaViewer.setAsset("Scene7SharedAssets/Mixed_Media_Set_Sample");
mixedMediaViewer.init();
</script>
</body>
</html>
recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8