@[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:整个文件的大小，如果未知则为Nonetotal_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.
