alex-zhang / Air-Mobile-Extensions

Collection of AIR 3.0 Native Extensions for Android and iOS

AIR Mobile Extensions

These libraries provides different AIR 3 Native Extension adapters for the Android platform. powered by Powerflasher GmbH

Use cases:

• Extending the AIR API with additional hardware features of Android device
• Using services which can't be accessed via the AIR API itself

Available Native Extensions

Sensors

• AmbientLight Sensor (Android)
• Barometer Sensor (Android)
• Gravity Sensor (Android)
• Gyroscope Sensor (Android)
• Magnetometer Sensor (Android)
• Orientation Sensor (Android)
• Proximity Sensor (Android)

OS Features

• Battery Status (Android)
• Toast Messages (Android)
• Vibrator Hardware (Android / iOS)
• Notifications (Android)

Dependencies

• compiled against Android 2.2 (API Level 8), some need Android 2.3.3 (API Level 9)
• compiled against iOS 4.2 SDK
• AIR 3.0 SDK

Usage

Download

Download the prefered Extension from the Extension_Android _*_Interface directory of the extension. I've also added the source files from native code in case you want to change the implementation for yourself.

Installation

• Copy the '.swc' file from the /extension folder into your library folder and add it to your project classpath.
• Copy the '.ane' file from the /extension folder into your project folder
• Add the content of the 'descriptor_extensions.xml' into your application-descriptor.xml file
• Add all necessary permissions into your application-descriptor.xml file

API Usage

After adding the.swc file to your project path you've access to the containing classes. The implementation of the different services is straight forwarded and orients oneself by the Adobe AIR API of the Geolocation and Accelerometer class.

In case you want to check whether a service is available or not you should use the static method isSupported() before initializing the instance.

E.g.

if (Vibrator.isSupported())
{
	var vibrator : Vibrator = new Vibrator();
	vibrator.vibrate(200);
}

if (Proximity.isSupported())
{
	proximity = new Proximity();
	proximity.setRequestedUpdateInterval(1000);
	proximity.addEventListener(ProximityEvent.UPDATE, handleProximityUpdate);
}

You can dispose all Services via:

proximity.dispose();

More information in the wiki.

Packaging

Make sure you've added the .ane files during the packaging process of your .apk file.

E.g. via ANT

<arg value="-extdir" />
<arg value="/ane-dir" />

Change log

v 1.0

• [Added] Vibrator Service (iOS)

v 0.9

• [Added] Notification Support (Android)

v 0.8

• [Added] Toast Messages (Android)
• [Added] Gravity Sensor (Android)

v 0.7

• [Added] Pressure/Barometer Sensor (Android)
• [Added] Magnetometer Sensor (Android)

v 0.6

• [Added] Battery status (Android)

v 0.5

• [Added] Gyroscope Sensor (Android)
• [Added] cancel() method for the Vibrator class

v 0.4

• [Added] getMaximumRange(), getPower() and getResolution() implementation for the Proximity, Orientation and AmbientLight sensors

v 0.3

• [Modified] Project structure (Android)

v 0.2

• [Fix] Now each Sensor can be initiated multiple times, e.g. to use different intervals to retrieved sensor updates
• [Modified] Renamed all *Service classes into *, e.g. ProximityService > Proximity

v 0.1

• [Added] Ambient Light Sensor (Android)
• [Added] Orientation Sensor (Android)
• [Added] Proximity Sensor (Android)
• [Added] Vibrator Service (Android)

Roadmap

• Add additional Documentation of each service

• Add Unit Tests

• Add equivalent iOS implementations