fokkezb / audiorecorder

Titanium audio recorder module for Android

AudioRecorder Module

Description

Android module for record audio in different format like(mp4,3gp) without using intent.

Permission

This module needs following permissions

<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_INTERNAL_STORAGE" />

Note: These permissions already added in timodule.xml, so no need to add in tiapp.xml

Features

• Support mp4 and 3gp formats
• Support for different audio encoders
• Option to stop recording process by specifying maxFileSize and maxDuration
• Save files in external storage
• Method to check whether audio recorder
• Success and error callback methods

Accessing the AudioRecorder Module

To access this module from JavaScript, you would do the following:

var audioRecorder = require("titutorial.audiorecorder");

The audiorecorder variable is a reference to the Module object.

Reference

Based on Android MediaRecorder http://developer.android.com/reference/android/media/MediaRecorder.html

Methods

startRecording()

Method to start the audio recording process.

Parameters

Property	Description	Default
outputFormat	required out put file format either audioRecorder.OutputFormat_MPEG_4 or audioRecorder.OutputFormat_THREE_GPP	audioRecorder.OutputFormat_THREE_GPP
audioEncoder	required audio encoder type audioRecorder.AudioEncoder_AAC, audioRecorder.AudioEncoder_AMR_NB, audioRecorder.AudioEncoder_AMR_WB, audioRecorder.AudioEncoder_DEFAULT	audioRecorder.AudioEncoder_AMR_NB
directoryName	output directory name(directory will be created with this name in SD card)	audio_recorder
fileName	output file name	Default file name is current timestamp
maxFileSize	maximum filesize (in bytes) of the recording session	-
maxDuration	maximum duration (in ms) of the recording session.(optional)	-
success	callback function to handle success	-
error	callback function to handle error response	-

startRecording()

Method to start the audio recording process

isRecording()

Method to check recording process

getMaxAmplitude()

Method to check amplitude of microphone input

Usage

audioRecorder.startRecording({
	outputFormat : audioRecorder.OutputFormat_THREE_GPP,
	audioEncoder : audioRecorder.AudioEncoder_AMR_NB,
	directoryName : "testdir",
	fileName : "testfile",
	maxFileSize : 7000,
	success : function(e) {
		alert("success => " + e.filePath);
		Ti.API.info("response is => " + JSON.stringify(e));

		var audioDir = Titanium.Filesystem.getFile(Titanium.Filesystem.externalStorageDirectory, "testdir");
		var audioFile = Ti.Filesystem.getFile(audioDir.resolve(), e.fileName);
		Ti.API.info("audioFile.nativePath = " + audioFile.nativePath);
		audioPlayer.url = audioFile.nativePath;
	},
	error : function(d) {
		alert("error => " + e.message);
		Ti.API.info("error is => " + JSON.stringify(d));
	}
});

refer example/app.js for more info

Todo

• Local storage option

Author

Karthi Ponnusamy - [email protected]

License

Copyright (c) 2013 titaniumtutorial.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.