Air for Android: Microphone
Plugging into mobile devices allows for so many more possibilities that weren’t previously. In the case of mobile phones you also have a microphone attached to the device that you can now plug into.
This uses the same API and programming strategies as AIR2. If you already know if you can skip this post. If not, this will be a good post for both Air for Android and Air2+ programming techniques.
Unlike using the microphone in the web you won’t need to request microphone access from the user to use this feature. Just make sure that you have access!
If you are starting with this post I recommend actually starting with a previous post introducing AIR for Android Development. There is a ANT file there that you will want to have.
Microphone Method
As with many other Air techniques you need to check that you have access to the microphone before you access the microphone.
if(Microphone.isSupported)
{
_mic = Microphone.getMicrophone();
}
{
_mic = Microphone.getMicrophone();
}
Once you know you can access the microphone you can listen to updates from the microphone.
_mic.addEventListener(SampleDataEvent.SAMPLE_DATA, _onMic_SampleHandler);
...
private function _onMic_SampleHandler(event:SampleDataEvent):void
{
_level = _mic.activityLevel;
}
...
private function _onMic_SampleHandler(event:SampleDataEvent):void
{
_level = _mic.activityLevel;
}
Remember to keep your rate appropriate. This will effect the amount of data being pulled into your application. If you are storing the input this will make a big difference.
Microphone Application
package
{
import flash.display.Sprite;
import flash.display.StageAlign;
import flash.display.StageScaleMode;
import flash.events.AccelerometerEvent;
import flash.events.ActivityEvent;
import flash.events.Event;
import flash.events.SampleDataEvent;
import flash.media.Microphone;
import flash.net.URLRequest;
import flash.net.navigateToURL;
import flash.sensors.Accelerometer;
import flash.system.Security;
import flash.text.TextField;
/**
* Android testing application.
*
* @author jonbcampos
*
*/
public class GetMicrophone extends Sprite
{
//---------------------------------------------------------------------
//
// Constructor
//
//---------------------------------------------------------------------
public function GetMicrophone()
{
//setup stage
stage.scaleMode = StageScaleMode.NO_SCALE;
stage.align = StageAlign.TOP_LEFT;
//add handlers
addEventListener(Event.ADDED_TO_STAGE, _onAddedToStage);
}
//---------------------------------------------------------------------
//
// Private Properties
//
//---------------------------------------------------------------------
private var _mic:Microphone;
private var _level:Number;
private var _col:Sprite;
//---------------------------------------------------------------------
//
// Protected Methods
//
//---------------------------------------------------------------------
protected function createChildren():void
{
if(!_col)
{
_createCol();
_col.x = width*0.125;
_col.y = height*0.125;
addChild(_col);
}
}
//---------------------------------------------------------------------
//
// Handler Methods
//
//---------------------------------------------------------------------
private function _onAddedToStage(event:Event):void
{
//removes listener
removeEventListener(Event.ADDED_TO_STAGE, _onAddedToStage);
//draws background
_draw();
//creates children
createChildren();
//
_setupMicrophone();
//
addEventListener(Event.ENTER_FRAME, _onEnterFrame);
}
private function _onMic_SampleHandler(event:SampleDataEvent):void
{
_level = _mic.activityLevel;
}
private function _onEnterFrame(event:Event):void
{
_col.scaleY = _level/100;
}
//---------------------------------------------------------------------
//
// Private Methods
//
//---------------------------------------------------------------------
private function _draw():void
{
graphics.clear();
graphics.beginFill(0xFFFFFF,1);
graphics.drawRect(0, 0, 480, 762);
graphics.endFill();
}
private function _createCol():void
{
_col = new Sprite();
_col.graphics.clear();
_col.graphics.beginFill(0x0000FF, 0.8);
_col.graphics.drawRect(0, 0, width*0.75, height*0.75);
_col.graphics.endFill();
}
private function _setupMicrophone():void
{
if(Microphone.isSupported)
{
_mic = Microphone.getMicrophone();
_mic.setLoopBack(false);
_mic.rate = 44;
_mic.gain = 100;
_mic.setUseEchoSuppression(true);
_mic.addEventListener(SampleDataEvent.SAMPLE_DATA, _onMic_SampleHandler);
}
}
}
}
{
import flash.display.Sprite;
import flash.display.StageAlign;
import flash.display.StageScaleMode;
import flash.events.AccelerometerEvent;
import flash.events.ActivityEvent;
import flash.events.Event;
import flash.events.SampleDataEvent;
import flash.media.Microphone;
import flash.net.URLRequest;
import flash.net.navigateToURL;
import flash.sensors.Accelerometer;
import flash.system.Security;
import flash.text.TextField;
/**
* Android testing application.
*
* @author jonbcampos
*
*/
public class GetMicrophone extends Sprite
{
//---------------------------------------------------------------------
//
// Constructor
//
//---------------------------------------------------------------------
public function GetMicrophone()
{
//setup stage
stage.scaleMode = StageScaleMode.NO_SCALE;
stage.align = StageAlign.TOP_LEFT;
//add handlers
addEventListener(Event.ADDED_TO_STAGE, _onAddedToStage);
}
//---------------------------------------------------------------------
//
// Private Properties
//
//---------------------------------------------------------------------
private var _mic:Microphone;
private var _level:Number;
private var _col:Sprite;
//---------------------------------------------------------------------
//
// Protected Methods
//
//---------------------------------------------------------------------
protected function createChildren():void
{
if(!_col)
{
_createCol();
_col.x = width*0.125;
_col.y = height*0.125;
addChild(_col);
}
}
//---------------------------------------------------------------------
//
// Handler Methods
//
//---------------------------------------------------------------------
private function _onAddedToStage(event:Event):void
{
//removes listener
removeEventListener(Event.ADDED_TO_STAGE, _onAddedToStage);
//draws background
_draw();
//creates children
createChildren();
//
_setupMicrophone();
//
addEventListener(Event.ENTER_FRAME, _onEnterFrame);
}
private function _onMic_SampleHandler(event:SampleDataEvent):void
{
_level = _mic.activityLevel;
}
private function _onEnterFrame(event:Event):void
{
_col.scaleY = _level/100;
}
//---------------------------------------------------------------------
//
// Private Methods
//
//---------------------------------------------------------------------
private function _draw():void
{
graphics.clear();
graphics.beginFill(0xFFFFFF,1);
graphics.drawRect(0, 0, 480, 762);
graphics.endFill();
}
private function _createCol():void
{
_col = new Sprite();
_col.graphics.clear();
_col.graphics.beginFill(0x0000FF, 0.8);
_col.graphics.drawRect(0, 0, width*0.75, height*0.75);
_col.graphics.endFill();
}
private function _setupMicrophone():void
{
if(Microphone.isSupported)
{
_mic = Microphone.getMicrophone();
_mic.setLoopBack(false);
_mic.rate = 44;
_mic.gain = 100;
_mic.setUseEchoSuppression(true);
_mic.addEventListener(SampleDataEvent.SAMPLE_DATA, _onMic_SampleHandler);
}
}
}
}
Microphone Application Descriptor
No descriptor changes are necessary for this feature, just thought I’d include it.
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/2.5">
<!-- Adobe AIR Application Descriptor File Template.
Specifies parameters for identifying, installing, and launching AIR applications.
xmlns - The Adobe AIR namespace: http://ns.adobe.com/air/application/2.5
The last segment of the namespace specifies the version
of the AIR runtime required for this application to run.
minimumPatchLevel - The minimum patch level of the AIR runtime required to run
the application. Optional.
-->
<!-- A universally unique application identifier. Must be unique across all AIR applications.
Using a reverse DNS-style name as the id is recommended. (Eg. com.example.ExampleApplication.) Required. -->
<id>com.unitedmindset.GetMicrophone</id>
<!-- Used as the filename for the application. Required. -->
<filename>GetMicrophone</filename>
<!-- The name that is displayed in the AIR application installer.
May have multiple values for each language. See samples or xsd schema file. Optional. -->
<name>GetMicrophone</name>
<!-- A string value of the format <0-999>.<0-999>.<0-999> that represents application version which can be used to check for application upgrade.
Values can also be 1-part or 2-part. It is not necessary to have a 3-part value.
An updated version of application must have a versionNumber value higher than the previous version. Required for namespace >= 2.5 . -->
<versionNumber>1.0.0</versionNumber>
<!-- A string value (such as "v1", "2.5", or "Alpha 1") that represents the version of the application, as it should be shown to users. Optional. -->
<!-- <versionLabel></versionLabel> -->
<!-- Description, displayed in the AIR application installer.
May have multiple values for each language. See samples or xsd schema file. Optional. -->
<!-- <description></description> -->
<!-- Copyright information. Optional -->
<!-- <copyright></copyright> -->
<!-- Publisher ID. Used if you're updating an application created prior to 1.5.3 -->
<!-- <publisherID></publisherID> -->
<!-- Settings for the application's initial window. Required. -->
<initialWindow>
<!-- The main SWF or HTML file of the application. Required. -->
<!-- Note: In Flash Builder, the SWF reference is set automatically. -->
<content>[This value will be overwritten by Flash Builder in the output app.xml]</content>
<!-- The title of the main window. Optional. -->
<!-- <title></title> -->
<!-- The type of system chrome to use (either "standard" or "none"). Optional. Default standard. -->
<!-- <systemChrome></systemChrome> -->
<!-- Whether the window is transparent. Only applicable when systemChrome is none. Optional. Default false. -->
<!-- <transparent></transparent> -->
<!-- Whether the window is initially visible. Optional. Default false. -->
<visible>true</visible>
<!-- Whether the user can minimize the window. Optional. Default true. -->
<!-- <minimizable></minimizable> -->
<!-- Whether the user can maximize the window. Optional. Default true. -->
<!-- <maximizable></maximizable> -->
<!-- Whether the user can resize the window. Optional. Default true. -->
<!-- <resizable></resizable> -->
<!-- The window's initial width in pixels. Optional. -->
<width>480</width>
<!-- The window's initial height in pixels. Optional. -->
<height>762</height>
<!-- The window's initial x position. Optional. -->
<!-- <x></x> -->
<!-- The window's initial y position. Optional. -->
<!-- <y></y> -->
<!-- The window's minimum size, specified as a width/height pair in pixels, such as "400 200". Optional. -->
<!-- <minSize></minSize> -->
<!-- The window's initial maximum size, specified as a width/height pair in pixels, such as "1600 1200". Optional. -->
<!-- <maxSize></maxSize> -->
</initialWindow>
<!-- We recommend omitting the supportedProfiles element, -->
<!-- which in turn permits your application to be deployed to all -->
<!-- devices supported by AIR. If you wish to restrict deployment -->
<!-- (i.e., to only mobile devices) then add this element and list -->
<!-- only the profiles which your application does support. -->
<!-- <supportedProfiles>desktop extendedDesktop mobileDevice extendedMobileDevice</supportedProfiles> -->
<!-- The subpath of the standard default installation location to use. Optional. -->
<!-- <installFolder></installFolder> -->
<!-- The subpath of the Programs menu to use. (Ignored on operating systems without a Programs menu.) Optional. -->
<!-- <programMenuFolder></programMenuFolder> -->
<!-- The icon the system uses for the application. For at least one resolution,
specify the path to a PNG file included in the AIR package. Optional. -->
<icon>
<image16x16>assets/icon16.png</image16x16>
<image32x32>assets/icon32.png</image32x32>
<image36x36>assets/icon36.png</image36x36>
<image48x48>assets/icon48.png</image48x48>
<image72x72>assets/icon72.png</image72x72>
<image128x128>assets/icon128.png</image128x128>
</icon>
<!-- Whether the application handles the update when a user double-clicks an update version
of the AIR file (true), or the default AIR application installer handles the update (false).
Optional. Default false. -->
<!-- <customUpdateUI></customUpdateUI> -->
<!-- Whether the application can be launched when the user clicks a link in a web browser.
Optional. Default false. -->
<!-- <allowBrowserInvocation></allowBrowserInvocation> -->
<!-- Listing of file types for which the application can register. Optional. -->
<!-- <fileTypes> -->
<!-- Defines one file type. Optional. -->
<!-- <fileType> -->
<!-- The name that the system displays for the registered file type. Required. -->
<!-- <name></name> -->
<!-- The extension to register. Required. -->
<!-- <extension></extension> -->
<!-- The description of the file type. Optional. -->
<!-- <description></description> -->
<!-- The MIME content type. -->
<!-- <contentType></contentType> -->
<!-- The icon to display for the file type. Optional. -->
<!-- <icon>
<image16x16></image16x16>
<image32x32></image32x32>
<image48x48></image48x48>
<image128x128></image128x128>
</icon> -->
<!-- </fileType> -->
<!-- </fileTypes> -->
<!-- Specify Android specific tags that get passed to AndroidManifest.xml file. -->
<android>
<manifestAdditions>
<![CDATA[
<manifest android:installLocation="auto">
<!-- Added for Internet and debugging support -->
<uses-permission android:name="android.permission.INTERNET"/>
<!-- Added for Geolocation support -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- Added for NetworkInfo Support -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- Added for Camera Support -->
<uses-permission android:name="android.permission.CAMERA" />
<!-- Added for Microphone Support -->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<!-- Added to keep Android Device Awake -->
<uses-permission android:name="android.permission.WAKE_LOCK" />
<!-- Added to keep Android Device from Locking -->
<uses-permission android:name="android.permission.DISABLE_KEYGUARD" />
<!-- -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-configuration android:reqFiveWayNav="true"/>
<supports-screens android:normalScreens="true"/>
<uses-feature android:required="true" android:name="android.hardware.touchscreen.multitouch"/>
<application android:enabled="true">
<activity android:excludeFromRecents="false">
<intent-filter>
<action android:name="android.intent.action.MAIN"/>
<category android:name="android.intent.category.LAUNCHER"/>
</intent-filter>
</activity>
</application>
</manifest>
]]>
</manifestAdditions>
</android>
<!-- End of the schema for adding the android specific tags in AndroidManifest.xml file -->
</application>
<application xmlns="http://ns.adobe.com/air/application/2.5">
<!-- Adobe AIR Application Descriptor File Template.
Specifies parameters for identifying, installing, and launching AIR applications.
xmlns - The Adobe AIR namespace: http://ns.adobe.com/air/application/2.5
The last segment of the namespace specifies the version
of the AIR runtime required for this application to run.
minimumPatchLevel - The minimum patch level of the AIR runtime required to run
the application. Optional.
-->
<!-- A universally unique application identifier. Must be unique across all AIR applications.
Using a reverse DNS-style name as the id is recommended. (Eg. com.example.ExampleApplication.) Required. -->
<id>com.unitedmindset.GetMicrophone</id>
<!-- Used as the filename for the application. Required. -->
<filename>GetMicrophone</filename>
<!-- The name that is displayed in the AIR application installer.
May have multiple values for each language. See samples or xsd schema file. Optional. -->
<name>GetMicrophone</name>
<!-- A string value of the format <0-999>.<0-999>.<0-999> that represents application version which can be used to check for application upgrade.
Values can also be 1-part or 2-part. It is not necessary to have a 3-part value.
An updated version of application must have a versionNumber value higher than the previous version. Required for namespace >= 2.5 . -->
<versionNumber>1.0.0</versionNumber>
<!-- A string value (such as "v1", "2.5", or "Alpha 1") that represents the version of the application, as it should be shown to users. Optional. -->
<!-- <versionLabel></versionLabel> -->
<!-- Description, displayed in the AIR application installer.
May have multiple values for each language. See samples or xsd schema file. Optional. -->
<!-- <description></description> -->
<!-- Copyright information. Optional -->
<!-- <copyright></copyright> -->
<!-- Publisher ID. Used if you're updating an application created prior to 1.5.3 -->
<!-- <publisherID></publisherID> -->
<!-- Settings for the application's initial window. Required. -->
<initialWindow>
<!-- The main SWF or HTML file of the application. Required. -->
<!-- Note: In Flash Builder, the SWF reference is set automatically. -->
<content>[This value will be overwritten by Flash Builder in the output app.xml]</content>
<!-- The title of the main window. Optional. -->
<!-- <title></title> -->
<!-- The type of system chrome to use (either "standard" or "none"). Optional. Default standard. -->
<!-- <systemChrome></systemChrome> -->
<!-- Whether the window is transparent. Only applicable when systemChrome is none. Optional. Default false. -->
<!-- <transparent></transparent> -->
<!-- Whether the window is initially visible. Optional. Default false. -->
<visible>true</visible>
<!-- Whether the user can minimize the window. Optional. Default true. -->
<!-- <minimizable></minimizable> -->
<!-- Whether the user can maximize the window. Optional. Default true. -->
<!-- <maximizable></maximizable> -->
<!-- Whether the user can resize the window. Optional. Default true. -->
<!-- <resizable></resizable> -->
<!-- The window's initial width in pixels. Optional. -->
<width>480</width>
<!-- The window's initial height in pixels. Optional. -->
<height>762</height>
<!-- The window's initial x position. Optional. -->
<!-- <x></x> -->
<!-- The window's initial y position. Optional. -->
<!-- <y></y> -->
<!-- The window's minimum size, specified as a width/height pair in pixels, such as "400 200". Optional. -->
<!-- <minSize></minSize> -->
<!-- The window's initial maximum size, specified as a width/height pair in pixels, such as "1600 1200". Optional. -->
<!-- <maxSize></maxSize> -->
</initialWindow>
<!-- We recommend omitting the supportedProfiles element, -->
<!-- which in turn permits your application to be deployed to all -->
<!-- devices supported by AIR. If you wish to restrict deployment -->
<!-- (i.e., to only mobile devices) then add this element and list -->
<!-- only the profiles which your application does support. -->
<!-- <supportedProfiles>desktop extendedDesktop mobileDevice extendedMobileDevice</supportedProfiles> -->
<!-- The subpath of the standard default installation location to use. Optional. -->
<!-- <installFolder></installFolder> -->
<!-- The subpath of the Programs menu to use. (Ignored on operating systems without a Programs menu.) Optional. -->
<!-- <programMenuFolder></programMenuFolder> -->
<!-- The icon the system uses for the application. For at least one resolution,
specify the path to a PNG file included in the AIR package. Optional. -->
<icon>
<image16x16>assets/icon16.png</image16x16>
<image32x32>assets/icon32.png</image32x32>
<image36x36>assets/icon36.png</image36x36>
<image48x48>assets/icon48.png</image48x48>
<image72x72>assets/icon72.png</image72x72>
<image128x128>assets/icon128.png</image128x128>
</icon>
<!-- Whether the application handles the update when a user double-clicks an update version
of the AIR file (true), or the default AIR application installer handles the update (false).
Optional. Default false. -->
<!-- <customUpdateUI></customUpdateUI> -->
<!-- Whether the application can be launched when the user clicks a link in a web browser.
Optional. Default false. -->
<!-- <allowBrowserInvocation></allowBrowserInvocation> -->
<!-- Listing of file types for which the application can register. Optional. -->
<!-- <fileTypes> -->
<!-- Defines one file type. Optional. -->
<!-- <fileType> -->
<!-- The name that the system displays for the registered file type. Required. -->
<!-- <name></name> -->
<!-- The extension to register. Required. -->
<!-- <extension></extension> -->
<!-- The description of the file type. Optional. -->
<!-- <description></description> -->
<!-- The MIME content type. -->
<!-- <contentType></contentType> -->
<!-- The icon to display for the file type. Optional. -->
<!-- <icon>
<image16x16></image16x16>
<image32x32></image32x32>
<image48x48></image48x48>
<image128x128></image128x128>
</icon> -->
<!-- </fileType> -->
<!-- </fileTypes> -->
<!-- Specify Android specific tags that get passed to AndroidManifest.xml file. -->
<android>
<manifestAdditions>
<![CDATA[
<manifest android:installLocation="auto">
<!-- Added for Internet and debugging support -->
<uses-permission android:name="android.permission.INTERNET"/>
<!-- Added for Geolocation support -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- Added for NetworkInfo Support -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- Added for Camera Support -->
<uses-permission android:name="android.permission.CAMERA" />
<!-- Added for Microphone Support -->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<!-- Added to keep Android Device Awake -->
<uses-permission android:name="android.permission.WAKE_LOCK" />
<!-- Added to keep Android Device from Locking -->
<uses-permission android:name="android.permission.DISABLE_KEYGUARD" />
<!-- -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-configuration android:reqFiveWayNav="true"/>
<supports-screens android:normalScreens="true"/>
<uses-feature android:required="true" android:name="android.hardware.touchscreen.multitouch"/>
<application android:enabled="true">
<activity android:excludeFromRecents="false">
<intent-filter>
<action android:name="android.intent.action.MAIN"/>
<category android:name="android.intent.category.LAUNCHER"/>
</intent-filter>
</activity>
</application>
</manifest>
]]>
</manifestAdditions>
</android>
<!-- End of the schema for adding the android specific tags in AndroidManifest.xml file -->
</application>
All cool, but how to record a sound coming from a speaker?
@ozren you can easily get the sound sample and save it as you see fit. What issues are you having?
Hi,
This is really cool.
How can I create an example in Flash Professional using this.
Can you share one example here.
@pcs The Flash Professional example would be really simple, just add the listeners to the stage and you should be good to go.
Thanks for your response.
Is there any example which I can follow using Flash Professional?
@pcs for microphone there is not. Have you looked at: http://unitedmindset.com/jonbcampos/2010/07/20/creating-a-flash-professional-android-project/
Hey Jonathan. I haven’t tried your example yet, but in my experience so far I can’t actually get data from the Android device unless I add this to the application descriptor file:
<![CDATA[
]]>
The “Record Audio” permission is the one that seems to be especially important.
That app descriptor xml is:
<android
<manifestAdditions
<![CDATA[
<manifest
!– See the Adobe AIR documentation for more information about setting Google Android permissions –
<uses-permission android:name="android.permission.INTERNET"/
<uses-permission android:name="android.permission.RECORD_AUDIO"/
</manifestAdditions
</android
</application
@RJ
Great find. Thats what I get for just including all permissions for my test app and not seeing what taking a few away will do. Thanks for the comment.