BaseMobileTasks-ane

破晓 · 发表于 2015-4-8 16:02:53

本帖最后由破晓于 2015-4-8 17:05 编辑

获取OS版本字符串
显示文本显示（Android Toast）
设置全屏（Android Immersive mode）
分享图像（用户选择安装的应用程序（如Facebook或Twitter）与共享图片）
振动设备

Air Native Extension for Performing Base Tasks on Mobile Devices

This is an (Android only atm) ane for performing base tasks on device.

Supported Tasks

Get OS Version String
Show Text Display (Android Toast)
Set Full Screen (Android Immersive mode)
Share Image (User selects an installed app (e.g. Facebook or Twitter) to share image with)
Device Vibration

Build

Compiled .swc and .ane files are included in the bin directory, but to perform a clean build; set the properties in build.properties.template appropriately, change its name to build.properties and run the default ant target in build.xml in the root directory.

Usage

The BaseMobileTasks Actionscript class is a Singleton instance and should be accessed withBaseMobileTasks.instance. Before doing so it is recommended to first check if it is supported on the current platform with the static method BaseMobileTasks.isSupported().

To get the OS Version:

if (BaseMobileTasks.isSupported())
// version = e.g. '5.0.1' - may also be null, so should check before using
var osVersion:String = BaseMobileTasks.instance.getOSVersion();

复制代码

To display a text message (Toast text):

if (BaseMobileTasks.isSupported())
// May also use BaseMobileTasks.TEXT_DISPLAY_SHORT
BaseMobileTasks.instance.showTextDisplay("Hello World", BaseMobileTasks.TEXT_DISPLAY_LONG);

复制代码

To go into full screen (note: requires Android 4.4 or higher):

if (BaseMobileTasks.isSupported())
{
var actualScreenDimensions:Array = BaseMobileTasks.instance.setFullscreen();
if (actualScreenDimensions != null)
{
var actualWidth:int = actualScreenDimensions[0];
var actualHeight:int = actualScreenDimensions[1];
}
else
{
// Either an error has occurred or user is on an Android device less than 4.4. You could check with getOSVersion() 1st if desired.
// Store screen width and height another way (e.g. stage.fullScreenWidth && stage.fullScreenHeight)
}
}

复制代码

To share an image, first save the image to a public directory (I recommend creating an appropriately named folder within File.userDirectory) on the device then send its path to the ane like so:

private function ShareImage(image:BitmapData)
{
// can't share
if (!BaseMobileTasks.isSupported())
return;
var file:File = File.userDirectory.resolvePath("MyApp" + File.separator + "imageName.jpg");
var imageBytes:ByteArray = image.encode(image.rect, new JPEGEncoderOptions(80));
var stream:FileStream = new FileStream();
stream.open(file, FileMode.WRITE);
stream.writeBytes(imageBytes);
stream.close();
BaseMobileTasks.instance.addEventListener(BaseMobileTaskEvent.IMAGE_SHARED, onImageShared);
BaseMobileTasks.instance.addEventListener(BaseMobileTaskEvent.SHARE_IMAGE_ERROR, onImageShareErr);
var title:String = "Share Image from MyApp!";
BaseMobileTasks.instance.shareImage(file.nativePath, title);
}
private function onImageShared(e:BaseMobileTaskEvent):void
{
// important to remove event listeners from Singleton instance
BaseMobileTasks.instance.removeEventListener(BaseMobileTaskEvent.IMAGE_SHARED, onImageShared);
BaseMobileTasks.instance.removeEventListener(BaseMobileTaskEvent.SHARE_IMAGE_ERROR, onImageShareErr);
// User has been presented with a list of apps to share with. He or she may still decide not to share.
}
private function onImageShareErr(e:BaseMobileTaskEvent):void
{
// important to remove event listeners from Singleton instance
BaseMobileTasks.instance.removeEventListener(BaseMobileTaskEvent.IMAGE_SHARED, onImageShared);
BaseMobileTasks.instance.removeEventListener(BaseMobileTaskEvent.SHARE_IMAGE_ERROR, onImageShareErr);
trace("Could not share image: " + e.reason);
}

复制代码

To vibrate device:

if (BaseMobileTasks.isSupported())
// If vibration is supported on device, device will vibrate for 250 milliseconds
BaseMobileTasks.instance.vibrate(250);

复制代码

Installation

Include the .swc file in your project and, when compiling, be sure the .ane file is inside your extdir. For more info, RTFM.In your app descriptor include the extension id like: