Dostęp do klas API środowiska AIR z JavaScript

Adobe AIR 1.0 i starsze wersje

Poza standardowymi i rozszerzonymi elementami środowiska Webkit, kod HTML i JavaScript może uzyskać dostęp do klas hosta dostarczonych przez środowisko wykonawcze. Klasy te umożliwiają dostęp do zaawansowanych funkcji dostarczanych przez środowisko AIR, w tym:

  • Dostęp do systemu plików

  • Użycie lokalnych baz danych SQL

  • Sterowanie menu aplikacji i okien

  • Dostęp do gniazd do pracy w sieci

  • Użycie klas i obiektów zdefiniowanych przez użytkownika

  • Możliwości dźwiękowe

    Na przykład: interfejs API pliku AIR zawiera klasę File, która znajduje się w pakiecie flash.filesystem. Obiekt File w języku JavaScript można utworzyć w sposób następujący: 

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

    Obiekt runtime jest specjalnym obiektem JavaScript dostępnym dla treści HTML uruchomionej w obszarze izolowanym aplikacji w środowisku AIR. Umożliwia dostęp do klas środowiska wykonawczego z kodu JavaScript. Właściwość flash obiektu runtime zapewnia dostęp do pakietu flash. Z kolei właściwość flash.filesystem obiektu runtime zapewnia dostęp do pakietu flash.filesystem (pakiet ten zawiera klasę File). Pakiety są sposobem na organizowanie klas używanych w kodzie ActionScript.

    Uwaga: Właściwość runtime nie jest automatycznie dodawana do obiektów okna dla stron załadowanych do ramki lub ramki pływającej. Jednak tak długo, jak dokumenty podrzędne są w obszarze izolowanym aplikacji, element podrzędny ma dostęp do właściwości runtime elementu nadrzędnego.

    Ponieważ struktura pakietu klas środowiska wykonawczego będzie wymagała od programistów wpisywania długich ciągów znaków kodu JavaScript w celu dostępu do każdej klasy (np. window.runtime.flash.desktop.NativeApplication ), plik AIRAliases.js programu AIR SDK umożliwia łatwiejszy dostęp do klas środowiska wykonawczego (np. przez proste wpisanie air.NativeApplication ).

    Klasy interfejsu API środowiska AIR omawiane są wszędzie w podręczniku. Pozostałe klasy interfejsu API programu Flash Player, które mogą zainteresować programistów HTML, zostały opisane w podręczniku Skorowidz interfejsu API środowiska Adobe AIR dla programistów HTML . ActionScript jest językiem używanym w treści SWF (Flash Player). Jednak składnia języków JavaScript i ActionScript jest podobna. (Oba są oparte na wersjach języka ECMAScript). Wszystkie klasy wbudowane dostępne są w obu językach: JavaScript (w treści HTML) i ActionScript (w treści SWF).

    Uwaga: Kod JavaScript nie może korzystać z klas Dictionary, XML i XMLList, które dostępne są w języku ActionScript.