ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
org.osmf.net 

NetLoader  - AS3 OSMF

Paketorg.osmf.net
Klassepublic class NetLoader
VererbungNetLoader Inheritance LoaderBase Inheritance EventDispatcher Inheritance Object
Unterklassen HTTPStreamingNetLoader, MulticastNetLoader, RTMPDynamicStreamingNetLoader

Sprachversion: ActionScript 3.0
Produktversion: OSMF 1.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die NetLoader-Klasse erweitert die LoaderBase, um Ladeunterstützung für die AudioElement- und VideoElement-Klassen bereitzustellen.

Unterstützt sowohl Streaming- als auch progressive Medienressourcen. Wenn die Ressourcen-URL RTMP lautet, wird durch Aufrufen einer NetConnectionFactoryBase eine Verbindung zu einem RTMP-Server hergestellt. NetConnections können zwischen LoadTrait-Instanzen gemeinsam genutzt werden. Wenn die Ressourcen-URL HTTP lautet, wird connect(null) für progressive Downloads durchgeführt.

Der NetLoader unterstützt Flash Media Token Authentication, bei der Authentifizierungstoken über die NetConnection übergeben werden.

Beispiele anzeigen



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  reconnectTimeout : Number
Das Stream-Neuverbindungszeitlimit in Millisekunden.
NetLoader
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
NetLoader
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
 Inherited
Gibt an, ob dieser Loader die angegebene MediaResourceBase verarbeiten (laden) kann.
LoaderBase
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Lädt das angegebene LoadTrait.
LoaderBase
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Entlädt das angegebene LoadTrait.
LoaderBase
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Geschützte Methoden
 MethodeDefiniert von
  
Die Factory-Funktion zum Erstellen eines NetStream.
NetLoader
  
Die Factory-Funktion zum Erstellen einer NetStreamSwitchManagerBase.
NetLoader
 Inherited
Führt das Laden des angegebenen LoadTrait aus.
LoaderBase
 Inherited
Führt das Entladen des angegebenen LoadTrait aus.
LoaderBase
  
reconnect(netConnection:NetConnection, resource:URLResource):void
Versucht, die angegebene NetConnection mit der angegebenen URL neu zu verbinden.
NetLoader
 Inherited
Aktualisiert das angegebene LoadTrait mit den angegebenen Informationen und löst das Statusänderungsereignis aus, falls erforderlich.
LoaderBase
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
 InheritedWird nach einer Änderung des Status eines gerade von der LoaderBase geladenen oder entladenen LoadTrait ausgelöst.LoaderBase
Eigenschaftendetails

reconnectTimeout

Eigenschaft
reconnectTimeout:Number

Das Stream-Neuverbindungszeitlimit in Millisekunden.

Der NetLoader versucht nicht mehr, den Stream neu zu verbinden, wenn keine erfolgreiche Neuverbindung innerhalb dieser Zeitspanne auftritt. Standardmäßig sind es 120 Sekunden. Für nicht angehaltene Streams beginnt die Timeout-Zeit, sobald der Puffer geleert wird. Daher ist ein Wert von 0 Sekunden gültig. Versuchen Sie also keine Neuverbindung, nachdem der Puffer geleert wird. Für angehaltene Streams beginnt die Timeout-Zeit sofort.



Implementierung
    public function get reconnectTimeout():Number
    public function set reconnectTimeout(value:Number):void

Auslöser
ArgumentError — Wenn der value-Parameter kleiner als 0 ist.
Konstruktordetails

NetLoader

()Konstruktor
public function NetLoader(factory:NetConnectionFactoryBase = null)

Sprachversion: ActionScript 3.0
Produktversion: OSMF 1.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Konstruktor.

Parameter
factory:NetConnectionFactoryBase (default = null) — Die NetConnectionFactoryBase-Instanz, die zum Verwalten der NetConnections verwendet werden soll. Wenn Factory „null“ ist, wird eine NetConnectionFactory erstellt und verwendet. Da die NetConnectionFactory-Klasse die gemeinsame Nutzung der Verbindung erleichtert, stellt dies eine einfache Möglichkeit zum Bereitstellen der globalen gemeinsamen Nutzung dar, indem eine einzelne NetConnectionFactory-Instanz im Player erstellt und anschließend an alle NetLoader-Instanzen übergeben wird.
Methodendetails

createNetStream

()Methode
protected function createNetStream(connection:NetConnection, resource:URLResource):NetStream

Die Factory-Funktion zum Erstellen eines NetStream.

Parameter

connection:NetConnection — Die mit dem neuen NetStream zu verknüpfende NetConnection.
 
resource:URLResource — Die Ressource, deren Inhalt im NetStream abgespielt wird.

Rückgabewerte
NetStream — Ein neuer NetStream, der mit der NetConnection verknüpft ist.

createNetStreamSwitchManager

()Methode 
protected function createNetStreamSwitchManager(connection:NetConnection, netStream:NetStream, dsResource:DynamicStreamingResource):NetStreamSwitchManagerBase

Die Factory-Funktion zum Erstellen einer NetStreamSwitchManagerBase.

Parameter

connection:NetConnection — Die NetConnection, die mit der NetStreamSwitchManagerBase verknüpft ist.
 
netStream:NetStream — Der NetStream, auf dem die NetStreamSwitchManagerBase betrieben wird.
 
dsResource:DynamicStreamingResource — Die Ressource, auf der die NetStreamSwitchManagerBase betrieben wird.

Rückgabewerte
NetStreamSwitchManagerBase — Die NetStreamSwitchManagerBase für den NetStream ist „null“, wenn MBR-Wechsel nicht für den NetStream aktiviert ist.

reconnect

()Methode 
protected function reconnect(netConnection:NetConnection, resource:URLResource):void

Versucht, die angegebene NetConnection mit der angegebenen URL neu zu verbinden.

Clients können diese Methode überschreiben, um benutzerdefiniertes NetConnection-Verhalten bereitzustellen, wenn die Neuverbindungsfunktion verwendet wird. Beispiel: Wenn Sie in Ihrem Player clientseitigen Lastausgleich bereitstellen wollen, können Sie eine benutzerdefinierte NetLoader-Klasse erstellen und diese Methode überschreiben, um eine alternative URI zu verwenden.

Parameter

netConnection:NetConnection — Die neue von der Stream-Neuverbindungslogik erstellte NetConnection.
 
resource:URLResource — Die URLResource, die ursprünglich zur Wiedergabe der Medien verwendet wurde.

NetLoaderExample.as

package
{
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    
    import org.osmf.elements.VideoElement;
    import org.osmf.media.MediaPlayerSprite;
    import org.osmf.media.URLResource;
    import org.osmf.net.NetLoader;
    
    public class NetLoaderExample extends Sprite
    {
        public function NetLoaderExample()
        {
            super();
            
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            
            var mediaPlayerSprite:MediaPlayerSprite = new MediaPlayerSprite();
            var netLoader:NetLoader = new NetLoader();
            var urlResource:URLResource = new URLResource("rtmp://cp67126.edgefcs.net/ondemand/mediapm/strobe/content/test/SpaceAloneHD_sounas_640_500_short");
            var videoElement:VideoElement = new VideoElement(urlResource, netLoader);
            
            addChild(mediaPlayerSprite);
            mediaPlayerSprite.media = videoElement;    
        }    
    }
} 




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.