Page History
Ist Nachdem Sie die URL zur neu erzeugten Video Entität ermitteltUpload-URL generiert haben, können Sie nun das jetzt Ihr Video hochladen. Hierbei bestehen folgende Optionen:
Dies erfolgt mit der Chunked-Upload-Methode mit Retry-Handling.
Response
200 - OK
"Chunked" Upload
Für den "Chunked" Upload müssen Sie im Header folgendes defineren:
"Chunked Upload
Beispiel
Code Block | ||||
---|---|---|---|---|
| ||||
curl -X POST |
-H "Mi24-Upload-Total-Chunks: 10" -H "Mi24-Upload-Current-Chunk: 1" -H "Content-Type:application/octet-stream" --data-binary "@/<FILENAME>" "<UPLOAD_URL>" |
URL | Beschreibung |
---|---|
UPLOAD_URL | Die vollständige Upload-URL. Beachten Sie, dass der Sicherheitstoken als Parameter enthalten sein muss. |
Headers (Kopfzeilen) | |
Mi24-Upload-Total-Chunks | Gesamtanzahl der Chunks. Das obige Beispiel verwendet 10 Chunks. |
Mi24-Upload-Current-Chunk |
Panel | ||
---|---|---|
| ||
curl -X POST https://file-1-a.video-cdn.net/jshdfkjhdfgjh/987876565423?__token__=abc123 |
Response für den Request
202 - Accepted
Response, wenn der Upload vollständig ausgeführt wurde
Aktuelle Chunk-Nummer, beginnend mit 1. Das obige Beispiel ist der erste Chunk von insgesamt 10. | |
Content-Type | Geben Sie "application/octet-stream" als Content-Type an, wie im obigen Beispiel. |
Befehlszeilenoptionen | |
---|---|
--data-binary <@/FILENAME> | Laden Sie die Datei als Binärdaten hoch und stellen Sie sicher, dass der Dateiname mit "@" beginnt. Geben Sie dann den Dateinamen (und gegebenenfalls den Pfad) der lokalen Videodatei an, die hochgeladen werden soll. |
Info |
---|
Sie müssten die obige Beispielanfrage 10 Mal senden und dabei den aktuellen Chunk jedes Mal erhöhen. Sie können Ihre Datei in so vielen oder wenigen Chunks hochladen, wie Sie möchten, obwohl die Chunk-Größe in der Regel zwischen 2 und 10 MB liegen sollte. Durch die Verwendung einer größeren Anzahl kleinerer Chunks und die Implementierung von Retry-Handling (siehe nächster Abschnitt) können Sie einen reibungsloseren und zuverlässigeren Upload Ihrer Videos erwarten. |
Antwortcodes
Erfolgreicher Upload eines einzelnen Chunks. Der gesamte Upload ist erst abgeschlossen, wenn Sie diesen Status für alle Chunks erhalten. Wenn Sie diesen Code für einen hochgeladenen Chunk nicht erhalten, lesen Sie unten "Retry-Handling". Status colour Green title 201 CREATED
Das Video-Chunk wurde bereits hochgeladen. Dieser Antwortcode wird zurückgegeben, wenn der Chunk bereits erfolgreich hochgeladen wurde. Status colour Green title 200 OK
Client-side Fehler. Antwortcode, wenn der Server eine Client-Anfrage aufgrund von Autorisierungsfehlern, Authentifizierungsfehlern oder schlecht formatierten Anfragen ablehnt. Status colour Red title 4xx ERROR
Serverseitiger Fehler. Antwortcodes, wenn der Server eine Anfrage nicht verarbeiten konnte. Status colour Red title 5xx ERROR
Wenn Sie diese Antwort erhalten, bedeutet dies, dass Ihr Upload abgelehnt wurde, da Sie die Grenzen Ihrer gebuchten Speicherkapazität erreicht haben. Status colour Yellow title 1101
Retry-Handling
Wenn die Antwort auf eine Chunk-Upload-Anforderung nicht oder lautet, muss der Chunk erneut hochgeladen werden.
Dies kann aus verschiedenen Gründen geschehen, wie z. B.:
Fehler in der Verbindung über das Internet
Abgelaufener Upload-Token
Rate-Limitierung
Timeout beim Empfang einer Antwort von der API
Um zu vermeiden, dass diese Situationen Ihren Upload unterbrechen, empfehlen wir dringend, Retry-Handling in Ihren Code zu implementieren.
Eine gute Strategie für Retry-Handling besteht darin, zwischen jedem Fehler eine zunehmend längere oder zufällige Zeit zu warten. Es gibt mehrere Optionen, zum Beispiel:
- Warten Sie 1 Sekunde, dann 2, dann 3... erhöhen Sie dabei jedes Mal um eine Sekunde.
- Warten Sie 1 Sekunde, dann 2, dann 3, 5, 8, 13... Erhöhung unter Verwendung einer Fibonacci-Folge.
- Warten Sie zwischen 1 und 5 Sekunden, zufällig ausgewählt.
Unabhängig von der Methode sollten Sie eine Grenze für die Anzahl der Wiederholungen festlegen. Manchmal sind die Ursachen für das Versagen mehr als vorübergehend und keine Menge an Wiederholungen wird erfolgreich sein.
Java 11 Chunk Upload Beispiel
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
package mi.uploader;
import java.io.*;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
public class App {
public static Integer CHUNK_SIZE = 2_097_152;
public static Integer MAX_RETRIES = 10;
public static HttpClient client = HttpClient.newBuilder()
.version(HttpClient.Version.HTTP_1_1)
.followRedirects(HttpClient.Redirect.NORMAL)
.connectTimeout(Duration.ofSeconds(20))
.build();
public static void main(String[] args) throws IOException, InterruptedException {
/*
Step 1. https://doc.movingimage.com/display/LT/Creating+a+Video+Entity
Step 2. https://doc.movingimage.com/display/LT/Getting+the+Upload+URL
Step 3. Upload
*/
URI url = URI.create("{URL obtained via API}");
File f = new File("sample_600s_25fps_1080.mp4");
InputStream inputStream = new FileInputStream(f);
long totalChunks = calculateChunks(f.length());
for (int i = 1; i <= totalChunks; i++) {
byte[] data = new byte[CHUNK_SIZE];
inputStream.read(data);
int statusCode = 0;
int retryAttempts = 0;
do {
if (statusCode >= 500) {
Thread.sleep(2000);
}
if (retryAttempts++ >= MAX_RETRIES) {
throw new RuntimeException("Upload failed. Please try again later.");
}
HttpRequest request = HttpRequest.newBuilder()
.POST(HttpRequest.BodyPublishers.ofByteArray(data))
.uri(url)
.setHeader("Mi24-Upload-Total-Chunks", String.valueOf(totalChunks)) // add request header
.setHeader("Mi24-Upload-Current-Chunk", String.valueOf(i)) // add request header
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
statusCode = response.statusCode();
System.out.println("Status: "+statusCode);
} while (statusCode >= 500);
}
System.out.println("Done");
}
public static long calculateChunks(long fileSize) {
long remainder = fileSize % CHUNK_SIZE;
int totalChunks = Math.toIntExact(fileSize / CHUNK_SIZE);
if (remainder > 0) {
totalChunks = totalChunks + 1;
}
return totalChunks;
}
} |