使用 AIR API

Adobe® AIR® 包括不适用于 Adobe® Flash® Player 中运行的 SWF 内容的功能。

ActionScript 3.0 开发人员

Adobe AIR API 相关内容在下列两书中进行了介绍:

HTML 开发人员

在构建基于 HTML 的 AIR 应用程序时,可用于 JavaScript 中的 API 通过 AIRAliases.js 文件获得(请参阅 通过 JavaScript 访问 AIR API 类 ),有关此类 API 的相关内容在下列两书中进行了介绍:

特定于 AIR 的 ActionScript 3.0 类

下表列出了特定于 Adobe AIR 的运行时类,它们不可用于在浏览器中的 Adobe® Flash® Player 中运行的 SWF 内容。

HTML 开发人员

通过 AIRAliases.js 文件获得、可用于 JavaScript 的类在 针对 HTML 开发人员的 Adobe AIR API 参考 中列出。

ActionScript 3.0 包

AIR 版本中添加了以下内容

ARecord

flash.net.dns

2.0

AAAARecord

flash.net.dns

2.0

ApplicationUpdater

air.update

1.5

ApplicationUpdaterUI

air.update

1.5

AudioPlaybackMode

flash.media

3.0

AutoCapitalize

flash.text

3.0

BrowserInvokeEvent

flash.events

1.0

CameraPosition

flash.media

3.0

CameraRoll

flash.media

2.0

CameraRollBrowseOptions

flash.media

3.0

CameraUI

flash.media

2.5

CertificateStatus

flash.security

2.0

CompressionAlgorithm

flash.utils

1.0

DatagramSocket

flash.net

2.0

DatagramSocketDataEvent

flash.events

2.0

DNSResolver

flash.net.dns

2.0

DNSResolverEvent

flash.events

2.0

DockIcon

flash.desktop

1.0

DownloadErrorEvent

air.update.events

1.5

DRMAuthenticateEvent

flash.events

1.0

DRMDeviceGroup

flash.net.drm

3.0

DRMDeviceGroupErrorEvent

flash.net.drm

3.0

DRMDeviceGroupEvent

flash.net.drm

3.0

DRMManagerError

flash.errors

1.5

EncryptedLocalStore

flash.data

1.0

ExtensionContext

flash.external

2.5

File

flash.filesystem

1.0

FileListEvent

flash.events

1.0

FileMode

flash.filesystem

1.0

FileStream

flash.filesystem

1.0

FocusDirection

flash.display

1.0

GameInput

flash.ui

3.0

GameInputControl

flash.ui

3.0

GameInputControlType

flash.ui

3.6 和更低版本;自 3.7 起不再使用

GameInputDevice

flash.ui

3.0

GameInputEvent

flash.ui

3.0

GameInputFinger

flash.ui

3.6 和更低版本;自 3.7 起不再使用

GameInputHand

flash.ui

3.6 和更低版本;自 3.7 起不再使用

Geolocation

flash.sensors

2.0

GeolocationEvent

flash.events

2.0

HTMLHistoryItem

flash.html

1.0

HTMLHost

flash.html

1.0

HTMLLoader

flash.html

1.0

HTMLPDFCapability

flash.html

1.0

HTMLSWFCapabiltiy

flash.html

2.0

HTMLUncaughtScriptExceptionEvent

flash.events

1.0

HTMLWindowCreateOptions

flash.html

1.0

Icon

flash.desktop

1.0

IFilePromise

flash.desktop

2.0

ImageDecodingPolicy

flash.system

2.6

InteractiveIcon

flash.desktop

1.0

InterfaceAddress

flash.net

2.0

InvokeEvent

flash.events

1.0

InvokeEventReason

flash.desktop

1.5.1

IPVersion

flash.net

2.0

IURIDereferencer

flash.security

1.0

LocationChangeEvent

flash.events

2.5

MediaEvent

flash.events

2.5

MediaPromise

flash.media

2.5

MediaType

flash.media

2.5

MXRecord

flash.net.dns

2.0

NativeApplication

flash.desktop

1.0

NativeDragActions

flash.desktop

1.0

NativeDragEvent

flash.events

1.0

NativeDragManager

flash.desktop

1.0

NativeDragOptions

flash.desktop

1.0

NativeMenu

flash.display

1.0

NativeMenuItem

flash.display

1.0

NativeProcess

flash.desktop

2.0

NativeProcessExitEvent

flash.events

2.0

NativeProcessStartupInfo

flash.desktop

2.0

NativeWindow

flash.display

1.0

NativeWindowBoundsEvent

flash.events

1.0

NativeWindowDisplayState

flash.display

1.0

NativeWindowDisplayStateEvent

flash.events

1.0

NativeWindowInitOptions

flash.display

1.0

NativeWindowRenderMode

flash.display

3.0

NativeWindowResize

flash.display

1.0

NativeWindowSystemChrome

flash.display

1.0

NativeWindowType

flash.display

1.0

NetworkInfo

flash.net

2.0

NetworkInterface

flash.net

2.0

NotificationType

flash.desktop

1.0

OutputProgressEvent

flash.events

1.0

PaperSize

flash.printing

2.0

PrintMethod

flash.printing

2.0

PrintUIOptions

flash.printing

2.0

PTRRecord

flash.net.dns

2.0

ReferencesValidationSetting

flash.security

1.0

ResourceRecord

flash.net.dns

2.0

RevocationCheckSettings

flash.security

1.0

Screen

flash.display

1.0

ScreenMouseEvent

flash.events

1.0

SecureSocket

flash.net

2.0

SecureSocketMonitor

air.net

2.0

ServerSocket

flash.net

2.0

ServerSocketConnectEvent

flash.events

2.0

ServiceMonitor

air.net

1.0

SignatureStatus

flash.security

1.0

SignerTrustSettings

flash.security

1.0

SocketMonitor

air.net

1.0

SoftKeyboardType

flash.text

3.0

SQLCollationType

flash.data

1.0

SQLColumnNameStyle

flash.data

1.0

SQLColumnSchema

flash.data

1.0

SQLConnection

flash.data

1.0

SQLError

flash.errors

1.0

SQLErrorEvent

flash.events

1.0

SQLErrorOperation

flash.errors

1.0

SQLEvent

flash.events

1.0

SQLIndexSchema

flash.data

1.0

SQLMode

flash.data

1.0

SQLResult

flash.data

1.0

SQLSchema

flash.data

1.0

SQLSchemaResult

flash.data

1.0

SQLStatement

flash.data

1.0

SQLTableSchema

flash.data

1.0

SQLTransactionLockType

flash.data

1.0

SQLTriggerSchema

flash.data

1.0

SQLUpdateEvent

flash.events

1.0

SQLViewSchema

flash.data

1.0

SRVRecord

flash.net.dns

2.0

StageAspectRatio

flash.display

2.0

StageOrientation

flash.display

2.0

StageOrientationEvent

flash.events

2.0

StageText

flash.text

3.0

StageTextInitOptions

flash.text

3.0

StageWebView

flash.media

2.5

StatusFileUpdateErrorEvent

air.update.events

1.5

StatusFileUpdateEvent

air.update.events

1.5

StatusUpdateErrorEvent

air.update.events

1.5

StatusUpdateEvent

air.update.events

1.5

StorageVolume

flash.filesystem

2.0

StorageVolumeChangeEvent

flash.events

2.0

StorageVolumeInfo

flash.filesystem

2.0

SystemIdleMode

flash.desktop

2.0

SystemTrayIcon

flash.desktop

1.0

TouchEventIntent

flash.events

3.0

UpdateEvent

air.update.events

1.5

Updater

flash.desktop

1.0

URLFilePromise

air.desktop

2.0

URLMonitor

air.net

1.0

URLRequestDefaults

flash.net

1.0

XMLSignatureValidator

flash.security

1.0

具有特定于 AIR 功能的 Flash Player 类

以下类可用于在浏览器中运行的 SWF 内容,但 AIR 提供了附加的属性或方法:

属性、方法或事件

AIR 版本中添加了以下内容

flash.desktop

Clipboard

supportsFilePromise

2.0

ClipboardFormats

BITMAP_FORMAT

1.0

FILE_LIST_FORMAT

1.0

FILE_PROMISE_LIST_FORMAT

2.0

URL_FORMAT

1.0

flash.display

LoaderInfo

childSandboxBridge

1.0

parentSandboxBridge

1.0

Stage

assignFocus()

1.0

autoOrients

2.0

deviceOrientation

2.0

nativeWindow

1.0

orientation

2.0

orientationChange 事件

2.0

orientationChanging 事件

2.0

setAspectRatio

2.0

setOrientation

2.0

softKeyboardRect

2.6

supportedOrientations

2.6

supportsOrientationChange

2.0

NativeWindow

owner

2.6

listOwnedWindows

2.6

NativeWindowInitOptions

owner

2.6

flash.events

Event

CLOSING

1.0

DISPLAYING

1.0

PREPARING

2.6

EXITING

1.0

HTML_BOUNDS_CHANGE

1.0

HTML_DOM_INITIALIZE

1.0

HTML_RENDER

1.0

LOCATION_CHANGE

1.0

NETWORK_CHANGE

1.0

STANDARD_ERROR_CLOSE

2.0

STANDARD_INPUT_CLOSE

2.0

STANDARD_OUTPUT_CLOSE

2.0

USER_IDLE

1.0

USER_PRESENT

1.0

HTTPStatusEvent

HTTP_RESPONSE_STATUS

1.0

responseHeaders

1.0

responseURL

1.0

KeyboardEvent

commandKey

1.0

controlKey

1.0

flash.net

FileReference

extension

1.0

httpResponseStatus 事件

1.0

uploadUnencoded()

1.0

NetStream

drmAuthenticate 事件

1.0

onDRMContentData 事件

1.5

preloadEmbeddedData()

1.5

resetDRMVouchers()

1.0

setDRMAuthenticationCredentials()

1.0

URLRequest

authenticate

1.0

cacheResponse

1.0

followRedirects

1.0

idleTimeout

2.0

manageCookies

1.0

useCache

1.0

userAgent

1.0

URLStream

httpResponseStatus event

1.0

flash.printing

PrintJob

active

2.0

copies

2.0

firstPage

2.0

isColor

2.0

jobName

2.0

lastPage

2.0

maxPixelsPerInch

2.0

paperArea

2.0

printableArea

2.0

printer

2.0

printers

2.0

selectPaperSize()

2.0

showPageSetupDialog()

2.0

start2()

2.0

supportsPageSetupDialog

2.0

terminate()

2.0

PrintJobOptions

pixelsPerInch

2.0

printMethod

2.0

flash.system

Capabilities

languages

1.1

LoaderContext

allowLoadBytesCodeExecution

1.0

Security

APPLICATION

1.0

flash.ui

KeyLocation

D_PAD

2.5

以上多数新增属性和方法都只对 AIR 应用程序安全沙箱中的内容可用。但 URLRequest 类中的新增成员对于其他沙箱中运行的内容也可用。

ByteArray.compress() ByteArray.uncompress() 方法都包含一个新的 algorithm 参数,供您在 deflate 和 zlib 压缩之间选择。此参数仅对 AIR 中运行的内容可用。