Richieste di set di file multimediali

Ultimo aggiornamento: 2023-11-03
  • Argomenti:
  • Dynamic Media Classic
    Visualizza ulteriori informazioni su questo argomento
  • SDK/API
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Developer
    User

Image Server fornisce un meccanismo per recuperare una risposta di testo gerarchica (xml o json) che rappresenta tutte le risorse e i metadati associati a catalog::ImageSet per un determinato record.

I visualizzatori possono utilizzare questo meccanismo per generare risposte che informano la presentazione di immagini semplici, video, set video, set di campioni, set 360 gradi, set di pagine (e-catalogs) e set di file multimediali.

Sintassi della richiesta

La risposta impostata per un catalog::ImageSet possono essere recuperati utilizzando req=set e facendo riferimento all’id del record di catalogo nel percorso di rete. In alternativa, il set di immagini può essere specificato direttamente nell’URL utilizzando imageset= modificatore. Se il imageset= Il modificatore viene utilizzato per specificare il set di immagini. L’intero valore deve essere racchiuso tra parentesi graffe al fine di escape dal valore del set di immagini e garantire che tutti i modificatori inclusi non vengano interpretati come parte della stringa di query URL.

Tipi di risposta impostata

Il meccanismo di impostazione supporta i seguenti tipi di risposte:

immagini semplici

Un record di immagine senza catalogo::ImageSet definito.

video semplici

Record video nel catalogo dei contenuti statici.

set di campioni

Un insieme di elementi costituito da un riferimento a un record immagine e da un riferimento separato facoltativo a un record immagine utilizzato come campione.

set di campioni gerarchici

Un insieme di elementi costituito da un elemento campione di base o da un riferimento a un record set di campioni.

set 360 gradi

Un set di elementi costituito da un semplice elenco di ID immagine.

set 360 gradi bidimensionali

Un insieme di elementi costituito da un'immagine semplice o da un riferimento a un set 360 gradi di base.

set di pagine

Un set di elementi costituito da un elenco di un massimo di tre immagini pagina

media set

Un set di elementi costituito da immagini semplici, set video, set di campioni, set di campioni gerarchici, set 360 gradi, set 360 gradi bidimensionali, set di pagine e risorse video. Ogni elemento del set di file multimediali può contenere anche un campione opzionale.

set video

Un set di elementi costituito da un elenco di video semplici.

Rilevamento del tipo di set esterno

Quando un req=set richiesta ricevuta, il tipo di risposta da generare è determinato dal valore di catalog::AssetType. Se catalog::AssetType non è definito, il tipo di risposta è determinato dalle regole seguenti:

  • Se il record viene trovato nel catalogo immagini E catalog::ImageSet è definito

    • Si supponga di avere impostato un catalogo elettronico se almeno una voce nel campo Record Imageset contiene due punti
    • Supponiamo che il set di file multimediali sia impostato se almeno una voce nel campo Record Imageset contiene due punti e virgola.
    • Si supponga che il set di immagini sia impostato se almeno una voce nel campo Record Imageset contiene un punto e virgola.
    • Si supponga che il set 360 gradi non contenga due punti né punto e virgola, ma che almeno una voce contenga un set di riferimenti o un set in linea (set 360 gradi 2D).
    • Si supponga che il set sia sconosciuto se nessuna voce contiene due punti, un punto e virgola, un set di riferimento o un set in linea (ovvero un elenco di immagini separato da virgole).
  • Se il record viene trovato sia nei cataloghi di contenuto statico che in quelli di immagini

    • Si supponga che l'estensione file sia nel seguente set: mp3, mp4, flv, f4v, swf, xml
    • Ipotizza immagine in caso contrario
  • Se il record viene trovato nel catalogo dei contenuti statici ma NON nel catalogo delle immagini

    • Si supponga che l'estensione file sia nel seguente set: mp3, mp4, flv, f4v, swf, xml
    • Presupponiamo statico in caso contrario
  • Se il record in è stato trovato nel catalogo immagini ma NON nel catalogo contenuti statici

    • Immagini
  • Se il record NON viene trovato nel catalogo immagini e NON nel catalogo dei contenuti statici

    • Si supponga che l'estensione file sia nel seguente set: mp3, mp4, flv, f4v, swf, xml
    • Supponiamo un’immagine basata su file in caso contrario

In tutti i casi, la risposta XML risultante è conforme al documento XML specificato con il nodo principale impostato corrispondente al tipo rilevato.

Rilevamento tipo set interno

Quando il set esterno viene rilevato come tipo di set di file multimediali, la risposta contiene un set di elementi del set di file multimediali corrispondente a ciascuna voce del set di file multimediali in catalog::ImageSet. Se il parametro di tipo opzionale è specificato per una particolare voce di set di file multimediali, viene mappato a un tipo di output in base alla tabella seguente:

Tipo di input Tipo di 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

Se il parametro di tipo opzionale per una particolare voce del set di file multimediali non è specificato o corrisponde a un tipo non supportato, il tipo di elemento del set di file multimediali viene rilevato automaticamente utilizzando le stesse regole applicate a livello di set esterno.

Specifica XML

La risposta xml restituita è conforme alle seguenti specifiche:

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

LabelKey

Il labelkey= il modificatore viene utilizzato insieme al catalog::UserDataper generare etichette per immagini e campioni. Il catalog:UserData viene analizzato come un set di coppie chiave/valore e gli indici labelkey in questo set per recuperare il valore per la chiave specificata. Questo valore viene quindi restituito nel l attributo per s e i.

Restrizioni applicate

Per limitare le dimensioni della risposta ed evitare problemi autoreferenziali, la profondità massima di nidificazione è controllata dalla proprietà del server PS::fvctx.nestingLimit. Se questo limite viene superato, viene restituito un errore.

Per limitare le dimensioni delle risposte xml per i set di e-catalog di grandi dimensioni, i metadati privati vengono soppressi per gli elementi dei set di brochure in base alla proprietà del server PS::fvctx.brochureLimit. Tutti i metadati privati associati alla brochure vengono esportati fino al raggiungimento del limite della brochure. Una volta superato il limite, le mappe private e i dati utente vengono eliminati e viene impostato un flag corrispondente per indicare quale tipo di dati è stato eliminato.

I set di file multimediali nidificati non sono supportati. Un set di file multimediali nidificato è definito come un set di file multimediali contenente un elemento del set di file multimediali di tipo set di file multimediali. Se questa condizione viene rilevata, viene restituito un errore.

Esempi

Per risposte XML di esempio per req=set , fai riferimento alla pagina Proprietà sotto l’intestazione Esempi di HTML.

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

Consultate anche

req= , imageset= insieme di immagini, catalogo::ImageSet, Riferimento catalogo immagini

In questa pagina