Klasa: NETStream

Kompatybilność: ActionScript 1.0, Flash 7+

 

Wywołuje się, gdy osadzony punkt sygnałowy zostanie osiągnięty podczas odtwarzania pliku FLV.

 

Pozwala to na synchronizowanie akcji w twojej aplikacji z odtwarzanymi wydarzeniami video.

 

Są dwa typy punktów sygnałowych, które mogą byc osadzone w pliku FLV.

 

• "navigation" określa klatkę kluczowę wewnątrz pliku FLV oraz sygnałowy punkt czasu właściwości odpowiada do okreslonej klatki kluczowej. Nawigacyjne punkty sygnałów są używane do tworzenia zakładek oraz punktów wejściowych, aby pozwolic użytkownikowi na nawigację przez plik video.

 

• "event" określa czas korospędujący do kaltki kluczowej. Zdarzeniowy punkt sygnałowy najczejściej reprezentuje czas w video kiedy coś sie wdarza i może zostać użyte do obudzenia innych wydrzeń.

 

Zdarzenie onCuePoint() odbiera obiekt z podanymi właściwościami:

 

Nazwa	Opis
name	Nazwa danego punktu sygnałoego, kiedy osadzono plik FLV.
time	Czas w sekundach, w których punkt sygnałowy wystąpił w pliku video podczas odtwarzania.
type	Typ punktu sygnałowego: "navigation" lub "event".
parameters	Dołączona tablica nazwa/wartość par ciągów znaków określających punktsygnałowy. Każdy dostępny ciąg może być tutaj użyty jako nazwa bądź wartość.

 

Możesz określić punkty sygnałowe w pliku FLV, kiedy po raz pierwszy kodujesz plik, lub kiedy importujesz video klip we Flash'u, przez Video Import wizard.

 

Zdarzenie onMetaData() obsługuję również odzyskiwanie infromacji o punktach sygnłowych w pliku video. Jednakże onMetaData() zdarzenie przechwytujące informacje o wszystkich punktach sygnałowych przed rozpoczęciem odtwarzania pliku. Zdarzenie onCuePoint() odbiera tylko pojedynczy punkt sygnalowy w jednym czasie.

 

generalnie, jeśli chcesz zakodować odpowiedź do określonego punktu sygnałowego w jednym czasie, powinieneś użyć onCuePoint(), aby wzywać jakies akcje w twoim kodzie.

 

Jeśli chcesz użyć listy punktów sygnałowych dostarczonych do zdarzenia onMetaData(), aby pozwolić użytkownikowi rozpoczęcie odtwarzania, tylko na wybranych punktach przy źródłowym pliku. Przekaż wartość punktu sygnałowego time do metody NetStream.seek(), aby odtworzyć plik video od danego punkty sygnałowego.

var nc:NetConnection = new NetConnection();
nc.connect(null);
var ns:NetStream = new NetStream(nc);

ns.onCuePoint = function(infoObject:Object)
{
    trace("onCuePoint:");
    for (var propName:String in infoObject) {
        if (propName != "parameters")
        {
            trace(propName + " = " + infoObject[propName]);
        }
        else
        {
            trace("parameters =");
            if (infoObject.parameters != undefined) {
                for (var paramName:String in infoObject.parameters)
                {
                    trace(" " + paramName + ": " + infoObject.parameters[paramName]);
                }
            }
            else
            {
                trace("undefined");
            }
        }
    }
    trace("---------");
}

ns.play("http://www.helpexamples.com/flash/video/cuepoints.flv");

//zwróci:

 onCuePoint:
 parameters =
 lights: beginning
 type = navigation
 time = 0.418
 name = point1
 ---------
 onCuePoint:
 parameters =
 lights: middle
 type = navigation
 time = 7.748
 name = point2
 ---------
 onCuePoint:
 parameters =
 lights: end
 type = navigation
 time = 16.02
 name = point3
 ---------