VideoPlayer  - AS3 Flash

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.

Powiązane elementy interfejsu API

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.

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.

Powiązane elementy interfejsu API

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.

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.

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.

Powiązane elementy interfejsu API

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ą.

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.

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.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

Umożliwia bezpośredni dostęp do instancji obiektu NetConnection utworzonej za pomocą odtwarzacza wideo.

Umożliwia bezpośredni dostęp do instancji obiektu NetStream utworzonej za pomocą odtwarzacza wideo.

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.

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.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

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.

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 = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 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 = 110
• y = 100
• width = 40
• height = 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 = 100
• y = 100
• width = 60
• height = 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.

Powiązane elementy interfejsu API

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 = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 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 = 110
• y = 100
• width = 40
• height = 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 = 100
• y = 100
• width = 60
• height = 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.

Powiązane elementy interfejsu API

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 = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 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 = 110
• y = 100
• width = 40
• height = 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 = 100
• y = 100
• width = 60
• height = 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.

Powiązane elementy interfejsu API

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 = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 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 = 110
• y = 100
• width = 40
• height = 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 = 100
• y = 100
• width = 60
• height = 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.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

Liczba określająca skalę poziomą.

Wartością domyślną jest 1.

Powiązane elementy interfejsu API

Liczba określająca skalę pionową.

Wartością domyślną jest 1.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

Szerokość źródłowa załadowanego pliku FLV. Jeżeli informacja nie jest jeszcze dostępna, to właściwość ta zwraca -1.

Powiązane elementy interfejsu API

Szerokość źródłowa załadowanego pliku FLV. Jeżeli informacja nie jest jeszcze dostępna, to właściwość ta zwraca -1.

Powiązane elementy interfejsu API

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.

Liczba w zakresie od 0 do 1, która wskazuje ustawienie elementu sterującego głośnością.

Wartością domyślną jest 1.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

Tworzy obiekt VideoPlayer o określonej wysokości i szerokości.

Powiązane elementy interfejsu API

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

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

Powiązane elementy interfejsu API

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

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

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

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

Powiązane elementy interfejsu API

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().

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

Powiązane elementy interfejsu API

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

Powiązane elementy interfejsu API

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

Powiązane elementy interfejsu API

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

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.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

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.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

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.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

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.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Zdarzenie drmAuthenticate

Zdarzenie drmError

Zdarzenie drmError

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 metod setScale() lub setSize() lub zmiany właściwości width, height, scaleX i scaleY.
• 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.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

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.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

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.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

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.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

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.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

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.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

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

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:

1. Dodaj składnik FLVPlayback do biblioteki.
2. Zastąp testVideoPath ścieżką względną lub bezwzględną do pliku FLV.
3. Zapisz kod jako VideoPlayerExample.as w tym samym katalogu, w którym znajduje się plik FLA.
4. 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);            
        }
    }
}