DocumentatieDynamic Media Image Serving and Rendering API

Mediasetaanvragen media-set-requests

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar
  • Gebruiker

De Server van het beeld verstrekt een mechanisme om een hiërarchische tekstreactie (xml of json) op te halen die alle middelen en meta-gegevens verbonden aan catalogus vertegenwoordigt::ImageSet voor een bepaald verslag.

De kijkers kunnen dit mechanisme gebruiken om reacties te produceren om de presentatie van eenvoudige beelden, video's, videoreeksen, monsterreeksen, spin reeksen, paginasets (e-catalogi), en media reeksen te informeren.

Aanvraagsyntaxis section-d72b1d95e4ce4bb1b332ce096c2b99f1

De setreactie voor een catalog::ImageSet kan worden opgehaald met de optie req=set en door te verwijzen naar de catalogusrecord-id in het netpad. De afbeeldingsset kan ook rechtstreeks in de URL worden opgegeven met de optie imageset= . Als de modifier imageset= wordt gebruikt om de imageset op te geven, moet de gehele waarde tussen accolades worden geplaatst om de ingestelde waarde voor de afbeelding te omzeilen en ervoor te zorgen dat alle opgenomen modifiers niet worden geïnterpreteerd als onderdeel van de URL-queryreeks.

Typen ingestelde reacties section-93eb0a1f70344da2a888e56372ad3896

Het ingestelde mechanisme ondersteunt de volgende typen reacties:

eenvoudige afbeeldingen
An image record without catalog::ImageSet defined.
eenvoudige video's
Een video-opname in de statische inhoudscatalogus.
stalensets
Een set items die bestaat uit een verwijzing naar een afbeeldingsrecord en een optionele aparte verwijzing naar een afbeeldingsrecord die als staal wordt gebruikt.
hiërarchische stalensets
Een set items die bestaat uit een standaardstaalitem of een verwijzing naar een record in een stalenset.
spin-sets
Een set items die bestaat uit een eenvoudige lijst met afbeeldings-id's.
tweedimensionale centrifuges
Een set items die bestaat uit een eenvoudige afbeelding of een verwijzing naar een elementaire reeks spinnen.
paginasets
Een reeks items die bestaat uit een lijst met maximaal drie pagina-afbeeldingen
mediasets
Een set items die bestaat uit eenvoudige afbeeldingen, videoreeksen, stalensets, hiërarchische stalensets, centrifuges, tweedimensionale centrifuges, paginasets en video-elementen. Elk mediaset-item kan ook een optioneel staal bevatten.
videosets
Een reeks items die bestaat uit een lijst met eenvoudige video's.

Typedetectie buiten instellen section-3dd6e453528d46898e559d31458a59ba

Wanneer een req=set -aanvraag wordt ontvangen, wordt het type te genereren reactie bepaald door de waarde van catalog::AssetType . Als catalog::AssetType niet wordt bepaald, dan wordt het reactietype bepaald door de volgende regels:

  • Als record wordt gevonden in de afbeeldingscatalogus EN catalog::ImageSet is gedefinieerd

    • Een e-catalogusset aannemen als ten minste één item in het veld Recordafbeeldingsset een dubbele punt bevat
    • Mediaset aannemen als ten minste één item in het veld Afbeeldingsset record twee puntkomma's bevat.
    • Afbeeldingsset aannemen als ten minste één item in het veld Afbeeldingsset record één puntkomma bevat.
    • Er wordt aangenomen dat er een centrifuge is ingesteld als geen item dubbele punt of puntkomma bevat, maar ten minste één item een set waarnaar wordt verwezen of een in-line set bevat (dit is een 2D-centrifuge).
    • Onbekende set veronderstellen als geen item dubbele punt of puntkomma bevat, noch als set of inline set waarnaar wordt verwezen (d.w.z. een door komma's gescheiden lijst met afbeeldingen).

  • Als record wordt gevonden in zowel afbeeldings- ALS statische inhoudcatalogi

    • Video aannemen als de bestandsextensie zich in de volgende set bevindt: mp3, mp4, flv, f4v, swf, xml
    • Anders de afbeelding aannemen

  • Als record wordt gevonden in statische inhoudscatalogus maar NIET in afbeeldingscatalogus

    • Video aannemen als de bestandsextensie zich in de volgende set bevindt: mp3, mp4, flv, f4v, swf, xml
    • Anders statisch aannemen

  • Indien opname is gevonden in de afbeeldingscatalogus maar NIET in de catalogus met statische inhoud

    • Afbeelding aannemen

  • Als er geen record wordt gevonden in de afbeeldingscatalogus en NIET in de catalogus met statische inhoud

    • Op bestanden gebaseerde video aannemen als de bestandsextensie de volgende set heeft: mp3, mp4, flv, f4v, swf, xml
    • Anders wordt een op een bestand gebaseerde afbeelding aangenomen

In alle gevallen komt de resulterende xml-reactie overeen met het opgegeven XML-document met het ingestelde hoofdknooppunt dat overeenkomt met het gedetecteerde type.

Typedetectie binnen section-8f46490e467247e69ce284704def06f3

Wanneer de buitenste set wordt gedetecteerd als een mediaset, bevat het antwoord een set mediasetitems die overeenkomen met elk mediasetitem in catalog::ImageSet . Als de optionele parameter type is opgegeven voor een bepaald mediaset-item, wordt deze toegewezen aan een uitvoertype volgens de volgende tabel:

Invoertype
Uitvoertype
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

Als de optionele parameter type voor een bepaald mediaset-item niet is opgegeven of overeenkomt met een niet-ondersteund type, wordt het mediaset-itemtype automatisch gedetecteerd volgens dezelfde regels als die welke op het buitenste setniveau zijn toegepast.

XML-specificatie section-c1bd60948ef545759a16885bb6fcc607

De geretourneerde xml-reactie voldoet aan de volgende specificatie:

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

LabelKey section-bf565de6f7294cf89620343c9071f415

De labelkey= bepaling wordt gebruikt samen met het catalog::UserData gebied om etiketten voor beelden en monsters te produceren. Het veld catalog:UserData wordt geparseerd als een set sleutel/waardeparen en de index van de labeltoets in deze set om de waarde voor de opgegeven toets op te halen. Deze waarde wordt vervolgens geretourneerd in het kenmerk l voor de s en i .

Afgedwongen beperkingen section-b9f042873bee45a5ae11b69fd42f2bca

Om de grootte van de reactie te beperken en zelf-verwijzingskwesties te verhinderen, wordt de maximumhet nestelen diepte gecontroleerd door het serverbezit PS::fvctx.nestingLimit. Als deze limiet wordt overschreden, wordt een fout geretourneerd.

Om de grootte van de xml- reacties voor grote e-catalogusreeksen te beperken, worden de privé meta-gegevens onderdrukt voor brochure vastgestelde punten volgens het serverbezit PS::fvctx.brochureLimit. Alle persoonlijke metagegevens die aan de brochure zijn gekoppeld, worden geëxporteerd totdat de brochure-limiet is bereikt. Nadat de limiet is overschreden, worden privékaarten en gebruikersgegevens onderdrukt en wordt een bijbehorende markering ingesteld om aan te geven welk type gegevens is onderdrukt.

Geneste mediasets worden niet ondersteund. Een geneste mediaset wordt gedefinieerd als een mediaset die een mediaset-item van het type mediaset bevat. Als deze voorwaarde wordt gedetecteerd, wordt een fout geretourneerd.

Voorbeelden section-588c9d33aa05482c86cd2b1936887228

Zie de pagina Eigenschappen onder de kop HTML Examples voor voorbeelden van XML-reacties voor de req=set -aanvraag.

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

Zie ook section-625ec466c948476e800dc0c52a4532d3

​ req= ​, ​ imageset= ​, ​ catalogus::ImageSet ​, ​ Verwijzing van de Catalogus van het Beeld ​

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