Asset-Verwaltung
Wenn du versuchst, ein Bild von der API zu erhalten, bekommst du meistens eine URL ohne eine Dateierweiterung, wie unten gezeigt.
https://assets.tcgdex.net/de/swsh/swsh3/136
Das ist normal.
Wir erlauben dir, die Erweiterung und die Qualität (für Karten) des gewünschten Bildes anzupassen.
Für cards
kann die URL wie folgt rekonstruiert werden:
https://assets.tcgdex.net/de/swsh/swsh3/136/{quality}.{extension}
mit {quality}
, das durch high
oder low
ersetzt wird,
und {extension}
, das durch png
, webp
oder jpg
ersetzt wird.
Für symbols
und logos
kann die URL wie folgt rekonstruiert werden:
https://assets.tcgdex.net/de/swsh/swsh3/symbol.{extension}
mit {extension}
, das durch png
, webp
oder jpg
ersetzt wird.
Einige SDKs haben Helferfunktionen, um diese leicht zu rekonstruieren.
Auf einem Card
-Objekt:
// die endgültige URL abrufen val url = card.getImageUrl("high", "webp") // das Bild kann auch direkt abgerufen werden val image = card.getImage("high", "webp")
Auf einem Set
-Objekt:
// die endgültige URL abrufen val symbolURL = set.getSymbolUrl("webp") // das Symbolbild direkt abrufen val symbol = set.getSymbol("webp")
// die endgültige URL abrufen val logoURL = set.getLogoUrl("webp") // das Logobild direkt abrufen val logo = set.getLogo("webp")
Auf einem Card
-Objekt:
// die endgültige URL abrufen String url = card.getImageUrl("high", "webp") // das Bild kann auch direkt abgerufen werden BufferedImage image = card.getImage("high", "webp")
Auf einem Set
-Objekt:
// die endgültige URL abrufen String symbolURL = set.getSymbolUrl("webp") // das Symbolbild direkt abrufen BufferedImage symbol = set.getSymbol("webp")
// die endgültige URL abrufen String logoURL = set.getLogoUrl("webp") // das Logobild direkt abrufen BufferedImage logo = set.getLogo("webp")
Erweiterung
Alle Assets sind mit drei Erweiterungen verfügbar:
png
: Karte mit transparentem Hintergrundjpg
: Karte mit schwarzem Hintergrund (nicht empfohlen)webp
: Modernes Format, das kompakter ist als png/jpg mit transparentem Hintergrund (empfohlen)
Qualität
Alle Assets sind in zwei Qualitäten verfügbar:
high
: Bild im Format 600x825low
: Bild im Format 245x337