DocumentationAPI de diffusion et de rendu d’images Dynamic Media

Requêtes de visionneuse de médias media-set-requests

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 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 section-d72b1d95e4ce4bb1b332ce096c2b99f1

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 section-93eb0a1f70344da2a888e56372ad3896

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

image simple
Un enregistrement d’image sans catalog ::ImageSet défini.
Vidéos simples
Un enregistrement vidéo dans le catalogue de contenu statique.
Séries d’échantillons
Ensemble 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érarchiques
Ensemble 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° bidimensionnelles
Ensemble d’éléments consistant en une image simple ou une référence à une visionneuse à 360° de base.
Jeux de pages
Ensemble d’éléments constitué d’une liste comprenant au maximum 3 pages d’images
visionneuses de médias
Un 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éos
Ensemble d’éléments constitué d’une liste de vidéos simples.

Détection de type d’ensemble externe section-3dd6e453528d46898e559d31458a59ba

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 section-8f46490e467247e69ce284704def06f3

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ée
Type de Output
img
img
basic
img
advanced_image
img
img_set
img_set
advanced_image_set
img_set
advanced_swatchset
img_set
spin
spin
video
video
video_set
video_set
static
static
ecat
ecat

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 section-c1bd60948ef545759a16885bb6fcc607

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

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

LabelKey section-bf565de6f7294cf89620343c9071f415

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 section-b9f042873bee45a5ae11b69fd42f2bca

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 section-588c9d33aa05482c86cd2b1936887228

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

Voir aussi section-625ec466c948476e800dc0c52a4532d3

req= , imageset=, catalog ::ImageSet, Référence du catalogue d’images

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49