Standardiser l’audio uploadé pour une lecture fiable

En un coup d’œil

Comment le flux s’articule

Un upload pris en charge devient un fichier cohérent et lisible en quatre étapes gérées. Le traitement doit se terminer avant la lecture, donc votre application attend que la piste passe à ready puis demande la variante par nom.

Audio source pris en charge (WAV, FLAC, MP3, ...)
        |
        v
Upload vers AudioDN
        |
        v
AudioDN traite la piste           (track_status_id: processing)
        |
        v
Variante configurée générée       (track_status_id: ready)
        |
        v
Lire la même variante nommée sur web, mobile ou serveur

1. Configurez d’abord la sortie

La variante de transcoder est la fonctionnalité au cœur de cet exemple. Une variante est une recette réutilisable qui dit à AudioDN comment transformer tout upload pris en charge en une sortie spécifique. Configurez-la une fois et AudioDN génère cette même variante nommée pour les nouveaux uploads automatiquement — votre code n’a jamais à détecter ni traiter spécialement le codec source, et il demande toujours le résultat sous le même nom.

Pourquoi AAC à 128 kbps

AAC est un défaut pratique pour la lecture web et app générale : il est largement pris en charge par les navigateurs modernes, les OS mobiles et les lecteurs média, et 128 kbps offre un bon équilibre qualité, taille de fichier et performance de streaming pour l’écoute typique. AudioDN livre cette variante avec le type de contenu audio/aac. Si votre produit a besoin d’autres compromis, configurez un autre codec ou débit, ou ajoutez plus de variantes — voir Variant Types.

2. Uploader la source

Peu importe comment le fichier arrive — un master studio lossless, un mémo vocal compressé, ou ce qu’a produit le téléphone d’un auditeur. L’upload est une séquence courte et explicite : créer une session (optionnellement avec une piste imbriquée pour créer la première piste d’emblée), créer toute piste supplémentaire, PUT les octets vers l’URL d’upload de la piste, puis attendre que la piste soit ready.

POST /v1/upload_session                       -> upload_session_id
  (optional nested track object)               -> also track_id + track_upload.upload_url
POST /v1/upload/{upload_session_id}/track     -> track_upload.upload_url  (per additional file)
PUT  {track_upload.upload_url}                  (send the source bytes)
GET  /v1/track/{track_id}                       (poll until track_status_id = ready)
Request the configured variant                 (e.g. variants="aac")

Puis interrogez GET /v1/track/:track_id jusqu’à ce que track_status_id soit ready, ou écoutez un webhook de piste, avant de démarrer la lecture.

# COLLECTION_ID: uuid de la collection dans laquelle uploader
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 de la collection dans laquelle uploader

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 de la collection dans laquelle uploader

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 renvoyé par l’appel précédent
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 renvoyé par l’appel précédent

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 renvoyé par l’appel précédent

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()

# Après que create-track a renvoyé track_upload.upload_url, PUT les octets source.
# Tout format source pris en charge fonctionne, quelle que soit sa qualité ou son codec d'origine.
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. Lire la variante

Une fois la piste ready, chaque surface que votre produit livre demande exactement la même variante par nom et obtient exactement le même fichier prévisible — pas de détection de format, pas de cas particuliers par plateforme. Le chemin le plus rapide sur le web est le composant <audiodn-player> avec une clé Client-Side Player :

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>

Démo live

La piste hero de la page d’accueil, lue ici depuis sa seule variante aac standardisée.

Demander la même variante partout

Le lecteur est optionnel. Les applications web custom, mobiles, Flutter, natives et serveur peuvent créer une session de lecture et streamer l’URL signée renvoyée pour la même variante nommée, ou signer des URL de livraison directement pour la lecture backend.

• Site web / lecteur custom — intégrez <audiodn-player>, ou demandez le fichier pour votre propre UI. Voir le guide Web Integration.

• App mobile — créez une session de lecture demandant la variante aac depuis Swift, Kotlin ou Flutter, puis streamez l’URL signée avec n’importe quel lecteur audio de plateforme. Voir Mobile Integration.

• Serveur / API — signez des URL de livraison pour la lecture ou les téléchargements backend-to-backend. Voir Signed Delivery et l’ API Variants.

Plus d’options de lecteur (thèmes, tailles, playlists, pochette) : docs du composant Player.

Quand utiliser ce flux de travail

Utilisez-le dès que votre produit accepte de l’audio que vous ne contrôlez pas et a besoin qu’il se lise de façon cohérente. Cela couvre les uploads d’utilisateurs, d’artistes, de téléphones, de navigateurs, d’appareils d’enregistrement, de logiciels d’édition, de systèmes externes et de plusieurs outils de production à la fois.

Il convient aux plateformes musicales, podcasts, enregistrements vocaux, audio social, produits éducatifs, marketplaces, apps d’audio généré par IA et autres produits d’audio généré par les utilisateurs. Dans chaque cas AudioDN peut remplacer l’infrastructure custom que vous feriez autrement tourner : stockage d’upload, files de traitement, workers FFmpeg, stockage de sortie, signature de livraison et livraison de lecture.

Ce que cet exemple ne couvre pas

Cet exemple se concentre sur la production d’un format de lecture cohérent à partir d’uploads inconsistants. Les éléments suivants sont des capacités connexes mais distinctes, hors de ce flux de travail :

• Clips d’aperçu — extraits courts à seek restreint. Voir Lecteur de clip d’aperçu.
• Formes d’onde — variantes image ou vidéo de forme d’onde. Voir Variant Types.
• Variantes supplémentaires — débits ou codecs supplémentaires aux côtés de aac pour une livraison multi-qualité.
• Téléchargements lossless — proposer des téléchargements FLAC ou WAV à partir du même upload.
• Normalisation de loudness — AudioDN n’effectue pas de ciblage LUFS ni d’ajustement de gain ; ce flux standardise le format, pas le loudness.

FAQ

Checklist

• Une recette de variante de transcoder aac existe à 128 kbps (configurée une fois dans le tableau de bord, ou ajoutée à une seule piste via POST /v1/track/:track_id/variant).
• Un fichier source pris en charge a été uploadé — via l’API ou le composant <audiodn-uploader> — et a atteint track_status_id ready.
• Le lecteur est limité à la piste, demandant la variante aac avec une clé Client-Side Player.
• La même variante aac est demandée de façon cohérente sur les intégrations web, mobile et serveur.