Skip to content

Latest commit

 

History

History
63 lines (44 loc) · 2.71 KB

README.md

File metadata and controls

63 lines (44 loc) · 2.71 KB

Air Native Extension for mobile camera and gallery features (iOS + Android)

This is an Air native extension that allows you to display native UI to pick media (videos and images) from the gallery or take a picture/video with the camera on iOS and Android. It has been developed by FreshPlanet.

Usage

```actionscript
// Take a picture/video with the camera
if (AirImagePicker.getInstance().isCameraAvailable())
{
    AirImagePicker.getInstance().displayCamera(function(status:String, ...mediaArgs):void {
        // Do something with the Media information returned
    });
}

// Pick an image from the gallery
if (AirImagePicker.getInstance().isImagePickerAvailable())
{
    AirImagePicker.getInstance().displayImagePicker(function(status:String, ...mediaArgs):void {
        // Do something with the Media information returned
    });
}
```

In the manifestAdditions section of your AIR app manifest, include this in the application element:

<activity
  android:name="com.freshplanet.ane.AirImagePicker.AirImagePickerActivity"
  android:configChanges="orientation|keyboard|keyboardHidden|screenSize|screenLayout|fontScale"
/>

The "configChanges" attribute fixes crashes when returning to the app on some Samsung devices.

Advanced features available: square cropping, custom positioning for the gallery image picker on iPad, custom overlay to avoid white screen when loosing Stage3D context.

For more information, please look at the Actionscript documentation in AirImagePicker.as.

Installation

The ANE binary (AirBurstly.ane) is located in the bin folder. You should add it to your application project's Build Path and make sure to package it with your app (more information here).

Build script

Should you need to edit the extension source code and/or recompile it, you will find an ant build script (build.xml) in the build folder:

cd /path/to/the/ane/build
mv example.build.config build.config
#edit the build.config file to provide your machine-specific paths
ant

Authors

This ANE has been written by Alexis Taugeron and Daniel Rodriguez. It belongs to FreshPlanet Inc. and is distributed under the Apache Licence, version 2.0.