YoutubeDL接口参数翻译

@[TOC](YouTube-dl接口(YouTubeDL.py)参数翻译

翻译来自机器翻译勉强能用

YoutubeDL类。
YoutubeDL对象负责下载
实际的视频文件，并在用户请求时将其写入磁盘在一些其他任务中。在大多数情况下，
应该有一个程序。因为，给定一个视频URL，下载器不知道如何
提取所有需要的信息，InfoExtractors做的任务，它必须将URL传递给其中一个。
为此，YoutubeDL对象有一个允许的方法按照给定的顺序注册InfoExtractors。
当它被传递时一个URL, YoutubeDL对象处理它的第一个InfoExtractor它
发现报告能够处理它。InfoExtractor提取该URL所指向的视频或视频的所有信息
YoutubeDL处理提取的信息，可能使用File下载器下载视频。
YoutubeDL对象接受许多参数。为了不饱和对象构造函数的参数，它接收到的字典
相反的选项。这些选项通过参数可用属性，以便InfoExtractors使用。YoutubeDL还
注册自己为负责InfoExtractors的下载器所以这是“相互注册”

可用选项:
	username:          用于身份验证的用户名.
	password:          身份验证密码.
	videopassword:     访问视频的密码.
	ap_mso:            Adobe Pass多系统操作符标识符.
	ap_username:       多系统操作员帐户用户名.
	ap_password:       多系统操作员帐号密码.
	usenetrc:          使用netrc进行身份验证.
	verbose:           打印附加信息到标准输出.
	quiet:             不打印消息到标准输出.
	no_warnings:       不打印任何警告.
	forceurl:          强制打印最终URL.
	forcetitle:        强制打刷标题.
	forceid:           强制打印刷ID.
	forcethumbnail:    强制打印缩略图URL.
	forcedescription:  强制打刷描述.
	forcefilename:     强制打印最终文件名.
	forceduration:     强制打印刷时间.
	forcejson:         强制打印info_dict为JSON.
	dump_single_json:  强制打印整个播放列表的info_dict
					   (或视频)作为一个单一的JSON行.
	simulate:          不下载视频文件.
	format:            视频格式的代码。更多信息请参见options.py.
	outtmpl:           输出名称模板.
	outtmpl_na_placeholder: 不可用的元字段的占位符.
	restrictfilenames: 文件名中不允许"&"和空格
	ignoreerrors:      下载错误不停止.
	force_generic_extractor: 强制下载程序使用通用提取程序.
	nooverwrites:      防止覆盖文件.
	playliststart:     播放列表项开始.
	playlistend:       播放列表项结束于.
	playlist_items:    下载播放列表的具体索引.
	playlistreverse:   按相反的顺序下载播放列表.
	playlistrandom:    按随机顺序下载播放列表项目.
	matchtitle:        只下载匹配的标题.
	rejecttitle:       拒绝匹配标题的下载.
	logger:            将消息记录到日志中。Logger实例.
	logtostderr:       将消息记录到stderr而不是stdout.
	writedescription:  将视频描述写入。description文件
	writeinfojson:     将视频描述写入一个.info.json文件
	writeannotations:  将视频注释写入.annotations.xml文件
	writethumbnail:    将缩略图图像写入文件
	write_all_thumbnails: 将所有缩略图格式写入文件.
	writesubtitles:    将视频字幕写入文件。
	writeautomaticsub: 将自动生成的字幕写入文件。
 	allsubtitles:      下载视频的所有字幕。
 					   (需要写ubtitles or writeautomaticsub)
	listsubtitles:     列出所有可用的字幕。
	subtitlesformat:   字幕的格式代码。
	subtitleslangs:    下载字幕的语言列表。
	keepvideo:         保留后期处理后的视频文件。
	daterange: DateRange对象，仅当upload_date为i时才下载n the range.
    skip_download:     跳过视频文件的实际下载。
    cachedir:          缓存文件在文件系统中的位置。False禁用文件系统缓存。
    noplaylist:        如果有疑问，请下载单个视频而不是播放列表。
    age_limit:         表示用户年龄(以年为单位)的整数。跳过不适合特定年龄的视频。
    min_views:         表示视频的最小观看数的整数。必须有，才能不被跳过。
                       没有查看计数信息的视频总是。下载。没有限制。
    max_views:         表示最大视图计数的整数。比未被下载的视频更受欢迎的视频.
                       没有查看计数信息的视频总是。下载。没有限制。
    download_archive:  记录所有下载的文件的文件名。
                       视频已经出现在文件不下载again.
    cookiefile:        应该读取和转储cookie的文件名.
    nocheckcertificate:不验证SSL证书。
    prefer_insecure:   使用HTTP而不是HTTPS来检索信息。
                       目前只有YouTube支持这一功能。
                       
    proxy:             要使用的代理服务器的URL。
    geo_verification_proxy:  用于在受地理限制的站点上验证IP地址的代理的URL。
    socket_timeout:    等待无响应主机的时间，以秒为单位。
    bidi_workaround:   使用fridibi解决没有双向文本支持的错误终端。
    debug_printtraffic:打印发送和接收的HTTP流量。
    include_ads:       也可以下载广告。
    default_search:    如果输入url不是有效的'auto'，则添加此字符串.
    encoding:          使用此编码而不是系统指定的。
    extract_flat:      不解析url，返回直接结果。
    				传入'in_playlist'只对播放列表项显示此行为。

    postprocessors:    字典的列表，每一个都有一个条目
                       * key:  后处理器的名称。
                       * 查看列表Seeoutube_dl/postprocessor/__init__.py。
                       以及任何后续处理器的关键字参数。
    progress_hooks:下载过程中调用的函数列表，以及包含条目的字典
                  *状态:一个"下载"，"错误"，或"完成"。
                   首先检查这个，然后忽略未知值。
                   如果状态为“正在下载”或“已完成”，则
                   以下属性也可能存在:
                   * filename:最后的文件名(总是存在)
                   * tmpfilename:当前写入的文件名
                   * downloadaded_bytes:磁盘上的字节数
                   * total_bytes:整个文件的大小，如果未知则为None
                   total_bytes_estimate:对最终文件大小的猜测，如果没有不可用。
                      * elapsed:下载开始后的秒数。
                      * eta:以秒为单位的估计时间，如果未知则为None
                      * speed:下载速度，单位为字节/秒未知的
                      * fragment_index:当前的计数器下载的视频片段。
                      * fragment_count:碎片的数量(=独立的文件将被合并)
                      进度钩子保证至少被调用一次(状态为“完成”)下载成功。
    merge_output_format: 扩展使用时合并格式.
    fixup:自动纠正文件的已知错误.
          One of:
          - "never": 什么都不做
          - "warn": 只发出警告
          - "detect_or_warn": 检查我们是否可以对此做些什么，否则警告(默认)
    source_address:    绑定到的客户端IP地址.
    call_home:Boolean，如果允许我们联系youtube-dl服务器进行调试，则为true.
    sleep_interval:    当单独使用时，每次下载前休眠的秒数;或者当与    
    sleep_interval:    当单独使用时，每次下载前休眠的秒数;
    				   或者当max_sleep_interval一起使用时，
                       每次下载前随机休眠的范围的下限(可能休眠的最小秒数).
    max_sleep_interval:每次下载前随机睡眠范围的上限(最大可能的睡眠秒数)。必须与			
    					sleep_interval一起使用。
                        实际睡眠时间将是
                        range [sleep_interval;max_sleep_interval].
    listformats:       打印可用视频格式的概述并退出.
    list_thumbnails:   打印所有缩略图的表格并退出.
    match_filter:      每个视频的info_dict都会调用这个函数。
                       如果它返回一条消息，视频将被忽略。
                       如果返回None，则表示下载视频。
                       utils.py中的match_filter_func就是一个例子.
    no_color:         在输出中不发出颜色代码.
    geo_bypass:       通过伪造X-Forwarded-For HTTP报头绕过地理限制
    geo_bypass_country:两个字母的ISO 3166-2国家代码，将用于明确的地理限制，
    					通过伪造的x - forward - for HTTP头
    geo_bypass_ip_block: CIDR表示法中的IP范围将类似于geo_bypass_country
----以下选项决定选择哪个下载程序:
    external_downloader: 要调用的外部下载程序的可执行文件。
    					标准(内置)下载器为None或未设置.
    hls_prefer_native: 如果为True，使用本机HLS下载器而不是ffmpeg/avconv;
    					如果为False，则使用ffmpeg/avconv;如果为None，
    					则使用提取器建议的下载器.
-----以下参数不是YoutubeDL本身使用的，而是被YoutubeDL使用的下载器
	(见youtube_dl/downloader/common.py):
    nopart, updatetime, buffersize, ratelimit, min_filesize, 	
    max_filesize, test,noresizebuffer, retries, continuedl, 
    noprogress, consoletitle, xattr_set_filesize,
    external_downloader_args, hls_use_mpegts, http_chunk_size.
----后置处理器使用以下选项:
    prefer_ffmpeg: 如果为False，则使用avconv而不是ffmpeg(如果两者都可用)，
    否则更喜欢ffmpeg。
    ffmpeg_location:   ffmpeg/avconv二进制文件的位置;
    					二进制文件或其包含目录的路径.
    postprocessor_args: 后置处理器的附加命令行参数列表.
----以下选项由Youtube提取程序使用:
    youtube_include_dash_manifest: 如果为True(默认)，
    						则提取器将下载并处理DASH清单和相关数据。
						如果你不关心DASH，你可以通过禁用它来减少网络I/O.