Audior can be installed on any web server with PHP or .NET. Ruby can also be used through the Ruby scripts (alternatives to our own PHP scripts) posted on this thread.
The mobile version of Audior works only on web servers with PHP support.
On the client side, the desktop version of Audior needs Flash Player 11.1 or newer and it works on all browsers supporting Flash Player including Internet Explorer, Firefox, Chrome, Safari and Opera.
Audior does not need a media server like Red5 or Wowza or AMS to run or record audio.
We include a free installation of Audior with every purchase.
To install it please send us the FTP details for your website after purchase. Our tech support team will take care of the installation for you. Once the installation is performed we'll send you an e-mail with a quick overview of your new Audior installation.
When recording from desktop:
The MP3 files will be saved by Audior in the
Audior/recordings folder on your website. You can change the folder in which Audior saves the MP3 files by editing
Audior/upload.aspx.cs depending on the one you're using.
When recording from mobile devices:
Recordings made using mobile devices are saved in
Audior ships with 2 config files:
You will find them both in the Audior installation folder. Both output XML content.
By default audior_settings.xml is used but both contain the same options including:
Open audior_settings.xml and audior_settings.php in a text editor to view the complete list of config options.
To make a change, edit the PHP or XML file with a text editor, make the desired change and upload it back to your website.
index.html and set
Every time an event happens in Audior a JS function is called in the embedding HTML file. You can use these callbacks to trigger for example the start of a YouTube video in the HTML page, when the RECORD button is pressed inside Audior.
|JS function name||Event|
|btRecordClick(recorderId)||the RECORD button is released|
|btStopClick(recorderId)||the STOP button is released|
|btPlayClick(recorderId)||the PLAY button is released|
|btPauseClick(recorderId)||the PAUSE button is released|
|btSaveClick(recordDuration,recorderId)||the SAVE button is released|
|btDownloadClick(recorderId)||the DOWNLOAD button is released|
|btPauseRecordingClick(recorderId)||the PAUSE RECORDING button is released|
|btResumeRecordingClick(recorderId)||the RESUME RECORDING button is released|
|onRecordingPlaybackStopped(recorderId)||The recording has stopped playing.|
|onEncodingDone(duration, recorderId)||Audior has finished the encoding of the audio data to mp3.|
|onUploadDone(success, recordName, duration, recorderId)||the MP3 has finished uploading to the web server|
|onMicAccess(allowed,recorderId)||the user clicked Allow or Deny in the Privacy panel dialog box in Flash Player|
|onFlashReady(recorderId)||as soon as this function is called you can communicate with Audior using the JS Control API|
recorderId is a flash var sent to Audior.swf that is passed back to all JS the callbacks . You can use it to identify the Audior instance when you have 2 or more instances of Audior on the same HTML page. The
recorderId is also passed as a GET variable to the upload script (upload.php or upload.aspx) and to the settings file (audior_settings.xml or audior_settings.php).
recordName is the final name of the MP3 file incluing the .mp3 extension .
duration is the length of the recording in seconds but very accurate like this: 3.1362358276643 (3 seconds)
You will find the above JS functions and more documentation on each one in the index.html file with which Audior ships.
The 4 control functions are:
In the Audior archive you will find an index.html filw which already implements the JS Control API using 4 input buttons:
Every time the [Save] button is pressed inside Audior the upload.php (or upload.aspx) is executed on the web server. This file handles the actual upload of the mp3 file but it also receives some variables are via GET:
You can extend the upload server side script to:
The userId GET variable that is passed to this file needs to be passed to Audior.swf using flash vars. Look for this code
flashvars.userId ="User234"in index.html.
The recorderId GET variable that is passed to this file needs to be passed to Audior.swf using flash vars. Look for this code
flashvars.recorderId = "REC1"in index.html. The recorderId allows you to have 2 or more audio recorders on the HTML page. When one of them makes a call to the JS function you can use the recorderId to track which one called the function.
You can switch the upload script used by the desktop version of Audior (Audior.swf) to upload the MP3 file to the web server.
By default the upload script used is the upload.php file. PHP is the most commonly used server side scripting language.
To force Audior to use upload.aspx, edit your config file (audior_settings.xml is the default one but audior_settings.php can also be used, here's how to change to it ) in a text editor and set
uploadURL to upload.aspx.
Audior's size in the HTML page is given by the HTML code that embeds the Audior.swf in the HTML page.
Regarding it's height: Audior can not be smaller than 140px in height because that's how high the Adobe Privacy Panel is (the one that asks the user for access to the mic). In adition the Audior interface is currently fixed in height at 140px, using a higher height will result in empty space;
Regarding it's width: Audior can scale it's width indefinitely. To resize it's width:
Audior ships with 600px in width. Here are 2 resized versions, one with a width of 400px:
and the other with a width of 900px:
Starting with Audior 1.3 (build 112) recording also works from mobile browsers like Safari on iOS and Internet/Chrome on Android. When it detects a mobile browser, Audior switches to the mobile HTML audio recording solution which allows the user to record audio using the device's native audio recording apps. Once the recording is complete it is uploaded to the web sever.
Since various mobile devices record to different file formats including .mov, .mp4 and .3gp Audior uses FFmpeg server side to convert them to .mp3. FFmpeg is not packed with Audior which is why it needs to be manually uploaded to the Audior folder as explained in the next secion.
Audior will use the native Voice Recorder application. The resulted file will be uploaded on your server and converted using FFmpeg
Since on iOS browsers are not able to use the native Audio Recording application, Audior will use the default Camera app to record a video. The video is then uploaded to the server and FFmpeg will extract and convert just the audio track
Recording using Audior on mobile devices is different in several ways: