Methods > Recorders > StartFromURL method

Remarks

Starts a new recording session from a sound stream pointed by an Internet URL. The source stream can be either a shoutcast/icecast stream or simply a sound file stored on a web site.

When calling this method the container application is notified about the status of the connection to the given Internet URL through the CallbackForRecordersEvents delegate, invoked with the nEvent parameter set to EV_REC_CONNECTION_STARTED and EV_REC_CONNECTION_DONE.

Once connected successfully, the container application is notified through the CallbackForRecordersEvents delegate invoked with the nEvent parameter set to EV_REC_START.

The recording session can be stopped at any time through a call to the RecorderStop method.

This method fails if the SetRecordingMode method has been previously invoked with the nMode parameter set to REC_MODE_MIX or REC_MODE_INSERT or REC_MODE_OVERWRITE.

For details about recording from the Internet see the How to perform an Internet-based recording session section.

Syntax

[Visual Basic]

Public Function StartFromURL (

strOutputPath as string,

strURL as string

) as enumErrorCodes

[C#]

public enumErrorCodes StartFromURL (

string strOutputPath,

string strURL

);

[C++]

public: enumErrorCodes StartFromURL (

string strOutputPath,

string strURL

);

Parameter	Description

strOutputPath	String representing the absolute pathname of the output file that will contain the recorded data. If this pathname should contain invalid characters, they would be automatically changed into an underscore '_' character. If the string is left empty, the recording session will be performed in memory.
strURL	String representing the Internet URL (HTTP, FTP or MMS) pointing to the casting stream or remote file. Accepted formats for casting streams are WMA, MP3, OGG Vorbis, OPUS, AAC and AC3 while accepted formats for remote files are MP1, MP2, MP3, MP4, AIFF, WAV, OGG Vorbis, AAC, MP4, AC3, FLAC, WMA, OPUS and MPC.

Return value

Value	Meaning

Negative value	An error occurred. Check the LastError property value in order to see the last error.
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.