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 through the CallbackForDownloaderEvents delegate which is invoked with the nEvent parameter set to one of the following values:

- the EV_DOWNLOADER_SESSION_STARTED event reports that the downloading session is started

- the EV_DOWNLOADER_SESSION_PROGRESS event informs about the download advancement expressed in percentage

- the EV_DOWNLOADER_SESSION_COMPLETED event reports that the downloading session is completed successfully

In case the connection to the Youtube server or the access to the remote file should fail, the CallbackForDownloaderEvents delegate is invoked with the nEvent parameter set to EV_DOWNLOADER_SESSION_FAILED.

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

strOutputPath as string,

strVideoId as string

) as enumErrorCodes

[C#]

public enumErrorCodes StartFromYoutube (

string strOutputPath,

string strVideoId

);

[C++]

public: enumErrorCodes StartFromYoutube (

string strOutputPath,

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