Skip to content

michalstocki/FlashWavRecorder

Repository files navigation

Simple Microphone Recorder

Use flash to record audio data from a microphone. Converts the audio data to a WAV file. Uploads the WAV file to the server. The WAV file is POSTed as a multpart form-data request. Additional fields can be added to the request, such as authenticity_token, (response) formart, etc... The flash recorder creates serveral external interfaces. This allows the recorder to be controlled through javascript. Only the save button must be clicked inside the flash application, see Upload and download require user interaction for more information.

Demo

There are two pages demonstrating embedding the audio recorder:

Embedding the Recorder

<script>
  window.fwr_event_handler = function(eventName) {
    // handling logic here
  }
  var appWidth = 24;
  var appHeight = 24;
  var flashvars = {'upload_image': 'images/upload.png'};
  var params = {};
  var attributes = {'id': "recorderApp", 'name':  "recorderApp"};
  swfobject.embedSWF("recorder.swf", "flashcontent", appWidth, appHeight, "10.1.0", "", flashvars, params, attributes);
</script>

The fwr_event_handler is a javascript function that is called from the flash application. The first argument to the function is always the name of the event as a string. The other arguments may vary depending on the event.

Flash vars

upload_image: image used as the save button

font_color: font color for the save text, default #0000EE

font_size: font size for the save text, default 12

save_text: text used for the save link, default Save

background_color: background color of the flash app, only used when using a save link

if upload_image failes recorder will use a save link instead

Flash Events

ready: recorder is ready for use

  • width - save button's width
  • height - save button's height

no_microphone_found: no microphone was found when trying to record

microphone_user_request: user needs to allow the recorder to access the microphone

microphone_connected: user allowed access to the microphone

microphone_not_connected: user denied access to the microphone, at this point the recorder CAN NOT be used until the user reloads the page

permission_panel_closed: user closed permission dialog

Recording

recording: recording audio data from the microphone

  • name - of the recording that was specified when record was called

recording_stopped: stopped recording audio data

  • name - of the recording that was specified when record was called
  • duration - of the recording as a floating point value in seconds

Playback

playing: playing back the recorded audio data

  • name - of the recording that was specified when play was called

playback_started: useful for synchronizing playback with animation

  • name - of the recording that was specified when play was called
  • latency - number of milliseconds before playback starts

stopped: stopped playing back the recorded audio data

  • name - of the recording that was specified when play was called

playing_paused: paused playing the recorded audio

  • name - of the recording which was playing

Uploading recorded audio

save_pressed: save button was pressed in the recorder, good place to update the form data in the recorder

  • name - of the recording

saving: upload is in progress

  • name - of the recording

saved: upload is complete

  • name - of the recording
  • response - from the server as a string, can use var data = jQuery.parseJSON(arguments[2]) if response is json

save_failed: the recorder failed to upload the audio data

  • name - of the recording
  • error - message as a string

save_progress: upload progress

  • name - of the recording
  • bytes_loaded - number of bytes uploaded
  • bytes_total - number of bytes to upload

Observing microphone level

observing_level: started dispatching "microphone_level" event

Is dispatched just after call of observeLevel

microphone_level: current Microphone level

  • level - value from 0 to 1 provides current volume of sound registered by microphone

observing_level_stopped: stopped dispatching "microphone_level" event

Is dispatched just after call of stopObservingLevel

Obtaining raw microphone samples

observing_samples: started dispatching "microphone_samples" event

Is dispatched just after call of observeSamples

microphone_samples: current buffer of microphone samples

  • samples - array of values from -1 to 1

observing_samples_stopped: stopped dispatching "microphone_samples" event

Is dispatched just after call of stopObservingSamples

Recorder JS Interface

record: tells the recorder to record audio data from the microphone

  • name - of the recording, basically a reference to the recording, use this name for playback
  • filename - [optional] if saving the file on the server, this is the name of the file to save the WAV file as

stopRecording: tells the recorder to stop recording

playBack: tells the recorder to playback the recorded audio

  • name - of the recording

playBackFrom: tells the recorder to playback from given second in recorded audio

  • name - of the recording
  • time - point in recording to start playback (Float of seconds).

pausePlayBack: tells the recorder to pause playback of recorded audio

  • name - of the recording

stopPlayBack: tells the recorder to stop playback

duration: returns the duration of the recording

  • name - of the recording

getCurrentTime: returns current time in recording playback

  • name - of the recording

getBase64: returns WAV data of recording in form of Base64 string

  • name - of the recording

getBlob: returns WAV data of recording in form of Blob object which can be used to send recorded audio to server (via JavaScript) or save on user's local drive

  • name - of the recording

Returns number of seconds as float. For paused recording returns pause position, for stopped recording returns 0.

observeLevel: starts dispatching microphone_level events

stopObservingLevel: stops dispatching microphone_level events

observeSamples: starts dispatching microphone_samples events

stopObservingSamples: stops dispatching microphone_samples events

init: setup the recorder for saving recordings

  • url - upload url
  • field_name - name of the form field for the WAV file
  • form_data - additional form data. Specified as an array of name/value pairs. ex: [{"name": 'authenticity_token', "value": "xxxx"}, {"name": "format", "value": "json"}]

showPermissionWindow: show the permissions dialog for microphone access. The function also enlarges flash object to be 240x160 (the minimum size of flash application which allows displaying settings dialog).

The function called with {permanent: true} option, displays flash settings dialog with "Remember" option, which allow granting permanent microphone access for the site.

show: show the save button

hide: hide the save button

update: update the form data

  • form_data - additional form data, in jQuery you can use $('#upload_form').serializeArray()

configure: configure microphone settings

  • rate - at which the microphone captures sound, in kHz. default is 22. Currently we only support 44 and 22.
  • gain - the amount by which the microphone should multiply the signal before transmitting it. default is 100
  • silence_level - amount of sound required to activate the microphone and dispatch the activity event. default is 0
  • silence_timeout - number of milliseconds between the time the microphone stops detecting sound and the time the activity event is dispatched. default is 4000

setUseEchoSuppression: use echo suppression

  • yes_no

setLoopBack: routes audio captured by a microphone to the local speakers

  • yes_no

isMicrophoneAccessible: returns true if microphone is connected and user has allowed use microphone.

Gradle Build

Set environment variable FLEX_HOME (compiled with Flex SDK 4.6.0 on windows)

Build with gradlew dist

Change Log

Releases history is available on FlashWavRecorder releases page.

Support & Sponsors

Code quality improved by

IntelliJ IDEA logo