VirtualDirectory

This tag contains the virtual directory mappings for resources such as recorded streams.

Description

Virtual directories let you share resources such as recorded streams across different applications. Virtual directories let multiple applications share the resources located in an application directory. When the beginning portion of a resource's URI matches a specific virtual directory, Flash Media Server maps the storage location of the resource to the virtual directory.

If you are mapping a virtual directory to a drive on another computer, make sure that the computer running Flash Media Server has the right permissions to access the other computer.

Syntax

<VirtualDirectory>
    <Streams>key-value;virtual path;directory</Streams>
</VirtualDirectory>

You specify a virtual directory by mapping the client's virtual key to the resource's actual key. Setting the key to point to the beginning of the value for the Streams tag forces the virtual directory mapping in a Streams to use the original mapping in the original Streams tag.

Example

<VirtualDirectory>
    <Streams>alphaKey;foo;c:\goodStreams</Streams> 
    <Streams>betaKey;foo;c:\evenBetterStreams</Streams>
</VirtualDirectory>

You create a stream switching scenario by including more than one copy of the same virtual path with different keys. This example shows two pointers to the same virtual path using different keys.

Additional information

Custom stream delivery is a new feature in Flash Media Server 2. This task that is enabled using a combination of the VirtualDirectory and VirtualKey tags, and the Client.virtualKey and Stream.setVirtualPath() APIs.

Contained tag

Comments

tech_writer_00 said on Feb 12, 2007 at 6:24 PM :

The correct syntax for the <Streams> tag is:
<Streams key="virtualKey">virtual directory;actual directory</Streams>

Coronero said on Apr 14, 2007 at 7:11 AM :

"This tag contains the virtual directory mappings for resources such as recorded streams." - that's pretty clear. but it doesn't explain or explicitly say that live streams cannot be accessed through virtual directories... supposedly and sadly that's not supported.