Top Level

Class NetConnection

Object

public dynamic class NetConnection
extends Object

Player version:

Flash Player 7

The NetConnection class provides the means to play back streaming FLV files from a local drive or HTTP address.

Note: This class is also supported in Flash Player 6 when used with Flash Communication Server. For more information, see your Flash Communication Server documentation.

Property Summary

Properties inherited from class Object

__proto__, __resolve, constructor, prototype

Constructor Summary
	`NetConnection()` Creates a NetConnection object that you can use in conjunction with a NetStream object to play back local streaming video (FLV) files.

Method Summary
	`connect(targetURI:String) : Boolean` Opens a local connection through which you can play back video (FLV) files from an HTTP address or from the local file system.

Methods inherited from class Object

addProperty, hasOwnProperty, isPropertyEnumerable, isPrototypeOf, registerClass, toString, unwatch, valueOf, watch

Constructor Detail

NetConnection Constructor

public NetConnection()

Player version:

Flash Player 7 — Note: This class is also supported in Flash Player 6 when used with Flash Communication Server. For more information, see your Flash Communication Server documentation.

Creates a NetConnection object that you can use in conjunction with a NetStream object to play back local streaming video (FLV) files. After creating the NetConnection object, use NetConnection.connect() to make the actual connection.

Playing external FLV files provides several advantages over embedding video in a Flash document, such as better performance and memory management, and independent video and Flash frame rates. The NetConnection class provides the means to play back streaming FLV files from a local drive or HTTP address.

Example
See the example for NetConnection.connect().

Method Detail

connect Method

public connect(targetURI:String) : Boolean

Player version:

Flash Player 7 — Note: This method is also supported in Flash Player 6 when used with Flash Communication Server. For more information, see the Flash Communication Server documentation.

Opens a local connection through which you can play back video (FLV) files from an HTTP address or from the local file system.

When using this method, consider the Flash Player security model and the following security considerations:

The default is to deny access between sandboxes. The website can enable access to a resource via a cross-domain policy file.
A website can deny access to a resource by adding server-side ActionScript application logic in Flash Communication Server.
For Flash Player 8, NetConnection.connect() is not allowed if the calling SWF file is in the local-with-file-system sandbox.

For more information, see the following:

"Understanding Security" in Learning ActionScript 2.0 in Flash
The Flash Player 8 Security white paper at http://www.macromedia.com/go/fp8_security
The Flash Player 8 Security-Related API white paper at http://www.macromedia.com/go/fp8_security_apis

Parameters

targetURI:String — For this parameter, you must pass null.

Returns

Boolean — If false, the connection failed and is not usable. If true, the connection has not failed at the time the connect() method is called, but this does not guarantee success.

Example
The following example opens a connection to play the video2.flv file. Select New Video from the Library panel's options menu to create a new video object, and give it the instance name my_video.

var connection_nc:NetConnection = new NetConnection();
connection_nc.connect(null);
var stream_ns:NetStream = new NetStream(connection_nc);
my_video.attachVideo(stream_ns);
stream_ns.play("video2.flv");

See also

NetStream class

Properties | Methods

	Flash 8 ActionScript 2.0 Language Reference

Flash 8 ActionScript 2.0 Language Reference

Class NetConnection

NetConnection Constructor

connect Method