Pakiet | flash.net |
Klasa | public dynamic class NetStreamPlayOptions |
Dziedziczenie | NetStreamPlayOptions EventDispatcher Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
NetStream.play2()
. Przekazanie obiektu NetStreamPlayOptions do metody play2()
powoduje, że właściwości klasy określają różne opcje. Głównym przypadkiem dla tej klasy do implementacji są dynamiczne przejścia pomiędzy strumieniami oraz przełączanie pomiędzy strumieniami o różnej ilości bitów danych, rozmiarach, czy zmiana treści na liście odtwarzania.
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
len : Number
Czas odtwarzania, w sekundach, dla strumienia określonego we właściwości streamName. | NetStreamPlayOptions | ||
offset : Number
Bezwzględny czas przesyłania strumieniowego, przy którym serwer przełącza się między strumieniami o różnych szybkościach transmisji bitów na potrzeby dynamicznego przesyłania strumieniowego przy użyciu oprogramowania Flash Media Server. | NetStreamPlayOptions | ||
oldStreamName : String
Nazwa dotychczasowego strumienia lub strumienia, z którego wykonywane jest przejście. | NetStreamPlayOptions | ||
start : Number
Czas rozpoczęcia odtwarzania (w sekundach) dla strumienia określonego we właściwości streamName. | NetStreamPlayOptions | ||
streamName : String
Nazwa nowego strumienia, do którego wykonane zostanie przejście lub zostanie on odtworzony. | NetStreamPlayOptions | ||
transition : String
Tryb, w którym strumień określony we właściwości streamName jest odtwarzany lub wykonywane jest do niego przejście. | NetStreamPlayOptions |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Tworzy obiekt NetStreamPlayOptions w celu określenia opcji przekazywanych do metody NetStream.play2() method. | NetStreamPlayOptions | ||
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 | ||
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | ||
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
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 |
len | właściwość |
public var len:Number
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Czas odtwarzania, w sekundach, dla strumienia określonego we właściwości streamName
Wartością domyślną jest -1 co oznacza, że program Flash Player odtwarza strumień „na żywo” do momentu, w którym nie będzie on już dłużej dostępny lub odtwarza nagrany strumień do końca. Jeśli do właściwości len
przekazana zostanie wartość 0, program Flash Player odtworzy pojedynczą klatkę przesuniętą względem początku strumienia o ilość sekund określoną we właściwościstart
(zakładając, że właściwość start
jest równa lub większa od 0).
Jeśli do właściwości len
przekazana zostanie liczba dodatnia, program Flash Player odtworzy strumień „na żywo” przez liczbę sekund określoną we właściwości len
po tym, jak strumień stanie się dostępny lub odtworzony zostanie nagrany strumień przez liczbę sekund określoną we właściwości len
. (Jeśli strumień zakończy się przed osiągnięciem wartości właściwości len
, odtwarzanie zostanie zakończone razem ze strumieniem).
Jeśli do właściwości len
przekazana zostanie liczba ujemna różna od -1, program Flash Player zinterpretuje wartość jako -1.
Powiązane elementy interfejsu API
offset | właściwość |
public var offset:Number
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Bezwzględny czas przesyłania strumieniowego, przy którym serwer przełącza się między strumieniami o różnych szybkościach transmisji bitów na potrzeby dynamicznego przesyłania strumieniowego przy użyciu oprogramowania Flash Media Server. Właściwość offset
jest używana, gdy przy wywołaniu metody NetStream.play2()
określony jest tryb przejścia NetStreamPlayTransitions.SWITCH
. Istnieją dwa tryby przełączania: tryb szybkiego przełączania i tryb standardowego przełączania. Wartość domyślna właściwości offset
wynosi -1
, co oznacza tryb szybkiego przełączania. Aby zadecydować, kiedy ma być używany tryb szybkiego przełączania, a kiedy tryb standardowego przełączania, należy napisać kod ActionScript.
Szybkie przełączanie
W trybie szybkiego przełączania serwer Flash Media Server przełącza się na nowy strumień, nie czekając na odtworzenie danych znajdujących się w buforze. Bufor jest opróżniany ze wszystkich danych ze starego strumienia zapisanych po użyciu właściwości offset
. Szybkie przełączanie jest szybsze od standardowego, ponieważ nie wymaga odtworzenia znajdujących się w buforze danych ze starego strumienia.
Wartość domyślna właściwości offset
wynosi –1, co oznacza tryb szybkiego przełączania. Gdy właściwość offset
ma wartość –1, przełączanie następuje w pierwszej dostępnej klatce kluczowej po przesunięciu netstream.time + 3
, czyli o około 3 sekundy później w stosunku do punktu odtwarzania. Dla właściwości offset
można także ustawić dowolną wartość większą niż netstream.time
. Na przykład w celu szybkiego przełączenia 5 sekund później w stosunku do punktu odtwarzania należy dla właściwości offset
ustawić wartość netstream.time + 5
. Gdy wartość właściwości offset
jest mniejsza niż netstream.time
, wywoływane jest zdarzenie stanu NetStream.Play.Failed
.
Uwaga: Właściwość offset
jest bezwzględnym czasem przesyłania strumieniowego, a nie przesunięciem w stosunku do punktu odtwarzania. Na przykład w celu przełączenia odtwarzania o 5 sekund później w stosunku do punktu odtwarzania należy dla właściwości offset
ustawić wartość netstream.time + 5
, a nie 5
.
Standardowe przełączanie
Aby zamiast szybkiego przełączania używać standardowego przełączania, należy dla właściwości offset
ustawić wartość większą niż netstream.time + netstream.bufferLength
.
Standardowe przełączanie należy stosować, gdy w buforze klienta znajduje się strumień o dużej szybkości transmisji bitów, a klient chce zmniejszyć przepustowość z powodu jej spadku (a nie z powodu problemów z procesorem lub brakujących klatek). Klient może chcieć odtwarzać strumień o dużej szybkości transmisji bitów, dopóki to możliwe, a na końcu bufora zmniejszyć szybkość transmisji (jak przy standardowym przełączaniu).
Więcej informacji zawiera dokument Szybkie przełączanie między strumieniami na stronie Adobe Flash Media Server — Podręcznik dla programistów.
Powiązane elementy interfejsu API
oldStreamName | właściwość |
public var oldStreamName:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Nazwa dotychczasowego strumienia lub strumienia, z którego wykonywane jest przejście. Gdy metoda NetStream.play2()
jest używana do odtworzenia strumienia (nie do wykonywania przejścia), właściwość powinna mieć wartość null lub undefined. W przeciwnym wypadku należy określić strumień, z którego ma zostać wykonane przejście.
Powiązane elementy interfejsu API
start | właściwość |
public var start:Number
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Czas rozpoczęcia odtwarzania (w sekundach) dla strumienia określonego we właściwości streamName
. Poprawnymi wartościami są -2, -1 i 0.
Wartością domyślną dla właściwości start
jest -2 co oznacza, że program Flash Player usiłuje najpierw odtworzyć strumień „na żywo” określony we właściwości streamName
. Jeśli strumień „na żywo” o podanej nazwie nie został odnaleziony, program Flash Player odtworzy nagrany strumień określony we właściwości streamName
. Jeśli żaden z dwóch strumieni, „na żywo” lub nagrany, nie zostanie odnaleziony, program Flash Player otworzy strumień „na żywo” o nazwie określonej we właściwości streamName
, nawet jeśli żaden nie został w nim opublikowany. W momencie, gdy rozpocznie się publikowanie w tym strumieniu, program Flash Player rozpocznie jego odtwarzanie.
Jeśli do właściwości start
przekazana zostanie wartość -1, program Flash Player odtworzy jedynie strumień „na żywo” określony we właściwości streamName
. Jeśli nie zostanie odnaleziony żaden strumień „na żywo”, program Flash Player oczekuje na strumień przez czas nieokreślony, jeśli właściwość len
jest ustawiona na wartość -1; jeśli właściwość len
została ustawiona na inną wartość, program Flash Player przed rozpoczęciem odtwarzania kolejnego elementu z listy odtwarzania czeka na strumień przez czas określony liczbą sekund we właściwości len
.
Jeśli do właściwości start
przekazana zostanie liczba dodatnia, program Flash Player odtworzy jedynie nagrany strumień określony we właściwości streamName
, rozpoczynając od miejsca przesuniętego względem początku strumienia o ilość sekund określoną we właściwości start
. Jeśli nie zostanie odnaleziony żaden nagrany strumień, program Flash Player natychmiast rozpocznie odtwarzanie kolejnego elementu z listy odtwarzania.
Jeśli do właściwości start
przekazana zostanie liczba ujemna różna od -1 lub -2, program Flash Player zinterpretuje tę wartość jako -2.
Powiązane elementy interfejsu API
streamName | właściwość |
public var streamName:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Nazwa nowego strumienia, do którego wykonane zostanie przejście lub zostanie on odtworzony. Gdy właściwość oldStreamName
ma wartość null lub undefined, wywołanie metody NetStream.play2()
spowoduje rozpoczęcie odtwarzania strumienia określonego we właściwości streamName
. Jeśli określona została właściwość oldStreamName
, wywołanie metody NetStream.play2()
spowoduje przejście ze strumienia określonego we właściwości oldStreamName
do strumienia określonego we właściwości streamName
przy użyciu trybu przejścia określonego we właściwości transition
.
Powiązane elementy interfejsu API
transition | właściwość |
public var transition:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Tryb, w którym strumień określony we właściwości streamName
jest odtwarzany lub wykonywane jest do niego przejście. Możliwymi wartościami są stałe z klasy NetStreamPlayTransitions. Różny sposób działania trybu przejścia zależny od tego, czy metoda Netstream.play2()
wywoływana jest w celu odtworzenia czy przejścia. Aby uzyskać więcej informacji na temat trybów przejść, należy zapoznać się z opisem klasy NetStreamPlayTransitions.
Powiązane elementy interfejsu API
NetStreamPlayOptions | () | Konstruktor |
public function NetStreamPlayOptions()
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Tworzy obiekt NetStreamPlayOptions w celu określenia opcji przekazywanych do metody NetStream.play2()
.
Powiązane elementy interfejsu API
Tue Jun 12 2018, 12:06 PM Z