Methods > Recorders > StartSplitFromYoutube method

Remarks

Starts a new recording session from the sound stream of a video clip stored on Youtube and splits incoming sound in left and right channels.

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.

In this case the recording session wouldn't be kept inside the RecordedSound object so the only accepted recording mode, set through the SetRecordingMode method, is REC_MODE_NEW.

Limitations to encoding capabilities when splitting the recording session

If the EncodeFormats.ForRecording property is set to ENCODING_FORMAT_WMA, the only supported encoding mode for the EncodeFormats.WMA.EncodeMode property is WMA_ENCODE_CBR_STD_16 and the WMA.CBR property must be set to a value that can support both stereo and mono, so the only compatible combinations are the following:

•	for sounds at 16000 Hz CBR must be set to 16000 (16 kbps)

•	for sounds at 22050 Hz CBR must be set to 20000 (20 kbps)

•	for sounds at 44100 Hz CBR must be set to 32000 (32 kbps) or 48000 (48 kbps)

If the EncodeFormats.ForRecording property is set to ENCODING_FORMAT_WAV, the splitting will only work if the EncodeFormats.WAV.EncodeMode property is set to a format supporting both mono and stereo formats meaning that, for example, it will not work for mono-only formats like WAV_ENCODE_GSM_610 or WAV_ENCODE_G721_ADPCM_32.

If the EncodeFormats.ForRecording property is set to ENCODING_FORMAT_AIFF, the splitting will only work if the EncodeFormats.AIFF.EncodeMode property is set to a format supporting both mono and stereo formats meaning that, for example, it will not work for mono-only formats like AIFF_ENCODE_GSM_610.

If the EncodeFormats.ForRecording property is set to ENCODING_FORMAT_AU, the splitting will only work if the EncodeFormats.AU.EncodeMode property is set to a format supporting both mono and stereo formats meaning that, for example, it will not work for mono-only formats like AU_ENCODE_G721_ADPCM_32 or AU_ENCODE_G723_ADPCM_24 or AU_ENCODE_G723_ADPCM_40.

If the EncodeFormats.ForRecording property is set to ENCODING_FORMAT_ACM, the splitting will only work if the selected codec supports both mono and stereo formats meaning that, for example, it will not work for mono-only codecs like GSM 6.10 or G721 ADPCM.

The split doesn't work if the EncodeFormats.ForRecording property is set to ENCODING_FORMAT_AAC because this format doesn't support creating mono sounds.

When the stereo recording session is encoded in MP3, Ogg Vorbis or Opus audio formats, respective external encoders (Lame, OggEnc and OpusEnc) must be available on the target system because internal encoders cannot manage the "downmix" to mono of the split channels.

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

Syntax

[Visual Basic]

Public Function StartSplitFromYoutube (

strOutputPathLeft as string,

strOutputPathRight as string,

strVideoId as string

) as enumErrorCodes

[C#]

public enumErrorCodes StartSplitFromYoutube (

string strOutputPathLeft,

string strOutputPathRight,

string strVideoId

);

[C++]

public: enumErrorCodes StartSplitFromYoutube (

string strOutputPathLeft,

string strOutputPathRight,

string strVideoId

);

Parameter	Description

strOutputPathLeft	String representing the absolute pathname of the destination file that will contain the left channel of recorded data. If this pathname should contain invalid characters, they would be automatically changed into an underscore '_' character.
strOutputPathRight	String representing the absolute pathname of the destination file that will contain the right channel of recorded data. If this pathname should contain invalid characters, they would be automatically changed into an underscore '_' character.
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.