Methods > Recorders > StartFromYoutube method

Remarks

Starts a new recording session from a sound stream of a video clip stored on Youtube.

Calling this method will initially generate a download session in order to store the audio stream of the video clip inside a local temporary file so a successful call to this method will fire the following sequence of events:

- the DownloaderSessionStarted event

- a sequence of DownloaderSessionProgress events informing about the download advancement in percentage

- the DownloaderSessionCompleted event

In case the connection to the Youtube server or the access to the remote file should fail, the DownloaderSessionFailed would be invoked.

Once the audio stream has been downloaded 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.StartFromYoutube (

strOutputPath as string,

strVideoId as string

) as enumErrorCodes

[C++]

short control.StartFromYoutube (

LPCTSTR strOutputPath,

LPCTSTR strVideoId

);

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.
strVideoId	String containing the identifier of the video as assigned by Youtube or the full Youtube URL of the video.

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.