Requêtes de visionneuse de médias

Dernière mise à jour : 15 août 2025
  • Rubriques :

Créé pour :

  • Développeur
  • Utilisateur ou utilisatrice

La diffusion d’images fournit un mécanisme permettant de récupérer une réponse textuelle hiérarchique (xml ou json) qui représente toutes les ressources et métadonnées associées à catalog::ImageSet pour un enregistrement particulier.

Les visionneuses peuvent utiliser ce mécanisme pour générer des réponses afin d’informer la présentation d’images, de vidéos, de visionneuses de vidéos, d’échantillons, de visionneuses à 360°, de visionneuses de pages (catalogues électroniques) et de visionneuses de médias simples.

Syntaxe de la requête

La réponse set pour a catalog::ImageSet peut être récupérée à l’aide du req=set modificateur et en référençant l’ID d’enregistrement du catalogue dans le chemin net. Vous pouvez également spécifier la visionneuse d’images directement dans l’URL à l’aide du imageset= modificateur. Si le imageset= modificateur est utilisé pour spécifier la visionneuse d’images, la valeur entière doit être entourée d’accolades afin d’échapper la valeur de la visionneuse d’images et de s’assurer que les modificateurs inclus ne sont pas interprétés comme faisant partie de la chaîne de requête URL.

Types de réponses définies

Le mécanisme définir prend en charge les types de réponses suivants :

image simpleUn enregistrement d’image sans catalog ::ImageSet défini.
Vidéos simplesUn enregistrement vidéo dans le catalogue de contenu statique.
Séries d’échantillonsEnsemble d’éléments composé d’une référence à un enregistrement d’image et d’une référence séparée facultative à un enregistrement d’image utilisé comme échantillon.
ensembles d’échantillons hiérarchiquesEnsemble d’éléments constitué d’un élément d’échantillon de base ou d’une référence à un enregistrement d’ensemble d’échantillons.
visionneuses à 360°Ensemble d’éléments constitué d’une simple liste d’ID d’image.
Visionneuses à 360° bidimensionnellesEnsemble d’éléments consistant en une image simple ou une référence à une visionneuse à 360° de base.
Jeux de pagesEnsemble d’éléments constitué d’une liste comprenant au maximum 3 pages d’images
visionneuses de médiasUn ensemble d’éléments constitué d’images simples, de visionneuses de vidéos, de visionneuses d’échantillons, de visionneuses d’échantillons hiérarchiques, de visionneuses à 360°, de visionneuses à 360° bidimensionnelles, de visionneuses de pages et de ressources vidéo. Chaque élément de visionneuse de médias peut également contenir un échantillon facultatif.
Visionneuses de vidéosEnsemble d’éléments constitué d’une liste de vidéos simples.

Détection de type d’ensemble externe

Lorsqu’une req=set requête est reçue, le type de réponse à générer est déterminé par la valeur de catalog::AssetType. Si catalog::AssetType n’est pas défini, le type de réponse est déterminé par les règles suivantes :

  • Si l’enregistrement se trouve dans le catalogue d’images ET est catalog::ImageSet défini

    • Supposez la visionneuse de catalogue électronique si au moins une entrée de l’enregistrement Le champ de visionneuse d’images contient deux points
    • Supposez la visionneuse de supports si au moins une entrée de l’enregistrement Le champ Visionneuse d’images contient deux points-virgules.
    • Supposez la visionneuse d’images si au moins une entrée de l’enregistrement Le champ de visionneuse d’images contient un point-virgule.
    • Supposons une visionneuse à 360° si aucune entrée ne contient de deux-points ni de points-virgules, mais qu’au moins une entrée contient un jeu référencé ou un jeu en ligne (il s’agit d’un jeu à 360° 2D).
    • Supposez un ensemble inconnu si aucune entrée ne contient de deux-points ni de point-virgule, ni d’ensemble référencé, ni d’ensemble en ligne (c’est-à-dire une liste d’images séparées par des virgules).

  • Si l’enregistrement se trouve à la fois dans les catalogues de contenu image ET statique

    • Supposons que la vidéo si l'extension de fichier est dans le jeu suivant : mp3, mp4, flv, f4v, swf, xml
    • Assumer l’image autrement

  • Si l’enregistrement se trouve dans le catalogue de contenu statique mais PAS dans le catalogue d’images

    • Supposez la vidéo si l’extension de fichier se trouve dans l’ensemble suivant : mp3, mp4, flv, f4v, swf, xml
    • Supposez que ce n’est pas statique

  • Si l’enregistrement dans se trouve dans le catalogue d’images mais PAS dans le catalogue de contenu statique

    • Supposer l’image

  • Si l’enregistrement est INTROUVABLE dans le catalogue d’images et INTROUVABLE dans le catalogue de contenu statique

    • Supposons que la vidéo basée sur un fichier si l’extension de fichier se trouve dans le jeu suivant : mp3, mp4, flv, f4v, swf, xml
    • Supposons que l’image soit basée sur un fichier dans le cas contraire.

Dans tous les cas, la réponse xml obtenue est conforme au document XML spécifié avec le nœud racine défini correspondant au type détecté.

Détection du type d’ensemble interne

Lorsque l’ensemble externe est détecté comme jeu de supports de type, la réponse contient un ensemble d’éléments de visionneuse de supports correspondant à chaque entrée de visionneuse de supports dans catalog::ImageSet. Si le paramètre de type facultatif est spécifié pour une entrée de visionneuse de supports particulière, il est mappé à un type de sortie conformément au tableau suivant :

Type d’entréeType de Output
imgimg
basicimg
advanced_imageimg
img_setimg_set
advanced_image_setimg_set
advanced_swatchsetimg_set
spinspin
videovideo
video_setvideo_set
staticstatic
ecatecat

Si le paramètre de type facultatif pour une entrée de visionneuse de supports particulière n’est pas spécifié ou correspond à un type non pris en charge, le type d’élément de visionneuse de supports est automatiquement détecté à l’aide des mêmes règles que celles appliquées au niveau de l’ensemble externe.

Spécification XML

La réponse xml renvoyée est conforme à la spécification suivante :

http://crc.scene7.com/is-docs/examples/mediaset.dtd

LabelKey

Le modificateur labelkey= est utilisé avec le champ catalog::UserData pour générer des libellés pour les images et les échantillons. Le champ catalog:UserData est analysé sous la forme d’un ensemble de paires clé/valeur et les index labelkey s’y rapportent pour récupérer la valeur de la clé donnée. Cette valeur est ensuite renvoyée dans l’attribut l pour les s et i.

Restrictions appliquées

Afin de limiter la taille de la réponse et d’éviter les problèmes autoréférentiels, la profondeur d’imbrication maximale est contrôlée par la propriété PS::fvctx.nestingLimitserver . Si cette limite est dépassée, une erreur est renvoyée.

Afin de limiter la taille des réponses XML pour les ensembles de catalogues électroniques volumineux, les métadonnées privées sont supprimées pour les éléments de l’ensemble de brochures en fonction de la propriété PS::fvctx.brochureLimitde serveur. Toutes les métadonnées privées associées à la brochure sont exportées jusqu’à ce que la limite de la brochure soit atteinte. Une fois la limite dépassée, les mappages privés et les données utilisateur sont supprimés et un indicateur correspondant est défini pour indiquer le type de données qui a été supprimé.

Les visionneuses de médias imbriqués ne sont pas prises en charge. Une visionneuse de médias imbriquée est définie comme une visionneuse de médias qui contient un élément de visionneuse de médias de type visionneuse de médias. Si cette condition est détectée, une erreur est renvoyée.

Exemples

Pour obtenir des exemples de réponses XML pour req=set une requête, reportez-vous à la page Propriétés sous En-tête Exemples HTML.

http://crc.scene7.com/is-docs/examples/properties.htm