benz-amr-recorder

The project is currently in a maintenance state. The author is no longer actively involved in audio-related projects and has not performed major updates recently. The underlying core library, amr.js, is also infrequently updated. Pull Requests (PRs) are welcome from the community.

Recent Updates (2022-09-26):

• Verified compatibility with Webpack and Babel via create-react-app scaffolding.
• Added functionality to unbind events.
• Added a destroy() method to clean up instances.

You cannot change the audio source on an existing BenzAMRRecorder instance. To use a different audio file, you must create a new instance using new BenzAMRRecorder() and initialize it with the new source.

To prevent memory leaks, especially in memory-intensive applications, call amr.destroy() on the old instance before discarding it. This clears internal AMR and PCM data and unbinds all events.

You can install the library via npm or include the minified JS file directly in your HTML.

Using npm:

npm install benz-amr-recorder

Using a script tag:

<script type="text/javascript" src="./BenzAMRRecorder.min.js"></script>

If the browser supports the MP3 format, you can use this library to reformat an MP3 file into an AMR file.

var amrFromMp3 = new BenzAMRRecorder();
amrFromMp3.initWithUrl('path/to/file.mp3').then(function() {
  // Download the AMR file
  window.location.href = window.URL.createObjectURL(amrFromMp3.getBlob());
})

To record audio and save it as an AMR file, initialize the recorder for recording and then start the recording process.

var amrRec = new BenzAMRRecorder();
amrRec.initWithRecord().then(function() {
  amrRec.startRecord();
});

You can play AMR files selected by a user via an <input type="file"> element by using initWithBlob().

<input type="file" id="amr-file" accept=".amr">

var amr = new BenzAMRRecorder();
var amrFileObj = document.getElementById('amr-file');

amrFileObj.onchange = function() {
  amr.initWithBlob(this.files[0]).then(function() {
    amr.play();
  });
}

To play an existing AMR file, initialize the recorder with the file URL and then call play().

Important: Due to browser autoplay policies (Chrome 70+, iOS), you should trigger initWithXXX() or play() methods within a user-initiated event like click or touchstart.

var amr = new BenzAMRRecorder();
amr.initWithUrl('path/to/voice.amr').then(function() {
  amr.play();
});

amr.onEnded(function() {
  alert('play ended');
});

You can play local files by passing a Blob from an <input type="file"> to initWithBlob(blob).

<input type="file" id="amr-file" accept=".amr">

<script>
var amr = new BenzAMRRecorder();
var amrFileObj = document.getElementById('amr-file');
amrFileObj.onchange = function() {
  amr.initWithBlob(this.files[0]).then(function() {
    amr.play();
  });
}
</script>

If the browser natively supports MP3, you can use initWithUrl(url) with an MP3 path to load it, then use getBlob() to get the converted AMR file.

var amrFromMp3 = new BenzAMRRecorder();
amrFromMp3.initWithUrl('path/to/file.mp3').then(function() {
  // 下载 amr 文件
  window.location.href = window.URL.createObjectURL(amrFromMp3.getBlob());
})

To record audio, initialize the recorder using initWithRecord() and then call startRecord(). Once finished, call finishRecord() to convert the recording into an AMR format.

var amrRec = new BenzAMRRecorder();
amrRec.initWithRecord().then(function() {
  amrRec.startRecord();
});

After recording or converting, you can retrieve the AMR data as a Blob using getBlob() and trigger a download via window.URL.createObjectURL().

window.location.href = window.URL.createObjectURL(amr.getBlob());