CAE-Einstellungen

Überblick

Context Aware Encoding erstellt mehrere Wiedergaben Ihres Quellvideos basierend auf den von Ihnen bereitgestellten Richtlinien, aber auch basierend auf den Eigenschaften des Videos selbst. Dies hilft, die Kosten für das Transcodieren und Speichern Ihrer Videos zu vermeiden, indem Wiedergaben erstellt werden, die angesichts der Eigenschaften der Quelle im Wesentlichen wertlos sind.

Siehe die CAE-Leitfaden Weitere Informationen und Empfehlungen zu Einstellungen.

video_codecs

video_codecs:Array

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Array-Elementwerte: h264, hevc

Standardwert: keiner

Kompatible Auftragstypen: VOD

Beispiel: ["h264", "hevc"]

Beschreibung:

Für gemischte Codec-Ausgaben ein Array der Codecs, für die Wiedergaben erstellt werden sollen. Derzeit sind die zulässigen Artikelwerte h264 und hevc.

{
    "dynamic_profile_options": {
      "max_renditions": 6,
      "video_codecs" : ["h264", "hevc"'],
      "video_codec_options": {
        "h264": {
          "min_renditions": 2,
          "max_resolution": { "width": 1280, "height": 720 }
        },
        "hevc": {
          "min_renditions": 2,
          "max_resolution": { "width": 1920, "height": 1080 }
        }
      }
    }
  }

video_codec_options

video_codecs:Object

API-Versionen: V2

Elternteil: dynamic_profile_options

Standardwert: keiner

Kompatible Auftragstypen: VOD

Beispiel:

"video_codec_options": {
  "h264": {
    "min_renditions": 2,
    "max_resolution": { "width": 1280, "height": 720 }
  },
  "hevc": {
    "min_renditions": 2,
    "max_resolution": { "width": 1920, "height": 1080 }
  }
}

Beschreibung:

Bei gemischten Codec-Ausgaben ein Objekt, das die Optionen für jeden Codec angibt. Jede Eigenschaft ist ein Objekt mit dem Namen h264 oder hevc ihre Eigenschaften sind die Festlegen der Beschränkungen für Formatvarianten für diesen Codec. Die zulässigen Eigenschaften für diese Objekte sind:

min_renditions erforderlich
min_bitrate
max_bitrate
max_first_rendition_bitrate
min_resolution
max_resolution
max_first_rendition_resolution

{
    "dynamic_profile_options": {
      "max_renditions": 6,
      "video_codecs" : ["h264", "hevc"'],
      "video_codec_options": {
        "h264": {
          "min_renditions": 2,
          "max_resolution": { "width": 1280, "height": 720 }
        },
        "hevc": {
          "min_renditions": 2,
          "max_resolution": { "width": 1920, "height": 1080 }
        }
      }
    }
  }

min_renditions

min_renditions:Integer

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: 1-15

Standardwert: 1

Kompatible Auftragstypen: VOD

Beispiel: 3

Beschreibung:

Die Mindestanzahl der zu generierenden Wiedergaben.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2
          }
        }

max_renditions

max_renditions:Integer

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: 1-15

Standardwert: 8

Kompatible Auftragstypen: VOD

Beispiel: 10

Beschreibung:

Die maximale Anzahl der zu generierenden Wiedergaben.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10
          }
        }

min_resolution

min_resolution:Object

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: 16 x 16 - 8192 x 8192

Standardwert: 192 x 108

Kompatible Auftragstypen: VOD

Beispiel: siehe unten

Beschreibung:

Mindestauflösung für die Leiter zu berücksichtigen.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_resolution": {
              "height": 180,
              "width": 320
            }
          }
        }

max_resolution

max_resolution:Object

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: 16 x 16 - 8192 x 8192

Standardwert: Quellenauflösung

Kompatible Auftragstypen: VOD

Beispiel: siehe unten

Beschreibung:

Maximale Auflösung, die für die Leiter berücksichtigt werden muss.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_resolution": {
              "height": 180,
              "width": 320
            },
            "max_resolution": {
              "height": 1080,
              "width": 1920
            }
          }
        }

max_frame_rate

max_frame_rate:Number

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: 0,1 - 120

Standardwert: 30

Kompatible Auftragstypen: VOD

Beispiel: 60

Beschreibung:

Maximale Bildrate, die verwendet werden kann.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "max_frame_rate": 60
          }
        }

keyframe_rate

keyframe_rate:Number

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: 0,5, 1,0

Standardwert: 0.5

Kompatible Auftragstypen: VOD

Beispiel: 0.5

Beschreibung:

Keyframe-Rate. Dieser Wert kann entweder 0,5 oder 1 sein. Für SSAI-fähige Inhalte muss dieser Wert 1 sein.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "keyframe_rate": 0.5
          }
        }

fixed_frame_rate

fixed_frame_rate:Boolean

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: richtig oder falsch

Standardwert: wahr

Kompatible Auftragstypen: VOD

Beispiel: wahr

Beschreibung:

Weist den Generator an, für alle Wiedergaben dieselbe Bildrate zu verwenden. Bei false wird den H.264-Basisprofilwiedergaben bei Auflösungen unter 360p eine halbierte Bildrate zugewiesen.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "fixed_frame_rate": true
          }
        }

min_bitrate

min_bitrate:Number

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: 40 - 400

Standardwert: 200

Kompatible Auftragstypen: VOD

Beispiel: 300

Beschreibung:

Minimale Bitrate [kbps], die verwendet werden kann.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_bitrate": 300
          }
        }

max_bitrate

max_bitrate:Number

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: 400 - 40000

Standardwert: 15000

Kompatible Auftragstypen: VOD

Beispiel: 20000

Beschreibung:

Maximale Bitrate [kbps], die verwendet werden kann.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_bitrate": 300,
            "max_bitrate": 20000
          }
        }

max_first_rendition_bitrate

max_first_rendition_bitrate:Number

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: 40 - 1000

Standardwert: 400

Kompatible Auftragstypen: VOD

Beispiel: 700

Beschreibung:

Maximale Bitrate [kbps], die für die erste Wiedergabe verwendet werden kann.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_bitrate": 300,
            "max_bitrate": 20000
            "max_first_rendition_bitrate": 700
          }
        }

min_granularity

min_granularity:Number

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: 1 - 100 (%)

Standardwert: 30 (%)

Kompatible Auftragstypen: VOD

Beispiel: 20

Beschreibung:

Minimale relative Änderung der Bitrate zwischen den Wiedergaben.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_granularity": 20
          }
        }

max_granularity

max_granularity:Number

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: 1 - 100 (%)

Standardwert: 90 (%)

Kompatible Auftragstypen: VOD

Beispiel: 80

Beschreibung:

Maximale relative Änderung der Bitrate zwischen Wiedergaben.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_granularity": 20,
            "max_granularity": 80
          }
        }

video_codec

video_codec:String

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: h264, hevc

Standardwert: h264

Kompatible Auftragstypen: VOD

Beispiel: h264

Beschreibung:

Zu verwendender Video-Codec.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "video_codec": "h264"
          }
        }

bitrate_cap_to_bitrate_ratio

bitrate_cap_to_bitrate_ratio:Number

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: 1,0 - 2,0

Standardwert: 1.3

Kompatible Auftragstypen: VOD

Beispiel: 1.5

Beschreibung:

Verhältnis der maximalen Bitrate zur durchschnittlichen Bitrate, die für die VBR-Codierung verwendet werden soll.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "bitrate_cap_to_bitrate_ratio": 1.5
          }
        }

buffer_size_to_bitrate_ratio

buffer_size_to_bitrate_ratio:Number

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: 1,0 - 4,0

Standardwert: 2.0

Kompatible Auftragstypen: VOD

Beispiel: 2.5

Beschreibung:

Verhältnis der Decoderpuffergröße zur durchschnittlichen Bitrate, die für die VBR-Codierung verwendet werden soll.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "bitrate_cap_to_bitrate_ratio": 1.5,
            "buffer_size_to_bitrate_ratio": 2.5
          }
        }

bitrate_cap_offset

bitrate_cap_offset:Number

API-Versionen: V2

Elternteil: dynamic_profile_options

Standardwert: 64 [KBPS]

Kompatible Auftragstypen: VOD

Beispiel: 128

Beschreibung:

Konstante hinzugefügt bei der Berechnung der maximalen Bitrate.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "bitrate_cap_to_bitrate_ratio": 1.5,
            "buffer_size_to_bitrate_ratio": 2.5,
            "bitrate_cap_offset": 128
          }
        }

buffer_size_offset

buffer_size_offset:Number

API-Versionen: V2

Elternteil: dynamic_profile_options

Standardwert: 85 [KBPS]

Kompatible Auftragstypen: VOD

Beispiel: 100

Beschreibung:

Konstante hinzugefügt bei der Berechnung der VBV-Puffergröße.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "bitrate_cap_to_bitrate_ratio": 1.5,
            "buffer_size_to_bitrate_ratio": 2.5,
            bitrate_cap_offset": 128,
            "buffer_size_offset": 100
          }
        }

quality_rate_tune

quality_rate_tune:Number

API-Versionen: V2

Elternteil: dynamic_profile_options

Gültige Werte: -40,0 - 40,0

Standardwert: 0

Kompatible Auftragstypen: VOD

Beispiel: 2

Beschreibung:

Indem man es einstellt quality_rate_tune Bei einer positiven Zahl von 1 bis 40 weisen CAE-Profile eine höhere Videoqualität auf Kosten höherer Bitraten auf. In ähnlicher Weise kann man bei einer Zahl im Bereich von -1 bis -40 die Bitraten auf Kosten einer Verringerung der Videoqualität senken.

Zum Beispiel kann man mit -10 ungefähr 10% niedrigere Bitraten erwarten. Mit 10 steigen die Bitraten im Allgemeinen um 10%. Diese Zahlen sind Näherungen, da CAE für positive Werte von zusätzliche Vorkehrungen quality_rate_tune trifft, um eine sehr hohe Videoqualität zu gewährleisten, und es kann andere Parameter geben, die die Bitraten begrenzen, wie Granularität und Anzahl Formatvarianten.

Da der typische Inhalt und die gewünschte Videoqualität im Verhältnis zur Bandbreite stark variieren, kann es ratsam sein, mit verschiedenen Werten zu experimentieren.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "quality_rate_tune": 2
          }
        }

select_baseline_profile_configuration

select_baseline_profile_configuration:Boolean

API-Versionen: V2

Elternteil: dynamic_profile_options

Standardwert: wahr

Kompatible Auftragstypen: VOD

Beispiel: falsch

Beschreibung:

Mindestens eine im Profil verwendete Wiedergabe ist das Basisprofil. Beachten Sie, dass select_baseline_profile_configuration ist true standardmäßig, und es erfordert mindestens eine Wiedergabe eine Auflösung von 512 x 288 oder weniger haben.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "select_baseline_profile_configuration": true
          }
        }

select_distinct_configurations

select_distinct_configurations:Boolean

API-Versionen: V2

Elternteil: dynamic_profile_options

Standardwert: falsch

Kompatible Auftragstypen: VOD

Beispiel: wahr

Beschreibung:

Wenn dies der Fall ist, stellt CAE sicher, dass keine zwei Wiedergaben dieselbe Kombination aus Auflösung, Bildrate und Codec-Profil verwenden.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "select_distinct_configurations": true
          }
        }

video_configurations

video_configurations:Array

API-Versionen: V2

Elternteil: dynamic_profile_options

Standard: Der Profilgenerator verwendet Listen mit Standardauflösungen für alle bekannten Seitenverhältnisse. Wenn immer möglich, bleiben das Seitenverhältnis, das Probenseitenverhältnis und die Bildrate der Quelle in den Ausgabekonfigurationen erhalten.

Kompatible Auftragstypen: VOD

Beispiel: siehe unten

Beschreibung:

Ein Array von Strukturen, die Auflösungen, Bildraten und zugehörige Codec-Einstellungen beschreiben, die im Rahmen der CAE-Codierung bevorzugt oder obligatorisch generiert werden sollten. Siehe die Sektion unten.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "video_configurations": [
              {
                "width": 1920,
                "height": 1080,
                "sample_aspect_ratio": "16:9",
                "frame_rate": 30,
                "video_codec_profile": "high",
                "video_codec_level": 4.1,
                "video_reference_frames": 4,
                "video_bframes": 3,
                "required": true
              }
              ]
          }
        }

watermarks

watermarks:Array

API-Versionen: V2

Elternteil: dynamic_profile_options

Standard: Der Profilgenerator verwendet Listen mit Standardauflösungen für alle bekannten Seitenverhältnisse. Wenn immer möglich, bleiben das Seitenverhältnis, das Probenseitenverhältnis und die Bildrate der Quelle in den Ausgabekonfigurationen erhalten.

Kompatible Auftragstypen: VOD

Beispiel: siehe unten

Beschreibung:

Eine Reihe von Hashes, die beschreiben Wasserzeichen.

    {
        "input": "s3://zencodertesting/test.mov",
        "generate_dynamic_profile": true,
        "dynamic_profile_options" : {
          "min_rendition": 2,
          "max_rendition": 6,
          "watermarks":[
           {
              "url": "{url_to_watermark}",
             "width": "10%",
             "height": "10%"
           }
          ]
        }
      }

Wasserzeichen können auch Teil von sein video_configurations::

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options" : {
            "video_configurations": [
              {
               "width": 640,
               "height": 360,
                "watermarks":[
                  {
                    "url": "{url_to_watermark}",
                    "x": "-10",
                    "y": 10"
                  }
                ]
              },
              {
               "width": 960,
               "height": 540,
                "watermarks":[
                  {
                    "url": "{url_to_watermark}",
                    "x": "-15",
                    "y": "15"
                 }
                ]
              },
              {
                "width": 1280,
                "height": 720,
                "watermarks":[
                  {
                    "url": "{url_to_watermark}",
                    "x": "-20",
                    "y": "20"
                 }
                ]
              }
            ]
          }

Additional settings

Im Folgenden finden Sie zusätzliche allgemeine Codierungseinstellungen, die für CAE verwendet werden können.

Zusätzliche Einstellungen
Nennen	Typ	Beschreibung	Standardwert
`deblock`	Boolescher Wert	Wenden Sie einen Deblocking-Filter auf das Video an.	`false`
`deinterlace`	String	Legt fest, ob ein Deinterlacing-Filter angewendet werden soll oder nicht. Die Standardeinstellung ist "Erkennen". Wenn die Eingabedatei als Interlaced erkannt wird, wird sie deinterlaced. Stellen Sie dies auf "Ein", um das Deinterlacing zu erzwingen (wodurch die Qualität verringert wird, wenn die Eingabe nicht interlaced ist), oder auf "Aus", um Deinterlacing zu vermeiden.	`detect`
`deinterlace_mode`	String	Wenn nicht enthalten oder auf gesetzt `frame-to-frame`, entsprechen die Zencoder-Ausgaben der Framerate der Eingabedatei. Wenn auf gesetzt `field-to-frame`, verdoppelt Zencoder die Framerate der Eingabedatei für die Ausgabe. Wenn Sie `framerate` die doppelte Framerate der Eingabedatei manuell festlegen, stellt Zencoder die Framerate für die Ausgabe automatisch `deinterlace_mode` auf `field-to-frame` und verdoppelt sie.	`frame-to-frame`
`denoise`	String	Wenden Sie einen Entrauschungsfilter auf das Video an. Gültige Optionen sind `weak` `medium`, `strong`, und `strongest`. Reduziert normalerweise die Dateigröße um 5% bis 20%, abhängig von Entrauschungsstufe, Bitrate und Quellvideo. Jegliches Entrauschen verlangsamt die Codierung um etwa 20%. Werte über "schwach" sollten sorgfältig verwendet werden, obwohl Animationen manchmal einen hohen Grad an Entrauschung verarbeiten können.	`none (denoising not applied)`
`speed`	Ganze Zahl	Einstellung der Codierungsgeschwindigkeit.	`3`
`one_pass`	Boolescher Wert	1-Pass-Codierung erzwingen.	`false`
`start_clip`	String / Nummer	Erstellen Sie einen Clip des Originalvideos, beginnend zu einem bestimmten Zeitpunkt. Dies kann entweder ein Timecode mit einem Format von oder eine Dezimalzahl sein `HH:MM:SS.S`, die die Anzahl der Sekunden ausdrückt, mit denen begonnen werden soll.	`0`
`clip_length`	String / Nummer	Erstellen Sie einen Clip mit einer bestimmten Länge. Dies kann entweder eine Dauer mit einem Format von oder eine Dezimalzahl sein `HH:MM:SS.S`, die die Länge des Clips in Sekunden ausdrückt.	Dauer der Quelle

HDR-Einstellungen

CAE unterstützt auch HDR10 und die folgenden Einstellungen können enthalten sein dynamic_profile_options.

Zusätzliche Einstellungen
Nennen	Typ	Beschreibung	Standardwert
`master_display`	Objekt	Hash mit Einstellungen für Farbvolumen und Luminanz für HDR-Ausgänge.	keiner
`max_content_light_level`	Ganze Zahl	Maximaler Lichtpegel für den Inhalt als ganze Nissen oder Candela pro Quadratmeter (cd/m2) - ganzzahlige Werte.	keiner
`max_frame_average_light_level`	Ganze Zahl	Maximaler durchschnittlicher Lichtpegel für Content-Frames Nits oder Candela pro Quadratmeter (cd/m2) - ganzzahlige Werte. Obwohl Werte bis zu 10000 zulässig sind, erzielen Werte im Bereich von 100 bis 200 im Allgemeinen die besten Ergebnisse.	keiner

Einstellungen für die Videokonfiguration

Möglicherweise möchten Sie diese Funktion verwenden, wenn CAE keine spezifischen Konfigurationen erstellt, die Sie in Ihren Ausgaben haben müssen.

Dies ist eine Reihe von Objekten, die Videoauflösungen und Codec-Einstellungen beschreiben, die CAE als Teil seiner Ausgabe erzeugen sollte / muss (siehe die Beispiel oben). Dieses Array ist Optional. Wenn nicht angegeben, wird eine Reihe von Standardauflösungen von 192 x 108 bis zur Auflösung des Inhalts als Standardeingabesatz für CAE verwendet.

Videokonfigurationseinstellungen
Nennen	Typ	Beschreibung	Erforderlich?
`width`	Ganze Zahl	Videobildbreite [Pixel]	erforderlich
`height`	Ganze Zahl	Videobildhöhe [Pixel]	erforderlich
`sample_aspect_ratio`	Ganzzahl: Ganzzahliges Paar	Seitenverhältnis der Probe (z. B. 1: 1, 4: 3)	fakultativ
`frame_rate`	Nummer	Videobildrate [fps]	fakultativ
`video_codec_profile`	String	Videocodec-Profil	fakultativ
`video_codec_level`	String	Videocodec-Level	fakultativ
`video_reference_frames`	Ganze Zahl	Beschränkung der Anzahl der Referenzrahmen. Standard = 4 (3 für H.264-Basislinie).	fakultativ
`video_bframes`	Ganze Zahl	Beschränkung der Anzahl der B-Frames. Standard = 3 (0 für H.264-Basislinie).	fakultativ
`required`	Boolescher Wert	Wenn Sie dies auf true setzen, werden die vorgeschlagenen Konfigurationseinstellungen in der Ausgabe garantiert. Standard = falsch.	fakultativ