Kullanıcıdan ses kaydetme

Birçok tarayıcı artık kullanıcının video ve ses girişine erişebilir. Ancak tarayıcıya bağlı olarak bu, tam dinamik ve satır içi bir deneyim olabilir veya kullanıcının cihazındaki başka bir uygulamaya devredilebilir.

Basit ve aşamalı olarak başlayın

En kolay yöntem, kullanıcıdan önceden kaydedilmiş bir dosya istemektir. Bunu yapmak için basit bir dosya girişi öğesi oluşturun ve yalnızca ses dosyalarını kabul edebileceğimizi belirten bir accept filtresi ve doğrudan mikrofondan almak istediğimizi belirten bir capture özelliği ekleyin.

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

Bu yöntem tüm platformlarda kullanılabilir. Masaüstünde, kullanıcıdan dosya sisteminden bir dosya yüklemesini ister (capture özelliğini yoksayar). iOS'te Safari'de mikrofon uygulamasını açarak ses kaydetmenize ve ardından web sayfasına geri göndermenize olanak tanır. Android'de ise kullanıcıya, sesi web sayfasına geri göndermeden önce hangi uygulamayı kullanacağını seçme imkanı verir.

Kullanıcı kaydı tamamlayıp web sitesine döndüğünde dosya verilerini bir şekilde almanız gerekir. Giriş öğesine bir onchange etkinliği ekleyip etkinlik nesnesinin files özelliğini okuyarak hızlı erişim sağlayabilirsiniz.

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

Dosyaya erişiminiz olduğunda dosyayla istediğiniz her şeyi yapabilirsiniz. Örneğin, şunları yapabilirsiniz:

  • Oynatabilmek için doğrudan bir <audio> öğesine ekleyin.
  • Kullanıcının cihazına indirin.
  • XMLHttpRequest öğesine ekleyerek sunucuya yükleme
  • Web Audio API'den geçirip filtreler uygulama

Ses verilerine erişmek için giriş öğesi yöntemini kullanmak yaygın olsa da en az cazip seçenektir. Mikrofona erişmek ve doğrudan sayfada iyi bir deneyim sunmak istiyoruz.

Mikrofona etkileşimli olarak erişme

Modern tarayıcılar, mikrofona doğrudan erişim sağlayarak web sayfasıyla tamamen entegre deneyimler oluşturmamıza olanak tanır ve kullanıcı tarayıcıdan hiç ayrılmaz.

Mikrofona erişim izni alma

WebRTC spesifikasyonunda getUserMedia() adlı bir API kullanarak mikrofona doğrudan erişebiliriz. getUserMedia(), kullanıcıdan bağlı mikrofon ve kameralarına erişim izni vermesini ister.

İşlem başarılı olursa API, kameradan veya mikrofondan gelen verileri içeren bir Stream döndürür. Ardından bu verileri bir <audio> öğesine, WebRTC akışına veya Web Audio AudioContext'ye ekleyebilir ya da MediaRecorder API'yi kullanarak kaydedebiliriz.

Mikrofondan veri almak için getUserMedia() API'sine iletilen kısıtlama nesnesinde audio: true değerini ayarlamanız yeterlidir.

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

Belirli bir mikrofonu seçmek istiyorsanız önce mevcut mikrofonları listeleyebilirsiniz.

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

Ardından, getUserMedia yöntemini çağırırken kullanmak istediğiniz deviceId değerini iletebilirsiniz.

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

Bu tek başına pek kullanışlı değildir. Tek yapabileceğimiz ses verilerini alıp oynatmaktır.

Mikrofondan ham verilere erişme

Mikrofondan gelen ham verilere erişmek için getUserMedia() tarafından oluşturulan akışı almamız ve ardından verileri işlemek için Web Audio API'yi kullanmamız gerekir. Web Audio API, giriş kaynaklarını alıp bu kaynakları ses verilerini işleyebilen (kazancı ayarlama vb.) düğümlere ve son olarak kullanıcının duyabilmesi için bir hoparlöre bağlayan basit bir API'dir.

Bağlayabileceğiniz düğümlerden biri AudioWorkletNode. Bu düğüm, özel ses işleme için alt düzey özellikler sunar. Asıl ses işleme, AudioWorkletProcessor içindeki process() geri çağırma yönteminde gerçekleşir. Girişleri ve parametreleri beslemek ve çıkışları almak için bu işlevi çağırın.

Daha fazla bilgi edinmek için Enter Audio Worklet başlıklı makaleyi inceleyin.

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

Arabelleklerde tutulan veriler, mikrofondan gelen ham verilerdir. Bu verilerle yapabileceğiniz birkaç işlem vardır:

  • Doğrudan sunucuya yükleme
  • Yerel olarak depolama
  • WAV gibi özel bir dosya biçimine dönüştürüp sunucularınıza veya yerel olarak kaydedin.

Mikrofondan gelen verileri kaydetme

Mikrofondan gelen verileri kaydetmenin en kolay yolu MediaRecorder API'sini kullanmaktır.

MediaRecorder API, getUserMedia tarafından oluşturulan akışı alır ve akıştaki verileri tercih ettiğiniz hedefe kademeli olarak kaydeder.

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

Bizim örneğimizde, verileri doğrudan bir diziye kaydediyoruz. Bu diziyi daha sonra Blob biçimine dönüştürebiliriz. Bu biçim, verileri web sunucumuza veya doğrudan kullanıcının cihazındaki depolama alanına kaydetmek için kullanılabilir.

Mikrofonu sorumlu bir şekilde kullanmak için izin isteme

Kullanıcı daha önce sitenize mikrofon erişimi vermediyse getUserMedia yöntemini çağırdığınız anda tarayıcı, kullanıcıdan sitenize mikrofon izni vermesini ister.

Kullanıcılar, makinelerindeki güçlü cihazlara erişim istenmesinden hoşlanmaz ve genellikle isteği engeller ya da istemin oluşturulduğu bağlamı anlamazlarsa yok sayarlar. Mikrofona erişim iznini yalnızca ilk ihtiyaç duyulduğunda istemek en iyi uygulamadır. Kullanıcı erişim izni verdikten sonra tekrar izin istenmez. Ancak kullanıcı erişimi reddederse kullanıcıdan tekrar izin isteyemezsiniz.

Erişiminiz olup olmadığını kontrol etmek için Permissions API'yi kullanın.

getUserMedia API'si, mikrofona erişiminiz olup olmadığı konusunda bilgi vermez. Bu durum bir sorun yaratır. Kullanıcının mikrofona erişim izni vermesini sağlayacak güzel bir kullanıcı arayüzü sunmak için mikrofona erişim izni istemeniz gerekir.

Bu sorun, bazı tarayıcılarda Permission API kullanılarak çözülebilir. navigator.permission API'si, tekrar istemde bulunmak zorunda kalmadan belirli API'lere erişme özelliğinin durumunu sorgulamanıza olanak tanır.

Kullanıcının mikrofonuna erişiminiz olup olmadığını sorgulamak için sorgu yöntemine {name: 'microphone'} değerini iletebilirsiniz. Bu yöntem şunlardan birini döndürür:

  • granted: Kullanıcı daha önce mikrofona erişim izni vermiştir.
  • prompt: Kullanıcı size erişim izni vermemiştir ve getUserMedia numaralı telefonu aradığınızda kullanıcıdan izin istenir.
  • denied: Sistem veya kullanıcı, mikrofona erişimi açıkça engelledi ve mikrofona erişemeyeceksiniz.

Kullanıcının yapması gereken işlemleri karşılamak için kullanıcı arayüzünüzü değiştirmeniz gerekip gerekmediğini hızlıca kontrol edebilirsiniz.

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 () {};
});

Geri bildirim