Arbeiten mit den AIR-APIs

AIR-spezifische ActionScript 3.0-Klassen
Flash Player-Klassen mit AIR-spezifischer Funktionalität
AIR-spezifische Flex-Komponenten

Adobe® AIR® umfasst Funktionalität, die für SWF-Inhalt, der in Adobe® Flash® Player ausgeführt wird, nicht zur Verfügung steht.

ActionScript 3.0-Entwickler

Die Adobe AIR-APIs sind in den beiden folgenden Büchern dokumentiert:

HTML-Entwickler

Wenn Sie HTML-basierte AIR-Anwendungen erstellen, informieren Sie sich in den beiden folgenden Büchern über die APIs, die Ihnen in JavaScript über die Datei „AIRAliases.js“ (siehe Accessing AIR API classes from JavaScript) zur Verfügung stehen:

AIR-spezifische ActionScript 3.0-Klassen

In der folgenden Tabelle sind die für Adobe AIR spezifischen Laufzeitklassen aufgeführt. Sie stehen für SWF-Inhalte, die in Adobe® Flash® Player im Browser ausgeführt werden, nicht zur Verfügung.

HTML-Entwickler

Die Klassen, die Ihnen in JavaScript über die Datei „AIRAliases.js“ zur Verfügung stehen, sind unter Adobe AIR API Reference for HTML Developers aufgeführt.

Klasse	ActionScript 3.0-Paket	Hinzugefügt in AIR-Version
AAAARecord	flash.net.dns	2.0
ApplicationUpdater	air.update	1.5
ApplicationUpdaterUI	air.update	1.5
ARecord	flash.net.dns	2.0
BrowserInvokeEvent	flash.events	1.0
CameraRoll	flash.media	2.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
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
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
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
SecureSocketConnectEvent	flash.events	2.0
ServerSocket	flash.net	2.0
ServerSocketConnectEvent	flash.net	2.0
ServiceMonitor	air.net	1.0
SignatureStatus	flash.security	1.0
SignerTrustSettings	flash.security	1.0
SocketMonitor	air.net	1.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
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
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

Flash Player-Klassen mit AIR-spezifischer Funktionalität

Die folgenden Klassen stehen SWF-Inhalten, die im Browser ausgeführt werden, zur Verfügung, AIR bietet jedoch zusätzliche Eigenschaften und Methoden:

Paket	Klasse	Eigenschaft, Methode oder Ereignis	Hinzugefügt in AIR-Version
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
	LoaderInfo	`parentSandboxBridge`	1.0
	Stage	assignFocus()	1.0
		autoOrients	2.0
		deviceOrientation	2.0
		`nativeWindow`	1.0
		orientation	2.0
		orientationChange-Ereignis	2.0
		orientationChanging-Ereignis	2.0
		setAspectRatio	2.0
		`setOrientation`	2.0
		softKeyboardRect	2.6
		supportedOrientations	2.6
		supportsOrientationChange	2.0
	NativeWindow	owner	2.6
	NativeWindow	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
	KeyboardEvent	`controlKey`	1.0
flash.net	FileReference	`extension`	1.0
		`httpResponseStatus`-Ereignis	1.0
		`uploadUnencoded()`	1.0
	NetStream	`drmAuthenticate-Ereignis`	1.0
		`onDRMContentData`-Ereignis	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
	PrintJobOptions	`printMethod`	2.0
flash.system	Capabilities	`languages`	1.1
	LoaderContext	`allowLoadBytesCodeExecution`	1.0
	Security	`APPLICATION`	1.0
flash.ui	KeyLocation	D_PAD	2.5

Die meisten dieser neuen Eigenschaften und Methoden stehen nur Inhalten in der Sicherheits-Sandbox der AIR-Anwendung zur Verfügung. Die neuen Mitglieder in den URLRequest-Klassen stehen jedoch auch Inhalten zur Verfügung, die in anderen Sandboxen ausgeführt werden.

Die Methoden ByteArray.compress() und ByteArray.uncompress() enthalten je einen neuen algorithm-Parameter, mit dem Sie zwischen den Kompressionsarten „deflate“ und „zlib“ wählen können. Dieser Parameter ist nur für Inhalte verfügbar, die in AIR ausgeführt werden.

AIR-spezifische Flex-Komponenten

Die folgenden Adobe® Flex™ MX-Komponenten sind bei der Entwicklung von Inhalten für Adobe AIR verfügbar:

Außerdem enthält Flex 4 die folgenden Spark-AIR-Komponenten:

Weitere Informationen zu den AIR-Flex-Komponenten finden Sie unter Using the Flex AIR components.