Enregistrement de l'audio de l'utilisateur

De nombreux navigateurs peuvent désormais accéder aux entrées vidéo et audio de l'utilisateur. Toutefois, selon le navigateur, il peut s'agir d'une expérience dynamique et intégrée complète, ou elle peut être déléguée à une autre application sur l'appareil de l'utilisateur.

Commencez simplement et progressivement

Le plus simple est de demander à l'utilisateur un fichier préenregistré. Pour ce faire, créez un élément d'entrée de fichier simple et ajoutez un filtre accept qui indique que nous ne pouvons accepter que les fichiers audio, ainsi qu'un attribut capture qui indique que nous voulons l'obtenir directement à partir du micro.

<input type="file" accept="audio/*" capture />

Cette méthode fonctionne sur toutes les plates-formes. Sur ordinateur, l'utilisateur est invité à importer un fichier à partir du système de fichiers (en ignorant l'attribut capture). Dans Safari sur iOS, l'application de micro s'ouvre, ce qui vous permet d'enregistrer du contenu audio, puis de le renvoyer vers la page Web. Sur Android, l'utilisateur peut choisir l'application à utiliser pour enregistrer le contenu audio avant de le renvoyer vers la page Web.

Une fois que l'utilisateur a terminé l'enregistrement et qu'il est de retour sur le site Web, vous devez récupérer les données du fichier. Vous pouvez y accéder rapidement en associant un événement onchange à l'élément d'entrée, puis en lisant la propriété files de l'objet d'événement.

<input type="file" accept="audio/*" capture id="recorder" />
<audio id="player" controls></audio>
  <script>
    const recorder = document.getElementById('recorder');
    const player = document.getElementById('player');

    recorder.addEventListener('change', function (e) {
      const file = e.target.files[0];
      const url = URL.createObjectURL(file);
      // Do something with the audio file.
      player.src = url;
    });
  </script>
</audio>

Une fois que vous avez accès au fichier, vous pouvez en faire ce que vous voulez. Par exemple, vous pouvez :

  • Associez-le directement à un élément <audio> pour pouvoir le lire.
  • Téléchargez-le sur l'appareil de l'utilisateur.
  • Importez-le sur un serveur en l'associant à un XMLHttpRequest.
  • Transmettez-le via l'API Web Audio et appliquez-lui des filtres.

Bien que l'utilisation de l'élément d'entrée pour accéder aux données audio soit omniprésente, c'est l'option la moins intéressante. Nous voulons vraiment accéder au micro et offrir une expérience agréable directement sur la page.

Accéder au micro de manière interactive

Les navigateurs récents peuvent avoir une ligne directe vers le micro, ce qui nous permet de créer des expériences entièrement intégrées à la page Web, sans que l'utilisateur n'ait à quitter le navigateur.

Obtenir l'accès au micro

Nous pouvons accéder directement au micro à l'aide d'une API de la spécification WebRTC appelée getUserMedia(). getUserMedia() demandera à l'utilisateur l'accès à ses micros et caméras connectés.

Si l'API réussit, elle renvoie un Stream qui contient les données de la caméra ou du micro. Nous pouvons ensuite l'associer à un élément <audio>, à un flux WebRTC ou à un AudioContext Web Audio, ou l'enregistrer à l'aide de l'API MediaRecorder.

Pour obtenir des données du micro, il suffit de définir audio: true dans l'objet de contraintes transmis à l'API getUserMedia().

<audio id="player" controls></audio>
<script>
  const player = document.getElementById('player');

  const handleSuccess = function (stream) {
    if (window.URL) {
      player.srcObject = stream;
    } else {
      player.src = stream;
    }
  };

  navigator.mediaDevices
    .getUserMedia({audio: true, video: false})
    .then(handleSuccess);
</script>

Si vous souhaitez choisir un micro en particulier, vous pouvez d'abord énumérer les micros disponibles.

navigator.mediaDevices.enumerateDevices().then((devices) => {
  devices = devices.filter((d) => d.kind === 'audioinput');
});

Vous pouvez ensuite transmettre le deviceId que vous souhaitez utiliser lorsque vous appelez getUserMedia.

navigator.mediaDevices.getUserMedia({
  audio: {
    deviceId: devices[0].deviceId,
  },
});

En soi, cela n'est pas très utile. Tout ce que nous pouvons faire, c'est prendre les données audio et les lire.

Accéder aux données brutes du micro

Pour accéder aux données brutes du micro, nous devons utiliser le flux créé par getUserMedia(), puis l'API Web Audio pour traiter les données. L'API Web Audio est une API simple qui prend des sources d'entrée et les connecte à des nœuds capables de traiter les données audio (ajuster le gain, etc.) et, enfin, à un haut-parleur pour que l'utilisateur puisse les entendre.

L'un des nœuds que vous pouvez connecter est un AudioWorkletNode. Ce nœud vous offre une fonctionnalité de bas niveau pour le traitement audio personnalisé. Le traitement audio réel s'effectue dans la méthode de rappel process() de AudioWorkletProcessor. Appelez cette fonction pour fournir des entrées et des paramètres, et récupérer des sorties.

Pour en savoir plus, consultez Enter Audio Worklet (en anglais).

<script>
  const handleSuccess = async function(stream) {
    const context = new AudioContext();
    const source = context.createMediaStreamSource(stream);

    await context.audioWorklet.addModule("processor.js");
    const worklet = new AudioWorkletNode(context, "worklet-processor");

    source.connect(worklet);
    worklet.connect(context.destination);
  };

  navigator.mediaDevices.getUserMedia({ audio: true, video: false })
      .then(handleSuccess);
</script>
// processor.js
class WorkletProcessor extends AudioWorkletProcessor {
  process(inputs, outputs, parameters) {
    // Do something with the data, e.g. convert it to WAV
    console.log(inputs);
    return true;
  }
}

registerProcessor("worklet-processor", WorkletProcessor);

Les données contenues dans les tampons sont les données brutes du micro. Vous disposez de plusieurs options pour les traiter :

  • Importez-le directement sur le serveur.
  • Stocker les données localement
  • Convertissez-le dans un format de fichier dédié, tel que WAV, puis enregistrez-le sur vos serveurs ou localement.

Enregistrer les données du micro

Le moyen le plus simple d'enregistrer les données du micro consiste à utiliser l'API MediaRecorder.

L'API MediaRecorder prend le flux créé par getUserMedia, puis enregistre progressivement les données du flux dans la destination de votre choix.

<a id="download">Download</a>
<button id="stop">Stop</button>
<script>
  const downloadLink = document.getElementById('download');
  const stopButton = document.getElementById('stop');


  const handleSuccess = function(stream) {
    const options = {mimeType: 'audio/webm'};
    const recordedChunks = [];
    const mediaRecorder = new MediaRecorder(stream, options);

    mediaRecorder.addEventListener('dataavailable', function(e) {
      if (e.data.size > 0) recordedChunks.push(e.data);
    });

    mediaRecorder.addEventListener('stop', function() {
      downloadLink.href = URL.createObjectURL(new Blob(recordedChunks));
      downloadLink.download = 'acetest.wav';
    });

    stopButton.addEventListener('click', function() {
      mediaRecorder.stop();
    });

    mediaRecorder.start();
  };

  navigator.mediaDevices.getUserMedia({ audio: true, video: false })
      .then(handleSuccess);
</script>

Dans notre cas, nous enregistrons les données directement dans un tableau que nous pouvons ensuite transformer en Blob, qui peut ensuite être utilisé pour enregistrer les données sur notre serveur Web ou directement dans l'espace de stockage de l'appareil de l'utilisateur.

Demander l'autorisation d'utiliser le micro de manière responsable

Si l'utilisateur n'a pas encore autorisé votre site à accéder au micro, le navigateur l'invite à le faire dès que vous appelez getUserMedia.

Les utilisateurs n'aiment pas être invités à accéder à des appareils puissants sur leur machine. Ils bloquent souvent la demande ou l'ignorent s'ils ne comprennent pas le contexte dans lequel l'invite a été créée. Il est recommandé de ne demander l'accès au micro que lorsque cela est nécessaire pour la première fois. Une fois que l'utilisateur a accordé l'accès, il n'est plus invité à le faire. Toutefois, s'il refuse l'accès, vous ne pouvez plus lui demander l'autorisation.

Utiliser l'API Permissions pour vérifier si vous disposez déjà d'un accès

L'API getUserMedia ne vous permet pas de savoir si vous avez déjà accès au micro. Cela vous pose un problème : pour fournir une interface utilisateur agréable permettant à l'utilisateur de vous accorder l'accès au micro, vous devez demander l'accès au micro.

Dans certains navigateurs, ce problème peut être résolu à l'aide de l'API Permission. L'API navigator.permission vous permet d'interroger l'état de la possibilité d'accéder à des API spécifiques sans avoir à demander à nouveau l'autorisation.

Pour savoir si vous avez accès au micro de l'utilisateur, vous pouvez transmettre {name: 'microphone'} à la méthode de requête. Elle renverra l'un des éléments suivants :

  • granted : l'utilisateur vous a déjà autorisé à accéder au micro.
  • prompt : l'utilisateur ne vous a pas accordé l'accès et sera invité à le faire lorsque vous appellerez getUserMedia.
  • denied : le système ou l'utilisateur a explicitement bloqué l'accès au micro, et vous ne pourrez pas y accéder.

Vous pouvez désormais vérifier rapidement si vous devez modifier votre interface utilisateur pour l'adapter aux actions que l'utilisateur doit effectuer.

navigator.permissions.query({name: 'microphone'}).then(function (result) {
  if (result.state == 'granted') {
  } else if (result.state == 'prompt') {
  } else if (result.state == 'denied') {
  }
  result.onchange = function () {};
});

Commentaires