Pakiet | fl.video |
Klasa | public class VideoPlayer |
Dziedziczenie | VideoPlayer Video DisplayObject EventDispatcher Object |
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
cuePoint
będą występowały. Klasa FLVPlayback opakowuje klasę VideoPlayer.
Z klasy FLVPlayback należy korzystać w niemal wszystkich przypadkach, ponieważ nie ma funkcji w klasie VideoPlayer, do której nie można by uzyskać dostępu za pomocą klasy FLVPlayback.
Ponadto klasa FLVPlayback automatycznie łączy się z klasą NCManager, co umożliwia dostęp do plików FLV przesyłanych strumieniowo na serwerze wideo, takim jak Flash Media Server. Do interakcji z klasą NCManager dochodzi po poprawnym ustawieniu właściwości contentPath
i przekazaniu adresu URL do metod play()
i load()
. Jeśli używana jest tylko klasa VideoPlayer, należy dołączyć następującą instrukcję do kodu ActionScript, aby upewnić się, że klasa NCManager została uwzględniona:
var _forceNCManager:fl.video.NCManager;
Klasa NCManager implementuje interfejs INCManager i może zostać zastąpiona przez niestandardową klasę w celu zarządzania komunikacją w sieci, która implementuje interfejs. W przypadku zastąpienia należy również dołączyć następującą instrukcję, zastępując NCManager nazwą udostępnionej klasy:
fl.video.VideoPlayer.iNCManagerClass = fl.video.NCManager;
Dodanie tej instrukcji nie jest konieczne, jeśli używana jest domyślna klasa NCManager.
Uwaga: Jeśli używany jest składnik FLVPlayback, można również ustawić iNCManagerClass
w celu zastąpienia domyślnej klasy fl.video.NCManager.
W celu obsługi wielu strumieni dla wielu przepustowości klasa NCManager obsługuje podzbiór SMIL.
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
Bieżące opcje dostępności tego obiektu wyświetlanego. | DisplayObject | ||
align : String
Określa związek między sposobem wyświetlania wideo a wartościami właściwości registrationX, registrationY, registrationWidth i registrationHeight. | VideoPlayer | ||
alpha : Number
Wartość przezroczystości alfa określonego obiektu. | DisplayObject | ||
autoRewind : Boolean
Wartość logiczna (Boolean), której prawdziwość powoduje, że po zatrzymaniu odtwarzania plik jest przewijany do klatki nr 1. Zatrzymanie może nastąpić w wyniku osiągnięcia końca strumienia lub wywołania metody stop(). | VideoPlayer | ||
blendMode : String
Wartość z klasy BlendMode określająca, jakiego trybu mieszania należy użyć. | DisplayObject | ||
blendShader : Shader [tylko do zapisu]
Ustawia moduł cieniujący, który jest używany do mieszania pierwszego planu oraz tła. | DisplayObject | ||
bufferTime : Number
Liczba sekund określająca czas buforowania danych w pamięci przed rozpoczęciem odtwarzania strumienia wideo. | VideoPlayer | ||
bytesLoaded : uint [tylko do odczytu]
Liczba określająca rozmiar pobierania w ilości bajtów, dla pobierania za pomocą protokołu HTTP. | VideoPlayer | ||
bytesTotal : uint [tylko do odczytu]
Liczba określająca całkowitą liczbę pobranych bajtów za pomocą protokołu HTTP. | VideoPlayer | ||
cacheAsBitmap : Boolean
Jeśli ustawiono wartość true, środowisko wykonawcze Flash buforuje wewnętrzną reprezentację bitmapy obiektu wyświetlanego. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
W przypadku wartości innej niż null ten obiekt Matrix definiuje sposób renderowania obiektu wyświetlanego, gdy cacheAsBitmap jest ustawione na true. | DisplayObject | ||
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
deblocking : int
Określa typ filtra zastosowanego do dekodowanych danych wideo podczas przetwarzania końcowego. | Video | ||
filters : Array
Indeksowana tablica zawierająca wszystkie filtry aktualnie skojarzone z obiektem wyświetlanym. | DisplayObject | ||
height : Number [przesłanianie]
Liczba określająca wysokość wystąpienia klasy VideoPlayer (w pikselach). | VideoPlayer | ||
idleTimeout : Number
Czas, w milisekundach, przed upływem którego program Flash kończy bezczynne połączenie z serwerem wideo (np. Flash Media Server) z powodu wstrzymania lub zatrzymania odtwarzania. | VideoPlayer | ||
iNCManagerClass : Object = fl.video.NCManager [statyczny]
Aby wszystkie obiekty VideoPlayer korzystały z klasy niestandardowej jako domyślnej implementacji INCManager, należy ustawić dla właściwości iNCManagerClass obiekt klasy lub ciąg znaków nazwy niestandardowej klasy. | VideoPlayer | ||
isLive : Boolean [tylko do odczytu]
Wartość logiczna (Boolean), której prawdziwość sygnalizuje aktywny strumień wideo. | VideoPlayer | ||
isRTMP : Boolean [tylko do odczytu]
Wartość logiczna (Boolean), której ustawienie to true, gdy plik FLV jest pobierany strumieniowo jest pobierany strumieniowo z serwera Flash Media Server (FMS) przy użyciu protokołu RTMP. | VideoPlayer | ||
loaderInfo : LoaderInfo [tylko do odczytu]
Zwraca obiekt LoaderInfo zawierający informacje o ładowaniu pliku, do którego należy ten obiekt wyświetlany. | DisplayObject | ||
mask : DisplayObject
Wywoływany obiekt wyświetlany jest maskowany przez określony obiekt maski. | DisplayObject | ||
metadata : Object [tylko do odczytu]
Obiekt będący pakietem metadanych, które odebrano wskutek wywołania metody NetSteam.onMetaData() (jeśli jest ona dostępna). | VideoPlayer | ||
metaData : Object
Pobiera obiekt metadanych wystąpienia klasy DisplayObject, jeśli metadane są przechowywane razem z tym wystąpieniem klasy DisplayObject w pliku SWF, korzystając ze znacznika PlaceObject4. | DisplayObject | ||
mouseX : Number [tylko do odczytu]
Określa współrzędną x myszy lub urządzenia wejściowego użytkownika w pikselach. | DisplayObject | ||
mouseY : Number [tylko do odczytu]
Określa współrzędną y myszy lub urządzenia wejściowego użytkownika w pikselach. | DisplayObject | ||
name : String
Nazwa instancji obiektu DisplayObject. | DisplayObject | ||
ncMgr : INCManager [tylko do odczytu]
Obiekt INCManager, który zapewnia dostęp do instancji klasy, która stanowi interfejs klasy NCManager. | VideoPlayer | ||
netConnection : NetConnection [tylko do odczytu]
Umożliwia bezpośredni dostęp do wystąpienia obiektu NetConnection utworzonego za pomocą odtwarzacza wideo. | VideoPlayer | ||
netStream : NetStream [tylko do odczytu]
Umożliwia bezpośredni dostęp do wystąpienia obiektu NetStream utworzonego za pomocą odtwarzacza wideo. | VideoPlayer | ||
netStreamClientClass : Object [statyczny]
Rejestruje klasę własną dla właściwości klienta NetStream. | VideoPlayer | ||
opaqueBackground : Object
Określa, czy przy konkretnym kolorze tła obiekt wyświetlany jest nieprzejrzysty. | DisplayObject | ||
parent : DisplayObjectContainer [tylko do odczytu]
Odnosi się do obiektu DisplayObjectContainer, który zawiera obiekt wyświetlany. | DisplayObject | ||
playheadTime : Number
Liczba, która jest bieżącym czasem lub położeniem głowicy odtwarzania mierzonym w sekundach (może być wartością ułamkową). | VideoPlayer | ||
playheadUpdateInterval : Number
Liczba milisekund określająca czas między poszczególnymi zdarzeniami playheadUpdate. | VideoPlayer | ||
progressInterval : Number
Liczba milisekund określająca czas między poszczególnymi zdarzeniami progress. | VideoPlayer | ||
registrationHeight : Number
Wysokość stosowana do wyrównywania elementów wideo podczas automatycznej zmiany rozmiaru. | VideoPlayer | ||
registrationWidth : Number
Szerokość stosowana do wyrównywania elementów wideo podczas automatycznej zmiany rozmiaru. | VideoPlayer | ||
registrationX : Number
Współrzędna x stosowana do wyrównywania elementów wideo podczas automatycznej zmiany rozmiaru. | VideoPlayer | ||
registrationY : Number
Współrzędna y stosowana do wyrównywania elementów wideo podczas automatycznej zmiany rozmiaru. | VideoPlayer | ||
root : DisplayObject [tylko do odczytu]
Dla obiektu wyświetlanego w załadowanym pliku SWF główną właściwość stanowi obiekt wyświetlany na samym szczycie na liście wyświetlania w postaci struktury drzewa, którą reprezentuje plik SWF. | DisplayObject | ||
rotation : Number
Określa wielkość obrotu instancji obiektu DisplayObject (w kątach). | DisplayObject | ||
rotationX : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi x — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | ||
rotationY : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi y — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | ||
rotationZ : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi z — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | ||
scale9Grid : Rectangle
Aktualnie stosowana siatka skalowania. | DisplayObject | ||
scaleMode : String
Określa metodę zmiany rozmiaru wideo po załadowaniu danych. | VideoPlayer | ||
scaleX : Number [przesłanianie]
Liczba określająca skalę poziomą. | VideoPlayer | ||
scaleY : Number [przesłanianie]
Liczba określająca skalę pionową. | VideoPlayer | ||
scaleZ : Number
Wskazuje skalę głębokości (procent) obiektu względem punktu odniesienia. | DisplayObject | ||
scrollRect : Rectangle
Granice obszaru przewijania obiektu wyświetlanego. | DisplayObject | ||
smoothing : Boolean
Określa, czy podczas skalowania obraz wideo powinien zostać wygładzony (poddany interpolacji). | Video | ||
soundTransform : flash.media:SoundTransform
Zapewnia bezpośredni dostęp do właściwości NetStream.soundTransform, która daje lepszą kontrolę nad dźwiękiem. | VideoPlayer | ||
source : String [tylko do odczytu]
Ciąg znaków określający adres URL pliku FLV oraz sposób jego przetwarzania strumieniowego. | VideoPlayer | ||
stage : Stage [tylko do odczytu]
Stół montażowy obiektu wyświetlanego. | DisplayObject | ||
state : String [tylko do odczytu]
Ciąg znaków określający stan składnika. | VideoPlayer | ||
stateResponsive : Boolean [tylko do odczytu]
Wartość logiczna (Boolean), której prawdziwość sygnalizuje stan gotowości do odpowiedzi. | VideoPlayer | ||
totalTime : Number [tylko do odczytu]
Liczba będąca całkowitym czasem odtwarzania wideo (w sekundach). | VideoPlayer | ||
transform : flash.geom:Transform
Obiekt z właściwościami dotyczącymi matrycy obiektu wyświetlanego, transformacji kolorów oraz granic pikseli. | DisplayObject | ||
videoHeight : int [przesłanianie] [tylko do odczytu]
Szerokość źródłowa załadowanego pliku FLV. | VideoPlayer | ||
videoWidth : int [przesłanianie] [tylko do odczytu]
Szerokość źródłowa załadowanego pliku FLV. | VideoPlayer | ||
visible : Boolean [przesłanianie]
Wartość logiczna (Boolean), której prawdziwość powoduje, że instancja składnika VideoPlayer jest widoczna. | VideoPlayer | ||
volume : Number
Liczba w zakresie od 0 do 1, która wskazuje ustawienie elementu sterującego głośnością. | VideoPlayer | ||
width : Number [przesłanianie]
Liczba określająca szerokość instancji składnika VideoPlayer na stole montażowym. | VideoPlayer | ||
x : Number [przesłanianie]
Liczba określająca poziome położenie odtwarzacza wideo (w pikselach). | VideoPlayer | ||
y : Number [przesłanianie]
Liczba określająca pionowe położenie odtwarzacza wideo (w pikselach). | VideoPlayer | ||
z : Number
Wskazuje współrzędną wzdłuż osi Z instancji DisplayObject względem nadrzędnego kontenera 3D. | DisplayObject |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Tworzy obiekt VideoPlayer o określonej wysokości i szerokości. | VideoPlayer | ||
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 | ||
Określa strumień wideo z kamery, który ma być wyświetlany w obszarze wyznaczonym przez obiekt Video w oknie aplikacji. | Video | ||
Określa strumień danych wideo, który ma być wyświetlany w obszarze wyznaczonym przez obiekt Video w oknie aplikacji. | Video | ||
Usuwa obraz aktualnie wyświetlany w obiekcie Video (a nie strumień wideo). | Video | ||
Powoduje zamknięcie strumienia wideo i połączenia z serwerem Flash Media Server. | VideoPlayer | ||
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | ||
Zwraca prostokąt definiujący obszar obiektu wyświetlanego (w układzie współrzędnych obiektu targetCoordinateSpace). | DisplayObject | ||
Zwraca prostokąt definiujący granice obiektu wyświetlanego w układzie współrzędnych określonych przez parametr targetCoordinateSpace (z wyłączeniem konturów kształtów). | DisplayObject | ||
Konwertuje obiekt punktowy ze współrzędnych obiektu Stage (globalne) do współrzędnych obiektu wyświetlanego (lokalne). | DisplayObject | ||
Konwertuje punkt dwuwymiarowy ze współrzędnych stołu wymiarowego (globalnych) na współrzędne trójwymiarowego obiektu wyświetlanego (lokalne). | DisplayObject | ||
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Wyznacza prostokąt ograniczający obiekt wyświetlany w celu sprawdzenia, czy zachodzi on lub przecina się z prostokątem ograniczającym obiektu wyświetlanego obj. | DisplayObject | ||
Analizuje obiekt wyświetlany w celu ustalenia czy nakłada się on lub przecina punkt określony przez parametry x i y. | DisplayObject | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
load(url:String, totalTime:Number = NaN, isLive:Boolean = false, startTime:Number = NaN, duration:Number = NaN):void
Podobna do metody play(), lecz powoduje załadowanie pliku FLV bez odtwarzania. | VideoPlayer | ||
Konwertuje punkt trójwymiarowy trójwymiarowego obiektu wyświetlanego (lokalnego) na punkt dwuwymiarowy we współrzędnych stołu montażowego (globalnych). | DisplayObject | ||
Konwertuje obiekt punktowy ze współrzędnych obiektu wyświetlanego (lokalne) do współrzędnych obiektu Stage (globalne). | DisplayObject | ||
Wywoływana przez obiekt INCManager po zakończeniu lub przerwaniu połączenia w efekcie wywołania metody INCManager.connectToURL(). | VideoPlayer | ||
Wywoływana przez obiekt INCManager po zakończeniu lub przerwaniu ponownego połączenia w efekcie wywołania metody INCManager.reconnect(). | VideoPlayer | ||
Wstrzymuje odtwarzanie wideo. | VideoPlayer | ||
play(url:String = null, totalTime:Number = NaN, isLive:Boolean = false, startTime:Number = NaN, duration:Number = NaN):void
Powoduje odtwarzanie wideo. | VideoPlayer | ||
Odtwarza plik FLV, jeżeli została pobrana wystarczająca ilość danych. | VideoPlayer | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | ||
Pozwala odszukać w pliku określony punkt czasowy z dokładnością do trzech miejsc po przecinku (milisekund). | VideoPlayer | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Ustawia jednocześnie właściwości scaleX i scaleY. | VideoPlayer | ||
Ustawia jednocześnie właściwości width i height. | VideoPlayer | ||
Zatrzymuje odtwarzanie wideo. | VideoPlayer | ||
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 | |||
Wywoływane, gdy obiekt wyświetlany jest dodawany do listy wyświetlania. | DisplayObject | |||
Wywoływane, gdy obiekt wyświetlany jest dodawany do listy wyświetlania na scenie — albo bezpośrednio, albo wskutek dodania poddrzewa zawierającego obiekt wyświetlany. | DisplayObject | |||
Wywoływane, gdy głowica odtwarzania znajduje się w punkcie początkowym odtwarzacza wideo (właściwość autoRewind ma wartość true). | VideoPlayer | |||
Wywoływane przez instancję VideoPlayer po zamknięciu NetConnection na skutek przekroczenia limitu czasu lub wywołania metody close(), metody load() lub play() albo ustawienia właściwości source, co w rezultacie prowadzi do zamknięcia połączenia RTMP. | VideoPlayer | |||
Wywoływane po zakończeniu odtwarzania, ponieważ odtwarzacz osiągnął koniec pliku FLV. | VideoPlayer | |||
Wywoływane w przypadku osiągnięcia punktu wskazującego. | VideoPlayer | |||
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | |||
Zdarzenie drmAuthenticate | VideoPlayer | |||
Zdarzenie drmError | VideoPlayer | |||
Zdarzenie drmError | VideoPlayer | |||
[zdarzenie broadcast] Wywoływane, gdy głowica odtwarzania przechodzi do nowej klatki. | DisplayObject | |||
[zdarzenie broadcast] Wywoływane, gdy głowica odtwarzania kończy odtwarzanie bieżącej klatki. | DisplayObject | |||
[zdarzenie broadcast] Wywoływane po zadziałaniu konstruktorów obiektów wyświetlanych klatek, ale przed działaniem skryptów klatek. | DisplayObject | |||
Zdarzenie wywoływane w przypadku zmiany rozmiaru lub położenia odtwarzacza wideo. | VideoPlayer | |||
Wywoływane po osiągnięciu po raz pierwszy metadanych pliku FLV. | VideoPlayer | |||
Zdarzenie wywoływane, gdy plik FLV jest odtwarzany z częstością określoną przez właściwość playheadUpdateInterval lub rozpoczyna się przewijanie do tyłu. | VideoPlayer | |||
Wskazuje liczbę załadowanych bajtów. | VideoPlayer | |||
Zdarzenie wywoływane, gdy plik FLV został załadowany i jest gotowy do wyświetlenia. | VideoPlayer | |||
Dysponowana, gdy obiekt ekranowy ma być usunięty z listy wyświetlania. | DisplayObject | |||
Dysponowana, gdy obiekt ekranowy ma być usunięty z listy wyświetlania na scenie — albo bezpośrednio, albo wskutek usunięcia poddrzewa zawierającego obiekt ekranowy. | DisplayObject | |||
[zdarzenie broadcast] Wywoływane, gdy lista wyświetlania ma być aktualizowana lub renderowana. | DisplayObject | |||
Wywoływane po zmianie stanu odtwarzania. | VideoPlayer |
Stała | Zdefiniowane przez | ||
---|---|---|---|
SHORT_VERSION : String = "2.1" [statyczny]
Zmienna stanu wskazująca na krótki numer wersji składnika. | VideoPlayer | ||
VERSION : String = "2.1.0.23" [statyczny]
Zmienna stanu wskazująca na długi numer wersji składnika. | VideoPlayer |
align | właściwość |
align:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Określa związek między sposobem wyświetlania wideo a wartościami właściwości registrationX
, registrationY
, registrationWidth
i registrationHeight
. Właściwość align
wykonuje automatyczną zmianę układu, gdy dla właściwości scaleMode
ustawiona jest wartość VideoScaleMode.MAINTAIN_ASPECT_RATIO
lub VideoScaleMode.NO_SCALE
. Zmiana tej właściwości po załadowaniu pliku FLV powoduje natychmiastowe rozpoczęcie automatycznej zmiany układu. Wartości pochodzą z klasy VideoAlign.
Wartością domyślną jest VideoAlign.CENTER.
Implementacja
public function get align():String
public function set align(value:String):void
Powiązane elementy interfejsu API
autoRewind | właściwość |
autoRewind:Boolean
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wartość logiczna (Boolean), której ustawienie true
powoduje, że po zatrzymaniu odtwarzania plik jest przewijany do klatki nr 1. Zatrzymanie może nastąpić w wyniku osiągnięcia końca strumienia lub wywołania metody stop()
. Właściwość ta nie ma znaczenia dla strumieni odtwarzanych na żywo.
Wartością domyślną jest false.
Implementacja
public function get autoRewind():Boolean
public function set autoRewind(value:Boolean):void
bufferTime | właściwość |
bufferTime:Number
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba sekund określająca czas buforowania danych w pamięci przed rozpoczęciem odtwarzania strumienia wideo. Dla plików FLV przesyłanych strumieniowo za pomocą RTMP, które nie są pobierane i umieszczane są tylko w buforze, ważne może być zwiększenie tego ustawienia z wartości domyślnej 0,1. Dla plików FLV pobranych stopniowo za pomocą protokołu HTTP zwiększenie tej wartości przyniesie mały zysk, jednak na starszych i wolnych komputerach może poprawić podgląd wideo wysokiej jakości.
Dla właściwości bufferTime
nie należy ustawiać wartości 0
w przypadku nagranego materiału wideo; należy ustawić domyślny czas buforowania lub zwiększyć ten czas.
Właściwość ta nie określa ilości danych pliku FLV do pobrania zanim rozpocznie się odtwarzanie.
Implementacja
public function get bufferTime():Number
public function set bufferTime(value:Number):void
Powiązane elementy interfejsu API
bytesLoaded | właściwość |
bytesLoaded:uint
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba określająca rozmiar pobierania w ilości bajtów, dla pobierania za pomocą protokołu HTTP. Zwraca wartość 0, gdy brak jest strumienia, strumień pochodzi z serwera Flash Media Server (FMS) lub informacja nie jest jeszcze dostępna. Zwracana wartość jest użyteczna jedynie dla pobierania HTTP.
Implementacja
public function get bytesLoaded():uint
bytesTotal | właściwość |
bytesTotal:uint
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba określająca całkowitą liczbę pobranych bajtów za pomocą protokołu HTTP. Zwraca wartość -1, gdy brak jest strumienia, strumień pochodzi z serwera Flash Media Server (FMS) lub informacja nie jest jeszcze dostępna. Zwracana wartość jest użyteczna jedynie dla pobierania HTTP.
Implementacja
public function get bytesTotal():uint
height | właściwość |
height:Number
[przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba określająca wysokość instancji składnika VideoPlayer (w pikselach).
Uwaga: Nie należy mylić tej właściwości z właściwością flash.media.Video.height
, która jest podobna do właściwości fl.video.VideoPlayer.videoHeight
.
Implementacja
override public function get height():Number
override public function set height(value:Number):void
Powiązane elementy interfejsu API
idleTimeout | właściwość |
idleTimeout:Number
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Czas, w milisekundach, przed upływem którego program Flash kończy bezczynne połączenie z serwerem wideo (np. Flash Media Server) z powodu wstrzymania lub zatrzymania odtwarzania. Właściwość ta nie ma wpływu na pobieranie pliku FLV za pomocą protokołu HTTP.
Ustawienie tej właściwości, gdy strumień wideo jest juz bezczynny, uruchamia ponownie czas oczekiwania z nową wartością.
Implementacja
public function get idleTimeout():Number
public function set idleTimeout(value:Number):void
iNCManagerClass | właściwość |
public static var iNCManagerClass:Object = fl.video.NCManager
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Aby wszystkie obiekty VideoPlayer korzystały z klasy niestandardowej jako domyślnej implementacji INCManager, należy ustawić dla właściwości iNCManagerClass
obiekt klasy lub ciąg znaków nazwy niestandardowej klasy. Klasa FLVPlayback zawiera definicję klasy niestandardowej; odtwarzacz wideo nie zawiera takiej definicji.
Wartość domyślna to ciąg fl.video.NCManager
.
isLive | właściwość |
isLive:Boolean
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wartość logiczna Boolean, której ustawienie to true
, jeżeli strumień wideo jest aktywny. Właściwość ta obowiązuje jedynie podczas przesyłania strumieniowego z serwera Flash Media Server (FMS) lub innej usługi Flash Video Streaming Service (FVSS). Wartość tej właściwości jest ignorowana w przypadku pobierania HTTP.
Podczas wysyłania do odtwarzacza wideo nagranego wcześniej strumienia należy ustawić dla właściwości isLive
wartość false
, wartość true
ustawić podczas wysyłania danych w czasie rzeczywistym (np.: transmisja na żywo). W celu zapewnienia lepszej wydajności po ustawieniu dla właściwości isLive
wartości false
nie należy ustawiać dla właściwości bufferTime
wartości 0
.
Implementacja
public function get isLive():Boolean
Powiązane elementy interfejsu API
isRTMP | właściwość |
isRTMP:Boolean
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wartość logiczna (Boolean), której ustawienie to true
, gdy plik FLV jest pobierany strumieniowo z serwera Flash Media Server (FMS) przy użyciu protokołu RTMP. Przyjmuje wartość false
dla każdego innego źródła pliku FLV.
Implementacja
public function get isRTMP():Boolean
Powiązane elementy interfejsu API
metadata | właściwość |
metadata:Object
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Obiekt będący pakietem metadanych, które odebrano wskutek wywołania metody NetSteam.onMetaData()
(jeśli jest ona dostępna). Gotowe, gdy wywoływane jest zdarzenie metadataReceived
.
Jeżeli plik FLV jest kodowany za pomocą kodera Flash 8, to właściwość metadata
zawiera następujące informacje. Starsze pliki FLV zawierają jedynie wartości height
, width
i duration
.
Parametr | Opis |
---|---|
canSeekToEnd | Wartość logiczna (Boolean), której ustawienie to true , jeżeli plik FLV jest zakodowany z klatką kluczową na ostatniej klatce, która pozwala na wyszukiwanie do końca stopniowo pobieranego klipu filmowego. Wartość jest false , gdy plik FLV nie jest zakodowany z kluczową klatką na ostatniej klatce. |
cuePoints | Tablica obiektów, jedna dla każdego punktu wskazującego osadzonego w pliku FLV. Wartość jest niezdefiniowana, jeżeli plik FLV nie zawiera punktów wskazujących. Każdy obiekt ma następujące właściwości:
|
audiocodecid | Liczba wskazująca użyty kodek audio (technika kodowania/dekodowania). |
audiodelay | Liczba reprezentująca czas 0 w pliku źródłowym, z którego został zakodowany plik FLV.
Zawartość wideo jest opóźniana na krótki okres czasu wymagany do zsynchronizowania z dźwiękiem. Przykład: jeśli wartość Należy pamiętać o tym, że klasy FLVPlayback i VideoPlayer kompensują to opóźnienie w swoich ustawieniach czasu. Oznacza to możliwość dalszego korzystania z ustawień czasowych używanych w pliku źródłowym. |
audiodatarate | Liczba określająca ilość danych audio w kilobajtach na sekundę. |
videocodecid | Liczba będąca wersją kodeka użytego do kodowania obrazu wideo. |
framerate | Liczba określająca liczba klatek na sekundę w pliku FLV. |
videodatarate | Liczba określająca przepustowość wideo w pliku FLV. |
height | Liczba będąca wysokością pliku FLV. |
width | Liczba będąca szerokością pliku FLV. |
duration | Liczba określająca w sekundach czas trwania pliku FLV. |
Implementacja
public function get metadata():Object
Powiązane elementy interfejsu API
ncMgr | właściwość |
ncMgr:INCManager
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Obiekt INCManager, który zapewnia dostęp do instancji klasy implementującej INCManager
, która stanowi interfejs klasy NCManager.
Właściwość tą można wykorzystać do zaimplementowania niestandardowego interfejsu INCManager, wymagającego specjalnej inicjalizacji.
Implementacja
public function get ncMgr():INCManager
Powiązane elementy interfejsu API
netConnection | właściwość |
netConnection:NetConnection
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Umożliwia bezpośredni dostęp do instancji obiektu NetConnection utworzonej za pomocą odtwarzacza wideo.
Implementacja
public function get netConnection():NetConnection
netStream | właściwość |
netStream:NetStream
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Umożliwia bezpośredni dostęp do instancji obiektu NetStream utworzonej za pomocą odtwarzacza wideo.
Implementacja
public function get netStream():NetStream
netStreamClientClass | właściwość |
public static var netStreamClientClass:Object
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.115.0, AIR 1.0 |
Rejestruje klasę własną dla właściwości klienta NetStream. Domyślnie używana jest klasa fl.video.VideoPlayerClient
; ta klasa obsługuje komunikaty onMetaData()
i onCuePoint()
. W celu dodania niestandardowych funkcji obsługi dla innych komunikatów, takich jak onImageData()
i onTextData()
, można utworzyć własną klasę i ustawić tę właściwość dla tej klasy.
Konstruktor dla tej klasy musi pobierać instancję VideoPlayer
jako jedyny parametr i musi zawierać właściwość ready typu Boolean. Gdy klient oczekuje na komunikaty danych oczekiwane na początku pliku, właściwość powinna mieć wartość false
. Jeśli obiekt VideoPlayer wykona operację automatycznego przewijania i zmiany wielkości przed odebraniem tych komunikatów, może się zdarzyć, że te komunikaty nigdy nie zostaną dodane. Domyślnie klasa fl.video.VideoPlayerClient
zwróci wartość true
z właściwości ready natychmiast po wywołaniu metody onMetaData()
.
Dla właściwości można ustawić obiekt klasy (jak w przykładzie poniżej) lub nazwę ciągu znaków klasy:
import fl.video. VideoPlayer.netStreamClientClass = MyCustomClient;
Ustawienie nazwy ciągu znaków klasy nie wystarczy do wymuszenia kompilacji klasy na format SWF. Wartością domyślną jest obiekt fl.video.VideoPlayerClient
klasy, a nie ciąg znaków nazwy.
Zalecane jest, aby każda niestandardowa implementacja zawierała podklasę fl.video.VideoPlayer
. W przeciwnym wypadku istnieje ryzyko uszkodzenia funkcji obsługi metadanych i punktu wskazującego, jakie są wbudowane do obiektu VideoPlayer i składnika FLVPlayback.
Wartością domyślną jest fl.video.VideoPlayerClient.
Zgłasza
VideoError — Jeśli dla tej właściwości ustawiono niepoprawną wartość, zostanie zgłoszony błąd VideoError.NETSTREAM_CLIENT_CLASS_UNSET .
|
playheadTime | właściwość |
playheadTime:Number
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba, która jest bieżącym czasem lub położeniem głowicy odtwarzania mierzonym w sekundach (może być wartością ułamkową). Ustawienie tej właściwości wyzwala wyszukiwanie i aktywuje wszystkie ograniczenia wyszukiwania.
Podczas odtwarzania pliku FLV, po zmianie czasu głowicy odtwarzania, co następuje co 0,25 sekundy, składnik wywołuje zdarzenie playheadUpdate
.
Z pewnych przyczyn właściwość playheadTime
może nie mieć spodziewanej wartości zaraz po wywołaniu jednej z metod wyszukiwania lub ustawieniu właściwości playheadTime
w celu wyszukiwania. Po pierwsze: w przypadku pobierania stopniowego można wyszukiwać jedynie ramki kluczowe, dlatego wyszukiwanie przenosi się do pierwszej ramki kluczowej po określonym czasie. (Podczas przesyłania strumieniowego wyszukiwanie zawsze przenosi się do dokładnie określonego punktu czasowego, nawet jeżeli plik FLV nie ma tam klatki kluczowej). Po drugie: wyszukiwanie jest asynchroniczne, więc jeżeli została wywołana metoda lub właściwość playheadTime
, to ta właściwość playheadTime nie zostanie zaktualizowana natychmiast. Aby uzyskać czas po zakończeniu wyszukiwania, należy wykrywać zdarzenie seek
, które nie rozpocznie się dopóki nie zostanie zaktualizowana właściwość playheadTime
.
Implementacja
public function get playheadTime():Number
public function set playheadTime(value:Number):void
Powiązane elementy interfejsu API
playheadUpdateInterval | właściwość |
playheadUpdateInterval:Number
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba milisekund określająca czas między poszczególnymi zdarzeniami playheadUpdate
. Ustawienie tej właściwości w trakcie odtwarzania pliku FLV, uruchamia ponownie czasomierz.
Rozmieszczanie punktów wskazujących ActionScript zaczyna się od aktualizacji głowicy odtwarzania, dlatego obniżenie wartości właściwość playheadUpdateInterval
może zwiększyć dokładność punktów wskazujących ActionScript.
Ponieważ interwał aktualizacji głowicy odtwarzania jest ustawiony przez wywołanie metody globalnej setInterval()
, aktualizacja nie może być wyzwalana częściej niż wynosi liczba klatek na sekundę pliku SWF (tak jak każdy interwał ustawiany tym sposobem). Przykład: dla domyślnej liczby 12 klatek na sekundę, najniższy efektywny interwał jaki można utworzyć wynosi około 83 milisekundy lub jedną sekundę (1000 milisekund) podzieloną przez 12.
Wartością domyślną jest 250.
Implementacja
public function get playheadUpdateInterval():Number
public function set playheadUpdateInterval(value:Number):void
Powiązane elementy interfejsu API
progressInterval | właściwość |
progressInterval:Number
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba będąca ilością czasu w milisekundach między poszczególnymi zdarzeniami progress
. Ustawienie tej właściwości podczas odtwarzania strumienia wideo powoduje ponowne uruchomienie czasomierza.
Implementacja
public function get progressInterval():Number
public function set progressInterval(value:Number):void
registrationHeight | właściwość |
registrationHeight:Number
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wysokość stosowana do wyrównywania elementów wideo podczas automatycznej zmiany rozmiaru. Nie należy mylić właściwości registrationHeight
z właściwością height
. Właściwość height
odzwierciedla rzeczywistą wysokość zawartości wideo.
Przykład 1: ładowanie pliku 80x80 FLV z następującymi ustawieniami:
registrationX
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
=VideoAlign.CENTER
scaleMode
=VideoScaleMode.NO_SCALE
x
= 90y
= 80width
= 80height
= 80
Przykład 2: ładowanie z tym samym scenariuszem, co w przykładzie 1, ale z następującymi ustawieniami:
scaleMode
=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x
= 110y
= 100width
= 40height
= 80
Przykład 3: ładowanie z tym samym scenariuszem, co w przykładzie 2, ale z następującymi ustawieniami:
scaleMode
=VideoScaleMode.EXACT_FIT
x
= 100y
= 100width
= 60height
= 40
Ustawienie właściwości registrationHeight
jest równoważne ustawieniu właściwości height
— i vice versa. Ustawienie jakiejkolwiek innej właściwości lub wywołanie innej metody, która powoduje zmianę wysokości, np. scaleX
, setSize
i setScale
również powoduje zachowanie synchronizacji właściwości height
i registrationHeight
.
Implementacja
public function get registrationHeight():Number
public function set registrationHeight(value:Number):void
Powiązane elementy interfejsu API
registrationWidth | właściwość |
registrationWidth:Number
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Szerokość stosowana do wyrównywania elementów wideo podczas automatycznej zmiany rozmiaru. Nie należy mylić właściwości registrationWidth
z właściwością width
. Właściwość width
odzwierciedla rzeczywistą szerokość zawartości wideo.
Przykład 1: ładowanie pliku 80x80 FLV z następującymi ustawieniami:
registrationX
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
=VideoAlign.CENTER
scaleMode
=VideoScaleMode.NO_SCALE
x
= 90y
= 80width
= 80height
= 80
Przykład 2: ładowanie z tym samym scenariuszem, co w przykładzie 1, ale z następującymi ustawieniami:
scaleMode
=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x
= 110y
= 100width
= 40height
= 80
Przykład 3: ładowanie z tym samym scenariuszem, co w przykładzie 2, ale z następującymi ustawieniami:
scaleMode
=VideoScaleMode.EXACT_FIT
x
= 100y
= 100width
= 60height
= 40
Ustawienie właściwości registrationWidth
jest równoważne ustawieniu właściwości width
— i vice versa. Ustawienie jakiejkolwiek innej właściwości lub wywołanie innej metody, która powoduje zmianę szerokości, np. scaleX
, setSize
i setScale
również powoduje zachowanie synchronizacji właściwości width
i registrationWidth
.
Implementacja
public function get registrationWidth():Number
public function set registrationWidth(value:Number):void
Powiązane elementy interfejsu API
registrationX | właściwość |
registrationX:Number
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Współrzędna x stosowana do wyrównywania elementów wideo podczas automatycznej zmiany rozmiaru. Nie należy mylić jej z właściwością x
, która odzwierciedla aktualne położenie zawartości wideo.
Przykład 1: ładowanie pliku 80x80 FLV z następującymi ustawieniami:
registrationX
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
=VideoAlign.CENTER
scaleMode
=VideoScaleMode.NO_SCALE
x
= 90y
= 80width
= 80height
= 80
Przykład 2: ładowanie z tym samym scenariuszem, co w przykładzie 1, ale z następującymi ustawieniami:
scaleMode
=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x
= 110y
= 100width
= 40height
= 80
Przykład 3: ładowanie z tym samym scenariuszem, co w przykładzie 2, ale z następującymi ustawieniami:
scaleMode
=VideoScaleMode.EXACT_FIT
x
= 100y
= 100width
= 60height
= 40
Jeśli ustawiona jest właściwość x
lub registrationX
, druga właściwość zostanie zmieniona w celu zachowania jej przesunięcia od pierwszej. Na przykład: jeśli x
= 10 i registrationX
= 20, wówczas ustawienie x
= 110 powoduje również ustawienie registrationX
= 120.
Implementacja
public function get registrationX():Number
public function set registrationX(value:Number):void
Powiązane elementy interfejsu API
registrationY | właściwość |
registrationY:Number
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Współrzędna y stosowana do wyrównywania elementów wideo podczas automatycznej zmiany rozmiaru. Nie należy mylić jej z właściwością y
, która odzwierciedla aktualne położenie zawartości wideo.
Przykład 1: ładowanie pliku 80x80 FLV z następującymi ustawieniami:
registrationX
= 100registrationY
= 100registrationWidth
= 60registrationHeight
= 40align
=VideoAlign.CENTER
scaleMode
=VideoScaleMode.NO_SCALE
x
= 90y
= 80width
= 80height
= 80
Przykład 2: ładowanie z tym samym scenariuszem, co w przykładzie 1, ale z następującymi ustawieniami:
scaleMode
=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x
= 110y
= 100width
= 40height
= 80
Przykład 3: ładowanie z tym samym scenariuszem, co w przykładzie 2, ale z następującymi ustawieniami:
scaleMode
=VideoScaleMode.EXACT_FIT
x
= 100y
= 100width
= 60height
= 40
Jeśli ustawiona jest właściwość y
lub registrationY
, druga właściwość zostanie zmieniona w celu zachowania jej przesunięcia od pierwszej. Na przykład: jeśli y
= 10 i registrationY
= 20, ustawienie y
= 110 powoduje również ustawienie registrationY
= 120.
Implementacja
public function get registrationY():Number
public function set registrationY(value:Number):void
Powiązane elementy interfejsu API
scaleMode | właściwość |
scaleMode:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Określa metodę zmiany rozmiaru wideo po załadowaniu danych. Ustawienie wartości VideoScaleMode.MAINTAIN_ASPECT_RATIO
powoduje zachowanie proporcji w prostokącie zdefiniowanym przez właściwości registrationX
, registrationY
, registrationWidth
i registrationHeight
. Ustawienie wartości VideoScaleMode.NO_SCALE
powoduje automatyczną zmianę rozmiarów wideo do rozmiarów źródłowego pliku FLV. Ustawienie wartości VideoScaleMode.EXACT_FIT
powoduje ignorowanie rozmiarów źródłowego pliku FLV i rozciągnięcie wideo w taki sposób, aby dopasować je do prostokąta zdefiniowanego przez właściwości registrationX
, registrationY
, registrationWidth
i registrationHeight
. Jeśli ta właściwość zostanie ustawiona po załadowaniu pliku FLV, natychmiast rozpocznie się automatyczna zmiana układu. Wartości pochodzą z VideoScaleMode
.
Wartością domyślną jest VideoScaleMode.MAINTAIN_ASPECT_RATIO.
Implementacja
public function get scaleMode():String
public function set scaleMode(value:String):void
Powiązane elementy interfejsu API
scaleX | właściwość |
scaleX:Number
[przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba określająca skalę poziomą.
Wartością domyślną jest 1.
Implementacja
override public function get scaleX():Number
override public function set scaleX(value:Number):void
Powiązane elementy interfejsu API
scaleY | właściwość |
scaleY:Number
[przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba określająca skalę pionową.
Wartością domyślną jest 1.
Implementacja
override public function get scaleY():Number
override public function set scaleY(value:Number):void
Powiązane elementy interfejsu API
soundTransform | właściwość |
soundTransform:flash.media:SoundTransform
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Zapewnia bezpośredni dostęp do właściwości NetStream.soundTransform
, która daje lepszą kontrolę nad dźwiękiem. Tę właściwość należy ustawić w celu zmiany ustawień; w celu pobrania aktualnych ustawień należy użyć metody operatora pobierania, która należy do właściwości.
Implementacja
public function get soundTransform():flash.media:SoundTransform
public function set soundTransform(value:flash.media:SoundTransform):void
Powiązane elementy interfejsu API
source | właściwość |
source:String
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Ciąg znaków określający adres URL pliku FLV oraz sposób jego przetwarzania strumieniowego. Adres URL może być adresem HTTP URL pliku FLV, adresem RTMP URL strumienia, lub adresem HTTP URL pliku XML.
Jeżeli właściwość ta została ustawiona przez Inspektora składników lub Inspektora właściwości, plik FLV rozpocznie pobieranie i odtwarzanie przy następnym zdarzeniu enterFrame
. Opóźnienie pozwala na ustawienie właściwości isLive
, autoPlay
i cuePoints
, które między innymi wpływają na ładowanie. Pozwala również, aby kod ActionScript znajdujący się w pierwszej klatce mógł wpłynąć na składnik FLVPlayback zanim rozpocznie on odtwarzanie.
Jeżeli ta właściwość zostanie ustawiona za pomocą ActionScript, wywołuje natychmiast metodę VideoPlayer.load()
, gdy właściwość autoPlay
ma wartość false
. Może również wywołać metodę VideoPlayer.play()
, gdy właściwość autoPlay
ma wartość true
. Właściwości autoPlay
, totalTime
i isLive
wpływają na sposób ładowania nowych plików FLV, właściwości te muszą być ustawiane przed ustawieniem właściwości source
.
Ustawienie właściwości autoPlay
na false
zapobiega automatycznemu odtwarzaniu nowych plików FLV.
Implementacja
public function get source():String
Powiązane elementy interfejsu API
state | właściwość |
state:String
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Ciąg znaków określający stan składnika. Ta właściwość jest ustawiana przez metody load()
, play()
, stop()
, pause()
i seek()
.
Możliwe wartości dla właściwości state: buffering
, connectionError
, disconnected
, loading
, paused
, playing
, rewinding
, seeking
i stopped
. W celu sprawdzania stanów można użyć klasy FLVPlayback.
Implementacja
public function get state():String
Powiązane elementy interfejsu API
stateResponsive | właściwość |
stateResponsive:Boolean
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wartość logiczna (Boolean) true
w przypadku, gdy stan to gotowość do odpowiedzi. Jeśli stan to brak gotowości do odpowiedzi, wywołania metod play()
, load()
, stop()
, pause()
i seek()
są ustawiane w kolejce i wykonywane później po zmianie stanu na stan gotowości do odpowiedzi. Te wywołania są ustawiane w kolejce i wykonywane później, dlatego zwykle nie ma konieczności śledzenia wartości właściwości stateResponsive
. Stany gotowości do odpowiedzi: stopped
, playing
, paused
i buffering
.
Implementacja
public function get stateResponsive():Boolean
Powiązane elementy interfejsu API
totalTime | właściwość |
totalTime:Number
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba będąca całkowitym czasem odtwarzania wideo (w sekundach).
W przypadku przesyłania strumieniowego z serwera Flash Media Server (FMS) i korzystania z domyślnego obiektu NCManager
ta wartość jest określana automatycznie przez interfejsy programistyczne aplikacji po stronie serwera (API) i ta wartość zastępuje wszystkie wartości ustawione przez tę właściwość lub zgromadzone z metadanych. Ta właściwość jest gotowa do odczytania po osiągnięciu stanu stopped
lub playing
po ustawieniu właściwości source
. Właściwość ta nie ma znaczenia dla strumieni odtwarzanych na żywo z FMS.
W przypadku pobierania HTTP wartość jest określana automatycznie, jeśli plik FLV zawiera osadzone metadane — w przeciwnym wypadku należy ustawić wartość jawnie lub będzie to NaN. Jeśli wartość zostanie ustawiona jawnie, wartość metadanych w strumieniu będzie ignorowana.
Po ustawieniu tej właściwości wartość wpływa na następny plik FLV, który jest ładowany poprzez ustawienie source
. Właściwość nie ma wpływu na plik FLV, który został już załadowany. Ponadto ta właściwość nie zwraca nowej wartości przekazanej do czasu załadowania nowego pliku FLV.
Jeśli właściwość nie zostanie ustawiona (jawnie lub automatycznie), odtwarzanie będzie działało, ale mogą wystąpić problemy związane z elementami sterującymi wyszukiwaniem.
Jeśli wartość nie jest ustawiona jawnie, będzie to NaN do czasu ustawienia poprawnej wartości z metadanych.
Implementacja
public function get totalTime():Number
Powiązane elementy interfejsu API
videoHeight | właściwość |
videoHeight:int
[tylko do odczytu] [przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Szerokość źródłowa załadowanego pliku FLV. Jeżeli informacja nie jest jeszcze dostępna, to właściwość ta zwraca -1.
Implementacja
override public function get videoHeight():int
Powiązane elementy interfejsu API
videoWidth | właściwość |
videoWidth:int
[tylko do odczytu] [przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Szerokość źródłowa załadowanego pliku FLV. Jeżeli informacja nie jest jeszcze dostępna, to właściwość ta zwraca -1.
Implementacja
override public function get videoWidth():int
Powiązane elementy interfejsu API
visible | właściwość |
visible:Boolean
[przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wartość typu Boolean, dla której ustawienie true
powoduje widoczność instancji VideoPlayer. Wartość false
sprawia, że instancja jest niewidoczna.
Wartością domyślną jest true.
Implementacja
override public function get visible():Boolean
override public function set visible(value:Boolean):void
volume | właściwość |
volume:Number
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba w zakresie od 0 do 1, która wskazuje ustawienie elementu sterującego głośnością.
Wartością domyślną jest 1.
Implementacja
public function get volume():Number
public function set volume(value:Number):void
Powiązane elementy interfejsu API
width | właściwość |
width:Number
[przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba określająca szerokość wystąpienia klasy VideoPlayer na stole montażowym.
Uwaga: Właściwość flash.media.Video.width
jest podobna do właściwości fl.video.VideoPlayer.videoWidth
.
Implementacja
override public function get width():Number
override public function set width(value:Number):void
Powiązane elementy interfejsu API
x | właściwość |
x:Number
[przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba określająca poziome położenie odtwarzacza wideo (w pikselach).
Ustawienie właściwości x
wpływa również na właściwość registrationX
. Jeśli ustawiona jest właściwość x
lub registrationX
, druga właściwość zostanie zmieniona w celu zachowania jej przesunięcia od pierwszej. Na przykład: jeśli x
= 10 i registrationX
= 20, wówczas ustawienie x
= 110 powoduje również ustawienie registrationX
= 120.
Implementacja
override public function get x():Number
override public function set x(value:Number):void
Powiązane elementy interfejsu API
y | właściwość |
y:Number
[przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba określająca pionowe położenie odtwarzacza wideo (w pikselach).
Ustawienie właściwości y
wpływa również na właściwość registrationY
. Jeśli ustawiona jest właściwość y
lub registrationY
, druga właściwość zostanie zmieniona w celu zachowania jej przesunięcia od pierwszej. Na przykład: jeśli y
= 10 i registrationY
= 20, ustawienie y
= 110 powoduje również ustawienie registrationY
= 120.
Implementacja
override public function get y():Number
override public function set y(value:Number):void
Powiązane elementy interfejsu API
VideoPlayer | () | Konstruktor |
public function VideoPlayer(width:int = 320, height:int = 240)
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Tworzy obiekt VideoPlayer o określonej wysokości i szerokości.
Parametrywidth:int (default = 320 ) — Szerokość odtwarzacza wideo w pikselach.
| |
height:int (default = 240 ) — Wysokość odtwarzacza wideo w pikselach.
|
Powiązane elementy interfejsu API
close | () | metoda |
public function close():void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Powoduje zamknięcie strumienia wideo i połączenia z serwerem Flash Media Server. Ta metoda wywołuje zdarzenie close
. Zwykle nie jest potrzebne bezpośrednie wywołanie tej metody, ponieważ funkcja limitu czasu bezczynności pamięta o konieczności zamknięcia strumienia.
Powiązane elementy interfejsu API
load | () | metoda |
public function load(url:String, totalTime:Number = NaN, isLive:Boolean = false, startTime:Number = NaN, duration:Number = NaN):void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Podobna do metody play()
, lecz powoduje ładowanie pliku FLV bez odtwarzania. W razie potrzeby dochodzi do automatycznej zmiany wielkości oraz przy wyświetleniu pierwszej klatki pliku FLV. Po wstępnym załadowaniu i automatycznym zdefiniowaniu układu stan jest następujący: VideoState.PAUSED
.
W tej metodzie stosowane są takie same parametry, co w metodzie play()
, ale metody load()
nie można wywołać bez adresu URL. W przypadku wywołania bez adresu zgłaszany jest błąd. Jeśli odtwarzacz jest w stanie bez odpowiedzi, metoda load()
umieszcza żądanie w kolejce.
Parametry
url:String — Ciąg znaków URL dla pliku FLV, który ma zostać załadowany. Jeśli nie zostanie wprowadzona żadna wartość adresu URL, zostanie zgłoszony błąd z komunikatem null URL sent to VideoPlayer.load .
| |
totalTime:Number (default = NaN ) — Długość pliku FLV. W celu automatycznego wykrywania długości z metadanych, serwera lub XML należy wprowadzić wartość 0, null lub undefined.
| |
isLive:Boolean (default = false ) — W przypadku strumieniowego przesyłania na żywo z serwera Flash Media Server (FMS) wartością jest true .
| |
startTime:Number (default = NaN ) — Czas, w sekundach, który należy traktować jako czas 0 w określonym pliku multimedialnym. Odtwarzanie rozpocznie się od tego miejsca, playheadTime będzie traktować startTime jako równy 0, a wyszukiwanie przed tym czasem nie będzie możliwe (wyszukiwanie do 0 spowoduje wyszukiwanie do określonego momentu startTime). Ten parametr jest ignorowany, jeśli isLive ma wartość true.
| |
duration:Number (default = NaN ) — Czas w sekundach traktowany jako czas trwania pliku multimedialnego. Stosowane tylko wówczas, gdy startTime <= 0. W przypadku startTime ten parametr definiuje segment pliku multimedialnego, który jest traktowany jako cały plik przez program VideoPlayer. Po odtworzeniu takiej ilości materiału, jaką określa czas trwania w sekundach, nastąpi zatrzymanie odtwarzania i wywołanie zdarzenia zakończenia. Próby wyszukiwania poza czas trwania zakończą się niepowodzeniem. Jeśli zostanie uzyskana wartość właściwości totalTime, będzie ona zawierała określony czas trwania. To odróżnia parametr totalTime dla tej metody, ponieważ ten parametr jest używany w celu określenia rzeczywistego czasu trwania pliku multimedialnego, co jest najbardziej użyteczne, gdy plik nie zawiera metadanych z taką informacją; jeśli wartość totalTime jest mniejsza niż rzeczywisty czas trwania pliku multimedialnego, nie spowoduje to zatrzymania odtwarzania. Jednak w przypadku tego parametru czasu odtwarzanie ZOSTANIE zatrzymane. Ten parametr jest ignorowany, jeśli właściwość isLive ma wartość true.
|
Powiązane elementy interfejsu API
ncConnected | () | metoda |
public function ncConnected():void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wywoływana przez obiekt INCManager po zakończeniu lub przerwaniu połączenia w efekcie wywołania metody INCManager.connectToURL()
. Jeśli połączenie nie powiodło się, przed wywołaniem należy ustawić dla właściwości INCManager.netConnection
wartość null
lub undefined.
Powiązane elementy interfejsu API
ncReconnected | () | metoda |
public function ncReconnected():void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wywoływana przez obiekt INCManager po zakończeniu lub przerwaniu ponownego połączenia w efekcie wywołania metody INCManager.reconnect()
. Jeśli połączenie nie powiodło się, przed wywołaniem należy ustawić dla właściwości INCManager.netconnection
wartość null
.
Powiązane elementy interfejsu API
pause | () | metoda |
public function pause():void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wstrzymuje odtwarzanie wideo. Jeśli wideo jest zatrzymane lub wstrzymane, wywołanie tej metody nie ma żadnego efektu. Aby ponownie rozpocząć odtwarzanie, należy wywołać metodę play()
. W tej metodzie nie są używane parametry.
Jeśli odtwarzacz jest w stanie bez odpowiedzi, metoda pause()
umieszcza żądanie w kolejce.
Jeśli nie jest podłączony żaden strumień, wywołanie powoduje zgłoszenie wyjątku. W celu określenia, czy wywołanie metody jest bezpieczne, należy użyć zdarzenia stateChange
i właściwości connected
.
Jeśli odtwarzacz jest w stanie zatrzymania, wywołanie metody pause()
nie powoduje żadnej zmiany i odtwarzacz pozostaje w stanie zatrzymania.
Powiązane elementy interfejsu API
play | () | metoda |
public function play(url:String = null, totalTime:Number = NaN, isLive:Boolean = false, startTime:Number = NaN, duration:Number = NaN):void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Powoduje odtwarzanie wideo. Może zostać wywołana, gdy odtwarzanie wideo jest wstrzymane lub zatrzymane lub gdy wideo jest już odtwarzane. W celu odtwarzania załadowanego wideo należy wywołać tę metodę bez argumentów, a w celu załadowania nowego strumienia należy wprowadzić adres URL.
Jeśli odtwarzacz jest w stanie bez odpowiedzi, umieszcza żądanie w kolejce.
Jeśli nie jest podłączony żaden strumień, wywołanie bez argumentów powoduje zgłoszenie wyjątku. W celu określenia, czy wywołanie metody jest bezpieczne, należy użyć zdarzenia stateChange
i właściwości connected
.
Parametry
url:String (default = null ) — W celu załadowania i odtworzenia nowego pliku FLV należy wprowadzić ciąg znaków URL. Jeśli plik FLV został już załadowany i użytkownik chce kontynuować jego odtwarzanie, należy wprowadzić wartość null .
| |
totalTime:Number (default = NaN ) — Należy wprowadzić długość pliku FLV. W celu automatycznego wykrywania długości z metadanych, serwera lub XML należy wprowadzić wartość 0 lub NaN . Jeśli w czasie wywoływania właściwości ncConnected właściwość INCManager.streamLength ma wartość inną niż 0 , null lub undefined, ta wartość właściwości ma priorytet wyższy niż wartość opisywana.
| |
isLive:Boolean (default = false ) — W przypadku strumieniowego przesyłania na żywo z serwera Flash Media Server (FMS) należy wprowadzić wartość true .
| |
startTime:Number (default = NaN ) — Czas, w sekundach, który należy traktować jako czas 0 w określonym pliku multimedialnym. Odtwarzanie rozpocznie się od tego miejsca, playheadTime będzie traktować startTime jako równy 0, a wyszukiwanie przed tym czasem nie będzie możliwe (wyszukiwanie do 0 spowoduje wyszukiwanie do określonego momentu startTime). Ten parametr jest ignorowany, jeśli isLive ma wartość true.
| |
duration:Number (default = NaN ) — Czas w sekundach traktowany jako czas trwania pliku multimedialnego. Stosowane tylko wówczas, gdy startTime <= 0. W przypadku startTime ten parametr definiuje segment pliku multimedialnego, który jest traktowany jako cały plik przez program VideoPlayer. Po odtworzeniu takiej ilości materiału, jaką określa czas trwania w sekundach, nastąpi zatrzymanie odtwarzania i wywołanie zdarzenia zakończenia. Próby wyszukiwania poza czas trwania zakończą się niepowodzeniem. Jeśli zostanie uzyskana wartość właściwości totalTime, będzie ona zawierała określony czas trwania. To odróżnia parametr totalTime dla tej metody, ponieważ ten parametr jest używany w celu określenia rzeczywistego czasu trwania pliku multimedialnego, co jest najbardziej użyteczne, gdy plik nie zawiera metadanych z taką informacją; jeśli wartość totalTime jest mniejsza niż rzeczywisty czas trwania pliku multimedialnego, nie spowoduje to zatrzymania odtwarzania. Jednak w przypadku tego parametru czasu odtwarzanie ZOSTANIE zatrzymane. Ten parametr jest ignorowany, jeśli właściwość isLive ma wartość true.
|
Powiązane elementy interfejsu API
playWhenEnoughDownloaded | () | metoda |
public function playWhenEnoughDownloaded():void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Odtwarza plik FLV, jeżeli została pobrana wystarczająca ilość danych. Jeżeli plik FLV został pobrany lub jest przesyłany strumieniowo z serwera Flash Media Server (FMS), to wywołanie metody playWhenEnoughDownloaded()
jest takie samo, jak wywołanie metody play()
bez parametrów. Wywołanie tej metody nie powoduje wstrzymania odtwarzania, tak więc w wielu przypadkach wymagane jest wywołanie przed nią metody pause()
.
seek | () | metoda |
public function seek(time:Number):void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pozwala odszukać w pliku określony punkt czasowy z dokładnością do trzech miejsc po przecinku (milisekund). Jeśli odtwarzane jest wideo, jego odtwarzanie będzie kontynuowane od tego punktu czasowego. Jeśli wideo jest wstrzymane, zostanie odszukany dany punkt czasowy i odtwarzanie nadal pozostanie wstrzymane. Jeśli wideo jest zatrzymane, zostanie odszukany dany punkt czasowy i odtwarzacz przejdzie do stanu wstrzymania. Nie ma wpływu na strumienie „na żywo”.
Właściwość playheadTime
może nie mieć spodziewanej wartości zaraz po wywołaniu jednej z metod wyszukiwania lub ustawieniu właściwości playheadTime
w celu wyszukiwania. W przypadku pobierania stopniowego można wyszukiwać jedynie ramki kluczowej, dlatego wyszukiwanie przenosi się do pierwszej ramki kluczowej po określonym czasie.
Uwaga: Podczas przesyłania strumieniowego wyszukiwanie zawsze przenosi się do dokładnie określonego punktu czasowego, nawet jeżeli plik FLV nie ma tam klatki kluczowej.
Wyszukiwanie jest asynchroniczne, dlatego wywołanie metody seek lub ustawienie właściwości playheadTime
nie powoduje natychmiastowej aktualizacji wartości playheadTime
. Aby uzyskać czas po zakończeniu wyszukiwania, należy wykrywać zdarzenie seek
, które nie rozpocznie się dopóki nie zostanie zaktualizowana właściwość playheadTime
.
Jeśli nie jest podłączony żaden strumień, wywołanie powoduje zgłoszenie wyjątku. W celu określenia, czy wywołanie metody jest bezpieczne, należy użyć zdarzenia stateChange
i właściwości connected
.
Parametry
time:Number — Liczba w sekundach określająca punkt czasowy, w którym zostanie umieszczona głowica odtwarzania.
|
Zgłasza
VideoError — Jeśli punkt czasowy < 0 lub NaN .
|
Powiązane elementy interfejsu API
setScale | () | metoda |
public function setScale(scaleX:Number, scaleY:Number):void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Ustawia jednocześnie właściwości scaleX
i scaleY
. Ustawienie właściwości scaleX
lub scaleY
osobno wywołuje dwa zdarzenia autolayout
, a wywołanie metody setScale()
powoduje wywołanie tylko jednego zdarzenia autolayout
.
Jeżeli właściwość scaleMode
ma ustawioną wartość VideoScaleMode.MAINTAIN_ASPECT_RATIO
lub VideoScaleMode.NO_SCALE
, to wywołanie tej metody powoduje natychmiastowe zdarzenie autolayout
.
Parametry
scaleX:Number — Liczba reprezentująca skalę poziomą.
| |
scaleY:Number — Liczba reprezentująca skalę pionową.
|
Powiązane elementy interfejsu API
setSize | () | metoda |
public function setSize(width:Number, height:Number):void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Ustawia jednocześnie właściwości width
i height
. Ustawienie właściwości width
lub height
osobno wywołuje dwa zdarzenia autolayout
, a wywołanie metody setSize()
powoduje wywołanie tylko jednego zdarzenia autolayout
.
Jeżeli właściwość scaleMode
ma ustawioną wartość VideoScaleMode.MAINTAIN_ASPECT_RATIO
lub VideoScaleMode.NO_SCALE
, to wywołanie tej metody powoduje natychmiastowe wywołanie zdarzenia autolayout
.
Parametry
width:Number — Szerokość odtwarzacza wideo.
| |
height:Number — Wysokość odtwarzacza wideo.
|
Powiązane elementy interfejsu API
stop | () | metoda |
public function stop():void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Zatrzymuje odtwarzanie wideo. Jeśli dla właściwości autoRewind
ustawiona jest wartość true
, następuje przewinięcie do pierwszej klatki. Jeśli wideo jest zatrzymane, wywołanie tej metody nie ma żadnego efektu. Aby ponownie rozpocząć odtwarzanie, należy wywołać metodę play()
. W tej metodzie nie są używane parametry.
Jeśli odtwarzacz jest w stanie bez odpowiedzi, umieszcza żądanie w kolejce.
Jeśli nie jest podłączony żaden strumień, wywołanie powoduje zgłoszenie wyjątku. W celu określenia, czy wywołanie metody jest bezpieczne, należy użyć zdarzenia stateChange
i właściwości connected
.
Powiązane elementy interfejsu API
autoRewound | Zdarzenie |
fl.video.VideoEvent
właściwość VideoEvent.type =
fl.video.VideoEvent.AUTO_REWOUND
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wywoływane, gdy głowica odtwarzania znajduje się w punkcie początkowym odtwarzacza wideo (właściwość autoRewind
ma wartość true
).
Zdarzenie autoRewound
jest typu VideoEvent i posiada stałą VideoEvent.AUTO_REWOUND
.
type
obiektu zdarzenia autoRewound
.
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ć. |
state | Łańcuch znaków identyfikujący stałą z klasy VideoState, która opisuje stan odtwarzania dla składnika. |
playheadTime | Liczba będąca aktualnym czasem lub położeniem głowicy odtwarzania. |
vp | Indeks obiektu VideoPlayer. |
Powiązane elementy interfejsu API
close | Zdarzenie |
fl.video.VideoEvent
właściwość VideoEvent.type =
fl.video.VideoEvent.CLOSE
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wywoływane przez instancję VideoPlayer, gdy instancja zamyka połączenie NetConnection na skutek przekroczenia limitu czasu lub na skutek wywołania metody close()
, load()
lub play()
lub ustawienia właściwości source
, co powoduje zamknięcie połączenia RTMP. Instancja klasy FLVPlayback wywołuje to zdarzenie jedynie podczas przesyłania strumieniowego z serwera Flash Media Server (FMS) lub innej usługi Flash Video Streaming Service (FVSS).
Zdarzenie close
jest typu VideoEvent i posiada VideoEvent.CLOSE
.
type
obiektu zdarzenia close
.
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ć. |
state | Łańcuch znaków identyfikujący stałą z klasy VideoState, która opisuje stan odtwarzania dla składnika. |
playheadTime | Liczba będąca aktualnym czasem lub położeniem głowicy odtwarzania. |
vp | Indeks obiektu VideoPlayer. |
Powiązane elementy interfejsu API
complete | Zdarzenie |
fl.video.VideoEvent
właściwość VideoEvent.type =
fl.video.VideoEvent.COMPLETE
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wywoływane po zakończeniu odtwarzania, ponieważ odtwarzacz osiągnął koniec pliku FLV. Składnik nie wywoła zdarzenia, jeżeli wywołana zostanie metoda stop()
lub pause()
albo użytkownik kliknie odpowiednie elementy sterujące.
Gdy aplikacja korzysta z pobierania stopniowego, nie ustawia jawnie właściwości totalTime
, i pobiera plik FLV, który w metadanych nie określa czasu trwania. Przed wywołaniem tego zdarzenia odtwarzacz wideo ustawia właściwość totalTime
na przybliżoną wartość całkowitą.
Odtwarzacz wideo wywołuje również zdarzenia stateChange
i stopped
.
Zdarzenie complete
jest typu VideoEvent i posiada stałą VideoEvent.COMPLETE
.
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ć. |
state | Łańcuch znaków identyfikujący stałą z klasy VideoState, która opisuje stan odtwarzania dla składnika. |
playheadTime | Liczba będąca aktualnym czasem lub położeniem głowicy odtwarzania. |
vp | Indeks obiektu VideoPlayer. |
Powiązane elementy interfejsu API
cuePoint | Zdarzenie |
fl.video.MetadataEvent
właściwość MetadataEvent.type =
fl.video.MetadataEvent.CUE_POINT
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wywoływane w przypadku osiągnięcia punktu wskazującego. Obiekt event posiada właściwość info
zawierającą informacje o obiekcie otrzymaną przez wywołanie zwrotne zdarzenia NetStream.onCuePoint
dla punktów wskazujących pliku FLV. Dla punktów wskazujących ActionScript zawiera obiekt przekazany do metod lub właściwości punktów wskazujących ActionScript.
Zdarzenie cuePoint
jest typu MetadataEvent i posiada stałą MetadataEvent.CUE_POINT
.
type
obiektu zdarzenia cuePoint
.
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ć. |
info | Obiekt zawierający właściwości opisujące punkt wskazujący. |
vp | Indeks obiektu VideoPlayer. |
Powiązane elementy interfejsu API
drmAuthenticate | Zdarzenie |
flash.events.DRMAuthenticateEvent
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | AIR 1.0 |
Zdarzenie drmAuthenticate
drmError | Zdarzenie |
flash.events.DRMErrorEvent
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | AIR 1.0 |
Zdarzenie drmError
drmStatus | Zdarzenie |
flash.events.DRMStatusEvent
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | AIR 1.0 |
Zdarzenie drmError
layout | Zdarzenie |
fl.video.LayoutEvent
właściwość LayoutEvent.type =
fl.video.LayoutEvent.LAYOUT
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Zdarzenie wywoływane w przypadku zmiany rozmiaru lub położenia odtwarzacza wideo. Oto dwa scenariusze układów:
- W przypadku zmiany układu odtwarzacza wideo za pomocą zdarzenia
autoLayout
, wywołania metodsetScale()
lubsetSize()
lub zmiany właściwościwidth
,height
,scaleX
iscaleY
. - Gdy są dwa odtwarzacze wideo o różnych rozmiarach i właściwość
visibleVideoPlayerIndex
jest przełączana z jednego odtwarzacza na drugi.
Zdarzenie layout
jest typu LayoutEvent i posiada stałą LayoutEvent.LAYOUT
.
type
obiektu zdarzenia layout
.
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ć. |
oldBounds | Wartości właściwości x , y , width i height obiektu docelowego przed wystąpieniem zdarzenia Layout . |
oldRegistrationBounds | Wartości właściwości registrationX , registrationY , registrationWidth i registrationHeight obiektu docelowego przed wystąpieniem zdarzenia layout . |
Powiązane elementy interfejsu API
metadataReceived | Zdarzenie |
fl.video.MetadataEvent
właściwość MetadataEvent.type =
fl.video.MetadataEvent.METADATA_RECEIVED
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wywoływane po osiągnięciu po raz pierwszy metadanych pliku FLV. Obiekt zdarzenie posiada właściwość info
zawierającą informacje o obiekcie otrzymane przez wywołanie zwrotne zdarzenia NetStream.onMetaData
.
Zdarzenie metadataReceived
jest typu MetadataEvent i posiada stałą MetadataEvent.METADATA_RECEIVED
.
type
obiektu zdarzenia metadataReceived
.
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ć. |
info | Obiekt zawierający właściwości opisujące plik FLV. |
vp | Indeks obiektu VideoPlayer. |
Powiązane elementy interfejsu API
playheadUpdate | Zdarzenie |
fl.video.VideoEvent
właściwość VideoEvent.type =
fl.video.VideoEvent.PLAYHEAD_UPDATE
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wywoływane, gdy plik FLV jest odtwarzany z częstością określoną przez właściwość playheadUpdateInterval
lub rozpoczyna się przewijanie do tyłu. Składnik nie wywołuje tego zdarzenia, gdy odtwarzacz wideo jest wstrzymany lub zatrzymany, chyba że wystąpi wyszukiwanie.
Zdarzenie playheadUpdate
jest typu VideoEvent i posiada stałą VideoEvent.PLAYHEAD_UPDATE
.
type
obiektu zdarzenia playheadUpdate
.
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ć. |
state | Łańcuch znaków identyfikujący stałą z klasy VideoState, która opisuje stan odtwarzania dla składnika. |
playheadTime | Liczba będąca aktualnym czasem lub położeniem głowicy odtwarzania. |
vp | Indeks obiektu VideoPlayer. |
Powiązane elementy interfejsu API
progress | Zdarzenie |
fl.video.VideoProgressEvent
właściwość VideoProgressEvent.type =
fl.video.VideoProgressEvent.PROGRESS
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wskazuje liczbę załadowanych bajtów. Wywoływane po rozpoczęciu ładowania z częstotliwością określoną przez właściwość progressInterval
i kończone po załadowaniu wszystkich bajtów lub wystąpieniu błędu sieciowego. Domyślnie co 0,25 sekundy — początek przy wywołaniu ładowania i koniec po załadowaniu wszystkich bajtów lub wystąpieniu błędu sieciowego. Zdarzenie wykorzystywane do sprawdzenia załadowanych bajtów lub liczby bajtów w buforze.
Wywoływane jedynie dla stopniowego pobierania za pomocą protokołu HTTP. Wskazuje postęp w liczbie pobranych bajtów. Obiekt zdarzenia ma właściwości bytesLoaded
i bytesTotal
, które są identyczne jak właściwości klasy FLVPlayback o tych samych nazwach.
Zdarzenie progress
jest typu VideoProgressEvent i posiada stałą VideoProgressEvent.PROGRESS
.
type
obiektu zdarzenia progress
.
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ć. |
bytesLoaded | Liczba elementów lub bajtów załadowanych w momencie, w którym detektor przetwarza zdarzenie. |
bytesTotal | Łączna liczba elementów lub bajtów, które zostaną wczytane w razie pomyślnego zakończenia operacji wczytywania. |
vp | Indeks obiektu VideoPlayer. |
Powiązane elementy interfejsu API
ready | Zdarzenie |
fl.video.VideoEvent
właściwość VideoEvent.type =
fl.video.VideoEvent.READY
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Zdarzenie wywoływane, gdy plik FLV został załadowany i jest gotowy do wyświetlenia. Rozpoczyna się podczas pierwszego przejścia w stan gotowości do odpowiedzi, po załadowaniu nowego pliku FLV za pomocą metod play()
lub load()
. Rozpoczyna się tylko jeden raz dla każdego załadowanego pliku FLV.
Zdarzenie ready
jest typu VideoEvent i posiada stałą VideoEvent.READY
.
type
obiektu zdarzenia ready
.
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ć. |
state | Łańcuch znaków identyfikujący stałą z klasy VideoState, która opisuje stan odtwarzania dla składnika. |
playheadTime | Liczba będąca aktualnym czasem lub położeniem głowicy odtwarzania. |
vp | Indeks obiektu VideoPlayer. |
Powiązane elementy interfejsu API
stateChange | Zdarzenie |
fl.video.VideoEvent
właściwość VideoEvent.type =
fl.video.VideoEvent.STATE_CHANGE
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wywoływane po zmianie stanu odtwarzania. Po ukończeniu wywołania autoRewind
zdarzenie stateChange
jest wywoływane ze stanem przewijania. Zdarzenie stateChange
nie zostanie rozpoczęte dopóki przewijanie nie zostanie zakończone.
Zdarzenie to może być wykorzystane do śledzenia kiedy odtwarzanie wchodzi lub opuszcza stany bez odpowiedzi, np. w trakcie łączenia, zmiany rozmiaru, przewijania. Metody play()
, pause()
, stop()
i seek()
kolejkują żądania, które zostaną wykonane, gdy odtwarzacz przejdzie w stan gotowości do odpowiedzi.
Zdarzenie stateChange
jest typu VideoEvent i posiada stałą VideoEvent.STATE_CHANGE
.
type
obiektu zdarzenia stateChange
.
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ć. |
state | Łańcuch znaków identyfikujący stałą z klasy VideoState, która opisuje stan odtwarzania dla składnika. |
playheadTime | Liczba będąca aktualnym czasem lub położeniem głowicy odtwarzania. |
vp | Indeks obiektu VideoPlayer. |
Powiązane elementy interfejsu API
SHORT_VERSION | Stała |
public static const SHORT_VERSION:String = "2.1"
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Zmienna stanu wskazująca na krótki numer wersji składnika. Numer wersji jest użyteczny, gdy istnieje plik FLA i wymagane jest określenie wersji składnika. W celu określenia wersji składnika należy wpisać następującą instrukcję trace do pliku FLA:
FLVPlayback.SHORT_VERSION
Zmienna SHORT_VERSION
zawiera tylko główne i podrzędne numery wersji, na przykład: 2.0. Zmienna VERSION
zawiera główne i podrzędne numery wersji, a także numery poprawek i kompilacji, na przykład: 2.0.0.11.
Powiązane elementy interfejsu API
VERSION | Stała |
public static const VERSION:String = "2.1.0.23"
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Zmienna stanu wskazująca na długi numer wersji składnika. Numer wersji jest użyteczny, gdy istnieje plik FLA i wymagane jest określenie wersji składnika. W celu określenia wersji składnika należy wpisać następującą instrukcję trace do pliku FLA:
FLVPlayback.VERSION
Zmienna VERSION
zawiera główne i podrzędne numery wersji, a także numery poprawek i kompilacji, na przykład: 2.0.0.11. Zmienna SHORT_VERSION
zawiera tylko główne i podrzędne numery wersji, na przykład: 2.0.
Powiązane elementy interfejsu API
W celu uruchomienia przykładu należy wykonać poniższe czynności:
- Dodaj składnik FLVPlayback do biblioteki.
- Zastąp
testVideoPath
ścieżką względną lub bezwzględną do pliku FLV. - Zapisz kod jako VideoPlayerExample.as w tym samym katalogu, w którym znajduje się plik FLA.
- Ustaw dla klasy Document w pliku FLA wartość VideoPlayerExample.
package { import fl.video.VideoPlayer; import flash.display.Sprite; import flash.filters.BlurFilter; public class VideoPlayerExample extends Sprite { private var videoPath:String = "http://www.helpexamples.com/flash/video/sheep.flv" private var player:VideoPlayer; private var blurryPlayer:VideoPlayer; public function VideoPlayerExample() { player = new VideoPlayer(); player.play(videoPath); player.setScale(0.75, 0.75); addChild(player); blurryPlayer = new VideoPlayer(); blurryPlayer.play(videoPath); blurryPlayer.setScale(0.75,0.75); blurryPlayer.filters = [ new BlurFilter(8, 8, 1) ]; blurryPlayer.x = 250; addChild(blurryPlayer); } } }
Tue Jun 12 2018, 12:06 PM Z