Dokumentation
Anleitung

Vorschaubilder, Logos und Playinfo abrufen

EAF-Vorschaubilder, Kontextlogos und Playinfo-Antworten einschließlich Größenangaben verarbeiten.

Auf dieser Seite

Für Vorschaubilder, Kontextlogos und bereitgestellte Medien gibt es eigene Befehle. Jeder benötigt seine jeweilige Funktionsfreigabe. Die Beispiele zeigen Datenformen mit Platzhaltern; sie sind keine Liste öffentlich zugänglicher Inhalte.

Vorschaubilder mit eafcover

Der Befehl nimmt EAF-Mediennummern entgegen, keine vollständigen Anbieter-Identifier:

<eafcover nrs="123456 987654"/>

Alternativ können die Nummern im Elementinhalt stehen:

<eafcover>123456,987654</eafcover>

Der Handler extrahiert Folgen aus Ziffern und Unterstrichen. Eine vollständige Kennung wie anbieter-123456 wird deshalb nicht als solche verarbeitet. Verwenden Sie die vereinbarten EAF-Nummern.

<coverlinks>
  <a href="https://media.example.org/cover/BEISPIEL.png" id="ANBIETER-123456">123456</a>
</coverlinks>

Textinhalt: angefragte Nummer. id: aufgelöster Identifier. href: Bildadresse. Nicht auf die Reihenfolge oder auf einen Treffer pro angefragter Nummer verlassen. Fehlende Zuordnungen müssen verarbeitet werden können. Die Funktionsfreigabe heißt genau eafcover, nicht eafcovers.

<logo/>

Die Antwort besitzt einen logo-Wrapper. Sein Inhalt ist kontextabhängig; eine leere Antwort ist möglich:

<logo></logo>

Der Server sucht nach kontextbezogenen Logodaten und kann auf übergeordnete Kontexte zurückfallen. Es gibt keinen hier zugesicherten Satz von Unterelementen. Stimmen Sie die Darstellungs- und Kennzeichnungspflichten Ihrer Integration mit uns ab. Übernommene HTML-Inhalte vor der Darstellung bereinigen.

Bereitgestellte Medien mit playinfo

<playinfo/>

Schematische Antwort:

<playinfo>
  <r identfier="anbieter-12345" download="17 MB"/>
  <r identfier="anbieter-67890" download=""/>
</playinfo>

Das Attribut heißt im bestehenden Protokoll tatsächlich identfier, nicht identifier. Implementieren Sie den Parser entsprechend.

download ist ein vom Medienhandler gelieferter Größenwert, kein boolescher Wert. Möglich sind formatierte Angaben, gespeicherte Größenstrings, 0 oder ein leerer Wert. Ein leerer Wert beweist nicht, dass jeder Download ausgeschlossen ist. Für einen tatsächlichen Zugriff den Medienlink-Ablauf verwenden und dessen Antwort auswerten.

playinfo arbeitet mit dem ersten Kontext und ist weder eine freie Textsuche noch ein Export aller Metadaten. Seine Medienauswahl kann von search abweichen. Eine Seitennavigation ist nicht vorgesehen. Stimmen Sie den Einsatz bei großen Beständen vorab mit uns ab.

Zur Übersicht: Einstieg in die ARIX-Schnittstelle