Pakiet | flash.media |
Klasa | public final class StageWebView |
Dziedziczenie | StageWebView EventDispatcher Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Klasa StageWebView pozwala w prosty sposób wyświetlać zawartość HTML na urządzeniach, na których nie jest obsługiwana klasa HTMLLoader. Ta klasa nie umożliwia interakcji między kodem ActionScript a zawartością HTML w sposób inny niż za pośrednictwem metod i właściwości samej klasy StageWebView. Nie można na przykład przekazywać wartości ani wywoływać funkcji między kodem ActionScript a JavaScript.
Obsługa profilów AIR: Ta funkcja jest obsługiwana we wszystkich systemach operacyjnych dla komputerów stacjonarnych i urządzeń przenośnych, ale nie na urządzeniach telewizyjnych ze środowiskiem AIR. W czasie wykonywania można sprawdzić, czy ta funkcja jest obsługiwana, odczytując właściwość StageWebView.isSupported
. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.
Na urządzeniach z profilami urządzeń przenośnych i rozszerzonymi profilami urządzeń przenośnych klasa StageWebView korzysta z kontrolki internetowej udostępnianej przez system operacyjny urządzenia. Z tego powodu dostępne funkcje i wygląd uzyskiwany podczas renderowania mogą różnić się zależnie od urządzenia.
W systemie Android wideo HTML5 w kodzie jest obsługiwane tylko pod warunkiem umieszczenia w deskryptorze aplikacji parametru <application android:hardwareAccelerated="true"/>
.
Na komputerach stacjonarnych (w przypadku profilów stacjonarnych i rozszerzonych profilów stacjonarnych) klasa StageWebView używa systemowego elementu sterującego do wyświetlania stron internetowych dostarczanego przez wtyczkę Flash Player. Dostępne funkcje i wygląd uzyskiwany podczas renderowania są takie same jak w przypadku klasy HTMLLoader. Nie można korzystać z opcji oferowanych przez wystąpienie klasy HTMLLoader — ścisłej integracji i mostu skryptów między kodem ActionScript i JavaScript. Klasa HTMLLoader używa wewnętrznego mechanizmu WebKit środowiska AIR, dlatego nie jest zalecane równoległe używanie wystąpień klas StageWebView i HTMLLoader, ponieważ nie jest zdefiniowane zachowanie takiej konfiguracji i aplikacja może zostać zamknięta.
Klasa StageWebView NIE JEST obiektem wyświetlanym i nie można jej dodać do listy wyświetlania programu Flash. Zamiast tego w celu wyświetlenia obiektu StageWebView należy dołączyć go bezpośrednio do stołu montażowego za pomocą właściwości stage
. Wystąpienie klasy StageWebView dołączone do stołu montażowego jest wyświetlane przed wszystkimi obiektami wyświetlanymi Flash. Rozmiarem i położeniem obszaru renderowania można sterować przy użyciu właściwości viewPort
. Nie ma możliwości sterowania kolejnością (głębokością) poszczególnych obiektów StageWebView. Nie jest zalecane nakładanie dwóch wystąpień.
Gdy zawartość w obiekcie StageWebView jest aktywna, obiekt StageWebView uzyskuje pierwszą możliwość obsłużenia wejścia klawiatury. Stół montażowy, do którego jest dołączony obiekt StageWebView, wywołuje każde nieobsłużone wejście klawiatury. Normalny cykl przechwytywania i przekazywania zdarzeń nie ma w tym przypadku zastosowania, gdyż wystąpienie klasy StageWebView nie należy do listy wyświetlania.
W systemie Android 3.0 lub nowszym aplikacja musi włączyć przyspieszanie sprzętowe w elemencie manifestAdditions systemu Android umieszczonym w deskryptorze aplikacji AIR, aby móc wyświetlać zawartość dodatku plug-in w obiekcie StageWebView.
Więcej informacji
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
isHistoryBackEnabled : Boolean [tylko do odczytu]
Informuje, czy historia przeglądania zawiera poprzednią stronę. | StageWebView | ||
isHistoryForwardEnabled : Boolean [tylko do odczytu]
Informuje, czy historia przeglądania zawiera następną stronę. | StageWebView | ||
isSupported : Boolean [statyczny] [tylko do odczytu]
Informuje, czy na bieżącym urządzeniu jest obsługiwana klasa StageWebView. | StageWebView | ||
location : String [tylko do odczytu]
Adres URL bieżącej lokalizacji. | StageWebView | ||
mediaPlaybackRequiresUserAction : Boolean
Określa, czy użytkownik musi wykonać gest w celu odtworzenia treści multimedialnej. | StageWebView | ||
stage : Stage
Stół montażowy, na którym jest wyświetlany obiekt StageWebView. | StageWebView | ||
title : String [tylko do odczytu]
Wartość tytułu HTML. | StageWebView | ||
viewPort : Rectangle
Obszar stołu montażowego, w którym jest wyświetlany obiekt StageWebView. | StageWebView |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Tworzy obiekt StageWebView. | StageWebView | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | ||
Przypisuje wskaźnik aktywności do zawartości w tym obiekcie StageWebView. | StageWebView | ||
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | ||
Zwalnia ten obiekt StageWebView. | StageWebView | ||
Przyciąga widok klasy StageWebView do bitmapy. | StageWebView | ||
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Przechodzi do następnej strony w historii przeglądania. | StageWebView | ||
Przechodzi do poprzedniej strony w historii przeglądania. | StageWebView | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Wczytuje i wyświetla określony ciąg HTML. | StageWebView | ||
Wczytuje stronę o określonym adresie URL. | StageWebView | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Ponownie wczytuje bieżącą stronę. | StageWebView | ||
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Zatrzymuje bieżącą operację wczytywania. | StageWebView | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg reprezentujący określony obiekt. | Object | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object | ||
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher |
Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
---|---|---|---|---|
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | |||
Sygnalizuje ukończenie ostatniej operacji wczytywania, której zażądano za pośrednictwem metody loadString() lub loadURL(). | StageWebView | |||
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | |||
Sygnalizuje, że wystąpił błąd. | StageWebView | |||
Wywoływane, gdy obiekt StageWebView staje się aktywny (otrzymuje wskaźnik aktywności). | StageWebView | |||
Wywoływane, gdy obiekt StageWebView przestaje być aktywny (zwalnia wskaźnik aktywności). | StageWebView | |||
Sygnalizuje, że właściwość „location” obiektu StageWebView uległa zmianie. | StageWebView | |||
Sygnalizuje nadchodzącą zmianę właściwości „location” obiektu StageWebView. | StageWebView |
isHistoryBackEnabled | właściwość |
isHistoryForwardEnabled | właściwość |
isSupported | właściwość |
location | właściwość |
mediaPlaybackRequiresUserAction | właściwość |
mediaPlaybackRequiresUserAction:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 21.0 |
Określa, czy użytkownik musi wykonać gest w celu odtworzenia treści multimedialnej. Właściwość ta nie działa w systemie iOS i automatycznie odtwarzanie treści multimedialnej wymaga użycia konstruktora StageWebView()
. Wartość domyślna to True.
Implementacja
public function get mediaPlaybackRequiresUserAction():Boolean
public function set mediaPlaybackRequiresUserAction(value:Boolean):void
stage | właściwość |
stage:Stage
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Stół montażowy, na którym jest wyświetlany obiekt StageWebView.
Aby ukryć ten obiekt StageWebView, należy dla właściwości stage
ustawić wartość null
.
Implementacja
public function get stage():Stage
public function set stage(value:Stage):void
title | właściwość |
viewPort | właściwość |
viewPort:Rectangle
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Obszar stołu montażowego, w którym jest wyświetlany obiekt StageWebView.
Implementacja
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
Zgłasza
RangeError — Wartość Rectangle jest nieprawidłowa.
|
StageWebView | () | Konstruktor |
public function StageWebView(useNative:Boolean = false, mediaPlaybackRequiresUserAction:Boolean = true)
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Tworzy obiekt StageWebView.
Obiekt pozostaje niewidoczny, dopóki nie zostanie dołączony do stołu montażowego lub nie zostanie ustawiona właściwość viewPort
.
Uwaga: Choć nie jest to zabronione, w przypadku niektórej zawartości mogą wystąpić awarie, jeśli ten sam proces użyje zarówno osadzonego, jak i systemowego mechanizmu WebKit. Z tego powodu zalecane jest, aby wszystkie obiekty StageWebView w danej aplikacji tworzyć z użyciem tej samej wartości właściwości useNative. Obiekt HTMLLoader jest zależny od osadzonego mechanizmu WebKit, dlatego aplikacje korzystające z obiektu HTMLLoader powinny tworzyć obiekty StageWebView z właściwością useNative ustawioną na false.
ParametryuseNative:Boolean (default = false ) — Gdy właściwość useNative ma wartość false, jako źródło tworzonego obiektu StageWebView jest używana wersja mechanizmu WebKit osadzona w środowisku AIR. Gdy właściwość useNative ma wartość true, środowisko AIR używa domyślnego systemowego mechanizmu obsługi stron internetowych. Platformy przenośne obsługują tylko używanie systemowego mechanizmu obsługi stron internetowych, dlatego właściwość useNative jest na nich ignorowana.
| |
mediaPlaybackRequiresUserAction:Boolean (default = true ) — true dla wartości domyślnych. Gdy wartość właściwości mediaPlaybackRequiresUserAction to true, wówczas WebView wymaga działania ze strony użytkownika w celu odtwarzania. W przypadku wartości false WebView odtwarza zawartość automatycznie.
|
assignFocus | () | metoda |
public function assignFocus(direction:String = "none"):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Przypisuje wskaźnik aktywności do zawartości w tym obiekcie StageWebView.
Wartości kierunku są zdefiniowane w klasie FocusDirection. Są to między innymi wartości „bottom” (dół), „none” (brak) i „top” (góra).
Parametry
direction:String (default = "none ") — Określa, czy wskaźnik aktywności ma zostać przypisany do pierwszego czy do ostatniego obiektu wyświetlanej zawartości, który może być aktywny.
|
Powiązane elementy interfejsu API
dispose | () | metoda |
public function dispose():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Zwalnia ten obiekt StageWebView.
Wywołanie metody dispose()
jest opcjonalne. Jeśli nie zostanie zachowane odniesienie do tego wystąpienia klasy StageWebView, wystąpienie będzie mogło zostać uwzględnione w procesie czyszczenia pamięci. Wywołanie metody dispose()
może spowodować wykonanie czyszczenia pamięci wcześniej lub w dogodniejszym momencie.
drawViewPortToBitmapData | () | metoda |
public function drawViewPortToBitmapData(bitmap:BitmapData):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.6 |
Przyciąga widok klasy StageWebView do bitmapy.
Można przechwycić bitmapę i ustawić wartość stołu montażowego wynoszącą null
w celu wyświetlania zawartości przed obiektem StageWebView.
Uwaga: Działanie tej metody nie jest gwarantowane w przypadku stron z zawartością obsługiwaną przez wtyczki (taką jak osadzone pliki PDF i SWF).
Parametry
bitmap:BitmapData — Obiekt BitmapData, na którym ma zostać narysowana widoczna część widoku klasy StageWebView.
|
Zgłasza
ArgumentError — Szerokość lub wysokość bitmapy różni się od szerokości lub wysokości widoku.
| |
Error — Bitmapa jest pusta.
|
Przykład ( Sposób korzystania z tego przykładu )
package { import flash.display.Bitmap; import flash.display.BitmapData; import flash.display.Sprite; import flash.events.*; import flash.geom.Rectangle; import flash.media.StageWebView; import flash.net.*; import flash.text.TextField; public class stagewebview1 extends Sprite { public var webView:StageWebView = new StageWebView(); public var textGoogle:TextField=new TextField(); public var textFacebook:TextField=new TextField(); public function stagewebview() { textGoogle.htmlText="<b>Google</b>"; textGoogle.x=300; textGoogle.y=-80; addChild(textGoogle); textFacebook.htmlText="<b>Facebook</b>"; textFacebook.x=0; textFacebook.y=-80; addChild(textFacebook); textGoogle.addEventListener(MouseEvent.CLICK,goGoogle); textFacebook.addEventListener(MouseEvent.CLICK,goFaceBook); webView.stage = this.stage; webView.viewPort = new Rectangle(0, 0, stage.stageWidth, stage.stageHeight); } public function goGoogle(e:Event):void { webView.loadURL("http://www.google.com"); webView.stage = null; webView.addEventListener(Event.COMPLETE,handleLoad); } public function goFaceBook(e:Event):void { webView.loadURL("http://www.facebook.com"); webView.stage = null; webView.addEventListener(Event.COMPLETE,handleLoad); } public function handleLoad(e:Event):void { var bitmapData:BitmapData = new BitmapData(webView.viewPort.width, webView.viewPort.height); webView.drawViewPortToBitmapData(bitmapData); var webViewBitmap:Bitmap=new Bitmap(bitmapData); addChild(webViewBitmap); } } }
historyBack | () | metoda |
public function historyBack():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Przechodzi do następnej strony w historii przeglądania.
historyForward | () | metoda |
public function historyForward():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Przechodzi do poprzedniej strony w historii przeglądania.
loadString | () | metoda |
public function loadString(text:String, mimeType:String = "text/html"):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Wczytuje i wyświetla określony ciąg HTML.
Użycie metody loadString()
powoduje nadanie właściwości location
wartości „about:blank”. W adresach URL w ciągu HTML można używać tylko standardowych schematów URI. Schematy URI środowiska AIR („app:” i „app-storage:”) są niedozwolone.
Zawartość HTML nie może wczytywać zasobów lokalnych, na przykład plików obrazów. Żądania XMLHttpRequest są niedozwolone.
Są obsługiwane tylko typy MIME „text/html” i „application/xhtml+xml”.
Parametry
text:String — Ciąg zawartości HTML lub XHTML do wyświetlenia.
| |
mimeType:String (default = "text/html ") — Typ MIME zawartości: albo „text/html”, albo „application/xhtml+xml”.
|
Przykład ( Sposób korzystania z tego przykładu )
loadString()
.
var webView:StageWebView = new StageWebView(); webView.stage = this.stage; webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight ); var htmlString:String = "<!DOCTYPE HTML>" + "<html>" + "<body>" + "<h1>Example</h1>" + "<p>King Phillip cut open five green snakes.</p>" + "</body>" + "</html>"; webView.loadString( htmlString, "text/html" );
loadURL | () | metoda |
public function loadURL(url:String):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Wczytuje stronę o określonym adresie URL.
W adresie URL może być zastosowany jeden z następujących schematów URI: „http:”, „https:”, „file:”, „data:”, „javascript:”. Zawartość wczytana przy użyciu schematu „file:” może wczytywać inne zasoby lokalne.
Parametry
url:String |
Przykład ( Sposób korzystania z tego przykładu )
loadURL()
.
Uwaga: W celu wczytywania zdalnych adresów URL w systemie Android należy określić uprawnienie INTERNET w deskryptorze aplikacji AIR.
var webView:StageWebView = new StageWebView(); webView.stage = this.stage; webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight ); webView.loadURL( "http://www.example.com" );
reload | () | metoda |
public function reload():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Ponownie wczytuje bieżącą stronę.
stop | () | metoda |
public function stop():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Zatrzymuje bieżącą operację wczytywania.
complete | Zdarzenie |
flash.events.Event
właściwość Event.type =
flash.events.Event.COMPLETE
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Sygnalizuje ukończenie ostatniej operacji wczytywania, której zażądano za pośrednictwem metody loadString()
lub loadURL()
.
Event.COMPLETE
definiuje wartość właściwości type
obiektu zdarzenia complete
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | false |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Obiekt sieciowy, którego ładowanie zostało ukończone. |
error | Zdarzenie |
flash.events.ErrorEvent
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Sygnalizuje, że wystąpił błąd.
focusIn | Zdarzenie |
flash.events.FocusEvent
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Wywoływane, gdy obiekt StageWebView staje się aktywny (otrzymuje wskaźnik aktywności).
focusOut | Zdarzenie |
flash.events.FocusEvent
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Wywoływane, gdy obiekt StageWebView przestaje być aktywny (zwalnia wskaźnik aktywności).
locationChange | Zdarzenie |
flash.events.LocationChangeEvent
właściwość LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGE
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Sygnalizuje, że właściwość location
obiektu StageWebView uległa zmianie.
Zdarzenia nie można anulować.
Wywoływanie następuje przy każdej zmianie lokalizacji. locationChanging | Zdarzenie |
flash.events.LocationChangeEvent
właściwość LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGING
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5 |
Sygnalizuje nadchodzącą zmianę właściwości location
obiektu StageWebView.
Zdarzenie locationChanging jest wywoływane tylko wtedy, gdy zmiana lokalizacji jest inicjowana za pośrednictwem zawartości HTML lub uruchomionego kodu w obiekcie StageWebView, na przykład w przypadku kliknięcia łącza przez użytkownika. Domyślnie nowa lokalizacja jest wyświetlana w tym obiekcie StageWebView. Istnieje możliwość wywołania metody preventDefault()
obiektu zdarzenia w celu anulowania tego zachowania. Można na przykład użyć funkcji flash.net.navigateToURL()
, aby otworzyć stronę w przeglądarce systemu na podstawie właściwości location
obiektu zdarzenia.
Zdarzenie locationChanging nie jest wywoływane w przypadku zmian lokalizacji realizowanych przy użyciu następujących metod:
historyBack()
historyForward()
loadString()
loadURL()
reload()
LOCATION_CHANGING
definiuje wartość właściwości type
obiektu LocationChangeEvent wywoływanego przed zmianą położenia strony.
loadURL()
wczytywana witryna internetowa, a następnie do nawigacji w obrębie historii są używane klawisze programowe Wstecz i Szukaj.
package { import flash.display.MovieClip; import flash.media.StageWebView; import flash.geom.Rectangle; import flash.events.KeyboardEvent; import flash.ui.Keyboard; import flash.desktop.NativeApplication; public class StageWebViewExample extends MovieClip{ private var webView:StageWebView = new StageWebView(); public function StageWebViewExample() { webView.stage = this.stage; webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight ); webView.loadURL( "http://www.example.com" ); stage.addEventListener( KeyboardEvent.KEY_DOWN, onKey ); } private function onKey( event:KeyboardEvent ):void { if( event.keyCode == Keyboard.BACK && webView.isHistoryBackEnabled ) { trace("Back."); webView.historyBack(); event.preventDefault(); } if( event.keyCode == Keyboard.SEARCH && webView.isHistoryForwardEnabled ) { trace("Forward."); webView.historyForward(); } } } }
Tue Jun 12 2018, 12:06 PM Z