Hochgeladenes Audio für zuverlässige Wiedergabe standardisieren

Auf einen Blick

So fügt sich der Workflow zusammen

Ein unterstützter Upload wird in vier verwalteten Schritten zu einer konsistenten, abspielbaren Datei. Die Verarbeitung muss vor der Wiedergabe abgeschlossen sein, daher wartet deine Anwendung, bis die Spur ready ist, und fordert dann die Variante per Name an.

Unterstütztes Quell-Audio (WAV, FLAC, MP3, ...)
        |
        v
Zu AudioDN hochladen
        |
        v
AudioDN verarbeitet die Spur       (track_status_id: processing)
        |
        v
Konfigurierte Variante erzeugt     (track_status_id: ready)
        |
        v
Dieselbe benannte Variante auf Web, Mobil oder Server abspielen

1. Zuerst die Ausgabe konfigurieren

Die Transcode-Variante ist das Feature, um das es in diesem Beispiel wirklich geht. Eine Variante ist ein wiederverwendbares Rezept, das AudioDN sagt, wie jeder unterstützte Upload in eine bestimmte Ausgabe umgewandelt wird. Einmal konfiguriert, erzeugt AudioDN automatisch dieselbe benannte Variante für neue Uploads — dein Code muss den Quell-Codec nie erkennen oder besonders behandeln und fordert das Ergebnis immer unter demselben Namen an.

Warum AAC mit 128 kbps

AAC ist ein praktischer Standard für allgemeine Web- und App-Wiedergabe: Es wird von modernen Browsern, mobilen Betriebssystemen und Mediaplayern breit unterstützt, und 128 kbps bietet ein nützliches Gleichgewicht aus Qualität, Dateigröße und Streaming-Performance für typisches Hören. AudioDN liefert diese Variante mit dem Content-Type audio/aac aus. Wenn dein Produkt andere Kompromisse braucht, konfiguriere einen anderen Codec oder eine andere Bitrate oder füge weitere Varianten hinzu — siehe Variant Types.

2. Die Quelle hochladen

Es spielt keine Rolle, wie die Datei ankommt — ein verlustfreies Studio-Master, eine komprimierte Sprachnotiz oder was das Telefon eines Hörers erzeugt hat. Der Upload ist eine kurze, explizite Sequenz: Session erstellen (optional mit verschachteltem Track, um die erste Spur sofort anzulegen), weitere Spuren anlegen, Bytes per PUT an die Upload-URL der Spur senden, dann warten, bis die Spur ready ist.

POST /v1/upload_session                       -> upload_session_id
  (optionales verschachteltes track-Objekt)    -> auch track_id + track_upload.upload_url
POST /v1/upload/{upload_session_id}/track     -> track_upload.upload_url  (pro zusätzlicher Datei)
PUT  {track_upload.upload_url}                  (Quell-Bytes senden)
GET  /v1/track/{track_id}                       (pollen, bis track_status_id = ready)
Konfigurierte Variante anfordern               (z. B. variants="aac")

Polle dann GET /v1/track/:track_id, bis track_status_id ready ist, oder höre auf einen Track-Webhook, bevor du die Wiedergabe startest.

# COLLECTION_ID: uuid of the collection to upload into
curl -X POST "https://api.audiodelivery.net/v1/upload_session" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "collection_id": "COLLECTION_ID",
  "expires_in": 7200
}'

// COLLECTION_ID: uuid of the collection to upload into

const payload = {
  "collection_id": "COLLECTION_ID",
  "expires_in": 7200
};

const response = await fetch('https://api.audiodelivery.net/v1/upload_session', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload)
});

const data = await response.json();

# COLLECTION_ID: uuid of the collection to upload into

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "collection_id": "COLLECTION_ID",
    "expires_in": 7200
}

response = requests.post(
    "https://api.audiodelivery.net/v1/upload_session",
    headers=headers,
    json=payload,
)
data = response.json()

# SESSION_ID: upload_session_id returned by the previous call
curl -X POST "https://api.audiodelivery.net/v1/upload/SESSION_ID/track" \
  -H "Content-Type: application/json" \
  -d '{
  "file_name": "track.wav"
}'

// SESSION_ID: upload_session_id returned by the previous call

const payload = {
  "file_name": "track.wav"
};

const response = await fetch('https://api.audiodelivery.net/v1/upload/SESSION_ID/track', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload)
});

const data = await response.json();

# SESSION_ID: upload_session_id returned by the previous call

import requests

headers = {
    "Content-Type": "application/json",
}

payload = {
    "file_name": "track.wav"
}

response = requests.post(
    "https://api.audiodelivery.net/v1/upload/SESSION_ID/track",
    headers=headers,
    json=payload,
)
data = response.json()

# Nachdem create-track track_upload.upload_url zurückgibt, PUT der Quell-Bytes.
# Jedes unterstützte Quellformat funktioniert — unabhängig von ursprünglicher Qualität oder Codec.
curl -X PUT "$UPLOAD_URL" \
  --data-binary @track.wav \
  -H "Content-Type: audio/wav"

npm install @audiodn/components

<script type="module" src="https://unpkg.com/@audiodn/components@latest/dist/uploader.js"></script>

<script type="module">
import '@audiodn/components/uploader';
</script>

<audiodn-uploader
api-key="YOUR_UPLOAD_API_KEY"
collection-id="COLLECTION_ID"
></audiodn-uploader>

3. Die Variante abspielen

Sobald die Spur ready ist, fordert jede Oberfläche, die dein Produkt ausliefert, exakt dieselbe Variante per Name an und erhält exakt dieselbe vorhersehbare Datei — ohne Format-Erkennung, ohne plattformspezifische Sonderfälle. Der schnellste Weg im Web ist die Komponente <audiodn-player> mit einem Client-Side-Player-Schlüssel:

npm install @audiodn/components

<script type="module" src="https://unpkg.com/@audiodn/components@latest/dist/player.js"></script>

<script type="module">
  import '@audiodn/components/player';
</script>

<audiodn-player
  api-key="YOUR_PLAYER_API_KEY"
  scope="track"
  id="TRACK_ID"
  variants="aac"
  size="regular"
></audiodn-player>

Live-Demo

Die Hero-Spur der Homepage, hier aus ihrer einzigen standardisierten aac-Variante abgespielt.

Dieselbe Variante überall anfordern

Der Player ist optional. Eigene Web-, Mobil-, Flutter-, Native- und Server-Anwendungen können eine Play-Session erstellen und die zurückgegebene signierte URL für dieselbe benannte Variante streamen oder Delivery-URLs direkt für Backend-Wiedergabe signieren.

• Website / eigener Player — <audiodn-player> einbetten oder die Datei für deine eigene UI anfordern. Siehe den Leitfaden Web Integration.

• Mobile App — eine Play-Session erstellen, die die aac-Variante aus Swift, Kotlin oder Flutter anfordert, dann die signierte URL mit jedem Plattform-Audioplayer streamen. Siehe Mobile Integration.

• Server / API — Delivery-URLs für Backend-zu-Backend-Wiedergabe oder Downloads signieren. Siehe Signed Delivery und die Variants API.

Weitere Player-Optionen (Themes, Größen, Playlists, Cover-Art): Player component docs.

Wann dieser Workflow passt

Greife darauf zurück, wann immer dein Produkt Audio akzeptiert, das du nicht kontrollierst, und es konsistent wiedergeben muss. Das umfasst Uploads von Nutzern, Künstlern, Telefonen, Browsern, Aufnahmegeräten, Bearbeitungssoftware, externen Systemen und mehreren Produktionswerkzeugen gleichzeitig.

Es passt zu Musikplattformen, Podcasts, Sprachaufnahmen, Social Audio, Bildungsprodukten, Marktplätzen, Apps mit KI-generiertem Audio und anderen Produkten mit nutzergeneriertem Audio. In jedem Fall kann AudioDN die eigene Infrastruktur ersetzen, die du sonst betreiben würdest: Upload-Speicher, Verarbeitungsqueues, FFmpeg-Worker, Ausgabespeicher, Delivery-Signing und Wiedergabe-Auslieferung.

Was dieses Beispiel nicht abdeckt

Dieses Beispiel konzentriert sich darauf, aus inkonsistenten Uploads ein einheitliches Wiedergabeformat zu erzeugen. Folgendes sind verwandte, aber separate Fähigkeiten und nicht Teil dieses Workflows:

• Preview-Clips — kurze, seek-beschränkte Ausschnitte. Siehe Preview clip player.
• Waveforms — Waveform-Bild- oder Video-Varianten. Siehe Variant Types.
• Zusätzliche Varianten — weitere Bitraten oder Codecs neben aac für Multi-Quality-Delivery.
• Verlustfreie Downloads — FLAC- oder WAV-Downloads aus demselben Upload anbieten.
• Loudness-Normalisierung — AudioDN führt kein LUFS-Targeting oder Gain-Anpassung durch; dieser Workflow standardisiert das Format, nicht die Lautheit.

FAQ

Checkliste

• Ein aac-Transcode-Varianten-Rezept existiert mit 128 kbps (einmal im Dashboard konfiguriert oder zu einer einzelnen Spur per POST /v1/track/:track_id/variant hinzugefügt).
• Eine unterstützte Quelldatei wurde hochgeladen — über die API oder die Komponente <audiodn-uploader> — und hat track_status_id ready erreicht.
• Der Player ist auf die Spur gescoped und fordert die aac-Variante mit einem Client-Side-Player-Schlüssel an.
• Dieselbe aac-Variante wird konsistent über Web-, Mobil- und Server-Integrationen angefordert.