Grundlagen

FAQ

• Was macht Zencoder tun?

  Zencoder ist ein Online-Videokonvertierungs- / Codierungs- / Transcodierungsdienst. Wir nehmen Videos auf, die Sie von Benutzern Ihrer Website oder anderen Quellen erhalten, und konvertieren sie in Formate, die mit der Webwiedergabe, Mobiltelefonen oder anderen Geräten kompatibel sind, die Sie unterstützen müssen.

• Wer ist Zencoder zum?

  Zencoder ist für Entwickler gedacht, die Videos in ihre Anwendung integrieren möchten, ohne den schmerzhaften und langsamen Prozess des Erstellens, Verwaltens und Skalierens ihrer eigenen Transcodierungsserver durchlaufen zu müssen. Jede Website oder Anwendung, die Video-Uploads von Benutzern akzeptiert, benötigt eine Art Transcodierungs-Backend. Von Benutzern hochgeladene Videos haben selten Größen und Formate, die im Internet und auf anderen Geräten abgespielt werden können.

• Wie lade ich ein zu codierendes Video hoch?

  Der Zweck von Zencoder besteht darin, deine Videos automatisch zu konvertieren, ohne sie einzeln über ein Webformular zu uns hochladen zu müssen. Um dies zu erreichen, haben wir eine erstellt API Dadurch kann Ihre Anwendung mit kommunizieren Zencoder und benachrichtigen Sie uns, wenn ein neues Video codiert werden muss. Zu Beginn sollten sich Ihre Videos auf einem Dateiserver oder einem Cloud-Hosting-Dienst wie Amazon S3 oder Rackspace Cloud Files befinden Zencoder kann über das Web zugreifen. Dann können Sie unsere nutzen Builder anfordern um eine Codierungsjobanforderung zu erstellen, die sagt Zencoder Wo finden Sie Ihr Video, wie codieren Sie es und wo platzieren Sie das resultierende Ausgabevideo? Siehe die Builder anfordern in Ihrem Konto für weitere Details.

• Gibt es Größenbeschränkungen für Dateien, die mit der Datei hochgeladen werden können? Builder anfordern?

  Ja, mit dem Request Builder können nur Dateien mit einer Größe von weniger als 5 GB hochgeladen werden.

• Was ist ein Codierungsjob?

  Bei einem Codierungsauftrag wird eine eingegebene Video- oder Audiodatei in ein oder mehrere Ausgabeformate konvertiert. Sie können einen Codierungsjob über das starten API oder mit dem Builder anfordern in deinem Account. Während des Codierungsprozesses Zencoder Lädt zuerst die Eingabedatei von jedem Ort herunter, an dem sie gehostet wird. Anschließend konvertieren wir die Datei in die angegebenen Ausgabeeinstellungen und laden die Ausgabedateien entweder auf unsere eigenen Server oder an einen von Ihnen festgelegten Speicherort hoch (häufig denselben Hosting-Server wie die Eingabedatei).

• Kann ich mehrere Eingaben in einem Codierungsjob senden?

  Nein, pro Job ist nur eine Eingabe zulässig.

• Was Programmiersprachen sind Zencoder kompatibel mit?

  Jede Sprache, die HTTP-Anforderungen senden kann. Dazu gehören Python, Ruby, Java, .NET (C #, VB, F # usw.), PHP, Perl, Javascript, Tcl, Haskell, Faktor, Common Lisp, Smalltalk, Forth, ML, R, S, J, K, Bash, Clojure, Scala, Modula2, Modula3, ColdFusion, Emacs Lisp, C++, C, C, D, Objective-C, NewtonScript, Mathematica, PL/SQL, Cobol, Arc und Assembly. Wenn Sie Ihre bevorzugte Sprache hier nicht sehen, prüfen Sie, ob sie das Internet unterstützt. Wenn ja, ist es wahrscheinlich in Ordnung.

  Mit anderen Worten, die Zencoder API ist nur HTTP-Anfragen in und aus. Wir bieten einige Integrationsbibliotheken an, die die Verwendung etwas vereinfachen, aber die Integration ist nicht so schwierig Zencoder ohne Bibliothek. Die integrierte JSON- oder XML-Unterstützung ist ein Bonus, aber JSON ist so einfach, dass Sie es wahrscheinlich selbst hacken können, wenn Sie eine Sprache verwenden, die es nicht unterstützt (Cobol?).

• Welche Integrationsbibliotheken bieten Sie an?

  Wir haben einige Bibliotheken erstellt, in die integriert werden kann Zencoder Einfacher:

  • Rubin
  • PHP
  • Elixier
  • Node.js
  • Python
  • Java

  Einige unserer Kunden haben ihre eigenen Bibliotheken erstellt und diese ebenfalls zur Verfügung gestellt.

  • C # .Net
  • Clojure
  • Gehen

  Wir würden gerne später weitere Bibliotheken hinzufügen, wenn Sie es sind einen bauen Lassen Sie es uns wissen und wir werden es unseren Dokumenten hinzufügen.

• Benötige ich eine Integrationsbibliothek?

  Zumindest bei der Integration mit Zencoder sendet nur eine HTTP-Anfrage mit einem JSON- oder XML-Body. Sie können dies von der tun Kommandozeile mit Curl. Holen Sie sich eine 201 Created zurück, und Sie haben gerade mit integriert Zencoder.

  Darüber hinaus möchten Sie möglicherweise output_notification über HTTP erhalten. Geben Sie uns eine URL und wir senden Ihnen den Auftragsstatus zurück. Sie benötigen lediglich eine URL auf Ihrer Site, die eingerichtet ist, um einen HTTP-POST mit einem JSON- oder XML-Body zu empfangen.

  Schließlich möchten Sie vielleicht unsere API verwenden, um andere Dinge mit Kodierungsjobs zu erledigen, wie working_with_jobs, working_with_jobs oder working_with_jobs. Das sind auch nur HTTP-Anfragen.

• Was macht eine Integrationsbibliothek?

  Unsere Integrationsbibliotheken abstrahieren Sie von den HTTP-Rohanforderungen. Verwenden von unsere Ruby-Bibliothek Sie können beispielsweise einen Job wie folgt erstellen:

  Zencoder::Job.create({:input => 's3://bucket/key.mp4',
      :outputs => [{:label => 'vp8 for the web',
      :url => 's3://bucket/key_output.webm'}]})
  

  Anstatt so etwas zu tun:

  require 'uri'
      require 'json'
      response = Net::HTTP.post_form(URI.parse('jobs.json'),
      {:input => 's3://bucket/key.mp4',
      :outputs => [{:label => 'vp8 for the web',
      :url => 's3://bucket/key_output.webm'}]}.to_json)

  Die Bibliotheken aktivieren keine Funktionen, die Sie nicht haben, wenn Sie direkt mit der API arbeiten. Sie machen es nur ein bisschen einfacher.

• Was soll ich tun, wenn Sie keine Integrationsbibliothek für meine Sprache haben?

  Sie haben drei Möglichkeiten.

  • Baue deine eigenen und lasse es frei
  • Arbeiten Sie ohne Bibliothek
  • Frag uns wenn wir einen in Arbeit haben

• Kann ich meine eigenen bauen? Zencoder Bibliothek und teilen Sie es?

  Natürlich. Wenn Sie Open Source a Zencoder Bibliothek, wir werden wahrscheinlich sogar darauf verlinken. Fühlen Sie sich frei, unsere zu kopieren Ruby-Bibliothek in der Sprache Ihrer Wahl.

• Wie kann ich Benachrichtigungen auf meinem Entwicklungscomputer erhalten?

  Beispielsweise können Tools von Drittanbietern verwendet werden ngrok.

• Was ist der Integrationsmodus?

  Der Integrationsmodus ist eine Einstellung in Ihrem Konto, mit der Sie Ihre Integration von testen können Zencoder ohne für die Codierung belastet zu werden. Sie können mehr darüber in der lesen Testjobs und Integrationsmodus Sektion.

• Was ist der Datenschutzmodus?

  Im Datenschutzmodus werden bestimmte API-Parameter erzwungen, um Ihre Inhalte vor nicht autorisierten Ansichten zu schützen. Wir werden auch die von unserem System aufgenommenen Miniaturansichten deaktivieren (Sie können weiterhin Miniaturansichten für die Ausgabe angeben) und potenziell vertrauliche Informationen verschleiern. Zencoder Mitarbeiter werden aus irgendeinem Grund keine privaten Dateien anzeigen.

  Wenn Sie Inhalte für Erwachsene senden Zencoder Ihr Konto muss sich im Datenschutzmodus befinden.

• Ist die Rate der API-Anforderungen begrenzt?

  Ja, Zencoder begrenzt, wie oft Sie eine bestimmte Methode innerhalb eines bestimmten Zeitraums aufrufen können. Limits werden pro Methode (Ressource) verfolgt, mit Ausnahme von Fortschrittsanforderungen, die pro Ausgabe verfolgt werden. Beispielsweise zählen Aufrufe zum Abrufen von Auftrags- und Ausgabeinformationen alle auf das gleiche Limit, während Aufrufe zum Ausgabefortschritt separat pro Ausgabe verfolgt werden.

  Für jedes Konto sind 60 Anforderungen pro Minute zulässig, mit Ausnahme von Anforderungen zur Joberstellung, die auf 1.000 Anforderungen pro Minute begrenzt sind, und von Fortschrittsanforderungen, die auf 60 Anforderungen pro Minute und Ausgabe begrenzt sind.

  Jede HTTP-Antwort enthält einen Header mit dem Namen " X-Zencoder-Rate-Remaining". In dieser Kopfzeile wird die Anzahl der Anrufe aufgeführt, die Sie innerhalb des aktuellen Zeitrahmens an eine bestimmte Ressource tätigen können.

  Wenn Sie Ihr Kontingent überschreiten, Zencoder gibt einen 403-Fehler mit einem Text von " 403 Forbidden (Rate Limit Exceeded)". Wir senden auch einen zusätzlichen Header zurück, " Retry-After„, der die Anzahl der Sekunden enthält, bis Ihr Kontingent zurückgesetzt wird.

• Warum ist die Rate der API-Anforderungen begrenzt?

  Wir beschränken API-Anfragen auf eine angemessene Anzahl, um sicherzustellen, dass ein Kunde sie verwendet Zencoder wirkt sich nicht nachteilig auf andere Kunden aus. Ohne Ratenbegrenzung könnte ein Kunde unser System mit Anfragen überfluten, so dass ein anderer Kunde das System nicht nutzen kann. Dies geschieht regelmäßig aus Versehen, wenn Kunden zum ersten Mal mit einer API arbeiten. Ein einfacher Programmierfehler kann die API mit Anforderungen überfluten, die der Kunde nicht senden möchte.

  Solange Ihre Anwendung ordnungsgemäß eingerichtet ist, sollte die Ratenbegrenzung kein Problem darstellen. Wenn wir einen 403 mit "Rate Limit Exceeded" im Text zurückgeben, wiederholen Sie Ihre Anfrage einfach nach dem angegebenen Zeitraum.

  Wenn Sie feststellen, dass Sie regelmäßig an diese Grenzen stoßen, kontaktiere uns um Ihr Setup und Ihre Optionen zu besprechen.