Thumbnail-Einstellungen

Dieses Thema enthält Details zu Kodierungseinstellungen für Video-Miniaturansichten.

Miniaturansichten

thumbnails:Array or Hash

API-Versionen: V2

Elternteil: Ausgänge

Kompatible Auftragstypen: VOD

Beispiel:

  • "Thumbnails": [{}]
  • "Thumbnails": {}

Beschreibung:

Für jede Ausgabe können Sie eine oder mehrere Miniaturansichten anfordern.

Jede Ausgabe kann ihre eigenen Miniaturansichten mit eindeutiger Größe, base_url und access_control haben.

Durch Übergeben mehrerer Miniaturansichten innerhalb eines Arrays können mehrere Sätze von Miniaturansichten für eine einzelne Ausgabe erstellt werden. Wenn Miniaturansichten in einem Array übergeben werden, a Etikette muss für set eingestellt werden.

Stellen Sie S3 ein Zugangskontrolle Verwenden Sie dieselben Optionen wie für die Ausgabe von Videos.

Miniaturansichten sind auf 100 pro Satz begrenzt. Wenn bei den angeforderten Optionen mehr Miniaturansichten generiert werden, wird der Ausgabe eine Warnung hinzugefügt, und die Erstellung von Miniaturansichten wird beendet, wenn das Limit erreicht ist.

Hinweis:: Es gibt keinen Job nur für Miniaturansichten. Angeben einer Ausgabe mit nur Miniaturansichten wird auch erstellen eine abrechnungsfähige MP3-Datei in voller Länge mit unseren Standard-Transcodierungseinstellungen, die Sie in den temporären Speicher hochladen können.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": [
        {
          "label": "first",
          "Nummer": 10
        },
        {
          "label": "second",
          "interval_in_frames": 5000
        }
      ]
    }
  ]
}}

Siehe auch: Etikette

Etikett

label:String

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Kompatible Auftragstypen: VOD

Beispiel: Poster

Beschreibung:

Ein Name für das Miniaturbild. Erforderlich, wenn Miniaturansätze in einem Array angefordert werden.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": [
        {
          "label": "poster"
        },
        {
          "label": "clips"
        }
      ]
    }
  ]
}}

Format

format:String

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Standard: png

Gültige Werte: png oder jpg

Kompatible Auftragstypen: VOD

Beispiel: jpg

Beschreibung:

Das Format des Miniaturbilds.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "format": "jpg"
      }
    }
  ]
}}

Nummer

number:Integer

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Gültige Werte: Eine positive ganze Zahl

Kompatible Auftragstypen: VOD

Beispiel: 3

Beschreibung:

Eine Reihe von Miniaturansichten, die erfasst werden sollen. Zencoder erfasst gleichmäßig verteilte Miniaturansichten über die gesamte Dauer der Datei. Wenn Sie also nach 1 Miniaturansicht fragen, befindet sich diese in der Mitte der Datei. Wenn Sie in einem 8-minütigen Video 3 Miniaturansichten angeben, werden die Miniaturansichten nach ca. 2, 4 und 6 Minuten angezeigt.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Nummer": 3
      }
    }
  ]
}}

start_at_first_frame

start_at_first_frame:Boolean

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Standard: falsch

Gültige Werte: richtig oder falsch

Kompatible Auftragstypen: VOD

Beispiel: wahr

Beschreibung:

Bei Verwendung der Nummer Option für die Erstellung von Miniaturansichten Hiermit werden mit dem ersten Frame Miniaturansichten erstellt.

Wenn Sie beispielsweise verwenden, wenn Ihr Video 5 Sekunden lang ist und Sie mit der Zahlenoption 5 Miniaturansichten anfordern, werden Miniaturansichten bei 0 s, 1s, 2s, 3s und 4s erstellt. Normalerweise würde es Miniaturansichten bei 0,83 s, 1,66s, 2,49s, 3,32 s und 4,15 Sekunden greifen.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Nummer": 5,
        "start_at_first_frame": true
      }
    }
  ]
}}

Intervall

interval:Float

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Kompatible Auftragstypen: VOD

Beispiel: 60

Beschreibung:

Nehmen Sie Thumbnails in gleichmäßigen Abständen in Sekunden auf. Zencoder gibt für alle N Sekunden der Datei eine Miniaturansicht zurück. Wenn Sie also ein Intervall von 60 wählen und Ihre Eingabedatei 12 Minuten lang ist, erhalten Sie 12 Miniaturansichten zurück, jede auf die Minute genau.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Intervall": 60
      }
    }
  ]
}}

Siehe auch: Intervall_in_Frames

interval_in_frames

interval_in_frames:Float

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Kompatible Auftragstypen: VOD

Beispiel: 120

Beschreibung:

Nehmen Sie Thumbnails in gleichmäßigen Abständen in Frames auf. Zencoder gibt eine Miniaturansicht für jeweils N Frames der Datei zurück. Wenn Sie also ein Intervall von 120 wählen und Ihre Eingabedatei 29,97 Bilder pro Sekunde enthält, erhalten Sie ungefähr alle 4 Sekunden Miniaturansichten zurück.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "interval_in_frames": 120
      }
    }
  ]
}}

Siehe auch: Intervall

mal

times:Array

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Kompatible Auftragstypen: VOD

Beispiel: [0, 30, 60, 90]

Beschreibung:

Eine Reihe von Zeiten in Sekunden, zu denen Sie ein Miniaturbild abrufen können. Dezimalstellen sind gültig. Wenn Sie also die Zeiten auf [12,5, 25] setzen, werden zwei Miniaturansichten angezeigt, eine nach 12,5 Sekunden und eine nach 25 Sekunden. Dieser Wert muss ein Array nicht negativer Zahlen sein.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Zeiten": [0, 30, 60, 90]
      }
    }
  ]
}}

aspect_mode

aspect_mode:String

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Standard: erhalten

Gültige Werte: konservieren, dehnen, beschneiden oder polstern

Kompatible Auftragstypen: VOD

Beispiel: Pad

Beschreibung:

Der Aspektmodus, der beim Erstellen von Miniaturansichten verwendet werden soll.

  • erhalten:: Standardmäßig behält Zencoder das Seitenverhältnis der ausgegebenen Videodatei bei. Wenn Sie also Breitbildinhalte senden und nach einer Standardauflösung fragen, behält die Miniaturbilddatei das Breitbild-Seitenverhältnis bei und passt in die angeforderte Größe.
  • strecken:: Wenn der Seitenmodus "Dehnen" ist, entspricht die Miniaturansicht genau der gewünschten Breite und Höhe, auch wenn das Bild dadurch verzerrt wird.
  • zuschneiden: Diese Option weist Zencoder an, das Miniaturbild zu "zoomen", um es an die gewünschte Größe anzupassen, indem Pixel von oben / unten oder links / rechts zugeschnitten werden.
  • Pad: Die Pad-Option weist Zencoder an, das Miniaturbild so zu gestalten, dass es der angeforderten Bildgröße entspricht. Verwenden Sie diese Option, um das Seitenverhältnis des ausgegebenen Videos beizubehalten, aber immer Miniaturansichten derselben Größe zu erhalten.

Hinweis: Aufgrund der Einschränkungen von Videoskalierungsalgorithmen sind die Abmessungen der Miniaturansichten eine gerade Zahl. Wenn Sie beispielsweise Miniaturansichten mit einer Größe von 100 x 75 anfordern, erhalten Sie Miniaturansichten mit einer Größe von 100 x 74.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Aspekt_Modus": "Pad",
        "Breite": 200,
        "Höhe": 200
      }
    }
  ]
}}

Siehe auch: Größe , Breite , und Höhe

Größe

size:String

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Kompatible Auftragstypen: VOD

Beispiel: 400 x 300

Beschreibung:

Eine Zielauflösung für die Miniaturansichten wie "160 × 120". Wenn keine Größe angegeben ist, haben Miniaturansichten dieselbe Größe wie das Ausgabevideo. Standardmäßig wird das Seitenverhältnis beibehalten. Wenn also das Seitenverhältnis dieses Größenparameters nicht mit dem Seitenverhältnis des Films übereinstimmt, stimmt die resultierende Datei möglicherweise nicht genau mit dieser Größe überein. Wenn Stretch für die entsprechende Ausgabedatei auf true gesetzt ist, wird diese Miniaturansicht ebenfalls gedehnt, um die Auflösung zu füllen.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Größe": "400x300"
      }
    }
  ]
}}

Siehe auch: Breite , Höhe , und Aspekt_Modus

Breite

width:Integer

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Gültige Werte: Eine positive ganze Zahl

Kompatible Auftragstypen: VOD

Beispiel: 640

Beschreibung:

Miniaturbildbreite. Wenn keine Breite angegeben wird, verwenden wir die Breite der Ausgabedatei oder skalieren auf Größe oder Höhe Rahmen.

Beachten Sie, dass Größe hat Vorrang vor beiden Breite und Höhe.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Breite": 640
      }
    }
  ]
}}

Siehe auch: Größe , Höhe , und Aspekt_Modus

Höhe

height:Integer

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Gültige Werte: Eine positive ganze Zahl

Kompatible Auftragstypen: VOD

Beispiel: 480

Beschreibung:

Miniaturbildhöhe. Wenn keine Höhe angegeben wird, verwenden wir die Höhe der Ausgabedatei oder skalieren auf Größe oder Breite Rahmen.

Beachten Sie, dass Größe hat Vorrang vor beiden Breite und Höhe.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Höhe": 480
      }
    }
  ]
}}

Siehe auch: Größe , Breite , und Aspekt_Modus

base_url

base_url:String

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Gültige Werte: Eine gültige S3-, Cloud Files-, GCS-, FTP-, FTPS- oder SFTP-URL, abzüglich Dateinamen. Format: s3: // [Bucket-Name] / [Pfad] oder ftp: // [Benutzer]: [Passwort] @ [ftp.url] / [Pfad]

Kompatible Auftragstypen: VOD

Beispiel:

  • s3: // mein-Ausgabe-Bucket /
  • cf: // Benutzername: api_key @ container / path /
  • ftp: // user: password@ftp.example.com/path/to

Beschreibung:

Ein Ausgabeziel für Miniaturansichten. Wenn base_url leer ist, speichern wir Thumbnails in unserem Zencoder S3-Bucket. Im Zencoder S3-Bucket gespeicherte Dateien sind nach 24 Stunden verfügbar. Beachten Sie, dass die Dateinamen zwischen den Ausgaben nicht eindeutig sind (z. B. frame_0000.png). Daher sollte das Ziel ein eindeutiges Verzeichnis oder ein eindeutiges Schlüsselpräfix sein, um ein Überschreiben von Dateien zu vermeiden.

FTP-Benutzer: Wir versuchen aus dem Stammverzeichnis Ihres Servers zu schreiben. Verwenden Sie daher einen absoluten Pfad für Ihre URL, um sicherzustellen, dass wir erfolgreich auf Ihren Server schreiben können.

Hinweise zu Anmeldeinformationen:

Wenn Sie Anmeldeinformationen über base_url angeben, sind diese in den URLs vorhanden, die in Anfragen zu den Jobdetails, Ausgabedetails usw. angezeigt werden. Wenn Referenzen werden mit Zencoder gespeichert und erscheinen in diesen Antworten nicht in URLs.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "base_url": "s3: // mein-Ausgabe-Bucket /"
      }
    }
  ]
}}

Siehe auch: Präfix und Dateiname

Präfix

prefix:String

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Standard: Rahmen

Kompatible Auftragstypen: VOD

Beispiel:

  • Daumen
  • video_thumbnails

Beschreibung:

Miniaturbilddateien werden mit sequentiellen Dateinamen exportiert. Sie können jedoch ein benutzerdefiniertes Präfix für die Miniaturbilddateien angeben. Wenn kein Präfix angegeben ist, verwenden wir frame. Wenn Sie beispielsweise das Präfix 'custom' verwenden, werden die exportierten Dateien als custom_0000.png, custom_0001.png usw. bezeichnet. Ohne ein benutzerdefiniertes Präfix würden sie frame_0000.png, frame_0001.png usw. heißen.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Präfix": "Daumen"
      }
    }
  ]
}}

Siehe auch: base_url und Dateiname

Dateiname

filename:String

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Standard: Rahmen

Kompatible Auftragstypen: VOD

Beispiel:

  • thumbnail _ {{number}}
  • {{number}} _ {{width}} x {{height}} - Miniaturansicht

Beschreibung:

Miniaturbilddateien können einen Dateinamen erhalten, der auf mehreren Attributen basiert. Zu den Attributen gehören Nummer, aufgefüllte Nummer, Breite, Höhe und Größe. Es ist nicht erforderlich, eine Dateierweiterung hinzuzufügen, da diese von Zencoder basierend auf der Option "Format" hinzugefügt wird.

Nummer oder gepolsterte Nummer muss verwendet werden, alle anderen sind optional. Die gepolsterte Nummer verwendet 4 Spots (0000, 0001 usw.).

Höhe, Breite und Größe basieren auf der tatsächlichen Größe der generierten Miniaturansicht.

Beispiel: _x-thumbnail

Gültige Zeichen sind Buchstaben, Zahlen, Bindestriche, Unterstriche und die interpolierten Werte.

Hinweis:: Wenn Sie einen Dateinamen angeben, wird ein beliebiger angegeben Präfix wird ignoriert.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Dateiname": "_x-thumbnail"
      }
    }
  ]
}}

Siehe auch: base_url und Präfix

Öffentlichkeit

public:Boolean

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Standard: falsch

Gültige Werte: richtig oder falsch

Kompatible Auftragstypen: VOD

Beschreibung:

Das Gleiche wie Öffentlichkeit für Ausgabedateien. Sehen Öffentlichkeit für die vollständige Dokumentation dieser Option.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Nummer": 10,
        "public": wahr
      }
    }
  ]
}}

Siehe auch: Zugangskontrolle

access_control

access_control:Array

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Gültige Werte: Eine Reihe von Hashes mit zwei Einstellungen: Stipendiat und Genehmigung.

Kompatible Auftragstypen: VOD

Beschreibung:

Das Gleiche wie Zugangskontrolle für Ausgabedateien. Sehen Zugangskontrolle für die vollständige Dokumentation dieser Option.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Zugangskontrolle": [
          {
            "Genehmigung": "LESEN",
            "Stipendiat": "jemand@example.com"
          }
        ]
      }
    }
  ]
}}

Siehe auch: Öffentlichkeit, Stipendiat und Erlaubnis

Erwerber

grantee:String

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails /. Zugangskontrolle

Gültige Werte: Ein gültiger S3-Berechtigter (E-Mail, ID oder URI)

Kompatible Auftragstypen: VOD

Beschreibung:

Das Gleiche wie Stipendiat für Ausgabedateien. Sehen Stipendiat für die vollständige Dokumentation dieser Option.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Zugangskontrolle": [
          {
            "Genehmigung": "VOLLE KONTROLLE",
            "Stipendiat": "cdc7931a9574b1055d5b76112021d0e9"
          }
        ]
      }
    }
  ]
}}

Siehe auch: Zugangskontrolle und Genehmigung

Genehmigung

permission:String

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails /. Zugangskontrolle

Gültige Werte: Eine Zeichenfolge oder ein Array von Zeichenfolgen, die Folgendes enthalten: READ, READ_ACP, WRITE_ACP oder FULL_CONTROL

Kompatible Auftragstypen: VOD

Beschreibung:

Das Gleiche wie Genehmigung für Ausgabedateien. Sehen Genehmigung für die vollständige Dokumentation dieser Option.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Zugangskontrolle": [
          {
            "Genehmigung": "VOLLE KONTROLLE",
            "Stipendiat": "cdc7931a9574b1055d5b76112021d0e9"
          }
        ]
      }
    }
  ]
}}

Siehe auch: Zugangskontrolle und Stipendiat

rss

rrs:Boolean

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Standard: falsch

Gültige Werte: richtig oder falsch

Kompatible Auftragstypen: VOD

Beschreibung:

Das Gleiche wie rrs für Ausgabedateien. Sehen rrs für die vollständige Dokumentation dieser Option.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "rrs": wahr
      }
    }
  ]
}}

Kopfzeilen

headers:Hash

API-Versionen: V2

Eltern: Ausgänge ODER Thumbnails

Kompatible Auftragstypen: VOD

Beispiel: {"Content-Type": "Binär- / Oktett-Stream"}

Beschreibung:

HTTP-Header, die beim Hochladen mit Ihren Miniaturansichten gesendet werden. Diese Funktion wird derzeit bei Verwendung von S3 und Cloud Files unterstützt.

Zencoder unterstützt das Festlegen einer begrenzten Teilmenge dieser Header: Cache-Control, Content-Disposition, Content-Codierung, Inhaltstyp, Abläuft, x-amz-acl, x-amz-storage-Klasse, x-amz-serverseitige Verschlüsselung und x-amz-Meta-*.

Header werden ignoriert, wenn kein Ausgabeort angegeben ist.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "Header": {
          "Content-Type": "Binär- / Oktett-Stream",
          "x-amz-acl": "public-read-write"
        }
      }
    }
  ]
}}

Referenzen

credentials:String

API-Versionen: V2

Elternteil: Ausgänge /. Thumbnails

Kompatible Auftragstypen: VOD

Beispiel: ftp_dev_server

Beschreibung:

Verweist auf den Spitznamen der gespeicherten Anmeldeinformationen, die für die Übertragung verwendet werden sollen und in der verwaltet werden Abschnitt "Kontoanmeldeinformationen".

HINWEIS: Anmeldeinformationen für Syndication-Dienste gelten nur für Ausgabevideos.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "base_url": "ftp://ftp.example.com/thumbnails/",
        "Anmeldeinformationen": "ftp_dev_server"
      }
    }
  ]
}}

Siehe auch: base_url

parallel_upload_limit

parallel_upload_limit:Integer

API-Versionen: V2

Standard: 30 für S3, 10 für alle anderen Ziele.

Gültige Werte: Eine ganze Zahl zwischen 1 und 30

Kompatible Auftragstypen: VOD

Beispiel: 5

Beschreibung:

Die maximale Anzahl gleichzeitiger Uploads beim Hochladen von Miniaturansichten.

Dies kann die Übertragungszeiten beschleunigen, abhängig von der Bandbreite auf Ihrem Remote-Server. Beachten Sie, dass mehr Verbindungen den Server stärker belasten können. Wenn Sie Probleme mit Upload-Zeitüberschreitungen haben oder verhindern möchten, dass Zencoder beim Hochladen von Dateien zu viel Bandbreite verwendet, setzen Sie diesen Wert auf 1.

{
  "input": "s3: //zencodertesting/test.mov",
  "Ausgänge": [
    {
      "Thumbnails": {
        "base_url": "ftp://ftp.example.com/thumbnails/",
        "parallel_upload_limit": 5
      }
    }
  ]
}}