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.

Calling this method will initially generate a ConnectionToUrlStarted event followed by a ConnectionToUrlDone event that will notify the container application about the status of the connection to the given Internet URL. Once connected successfully, the control will generate a RecordingStarted event. 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]

control.StartFromURL (

strOutputPath as string,

strURL as string

) as enumErrorCodes

[C++]

short control.StartFromURL (

LPCTSTR strOutputPath,

LPCTSTR 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 error code meaning
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.