通过 JavaScript 访问 AIR API 类

Adobe AIR 1.0 和更高版本

除 Webkit 的标准元素和扩展元素之外,HTML 和 JavaScript 代码还可以访问运行时提供的主机类。通过这些类,可以访问 AIR 提供的高级功能,包括:

  • 访问文件系统

  • 使用本地 SQL 数据库

  • 控制应用程序和窗口菜单

  • 访问网络套接字

  • 使用用户定义的类和对象

  • 声音功能

    例如,AIR 文件 API 包含一个 File 类,该类包含在 flash.filesystem 包中。可以在 JavaScript 中创建一个如下所示的 File 对象:

    var myFile = new window.runtime.flash.filesystem.File();

    runtime 对象是一个特殊的 JavaScript 对象,可用于在 AIR 应用程序沙箱中运行的 HTML 内容。使用该对象,可以通过 JavaScript 访问运行时类。runtime 对象的 flash 属性提供了对 Flash 包的访问。同样,runtime 对象的 flash.filesystem 属性提供了对 flash.filesystem 包(此包包含 File 类)的访问。包是一种对 ActionScript 中使用的类进行组织的方式。

    注: 不会自动向 frame 或 iframe 中加载的页面的窗口对象添加 runtime 属性。但是,只要子级文档位于应用程序沙箱中,子级文档就可以访问父级文档的 runtime 属性。

    由于运行时类的包结构要求开发人员键入长字符串的 JavaScript 代码字符串(如 window.runtime.flash.desktop.NativeApplication)来访问各个类,因此,AIR SDK 提供了一个 AIRAliases.js 文件,使用该文件,可以更方便地访问运行时类(例如,只需键入 air.NativeApplication 即可)。

    本指南主要讨论 AIR API 类。HTML 开发人员可能对 Flash Player API 中的其他类感兴趣,将在《针对 HTML 开发人员的 Adobe AIR API 参考》中介绍这些类。SWF (Flash Player) 内容所使用的语言为 ActionScript。但是,JavaScript 和 ActionScript 语法是类似的。(它们都基于 ECMAScript 语言版本。)JavaScript(在 HTML 内容中)和 ActionScript(在 SWF 内容中)均包含所有内置类。

    注: JavaScript 代码无法使用 Dictionary、XML 和 XMLList 类,但这些类在 ActionScript 中是可用的。