Developers

1.1.1-1.10

Implemented methods:

• get_BufferingProgress Filter uses it to report total downloading progress of all media streams. When option Downloading the clip is turned off (and thus no such info can be provided) or option Enable buffering notification is turned off, it will return S_FALSE and zero progress.

1.5-1.10

All quality-related settings and few other settings can be overridden. This can be done either by custom URL parameters or programmatically via IPropertyBag/IPropertyBag2 interfaces. The latter is available starting from version 1.8.2. If some parameter is presented using both ways, URL parameter takes precedence.

Value of URL parameter can be URL-encoded if need. Example of custom URL parameter (select 720p video):

https://youtube.com/watch?v=xXxxXXxxXxx&ys_video_resolution=720p

The same with IPropertyBag:

if (CComQIPtr<IPropertyBag> bag = filter) {
  CComVariant value("720p");
  bag->Write(L"ys_video_resolution", &value);
}

When using IPropertyBag/IPropertyBag2, configuration should be done before calling IFileSourceFilter::Load(). All values (including numeric ones) should be passed as strings.

All parameters reflect appropriate options in filter properties, no more, no less. All overridden options that was found are be reported in Log (tab in the filter properties).

Below is complete list of parameters with mapping to appropriate option. If not stated explicitly, expected value is the same as in appropriate option from the filter properties. For check boxes expected values are 0 and 1 (unchecked and checked respectively).

Download subtitles

Prior to version 1.6 i.e. prior to auto-translated subtitles support and precise subtitles selection it had three possible values: never, all, except_asr. There all means regular subtitles + ASR and except_asr means only regular subtitles. In version 1.6 these values are still acceptable for back compatibility with exactly the same meaning i.e. auto-translated subtitles are not included in results.

Since 1.6 using this parameter can be specified any set of subtitles using next form:

sub1;sub2;sub3;...;subN

where subX has format type_num=lang_tag.

Values of lang_tag are: special word _all (match any subtitle of given type) or language code (ISO 639-1 or 639-2, lowercase) appended by optional script code (ISO 15924, first letter uppercase, the rest lowercase) and/or optional country code (ISO 3166-1 alpha-2 (uppercase) or numeric). Subtitle becomes selected if its language tag contains any of provided language tags. 'Contains' means substring match, case-sensitive i.e. using generic C function it would be NULL != strstr(original_lang_tag, param_lang_tag).

For example, to download all regular subtitles, never download ASR, download English and Chinese (Traditional) auto-translated subtitles this parameter would be:

2=en;0=_all;2=zh-Hant