Keyboard Control  键盘控制

LEFT and RIGHT  LEFT 和 RIGHT

Seek backward/forward 5 seconds. Shift+arrow does a 1 second exact seek (see --hr-seek).
向后/向前搜索 5 秒。Shift+箭头进行 1 秒精确搜索（见 --hr-seek ）。

UP and DOWN  向上 和 向下

Seek forward/backward 1 minute. Shift+arrow does a 5 second exact seek (see --hr-seek).
向前/向后寻找 1 分钟。Shift+箭头键进行 5 秒精确寻找（见 --hr-seek ）。

Ctrl+LEFT and Ctrl+RIGHT
Ctrl+向左键和 Ctrl+向右键

Seek to the previous/next subtitle. Subject to some restrictions and might not always work; see sub-seek command.
跳转到上一个/下一个字幕。可能受到一些限制，不一定总是有效；请参阅 sub-seek 命令。

Ctrl+Shift+LEFT and Ctrl+Shift+RIGHT
Ctrl+Shift+向左键和 Ctrl+Shift+向右键

Adjust subtitle delay so that the previous or next subtitle is displayed now. This is especially useful to sync subtitles to audio.
调整字幕延迟，以便显示上一个或下一个字幕。这对于同步字幕与音频特别有用。

[ and ]  [ 和 ]

Decrease/increase current playback speed by 10%.
降低/提高当前播放速度 10%。

{ and }  { 和 }

Halve/double current playback speed.
将当前播放速度减半/加倍。

BACKSPACE  退格键

Reset playback speed to normal.
将播放速度重置为正常。

Shift+BACKSPACE  Shift+退格键

Undo the last seek. This works only if the playlist entry was not changed. Hitting it a second time will go back to the original position. See revert-seek command for details.
撤销上一次的寻找。这仅在播放列表条目未被更改时有效。再次点击将返回到原始位置。有关详细信息，请参阅 revert-seek 命令。

Shift+Ctrl+BACKSPACE

Mark the current position. This will then be used by Shift+BACKSPACE as revert position (once you seek back, the marker will be reset). You can use this to seek around in the file and then return to the exact position where you left off.
标记当前位置。然后， Shift+BACKSPACE 将将其用作回退位置（一旦你返回，标记将被重置）。你可以使用此功能在文件中寻找，然后返回到你离开的确切位置。

< and >  < 和 >

Go backward/forward in the playlist.
在播放列表中向前/向后移动。

ENTER  输入

Go forward in the playlist.
前进到播放列表。

Shift+HOME and Shift+END
Shift+HOME 和 Shift+END

Go to the first/last playlist entry.
转到第一个/最后一个播放列表条目。

p and SPACE  p 和空格

Pause (pressing again unpauses).
暂停（再次按动可继续）。

.

Step forward. Pressing once will pause, every consecutive press will play one frame and then go into pause mode again.
向前一步。按一次将暂停，连续按将播放一帧，然后再次进入暂停模式。

,

Step backward. Pressing once will pause, every consecutive press will play one frame in reverse and then go into pause mode again.
向后一步。按一次将暂停，连续按将反向播放一帧，然后再次进入暂停模式。

q

Stop playing and quit.
停止播放并退出。

Q

Like q, but store the current playback position. Playing the same file later will resume at the old playback position if possible. See RESUMING PLAYBACK.
类似于 q ，但存储当前播放位置。稍后再次播放同一文件时，如果可能，将恢复到旧播放位置。参见“恢复播放”。

/ and *  / 和 *

Decrease/increase volume.
减小/增大音量。

KP_DIVIDE and KP_MULTIPLY
KP_DIVIDE 和 KP_MULTIPLY

Decrease/increase volume.
减小/增大音量。

9 and 0  9 和 0

Decrease/increase volume.
减小/增大音量。

m

Mute sound.  静音声音。

_

Cycle through the available video tracks.
循环浏览可用的视频轨道。

#

Cycle through the available audio tracks.
循环浏览可用的音频轨道。

E

Cycle through the available Editions.
循环浏览可用的版本。

f

Toggle fullscreen (see also --fs).
切换全屏（另见 --fs 。）

ESC

Exit fullscreen mode.  退出全屏模式。

T

Toggle stay-on-top (see also --ontop).
切换置顶（另见 --ontop 。）

w and W  w 和 W

Decrease/increase pan-and-scan range. The e key does the same as W currently, but use is discouraged. See --panscan for more information.
减小/增加缩放范围。 e 键目前与 W 功能相同，但使用不推荐。更多信息请参阅 --panscan 。

o and P  o 和 P

Show progression bar, elapsed time and total duration on the OSD.
在 OSD 上显示进度条、已过时间和总时长。

O

Toggle OSD states between normal and playback time/duration.
在正常和播放时间/持续时间之间切换 OSD 状态。

v

Toggle subtitle visibility.
切换字幕可见性。

j and J  j 和 J

Cycle through the available subtitles.
循环切换可用的字幕。

z and Z  z 和 Z

Adjust subtitle delay by -/+ 0.1 seconds. The x key does the same as Z currently, but use is discouraged.
调整副标题延迟 -/+ 0.1 秒。当前 x 键与 Z 键功能相同，但使用不推荐。

l

Set/clear A-B loop points. See ab-loop command for details.
设置/清除 A-B 循环点。查看 ab-loop 命令以获取详细信息。

L

Toggle infinite looping.
切换无限循环。

Ctrl++ and Ctrl+-  Ctrl++ 和 Ctrl+-

Adjust audio delay (A/V sync) by +/- 0.1 seconds.
通过 +/- 0.1 秒调整音频延迟（音视频同步）。

Ctrl+KP_ADD and Ctrl+KP_SUBTRACT
Ctrl+KP_ADD 和 Ctrl+KP_SUBTRACT

Adjust audio delay (A/V sync) by +/- 0.1 seconds.
通过 +/- 0.1 秒调整音频延迟（音视频同步）。

G and F  G 和 F

Adjust subtitle font size by +/- 10%.
调整字幕字体大小 ±10%。

u

Switch between applying only --sub-ass-* overrides (default) to SSA/ASS subtitles, and overriding them almost completely with the normal subtitle style. See --sub-ass-override for more info.
在仅应用 --sub-ass-* 覆盖（默认）到 SSA/ASS 字幕和几乎完全用正常字幕样式覆盖它们之间切换。见 --sub-ass-override 了解更多信息。

V

Cycle through which video data gets used for ASS rendering. See --sub-ass-use-video-data for more info.
循环使用哪些视频数据用于 ASS 渲染。见 --sub-ass-use-video-data 了解更多信息。

r and R  r 和 R

Move subtitles up/down. The t key does the same as R currently, but use is discouraged.
移动字幕上下。 t 键目前与 R 执行相同操作，但使用被不建议。

s

Take a screenshot.  截取屏幕截图。

S

Take a screenshot, without subtitles. (Whether this works depends on VO driver support.)
截取屏幕截图，不包含字幕。（这能否工作取决于 VO 驱动程序支持。）

Ctrl+s

Take a screenshot, as the window shows it (with subtitles, OSD, and scaled video).
截取屏幕截图，如窗口所示（包含字幕、OSD 和缩放视频）。

HOME  首页

Seek to the beginning of the file.
移动到文件开头。

PGUP and PGDWN  PGUP 和 PGDN

Seek to the beginning of the previous/next chapter. In most cases, "previous" will actually go to the beginning of the current chapter; see --chapter-seek-threshold.
查找上一章/下一章的开头。在大多数情况下，“上一章”实际上会跳转到当前章节的开头；参见 --chapter-seek-threshold 。

Shift+PGUP and Shift+PGDWN
Shift+PGUP 和 Shift+PGDWN

Seek backward or forward by 10 minutes. (This used to be mapped to PGUP/PGDWN without Shift.)
向后或向前查找 10 分钟。（这曾经被映射到 PGUP/PGDWN，但不带 Shift。）

b

Activate/deactivate debanding.
激活/禁用去频带。

d

Cycle the deinterlacing filter.
循环去隔行滤波器。

A

Cycle aspect ratio override.
循环调整宽高比覆盖。

Ctrl+h

Toggle hardware video decoding on/off.
切换硬件视频解码开/关。

Alt+LEFT, Alt+RIGHT, Alt+UP, Alt+DOWN

Move the video rectangle (panning).
移动视频矩形（平移）。

Alt++ and Alt+-  Alt++ 和 Alt+-

Change video zoom.  更改视频缩放。

Alt+KP_ADD and Alt+KP_SUBTRACT
Alt+KP_ADD 和 Alt+KP_SUBTRACT

Change video zoom.  更改视频缩放。

Alt+BACKSPACE

Reset the pan/zoom settings.
重置平移/缩放设置。

F8

Show the playlist and the current position in it.
显示播放列表及其当前位置。

F9

Show the list of audio and subtitle streams.
显示音频和字幕流列表。

Ctrl+v

Append the file or URL in the clipboard to the playlist. If nothing is currently playing, it is played immediately. Only works on platforms that support the clipboard property.
将剪贴板中的文件或 URL 添加到播放列表。如果没有正在播放的内容，它将立即播放。仅在支持 clipboard 属性的平台上有效。

i and I  i 和 I

Show/toggle an overlay displaying statistics about the currently playing file such as codec, framerate, number of dropped frames and so on. See STATS for more information.
显示/切换显示当前播放文件统计信息的覆盖层，例如编解码器、帧率、丢失帧数等。有关更多信息，请参阅 STATS。

?

Toggle an overlay displaying the active key bindings. See STATS for more information.
切换显示活动按键绑定的覆盖层。有关更多信息，请参阅 STATS。

DEL

Cycle OSC visibility between never / auto (mouse-move) / always
在“从不”/自动（鼠标移动）/总是之间循环 OSC 可见性。

`

Show the console. (ESC closes it again. See CONSOLE.)
显示控制台。（按 ESC 关闭。见 控制台。）

(The following keys are valid only when using a video output that supports the corresponding adjustment.)
（以下键仅在使用支持相应调整的视频输出时有效。）

1 and 2  1 和 2

Adjust contrast.  调整对比度。

3 and 4  3 和 4

Adjust brightness.  调整亮度。

5 and 6  5 和 6

Adjust gamma.  调整伽玛。

7 and 8  7 和 8

Adjust saturation.  调整饱和度。

Alt+0 (and Command+0 on macOS)
Alt+0（以及在 macOS 上的 Command+0）

Resize video window to half its original size.
将视频窗口大小调整为原始大小的一半。

Alt+1 (and Command+1 on macOS)
Alt+1（在 macOS 上为 Command+1）

Resize video window to its original size.
将视频窗口大小调整为原始大小。

Alt+2 (and Command+2 on macOS)
Alt+2（在 macOS 上为 Command+2）

Resize video window to double its original size.
调整视频窗口大小至原始大小的两倍。

Command + f (macOS only)
Command + f（仅限 macOS）

Toggle fullscreen (see also --fs).
切换全屏（另见 --fs 。）

(The following keybindings open a menu in the console that lets you choose from a list of items by typing part of the desired item, by clicking the desired item, or by navigating them with keybindings: Down and Ctrl+n go down, Up and Ctrl+p go up, Page down and Ctrl+f scroll down one page, and Page up and Ctrl+b scroll up one page.)
（以下快捷键在控制台中打开一个菜单，允许您通过输入所需项目的部分内容、点击所需项目或使用快捷键进行导航来从项目列表中选择： Down 和 Ctrl+n 向下移动， Up 和 Ctrl+p 向上移动， Page down 和 Ctrl+f 向下滚动一页，以及 Page up 和 Ctrl+b 向上滚动一页。）

In track menus, selecting the current tracks disables it.
在轨道菜单中，选择当前轨道将禁用它。

g-p

Select a playlist entry.
选择一个播放列表条目。

g-s

Select a subtitle track.
选择一个字幕轨道。

g-S

Select a secondary subtitle track.
选择一个辅助字幕轨道。

g-a

Select an audio track.
选择一个音频轨道。

g-v

Select a video track.
选择一个视频轨道。

g-t

Select a track of any type.
选择任何类型的轨道。

g-c

Select a chapter.  选择一个章节。

g-e

Select an MKV edition or DVD/Blu-ray title.
选择一个 MKV 版本或 DVD/Blu-ray 标题。

g-l

Select a subtitle line to seek to. This currently requires ffmpeg in PATH, or in the same folder as mpv on Windows.
选择要跳转到的字幕行。这目前需要 ffmpeg 在 PATH 中，或者在 Windows 上 mpv 的同一文件夹中。

g-d

Select an audio device.
选择一个音频设备。

g-h

Select a file from the watch history. Requires --save-watch-history.
从观看历史记录中选择一个文件。需要 --save-watch-history 。

g-w

Select a file from watch later config files (see RESUMING PLAYBACK) to resume playing. Requires --write-filename-in-watch-later-config.
从稍后观看配置文件中选择一个文件以继续播放（见 RESUMING PLAYBACK）。需要 --write-filename-in-watch-later-config 。

g-b

Select a defined input binding.
选择一个定义好的输入绑定。

g-r

Show the values of all properties.
显示所有属性的值。

g-m, MENU, Ctrl+p  g-m, 菜单, Ctrl+p

Show a menu with miscellaneous entries.
显示包含杂项条目的菜单。

See SELECT for more information.
查看 SELECT 以获取更多信息。

(The following keys are valid if you have a keyboard with multimedia keys.)
（如果您有带多媒体键的键盘，以下键是有效的。）

PAUSE  暂停

Pause.  暂停。

STOP  停止

Stop playing and quit.
停止播放并退出。

PREVIOUS and NEXT  上一页和下一页

Seek backward/forward 1 minute.
向后/向前搜索 1 分钟。

ZOOMIN and ZOOMOUT  放大和缩小

Change video zoom.  更改视频缩放。

If you miss some older key bindings, look at etc/restore-old-bindings.conf in the mpv git repository.
如果您错过了某些旧快捷键，请查看 mpv 代码库中的 etc/restore-old-bindings.conf 。

Mouse Control  鼠标控制

Ctrl+left click  Ctrl+左键点击

Pan while holding the button, keeping the clicked part of the video under the cursor.
按住按钮同时进行拖动，保持视频中被点击的部分位于光标下方。

Left double click  左键双击

Toggle fullscreen on/off.
切换全屏开/关。

Right click  右键点击

Toggle pause on/off.  切换暂停/开启。

Forward/Back button  前进/后退按钮

Skip to next/previous entry in playlist.
跳转到播放列表中的下一个/上一个条目。

Wheel up/down  滚轮向上/向下

Decrease/increase volume.
减小/增大音量。

Wheel left/right  方向盘左/右

Seek forward/backward 10 seconds.
快进/快退 10 秒。

Ctrl+Wheel up/down  Ctrl+滚轮上/下

Change video zoom keeping the part of the video hovered by the cursor under it.
更改视频缩放，保持鼠标悬停部分始终位于视频下方。

Context Menu  上下文菜单

Context Menu is a menu that pops up on the video window on user interaction (mouse right click, etc.).
上下文菜单是一种在用户交互（鼠标右键点击等）时在视频窗口上弹出的菜单。

To use this feature, you need to fill the menu-data property with menu definition data, and add a keybinding to run the context-menu command, which can be done with a user script.
要使用此功能，您需要将 menu-data 属性填充为菜单定义数据，并添加一个键绑定来运行 context-menu 命令，这可以通过用户脚本完成。

Legacy option syntax  旧选项语法

The --option=value syntax is not strictly enforced, and the alternative legacy syntax -option value and -option=value will also work. This is mostly for compatibility with MPlayer. Using these should be avoided. Their semantics can change any time in the future.

For example, the alternative syntax will consider an argument following the option a filename. mpv -fs no will attempt to play a file named no, because --fs is a flag option that requires no parameter. If an option changes and its parameter becomes optional, then a command line using the alternative syntax will break.

Until mpv 0.31.0, there was no difference whether an option started with -- or a single -. Newer mpv releases strictly expect that you pass the option value after a =. For example, before mpv --log-file f.txt would write a log to f.txt, but now this command line fails, as --log-file expects an option value, and f.txt is simply considered a normal file to be played (as in mpv f.txt).

The future plan is that -option value will not work anymore, and options with a single - behave the same as -- options.

Escaping spaces and other special characters
转义空格和其他特殊字符

Keep in mind that the shell will partially parse and mangle the arguments you pass to mpv. For example, you might need to quote or escape options and filenames:
请注意，shell 将会部分解析并损坏您传递给 mpv 的参数。例如，您可能需要引用或转义选项和文件名：

mpv "filename with spaces.mkv" --title="window title"

It gets more complicated if the suboption parser is involved. The suboption parser puts several options into a single string, and passes them to a component at once, instead of using multiple options on the level of the command line.
如果涉及到子选项解析器，事情会变得更加复杂。子选项解析器将多个选项放入一个字符串中，并一次性传递给组件，而不是在命令行级别使用多个选项。

The suboption parser can quote strings with " and [...]. Additionally, there is a special form of quoting with %n% described below.
子选项解析器可以使用 " 和 [...] 引用字符串。此外，下面描述了带有 %n% 的特殊引用形式。

For example, assume the hypothetical foo filter can take multiple options:
例如，假设假设的 foo 过滤器可以接受多个选项：

mpv test.mkv --vf=foo:option1=value1:option2:option3=value3,bar

This passes option1 and option3 to the foo filter, with option2 as flag (implicitly option2=yes), and adds a bar filter after that. If an option contains spaces or characters like , or :, you need to quote them:
这会将 option1 和 option3 传递给 foo 过滤器，以 option2 作为标志（隐式地 option2=yes ），并在之后添加一个 bar 过滤器。如果选项包含空格或像 , 或 : 这样的字符，您需要引用它们：

mpv '--vf=foo:option1="option value with spaces",bar'

Shells may actually strip some quotes from the string passed to the commandline, so the example quotes the string twice, ensuring that mpv receives the " quotes.
Shell 实际上可能会从传递给命令行的字符串中删除一些引号，因此示例中字符串被引号引用两次，以确保 mpv 接收到的 " 引号正确。

The [...] form of quotes wraps everything between [ and ]. It's useful with shells that don't interpret these characters in the middle of an argument (like bash). These quotes are balanced (since mpv 0.9.0): the [ and ] nest, and the quote terminates on the last ] that has no matching [ within the string. (For example, [a[b]c] results in a[b]c.)
[...] 形式的引号将 [ 和 ] 之间的所有内容括起来。这对于那些在参数中间不解释这些字符的 shell（如 bash）非常有用。这些引号是平衡的（自 mpv 0.9.0 以来）： [ 和 ] 嵌套，引号在最后一个没有匹配的 ] 处结束，该 ] 在字符串内部没有对应的 [ 。（例如， [a[b]c] 结果为 a[b]c 。）

The fixed-length quoting syntax is intended for use with external scripts and programs.
固定长度引用语法旨在与外部脚本和程序一起使用。

It is started with % and has the following format:
它以 % 开头，格式如下：

%n%string_of_length_n

Note: where applicable with JSON-IPC, %n% is the length in UTF-8 bytes, after decoding the JSON data.
注意：在适用 JSON-IPC 的情况下， %n% 是解码 JSON 数据后的 UTF-8 字节长度。

Suboptions passed to the client API are also subject to escaping. Using mpv_set_option_string() is exactly like passing --name=data to the command line (but without shell processing of the string). Some options support passing values in a more structured way instead of flat strings, and can avoid the suboption parsing mess. For example, --vf supports MPV_FORMAT_NODE, which lets you pass suboptions as a nested data structure of maps and arrays.
子选项传递给客户端 API 时也需要转义。使用 mpv_set_option_string() 与传递 --name=data 到命令行（但无需对字符串进行 shell 处理）完全相同。某些选项支持以更结构化的方式传递值，而不是扁平字符串，从而可以避免子选项解析的混乱。例如， --vf 支持 MPV_FORMAT_NODE ，这允许您将子选项作为嵌套的映射和数组数据结构传递。

Paths  路径

Some care must be taken when passing arbitrary paths and filenames to mpv. For example, paths starting with - will be interpreted as options. Likewise, if a path contains the sequence ://, the string before that might be interpreted as protocol prefix, even though :// can be part of a legal UNIX path. To avoid problems with arbitrary paths, you should be sure that absolute paths passed to mpv start with /, and prefix relative paths with ./.
在将任意路径和文件名传递给 mpv 时必须小心。例如，以 - 开头的路径将被解释为选项。同样，如果路径包含序列 :// ，那么该序列之前的字符串可能会被解释为协议前缀，即使 :// 可以是合法的 UNIX 路径的一部分。为了避免与任意路径相关的问题，您应该确保传递给 mpv 的绝对路径以 / 开头，并且相对路径以 ./ 前缀。

Using the file:// pseudo-protocol is discouraged, because it involves strange URL unescaping rules.
不建议使用 file:// 伪协议，因为它涉及奇怪的 URL 转义规则。

The name - itself is interpreted as stdin, and will cause mpv to disable console controls. (Which makes it suitable for playing data piped to stdin.)
名称 - 本身被解释为 stdin，这将导致 mpv 禁用控制台控制。（这使得它适合播放通过 stdin 管道传输的数据。）

The special argument -- can be used to stop mpv from interpreting the following arguments as options.
特殊参数 -- 可以用来阻止 mpv 将后续参数解释为选项。

For paths passed to mpv suboptions (options that have multiple : and ,-separated values), the situation is further complicated by the need to escape special characters. To work around this, the path can instead be wrapped in the "fixed-length" syntax, e.g. %n%string_of_length_n (see above).
对于传递给 mpv 子选项（具有多个值并以 - 分隔的选项）的路径，还需要转义特殊字符，这使得情况更加复杂。为了解决这个问题，可以将路径用“固定长度”语法包裹，例如 %n%string_of_length_n （见上文）。

When using the libmpv API, you should strictly avoid using mpv_command_string for invoking the loadfile command, and instead prefer e.g. mpv_command to avoid the need for filename escaping.
在使用 libmpv API 时，应严格避免使用 mpv_command_string 来调用 loadfile 命令，而应优先考虑例如 mpv_command 以避免需要转义文件名。

The same applies when you're using the scripting API, where you should avoid using mp.command, and instead prefer using "separate parameter" APIs, such as mp.commandv and mp.command_native.
同样适用于使用脚本 API 的情况，此时应避免使用 mp.command ，而应优先考虑使用“单独参数”API，例如 mp.commandv 和 mp.command_native 。

Some mpv options will interpret special meanings for paths starting with ~, making it easy to dynamically find special directories, such as referring to the current user's home directory or the mpv configuration directory.
某些 mpv 选项将为以 ~ 开头的路径赋予特殊含义，这使得动态查找特殊目录变得容易，例如引用当前用户的家目录或 mpv 配置目录。

When using the special ~ prefix, there must always be a trailing / after the special path prefix. In other words, ~ doesn't work, but ~/ will work.
使用特殊 ~ 前缀时，必须在特殊路径前缀后始终跟有一个 / 。换句话说， ~ 不适用，但 ~/ 适用。

The following special paths/keywords are currently recognized:
以下特殊路径/关键字目前被识别：

Per-File Options  文件级选项

When playing multiple files, any option given on the command line usually affects all files. Example:
在播放多个文件时，命令行上给出的任何选项通常会影响所有文件。例如：

mpv --a file1.mkv --b file2.mkv --c

(This is different from MPlayer and mplayer2.)
(这与 MPlayer 和 mplayer2 不同。)

Also, if any option is changed at runtime (via input commands), they are not reset when a new file is played.
此外，如果在运行时（通过输入命令）更改了任何选项，当播放新文件时它们不会被重置。

Sometimes, it is useful to change options per-file. This can be achieved by adding the special per-file markers --{ and --}. (Note that you must escape these on some shells.) Example:
有时，按文件更改选项很有用。这可以通过添加特殊的按文件标记 --{ 和 --} 来实现。（注意，在某些 shell 中必须对这些标记进行转义。）示例：

mpv --a file1.mkv --b --\{ --c file2.mkv --d file3.mkv --e --\} file4.mkv --f

Additionally, any file-local option changed at runtime is reset when the current file stops playing. If option --c is changed during playback of file2.mkv, it is reset when advancing to file3.mkv. This only affects file-local options. The option --a is never reset here.
此外，任何在运行时更改的文件本地选项，在当前文件停止播放时都会重置。如果在播放 file2.mkv 期间更改了选项 --c ，则在切换到 file3.mkv 时会重置。这仅影响文件本地选项。选项 --a 在这里永远不会重置。

List Options  列表选项

Some options which store lists of option values can have action suffixes. For example, the --display-tags option takes a ,-separated list of tags, but the option also allows you to append a single tag with --display-tags-append, and the tag name can for example contain a literal , without the need for escaping.
某些选项可以存储选项值的列表，并且可以具有操作后缀。例如， --display-tags 选项接受一个由 , 分隔的标签列表，但该选项还允许您使用 --display-tags-append 添加单个标签，并且标签名称可以例如包含一个字面量 , 而无需转义。

Location and Syntax  位置和语法

You can put all of the options in configuration files which will be read every time mpv is run. The system-wide configuration file 'mpv.conf' is in your configuration directory (e.g. /etc/mpv or /usr/local/etc/mpv), the user-specific one is ~/.config/mpv/mpv.conf. For details and platform specifics (in particular Windows paths) see the FILES section.
您可以将所有选项放入配置文件中，这些文件将在每次运行 mpv 时被读取。系统级配置文件 'mpv.conf' 位于您的配置目录中（例如 /etc/mpv 或 /usr/local/etc/mpv ），用户特定的配置文件是 ~/.config/mpv/mpv.conf 。有关详细信息和平台特定信息（特别是 Windows 路径），请参阅“文件”部分。

User-specific options override system-wide options and options given on the command line override both. The syntax of the configuration files is option=value. Everything after a # is considered a comment. Options that work without values can be enabled by setting them to yes and disabled by setting them to no, and if the value is omitted, yes is implied. Even suboptions can be specified in this way.
用户特定的选项会覆盖系统级选项，而命令行上的选项会覆盖两者。配置文件的语法是 option=value 。在 # 之后的所有内容都被视为注释。无需值的选项可以通过将其设置为 yes 来启用，通过将其设置为 no 来禁用，如果省略了值，则默认为 yes。甚至子选项也可以这样指定。

# Don't allow new windows to be larger than the screen.
autofit-larger=100%x100%
# Enable hardware decoding if available, =yes is implied.
hwdec
# Spaces don't have to be escaped.
osd-playing-msg=File: ${filename}

Escaping special characters
转义特殊字符

This is done like with command line options. A config entry can be quoted with ", ', as well as with the fixed-length syntax (%n%) mentioned before. This is like passing the exact contents of the quoted string as a command line option. C-style escapes are currently _not_ interpreted on this level, although some options do this manually (this is a mess and should probably be changed at some point). The shell is not involved here, so option values only need to be quoted to escape # anywhere in the value, ", ' or % at the beginning of the value, and leading and trailing whitespace.
这就像使用命令行选项一样完成。配置条目可以用 " ， ' 引用，也可以用之前提到的固定长度语法（ %n% ）。这就像将引用字符串的精确内容作为命令行选项传递。目前在这个级别上，C 样式的转义 _不_ 被解释，尽管一些选项会手动这样做（这很混乱，可能迟早需要改变）。这里不涉及 shell，因此选项值只需要引用以转义值中的任何位置 # ， " ， ' 或值开头的 % ，以及前导和尾随空格。

Putting Command Line Options into the Configuration File
将命令行选项放入配置文件

Almost all command line options can be put into the configuration file. Here is a small guide:
几乎所有的命令行选项都可以放入配置文件。这里有一个小指南：

File-specific Configuration Files
特定文件配置文件

You can also write file-specific configuration files. If you wish to have a configuration file for a file called 'video.avi', create a file named 'video.avi.conf' with the file-specific options in it and put it in ~/.config/mpv/. You can also put the configuration file in the same directory as the file to be played. Both require you to set the --use-filedir-conf option (either on the command line or in your global config file). If a file-specific configuration file is found in the same directory, no file-specific configuration is loaded from ~/.config/mpv. In addition, the --use-filedir-conf option enables directory-specific configuration files. For this, mpv first tries to load a mpv.conf from the same directory as the file played and then tries to load any file-specific configuration.
您也可以编写特定文件的配置文件。如果您希望为名为 'video.avi' 的文件创建配置文件，请创建一个名为 'video.avi.conf' 的文件，在其中包含特定文件的选项，并将其放在 ~/.config/mpv/ 中。您也可以将配置文件放在要播放的文件所在的同一目录中。两者都需要您设置 --use-filedir-conf 选项（无论是在命令行还是在您的全局配置文件中）。如果在同一目录中找到特定文件的配置文件，则不会从 ~/.config/mpv 加载特定文件配置。此外， --use-filedir-conf 选项启用特定目录的配置文件。为此，mpv 首先尝试从播放的文件所在的同一目录加载 mpv.conf，然后尝试加载任何特定文件的配置。

Profiles  配置文件

To ease working with different configurations, profiles can be defined in the configuration files. A profile starts with its name in square brackets, e.g. [my-profile]. All following options will be part of the profile. A description (shown by --profile=help) can be defined with the profile-desc option. To end the profile, start another one or use the profile name default to continue with normal options.
为了方便处理不同的配置，可以在配置文件中定义配置文件。一个配置文件以方括号中的名称开始，例如 [my-profile] 。所有后续选项都将成为配置文件的一部分。可以使用 profile-desc 选项定义描述（通过 --profile=help 显示）。要结束配置文件，可以开始另一个配置文件或使用配置文件名称 default 继续使用常规选项。

You can list profiles with --profile=help, and show the contents of a profile with --show-profile=<name> (replace <name> with the profile name). You can apply profiles on start with the --profile=<name> option, or at runtime with the apply-profile <name> command.
可以使用 --profile=help 列出配置文件，并使用 --show-profile=<name> 显示配置文件的内容（将 <name> 替换为配置文件名称）。您可以在启动时使用 --profile=<name> 选项应用配置文件，或在运行时使用 apply-profile <name> 命令应用。

# normal top-level option
fullscreen=yes

# a profile that can be enabled with --profile=big-cache
[big-cache]
cache=yes
demuxer-max-bytes=512MiB
demuxer-readahead-secs=20

[network]
profile-desc="profile for content over network"
force-window=immediate
# you can also include other profiles
profile=big-cache

[reduce-judder]
video-sync=display-resample
interpolation=yes

# using a profile again extends it
[network]
demuxer-max-back-bytes=512MiB
# reference a builtin profile
profile=fast

Runtime profiles  运行时配置文件

Profiles can be set at runtime with apply-profile command. Since this operation is "destructive" (every item in a profile is simply set as an option, overwriting the previous value), you can't just enable and disable profiles again.
配置文件可以在运行时使用 apply-profile 命令设置。由于此操作是“破坏性”的（配置文件中的每个项目都简单地设置为选项，覆盖之前的值），因此您不能再次启用和禁用配置文件。

As a partial remedy, there is a way to make profiles save old option values before overwriting them with the profile values, and then restoring the old values at a later point using apply-profile <profile-name> restore.
作为部分补救措施，有一种方法可以在覆盖配置文件值之前保存旧选项值，然后在稍后使用 apply-profile <profile-name> restore 恢复旧值。

This can be enabled with the profile-restore option, which takes one of the following options:
这可以通过 profile-restore 选项启用，该选项接受以下选项之一：

default

Does nothing, and nothing can be restored (default).
无操作，且无法恢复（默认）。

copy

When applying a profile, copy the old values of all profile options to a backup before setting them from the profile. These options are reset to their old values using the backup when restoring.
应用配置文件时，在从配置文件设置之前，将所有配置选项的旧值复制到备份中。在恢复时，使用备份将这些选项重置为旧值。

Every profile has its own list of backed up values. If the backup already exists (e.g. if apply-profile name was called more than once in a row), the existing backup is no changed. The restore operation will remove the backup.
每个配置文件都有自己的备份值列表。如果备份已存在（例如，如果连续多次调用了 apply-profile name ），则现有备份不会被更改。恢复操作将删除备份。

It's important to know that restoring does not "undo" setting an option, but simply copies the old option value. Consider for example vf-add, appends an entry to vf. This mechanism will simply copy the entire vf list, and does _not_ execute the inverse of vf-add (that would be vf-remove) on restoring.
重要的是要知道，恢复操作不会“撤销”设置选项，而只是复制旧选项值。例如，考虑 vf-add ，向 vf 中追加条目。此机制将简单地复制整个 vf 列表，并且在恢复时不会执行 vf-add 的逆操作（那将是 vf-remove ）。

Note that if a profile contains recursive profiles (via the profile option), the options in these recursive profiles are treated as if they were part of this profile. The referenced profile's backup list is not used when creating or using the backup. Restoring a profile does not restore referenced profiles, only the options of referenced profiles (as if they were part of the main profile).
请注意，如果配置文件包含递归配置文件（通过 profile 选项），则这些递归配置文件中的选项被视为此配置文件的一部分。创建或使用备份时不会使用引用配置文件的备份列表。恢复配置文件不会恢复引用配置文件，只会恢复引用配置文件的选项（就像它们是主配置文件的一部分一样）。

copy-equal

Similar to copy, but restore an option only if it has the same value as the value effectively set by the profile. This tries to deal with the situation when the user does not want the option to be reset after interactively changing it.
类似于 copy ，但仅在选项具有与配置文件实际设置的值相同的值时才恢复选项。这试图处理用户在交互式更改选项后不希望重置选项的情况。

[something]
profile-restore=copy-equal
vf-add=rotate=PI/2  # rotate by 90 degrees

set vf vflip
apply-profile something
vf add hflip
apply-profile something
# vf == vflip,rotate=PI/2,hflip,rotate=PI/2
apply-profile something restore
# vf == vflip

Conditional auto profiles
条件自动配置文件

Profiles which have the profile-cond option set are applied automatically if the associated condition matches (unless auto profiles are disabled). The option takes a string, which is interpreted as Lua expression. If the expression evaluates as truthy, the profile is applied. If the expression errors or evaluates as falsy, the profile is not applied. This Lua code execution is not sandboxed.
设置了 profile-cond 选项的配置文件，如果关联的条件匹配（除非禁用自动配置文件），则自动应用。该选项接受一个字符串，该字符串被解释为 Lua 表达式。如果表达式评估为真值，则应用配置文件。如果表达式出错或评估为假值，则不应用配置文件。此 Lua 代码执行不受沙箱限制。

Any variables in condition expressions can reference properties. If an identifier is not already defined by Lua or mpv, it is interpreted as property. For example, pause would return the current pause status. You cannot reference properties with - this way since that would denote a subtraction, but if the variable name contains any _ characters, they are turned into -. For example, playback_time would return the property playback-time.
条件表达式中的任何变量都可以引用属性。如果标识符尚未由 Lua 或 mpv 定义，则将其解释为属性。例如， pause 会返回当前暂停状态。您不能以这种方式引用属性，因为 - 表示减法，但如果变量名包含任何 _ 字符，它们将被转换为 - 。例如， playback_time 会返回属性 playback-time 。

A more robust way to access properties is using p.property_name or get("property-name", default_value). The automatic variable to property magic will break if a new identifier with the same name is introduced (for example, if a function named pause() were added, pause would return a function value instead of the value of the pause property).
访问属性的一种更健壮的方法是使用 p.property_name 或 get("property-name", default_value) 。如果引入了具有相同名称的新标识符（例如，如果添加了一个名为 pause() 的函数， pause 将返回函数值而不是 pause 属性的值），则自动变量到属性的魔法将失效。

Note that if a property is not available, it will return nil, which can cause errors if used in expressions. These are logged in verbose mode, and the expression is considered to be false.
请注意，如果属性不可用，它将返回 nil ，如果在表达式中使用可能会导致错误。这些错误会在详细模式下记录，并且表达式被视为假。

Whenever a property referenced by a profile condition changes, the condition is re-evaluated. If the return value of the condition changes from falsy or error to truthy, the profile is applied.
每当由配置文件条件引用的属性发生变化时，条件将被重新评估。如果条件的返回值从假或错误变为真，则应用配置文件。

This mechanism tries to "unapply" profiles once the condition changes from truthy to falsy or error. If you want to use this, you need to set profile-restore for the profile. Another possibility it to create another profile with an inverse condition to undo the other profile.
此机制尝试在条件从真变为假或错误时“取消应用”配置文件。如果您想使用此功能，您需要为配置文件设置 profile-restore 。另一种可能性是创建另一个具有相反条件的配置文件来撤销另一个配置文件。

Recursive profiles can be used. But it is discouraged to reference other conditional profiles in a conditional profile, since this can lead to tricky and unintuitive behavior.
可以使用递归配置文件。但建议不要在条件配置文件中引用其他条件配置文件，因为这可能导致复杂且不直观的行为。

[something]
profile-desc=HD video sucks
profile-cond=width >= 1280
hue=-50

[youtube]
profile-cond=path:find('youtu%.?be')
gamma=20

[something]
profile-desc=Mess up video when entering fullscreen
profile-cond=fullscreen
profile-restore=copy
vf-add=rotate=PI/2  # rotate by 90 degrees

[something]
profile-cond=fullscreen
vf-add=@rot:rotate=PI/2

[something-inv]
profile-cond=not fullscreen
vf-remove=@rot

This feature is managed by an internal Lua script. Conditions are executed as Lua code within this script. Its environment contains at least the following things:
此功能由内部 Lua 脚本管理。条件作为脚本内的 Lua 代码执行。其环境至少包含以下内容：

(function environment table)

Every Lua function has an environment table. This is used for identifier access. There is no named Lua symbol for it; it is implicit.
每个 Lua 函数都有一个环境表。这用于标识符访问。没有命名的 Lua 符号表示它；它是隐式的。

The environment does "magic" accesses to mpv properties. If an identifier is not already defined in _G, it retrieves the mpv property of the same name. Any occurrences of _ in the name are replaced with - before reading the property. The returned value is as retrieved by mp.get_property_native(name). Internally, a cache of property values, updated by observing the property is used instead, so properties that are not observable will be stuck at the initial value forever.
环境对 mpv 属性进行“魔法”访问。如果标识符尚未在 _G 中定义，它将检索同名的 mpv 属性。在读取属性之前，名称中的任何 _ 都将被替换为 - 。返回的值与 mp.get_property_native(name) 检索的值相同。内部，使用由观察属性更新的属性值缓存，因此不可观察的属性将永远停留在初始值。

If you want to access properties, that actually contain _ in the name, use get() (which does not perform transliteration).
如果您想访问名称中实际上包含 _ 的属性，请使用 get() （它不执行转写）。

Internally, the environment table has a __index meta method set, which performs the access logic.
内部，环境表有一个 __index 元方法集，它执行访问逻辑。

p

A "magic" table similar to the environment table. Unlike the latter, this does not prefer accessing variables defined in _G - it always accesses properties.
一个类似于环境表的“魔法”表。与后者不同，这个不优先访问在 _G 定义的变量 - 它总是访问属性。

get(name [, def])

Read a property and return its value. If the property value is nil (e.g. if the property does not exist), def is returned.
读取一个属性并返回其值。如果属性值为 nil （例如，如果属性不存在），则返回 def 。

This is superficially similar to mp.get_property_native(name). An important difference is that this accesses the property cache, and enables the change detection logic (which is essential to the dynamic runtime behavior of auto profiles). Also, it does not return an error value as second return value.
这表面上类似于 mp.get_property_native(name) 。一个重要区别是，它访问属性缓存，并启用更改检测逻辑（这对于自动配置的动态运行时行为至关重要）。此外，它不会作为第二个返回值返回错误值。

The "magic" tables mentioned above use this function as backend. It does not perform the _ transliteration.
上述“魔法”表使用此函数作为后端。它不执行 _ 转写。

In addition, the same environment as in a blank mpv Lua script is present. For example, math is defined and gives access to the Lua standard math library.
此外，与空白 mpv Lua 脚本相同的运行环境也存在。例如， math 已定义，并提供对 Lua 标准数学库的访问。

Legacy auto profiles  遗产自动配置文件

Some profiles are loaded automatically using a legacy mechanism. The following example demonstrates this:
一些配置文件使用旧机制自动加载。以下示例演示了这一点：

[extension.mkv]
profile-desc="profile for .mkv files"
vf=vflip

The profile name follows the schema type.name, where type can be protocol for the input/output protocol in use (see --list-protocols), and extension for the extension of the path of the currently played file (not the file format).
配置文件名称遵循模式 type.name ，其中类型可以是 protocol 用于当前使用的输入/输出协议（见 --list-protocols ），以及 extension 用于当前播放文件路径的扩展（不是文件格式）。

This feature is very limited, and is considered soft-deprecated. Use conditional auto profiles.
此功能非常有限，被视为软弃用。请使用条件自动配置文件。

Track Selection  跟踪选择

--alang=<languagecode[,languagecode,...]>

Specify a prioritized list of audio languages to use, as IETF language tags. Equivalent ISO 639-1 two-letter and ISO 639-2 three-letter codes are treated the same. The first tag in the list that matches track's language in the file will be used. A track that matches more subtags will be preferred over one that matches fewer. See also --aid.
指定一个按优先级排序的音频语言列表，使用 IETF 语言标签。等效的 ISO 639-1 双字母和 ISO 639-2 三字母代码被同等对待。列表中第一个与文件中轨道语言匹配的标签将被使用。匹配更多子标签的轨道将优先于匹配较少子标签的轨道。另见 --aid 。

This is a string list option. See List Options for details.
这是一个字符串列表选项。有关详细信息，请参阅列表选项。

Examples  示例

• mpv dvd://1 --alang=hu,en chooses the Hungarian language track on a DVD and falls back on English if Hungarian is not available.
  mpv dvd://1 --alang=hu,en 在 DVD 上选择匈牙利语言轨道，如果匈牙利语不可用，则回退到英语。
• mpv --alang=jpn example.mkv plays a Matroska file with Japanese audio.
  mpv --alang=jpn example.mkv 播放带有日语音频的 Matroska 文件。

--slang=<languagecode[,languagecode,...]>

Equivalent to --alang, for subtitle tracks.
等同于 --alang ，用于字幕轨道。

This is a string list option. See List Options for details.
这是一个字符串列表选项。有关详细信息，请参阅列表选项。

Examples  示例

• mpv dvd://1 --slang=hu,en chooses the Hungarian subtitle track on a DVD and falls back on English if Hungarian is not available.
  mpv dvd://1 --slang=hu,en 在 DVD 上选择匈牙利字幕轨道，如果不可用则回退到英语。
• mpv --slang=jpn example.mkv plays a Matroska file with Japanese subtitles.
  mpv --slang=jpn example.mkv 播放带有日语字幕的 Matroska 文件。
• mpv --slang=pt-BR example.mkv plays a Matroska file with Brazilian Portuguese subtitles if available, and otherwise any Portuguese subtitles.
  mpv --slang=pt-BR example.mkv 如果可用，则播放带有巴西葡萄牙语字幕的 Matroska 文件，否则播放任何葡萄牙语字幕。

--vlang=<...>

Equivalent to --alang and --slang, for video tracks.
等同于 --alang 和 --slang ，用于视频轨道。

This is a string list option. See List Options for details.
这是一个字符串列表选项。有关详细信息，请参阅列表选项。

--aid=<ID|auto|no>

Select audio track. auto selects the default, no disables audio. See also --alang. mpv normally prints available audio tracks on the terminal when starting playback of a file.
选择音频轨道。 auto 选择默认， no 禁用音频。另请参阅 --alang 。mpv 通常在播放文件时在终端上打印可用的音频轨道。

--audio is an alias for --aid.
--audio 是 --aid 的别名。

--aid=no or --audio=no disables audio playback. (The latter variant does not work with the client API.)
--aid=no 或 --audio=no 禁用音频播放。（后者与客户端 API 不兼容。）

Note  注意

The track selection options (--aid but also --sid and the others) sometimes expose behavior that may appear strange. Also, the behavior tends to change around with each mpv release.
音轨选择选项（ --aid 但也 --sid 以及其他）有时会表现出可能看似奇怪的行为。此外，行为会随着每个 mpv 版本发布而变化。

The track selection properties will return the option value outside of playback (as expected), but during playback, the affective track selection is returned. For example, with --aid=auto, the aid property will suddenly return 2 after playback initialization (assuming the file has at least 2 audio tracks, and the second is the default).
音轨选择属性将在播放外返回选项值（如预期），但在播放期间，返回的是情感音轨选择。例如，使用 --aid=auto ，在播放初始化后， aid 属性会突然返回 2 （假设文件至少有 2 个音频轨道，第二个是默认的）。

At mpv 0.32.0 (and some releases before), if you passed a track value for which a corresponding track didn't exist (e.g. --aid=2 and there was only 1 audio track), the aid property returned no. However if another audio track was added during playback, and you tried to set the aid property to 2, nothing happened, because the aid option still had the value 2, and writing the same value has no effect.
在 mpv 0.32.0（以及一些之前的版本）中，如果您传递了一个不存在对应音轨的音轨值（例如 --aid=2 而只有一个音频轨道）， aid 属性会返回 no 。然而，如果在播放期间添加了另一个音频轨道，并且您尝试将 aid 属性设置为 2 ，则没有任何效果，因为 aid 选项仍然具有 2 的值，写入相同的值没有效果。

With mpv 0.33.0, the behavior was changed. Now track selection options are reset to auto at playback initialization, if the option had tries to select a track that does not exist. The same is done if the track exists, but fails to initialize. The consequence is that unlike before mpv 0.33.0, the user's track selection parameters are clobbered in certain situations.
在 mpv 0.33.0 中，行为发生了改变。现在在播放初始化时，如果选项尝试选择一个不存在的轨道，则跟踪选择选项将重置为 auto 。如果轨道存在但初始化失败，也会这样做。结果是，与 mpv 0.33.0 之前不同，在某些情况下，用户的轨道选择参数会被破坏。

Also since mpv 0.33.0, trying to select a track by number will strictly select this track. Before this change, trying to select a track which did not exist would fall back to track default selection at playback initialization. The new behavior is more consistent.
自 mpv 0.33.0 以来，尝试通过编号选择轨道将严格选择此轨道。在此更改之前，尝试选择一个不存在的轨道将在播放初始化时回退到默认轨道选择。新的行为更一致。

Setting a track selection property at runtime, and then playing a new file might reset the track selection to defaults, if the fingerprint of the track list of the new file is different.
在运行时设置轨道选择属性，然后播放新文件可能会将轨道选择重置为默认值，如果新文件的轨道列表指纹不同。

Be aware of tricky combinations of all of all of the above: for example, mpv --aid=2 file_with_2_audio_tracks.mkv file_with_1_audio_track.mkv would first play the correct track, and the second file without audio. If you then go back the first file, its first audio track will be played, and the second file is played with audio. If you do the same thing again but instead of using --aid=2 you run set aid 2 while the file is playing, then changing to the second file will play its audio track. This is because runtime selection enables the fingerprint heuristic.
请注意上述所有内容的复杂组合：例如， mpv --aid=2 file_with_2_audio_tracks.mkv file_with_1_audio_track.mkv 首先会播放正确的曲目，然后是第二个没有音频的文件。如果你然后返回到第一个文件，它的第一个音频轨道将被播放，第二个文件将带有音频播放。如果你再次执行相同的操作，但不是使用 --aid=2 ，而是在文件播放时运行 set aid 2 ，那么切换到第二个文件将播放其音频轨道。这是因为运行时选择启用了指纹启发式算法。

Most likely this is not the end.
很可能这不是结束。

--sid=<ID|auto|no>

Display the subtitle stream specified by <ID>. auto selects the default, no disables subtitles.
显示由 <ID> 指定的字幕流。 auto 选择默认， no 禁用字幕。

--sub is an alias for --sid.
--sub 是 --sid 的别名。

--sid=no or --sub=no disables subtitle decoding. (The latter variant does not work with the client API.)
--sid=no 或 --sub=no 禁用字幕解码。（后者与客户端 API 不兼容。）

--vid=<ID|auto|no>

Select video channel. auto selects the default, no disables video.
选择视频通道。 auto 选择默认， no 禁用视频。

--video is an alias for --vid.
--video 是 --vid 的别名。

--vid=no or --video=no disables video playback. (The latter variant does not work with the client API.)
--vid=no 或 --video=no 禁用视频播放。（后者与客户端 API 不兼容。）

If video is disabled, mpv will try to download the audio only if media is streamed with youtube-dl, because it saves bandwidth. This is done by setting the ytdl_format to "bestaudio/best" in the ytdl_hook.lua script.
如果禁用视频，当使用 youtube-dl 流媒体时，mpv 将尝试仅下载音频，因为这样可以节省带宽。这是通过在 ytdl_hook.lua 脚本中将 ytdl_format 设置为 "bestaudio/best" 来实现的。

--edition=<ID|auto>

(Matroska files only) Specify the edition (set of chapters) to use, where 0 is the first. If set to auto (the default), mpv will choose the first edition declared as a default, or if there is no default, the first edition defined.
（仅限 Matroska 文件）指定要使用的版本（章节集），其中 0 是第一个。如果设置为 auto （默认值），mpv 将选择声明的第一个默认版本，如果没有默认版本，则选择定义的第一个版本。

--track-auto-selection=<yes|no>

Enable the default track auto-selection (default: yes). Enabling this will make the player select streams according to --aid, --alang, and others. If it is disabled, no tracks are selected. In addition, the player will not exit if no tracks are selected, and wait instead (this wait mode is similar to pausing, but the pause option is not set).
启用默认轨道自动选择（默认：是）。启用此功能将使播放器根据 --aid 、 --alang 等选择流。如果禁用，则不选择任何轨道。此外，如果未选择任何轨道，播放器不会退出，而是等待（此等待模式类似于暂停，但未设置暂停选项）。

This is useful with --lavfi-complex: you can start playback in this mode, and then set select tracks at runtime by setting the filter graph. Note that if --lavfi-complex is set before playback is started, the referenced tracks are always selected.
这在 --lavfi-complex : 中非常有用，您可以在这种模式下开始播放，然后通过设置过滤器图来在运行时设置选择轨道。请注意，如果在播放开始之前设置了 --lavfi-complex ，则引用的轨道始终会被选中。

--subs-with-matching-audio=<yes|forced|no>

When autoselecting a subtitle track, select it even if the selected audio stream matches you preferred subtitle language (default: yes). If this option is set to no, then no subtitle track that matches the audio language will ever be autoselected by mpv regardless of --slang or subs-fallback. If set to forced, then only forced subtitles will be selected.
当自动选择字幕轨道时，即使所选音频流与您首选的字幕语言匹配（默认：是），也要选择它。如果此选项设置为 no ，则无论 --slang 或 subs-fallback 如何，mpv 都不会自动选择与音频语言匹配的字幕轨道。如果设置为 forced ，则只选择强制字幕。

--subs-match-os-language=<yes|no>

When autoselecting a subtitle track, select the track that matches the language of your OS if the audio stream is in a different language if suitable (default track or a forced track under the right conditions). Note that if --slang is set, this will be completely ignored (default: yes).
当自动选择字幕轨道时，如果音频流使用不同的语言，则选择与您的操作系统语言匹配的轨道（默认轨道或符合条件下的强制轨道）。请注意，如果设置了 --slang ，则这将完全被忽略（默认：是）。

--subs-fallback=<yes|default|no>

When autoselecting a subtitle track, if no tracks match your preferred languages, select a full track even if it doesn't match your preferred subtitle language (default: default). Setting this to default means that only streams flagged as default will be selected.
当自动选择字幕轨道时，如果没有轨道匹配您首选的语言，则选择完整轨道，即使它不匹配您首选的字幕语言（默认：默认）。将此设置为默认意味着只有标记为默认的流会被选中。

--subs-fallback-forced=<yes|no|always>

When autoselecting a subtitle track, the default value of yes will prefer using a forced subtitle track if the subtitle language matches the audio language and matches your list of preferred languages. The special value always will only select forced subtitle tracks and never fallback on a non-forced track. Conversely, no will never select a forced subtitle track.
当自动选择字幕轨道时，默认值 yes 将优先使用强制字幕轨道，如果字幕语言与音频语言匹配且匹配您的首选语言列表。特殊值 always 只会选择强制字幕轨道，永远不会回退到非强制轨道。相反，no 永远不会选择强制字幕轨道。

Playback Control  播放控制

--start=<relative time>

Seek to given time position.
跳转到指定的时间位置。

The general format for times is [+|-][[hh:]mm:]ss[.ms]. If the time is prefixed with -, the time is considered relative from the end of the file (as signaled by the demuxer/the file). A + is usually ignored (but see below).
时间的一般格式为 [+|-][[hh:]mm:]ss[.ms] 。如果时间前缀为 - ，则时间被认为是相对于文件末尾的（如由解复用器/文件指示）。 + 通常会被忽略（但请参阅以下内容）。

The following alternative time specifications are recognized:
以下替代时间指定被识别：

pp% seeks to percent position pp (0-100).
pp% 寻求百分比位置 pp（0-100）。

#c seeks to chapter number c. (Chapters start from 1.)
#c 寻求章节编号 c。（章节从 1 开始。）

none resets any previously set option (useful for libmpv).
none 重置之前设置的任何选项（对 libmpv 有用）。

If --rebase-start-time=no is given, then prefixing times with + makes the time relative to the start of the file. A timestamp without prefix is considered an absolute time, i.e. should seek to a frame with a timestamp as the file contains it. As a bug, but also a hidden feature, putting 1 or more spaces before the + or - always interprets the time as absolute, which can be used to seek to negative timestamps (useful for debugging at most).
如果提供 --rebase-start-time=no ，则使用 + 前缀会使时间相对于文件开始。没有前缀的时间戳被视为绝对时间，即应查找文件中包含的时间戳所在的帧。作为一个错误，但也是一个隐藏功能，在 + 或 - 前放置 1 或多个空格始终将时间解释为绝对时间，这可以用来查找负时间戳（最多用于调试）。

Examples  示例

--start=+56, --start=00:56

Seeks to the start time + 56 seconds.
查找起始时间 + 56 秒。

--start=-56, --start=-00:56

Seeks to the end time - 56 seconds.
查找结束时间 - 56 秒。

--start=01:10:00

Seeks to 1 hour 10 min.
寻求 1 小时 10 分钟。

--start=50%

Seeks to the middle of the file.
寻求到文件中间。

--start=30 --end=40

Seeks to 30 seconds, plays 10 seconds, and exits.
寻求到 30 秒，播放 10 秒，然后退出。

--start=-3:20 --length=10

Seeks to 3 minutes and 20 seconds before the end of the file, plays 10 seconds, and exits.
寻求到文件结束前 3 分 20 秒，播放 10 秒，然后退出。

--start='#2' --end='#4'

Plays chapters 2 and 3, and exits.
播放第 2 和第 3 章节，然后退出。

--end=<relative time>

Stop at given time. Use --length if the time should be relative to --start. See --start for valid option values and examples.
在指定时间停止。如果时间应相对于 --start ，请使用 --length 。有关有效选项值和示例，请参阅 --start 。

--length=<relative time>

Stop after a given time relative to the start time. See --start for valid option values and examples.
在相对于开始时间的指定时间后停止。有关有效选项值和示例，请参阅 --start 。

If both --end and --length are provided, playback will stop when it reaches either of the two endpoints.
如果提供了 --end 和 --length ，播放将在达到两个端点中的任何一个时停止。

Obscurity note: this does not work correctly if --rebase-start-time=no, and the specified time is not an "absolute" time, as defined in the --start option description.
注意事项：如果 --rebase-start-time=no ，并且指定的时间不是在 --start 选项描述中定义的“绝对”时间，则此功能可能无法正确工作。

--rebase-start-time=<yes|no>

Whether to move the file start time to 00:00:00 (default: yes). This is less awkward for files which start at a random timestamp, such as transport streams. On the other hand, if there are timestamp resets, the resulting behavior can be rather weird. For this reason, and in case you are actually interested in the real timestamps, this behavior can be disabled with no.
是否将文件开始时间移动到 00:00:00 （默认：是）。对于开始于随机时间戳的文件，例如传输流，这样做会更不尴尬。另一方面，如果存在时间戳重置，结果行为可能会相当奇怪。因此，如果您实际上对真实时间戳感兴趣，可以通过 no 禁用此行为。

--speed=<0.01-100>

Slow down or speed up playback by the factor given as parameter.
根据参数以给定倍数降低或提高播放速度。

If --audio-pitch-correction (on by default) is used, playing with a speed higher than normal automatically inserts the scaletempo2 audio filter.
如果使用 --audio-pitch-correction （默认开启）并播放高于正常速度，则自动插入 scaletempo2 音频过滤器。

--pitch=<0.01-100>

Raise or lower the audio's pitch by the factor given as parameter. Does not affect playback speed. Playing with an altered pitch automatically inserts the scaletempo2 audio filter.
根据参数以给定倍数提高或降低音频的音调。不影响播放速度。以改变后的音调播放时自动插入 scaletempo2 音频过滤器。

Since pitch change is achieved by combining pitch-preserving speed change and resampling, the range of pitch change is effectively limited by the min-speed and max-speed parameters of scaletempo2: for example, a min-speed of 0.25 limits the highest pitch factor to 4 (1/0.25).
由于音调变化是通过结合保持音调的速度变化和重采样实现的，因此音调变化范围实际上受到 scaletempo2 的 min-speed 和 max-speed 参数的限制：例如， min-speed 为 0.25 时，将最高音调倍数限制为 4（1/0.25）。

In a standard 12-tone scale system, octaves are separated by a factor of 2 whereas semitones are represented by a factor of 2^(1/12). This means pitches can easily be shifted up or down with a simple multiplier.
在一个标准的 12 音阶系统中，八度之间以 2 的倍数分隔，半音以 2^(1/12)的倍数表示。这意味着音高可以通过简单的乘数轻松上下移动。

Examples  示例

--pitch=2

Shifts the pitch up a full octave.
将音高提升一个完整八度。

--pitch=0.5

Shifts the pitch down an octave.
将音高降低一个八度。

--pitch=1.498307 (2^(7/12))

Shifts the pitch up a perfect fifth.
将音高上移一个纯五度。

--pitch=0.667420 (2^(-7/12))

Shifts the pitch down a perfect fifth.
将音高下移一个纯五度。

--pitch=1.059463 (2^(1/12))

Shifts the pitch up a semitone.
将音高提升半音阶。

--pitch=0.943874 (2^(-1/12))

Shifts the pitch down a semitone.
将音高降低半音阶。

--pause

Start the player in paused state.
以暂停状态启动播放器。

--shuffle

Play files in random order.
随机顺序播放文件。

--playlist-start=<auto|index>

Set which file on the internal playlist to start playback with. The index is an integer, with 0 meaning the first file. The value auto means that the selection of the entry to play is left to the playback resume mechanism (default). If an entry with the given index doesn't exist, the behavior is unspecified and might change in future mpv versions. The same applies if the playlist contains further playlists (don't expect any reasonable behavior). Passing a playlist file to mpv should work with this option, though. E.g. mpv playlist.m3u --playlist-start=123 will work as expected, as long as playlist.m3u does not link to further playlists.
设置要从中开始播放的内部播放列表中的文件。索引是一个整数，其中 0 表示第一个文件。值 auto 表示播放条目选择留给播放恢复机制（默认）。如果给定索引的条目不存在，行为是不确定的，并且可能在未来的 mpv 版本中更改。如果播放列表包含其他播放列表（不要期望有任何合理的行为），也适用同样的情况。将播放列表文件传递给 mpv 应与此选项一起工作。例如， mpv playlist.m3u --playlist-start=123 将按预期工作，只要 playlist.m3u 不链接到其他播放列表。

The value no is a deprecated alias for auto.
值 no 是 auto 的已弃用别名。

--playlist=<filename>

Play files according to a playlist file. Supports some common formats. If no format is detected, it will be treated as list of files, separated by newline characters. You may need this option to load plaintext files as a playlist. Note that XML playlist formats are not supported.
根据播放列表文件播放文件。支持一些常见格式。如果没有检测到格式，它将被视为由换行符分隔的文件列表。您可能需要此选项将纯文本文件作为播放列表加载。请注意，不支持 XML 播放列表格式。

This option forces --demuxer=playlist to interpret the playlist file. Some playlist formats, notably CUE and optical disc formats, need to use different demuxers and will not work with this option. They still can be played directly, without using this option.
此选项强制 --demuxer=playlist 解析播放列表文件。一些播放列表格式，特别是 CUE 和光盘格式，需要使用不同的解复用器，并且不能使用此选项。它们仍然可以直接播放，而不使用此选项。

You can play playlists directly, without this option. Before mpv version 0.31.0, this option disabled any security mechanisms that might be in place, but since 0.31.0 it uses the same security mechanisms as playing a playlist file directly. If you trust the playlist file, you can disable any security checks with --load-unsafe-playlists. Because playlists can load other playlist entries, consider applying this option only to the playlist itself and not its entries, using something along these lines:
您可以直接播放播放列表，而不使用此选项。在 mpv 版本 0.31.0 之前，此选项禁用了可能存在的任何安全机制，但从 0.31.0 版本开始，它使用与直接播放播放列表文件相同的安全机制。如果您信任播放列表文件，您可以使用 --load-unsafe-playlists 禁用任何安全检查。因为播放列表可以加载其他播放列表条目，考虑只将此选项应用于播放列表本身，而不是其条目，如下所示：

mpv --{ --playlist=filename --load-unsafe-playlists --}

Warning  警告

The way older versions of mpv played playlist files via --playlist was not safe against maliciously constructed files. Such files may trigger harmful actions. This has been the case for all versions of mpv prior to 0.31.0, and all MPlayer versions, but unfortunately this fact was not well documented earlier, and some people have even misguidedly recommended the use of --playlist with untrusted sources. Do NOT use --playlist with random internet sources or files you do not trust if you are not sure your mpv is at least 0.31.0.
较旧版本的 mpv 通过 --playlist 播放播放列表文件的方式不安全，无法抵御恶意构造的文件。此类文件可能会触发有害操作。这种情况一直存在于所有低于 0.31.0 版本的 mpv 以及所有 MPlayer 版本中，但遗憾的是，这一事实之前并未得到很好的记录，甚至有人错误地建议使用 --playlist 从不可信的来源。如果您不确定您的 mpv 至少是 0.31.0 版本，请勿使用 --playlist 与随机的互联网来源或您不信任的文件。

In particular, playlists can contain entries using protocols other than local files, such as special protocols like avdevice:// (which are inherently unsafe).
特别是，播放列表可以包含使用除本地文件之外的其他协议的条目，例如像 avdevice:// （本质上不安全）这样的特殊协议。

--chapter-merge-threshold=<number>

Threshold for merging almost consecutive ordered chapter parts in milliseconds (default: 100). Some Matroska files with ordered chapters have inaccurate chapter end timestamps, causing a small gap between the end of one chapter and the start of the next one when they should match. If the end of one playback part is less than the given threshold away from the start of the next one then keep playing video normally over the chapter change instead of doing a seek.
合并几乎连续的有序章节部分的阈值（默认：100 毫秒）。一些带有有序章节的 Matroska 文件具有不准确的章节结束时间戳，导致当它们应该匹配时，一个章节的结束和下一个章节的开始之间存在一个小间隔。如果一个播放部分的结束时间小于给定阈值远离下一个部分的开始，则保持正常播放视频而不是进行搜索。

--chapter-seek-threshold=<seconds>

Distance in seconds from the beginning of a chapter within which a backward chapter seek will go to the previous chapter (default: 5.0). Past this threshold, a backward chapter seek will go to the beginning of the current chapter instead. A negative value means always go back to the previous chapter.
从章节开始到向后章节搜索将到达的前一个章节的时间差（默认：5.0）。超过此阈值，向后章节搜索将跳转到当前章节的开始。负值表示始终返回到前一个章节。

--hr-seek=<no|absolute|yes|default>

Select when to use precise seeks that are not limited to keyframes. Such seeks require decoding video from the previous keyframe up to the target position and so can take some time depending on decoding performance. For some video formats, precise seeks are disabled. This option selects the default choice to use for seeks; it is possible to explicitly override that default in the definition of key bindings and in input commands.
选择何时使用不受关键帧限制的精确搜索。这种搜索需要从上一个关键帧解码到目标位置的视频，因此根据解码性能可能需要一些时间。对于某些视频格式，精确搜索被禁用。此选项选择用于搜索的默认选项；可以在键绑定定义和输入命令中显式覆盖该默认值。

no:  no：	Never use precise seeks. 切勿使用精确查找。
absolute:  绝对：	Use precise seeks if the seek is to an absolute position in the file, such as a chapter seek, but not for relative seeks like the default behavior of arrow keys. 如果寻道是到文件的绝对位置，例如章节寻道，则使用精确寻道，但不适用于像箭头键默认行为那样的相对寻道。
default:  默认：	Like absolute, but enable hr-seeks in audio-only cases. The exact behavior is implementation specific and may change with new releases (default). 类似于 absolute ，但在仅音频的情况下启用 hr-seeks。确切行为取决于实现，并且可能随着新版本而更改（默认）。
yes:	Use precise seeks whenever possible. 尽可能使用精确搜索。
always:  始终：	Same as yes (for compatibility). 与 yes 相同（为了兼容性）。

--hr-seek-demuxer-offset=<seconds>

This option exists to work around failures to do precise seeks (as in --hr-seek) caused by bugs or limitations in the demuxers for some file formats. Some demuxers fail to seek to a keyframe before the given target position, going to a later position instead. The value of this option is subtracted from the time stamp given to the demuxer. Thus, if you set this option to 1.5 and try to do a precise seek to 60 seconds, the demuxer is told to seek to time 58.5, which hopefully reduces the chance that it erroneously goes to some time later than 60 seconds. The downside of setting this option is that precise seeks become slower, as video between the earlier demuxer position and the real target may be unnecessarily decoded.
此选项存在是为了绕过由于某些文件格式解复用器的错误或限制导致的无法进行精确查找（如 --hr-seek ）失败。一些解复用器无法在给定目标位置之前查找关键帧，而是跳到较晚的位置。此选项的值从分配给解复用器的时戳中减去。因此，如果您将此选项设置为 1.5 并尝试精确查找 60 秒，解复用器将被告知查找时间 58.5，这有望减少它错误地跳到 60 秒之后的时间的机会。设置此选项的缺点是精确查找会变慢，因为视频在较早的解复用器位置和实际目标之间可能被不必要地解码。

--hr-seek-framedrop=<yes|no>

Allow the video decoder to drop frames during seek, if these frames are before the seek target. If this is enabled, precise seeking can be faster, but if you're using video filters which modify timestamps or add new frames, it can lead to precise seeking skipping the target frame. This e.g. can break frame backstepping when deinterlacing is enabled.
允许视频解码器在查找时丢弃帧，如果这些帧在查找目标之前。如果启用此功能，精确查找可以更快，但如果您使用修改时间戳或添加新帧的视频过滤器，可能会导致精确查找跳过目标帧。例如，当启用去隔行时，这可能会破坏帧回退。

Default: yes  默认： yes

--index=<mode>

Controls how to seek in files. Note that if the index is missing from a file, it will be built on the fly by default, so you don't need to change this. But it might help with some broken files.
控制文件中的搜索方式。注意，如果文件中缺少索引，它将默认动态构建，因此您不需要更改此设置。但这可能有助于一些损坏的文件。

default:  默认：	use an index if the file has one, or build it if missing 如果文件有一个索引，则使用它，如果没有，则构建它
recreate:  重新创建：	don't read or use the file's index 不要读取或使用文件的索引

Note  注意

This option only works if the underlying media supports seeking (i.e. not with stdin, pipe, etc).
此选项仅在底层媒体支持搜索（即不适用于 stdin、管道等）时才有效。

--load-unsafe-playlists

Load URLs from playlists which are considered unsafe (default: no). This includes special protocols and anything that doesn't refer to normal files. Local files and HTTP links on the other hand are always considered safe.
从被视为不安全的播放列表中加载 URL（默认：否）。这包括特殊协议以及任何不指向常规文件的内容。另一方面，本地文件和 HTTP 链接始终被视为安全。

In addition, if a playlist is loaded while this is set, the added playlist entries are not marked as originating from network or potentially unsafe location. (Instead, the behavior is as if the playlist entries were provided directly to mpv command line or loadfile command.)
此外，如果在此设置的情况下加载播放列表，则添加的播放列表条目不会被标记为来自网络或潜在的不安全位置。（其行为类似于播放列表条目直接提供给 mpv 命令行或 loadfile 命令。）

--access-references=<yes|no>

Follow any references in the file being opened (default: yes). Disabling this is helpful if the file is automatically scanned (e.g. thumbnail generation). If the thumbnail scanner for example encounters a playlist file, which contains network URLs, and the scanner should not open these, enabling this option will prevent it. This option also disables ordered chapters, mov reference files, opening of archives, and a number of other features.
跟随正在打开的文件中的任何引用（默认：是）。如果文件是自动扫描的（例如缩略图生成），禁用此功能可能会有所帮助。例如，如果缩略图扫描器遇到包含网络 URL 的播放列表文件，并且扫描器不应打开这些文件，启用此选项将防止它。此选项还将禁用有序章节、mov 引用文件、打开存档以及许多其他功能。

On older FFmpeg versions, this will not work in some cases. Some FFmpeg demuxers might not respect this option.
在较旧的 FFmpeg 版本中，在某些情况下可能不起作用。一些 FFmpeg 解复用器可能不会尊重此选项。

This option does not prevent opening of paired subtitle files and such. Use --autoload-files=no to prevent this.
此选项不能防止打开配对的字幕文件等。使用 --autoload-files=no 来防止此操作。

This option does not always work if you open non-files (for example using dvd://directory would open a whole bunch of files in the given directory). Prefixing the filename with ./ if it doesn't start with a / will avoid this.
如果您打开非文件（例如使用 dvd://directory 会在给定目录中打开大量文件），此选项不一定总是起作用。如果文件名不以 / 开头，请使用 ./ 作为前缀以避免此问题。

--loop-playlist=<N|inf|force|no>, --loop-playlist

Loops playback N times. A value of 1 plays it one time (default), 2 two times, etc. inf means forever. no is the same as 1 and disables looping. If several files are specified on command line, the entire playlist is looped. --loop-playlist is the same as --loop-playlist=inf.
循环播放 N 次。值为 1 表示播放一次（默认）， 2 表示播放两次，等等。 inf 表示无限循环。 no 与 1 相同，并禁用循环。如果命令行上指定了多个文件，则整个播放列表将循环播放。 --loop-playlist 与 --loop-playlist=inf 相同 。

The force mode is like inf, but does not skip playlist entries which have been marked as failing. This means the player might waste CPU time trying to loop a file that doesn't exist. But it might be useful for playing webradios under very bad network conditions.
与 force 模式类似，但不会跳过标记为失败的播放列表条目。这意味着播放器可能会浪费 CPU 时间尝试循环一个不存在的文件。但在非常糟糕的网络条件下播放网络广播可能很有用。

--loop-file=<N|inf|no>, --loop=<N|inf|no>

Loop a single file N times. inf means forever, no means normal playback. For compatibility, --loop-file and --loop-file=yes are also accepted, and are the same as --loop-file=inf.
循环播放单个文件 N 次。 inf 表示无限循环， no 表示正常播放。为了兼容性， --loop-file 和 --loop-file=yes 也被接受，并且与 --loop-file=inf 相同 。

The difference to --loop-playlist is that this doesn't loop the playlist, just the file itself. If the playlist contains only a single file, the difference between the two option is that this option performs a seek on loop, instead of reloading the file.
与 --loop-playlist 的区别在于，这个选项不会循环播放列表，只会循环文件本身。如果播放列表中只有一个文件，则这两个选项的区别在于，此选项在循环时执行查找，而不是重新加载文件。

Note  注意

--loop-file counts the number of times it causes the player to seek to the beginning of the file, not the number of full playthroughs. This means --loop-file=1 will end up playing the file twice. Contrast with --loop-playlist, which counts the number of full playthroughs.
--loop-file 统计玩家将文件从头开始搜索的次数，而不是完整播放次数。这意味着 --loop-file=1 将会播放文件两次。与 --loop-playlist 相比，它统计完整播放次数。

--loop is an alias for this option.
--loop 是此选项的别名。

--ab-loop-a=<time>, --ab-loop-b=<time>

Set loop points. If playback passes the b timestamp, it will seek to the a timestamp. Seeking past the b point doesn't loop (this is intentional).
设置循环点。如果播放超过 b 时间戳，它将跳转到 a 时间戳。超过 b 点后不会循环（这是故意的）。

If a is after b, the behavior is as if the points were given in the right order, and the player will seek to b after crossing through a. This is different from old behavior, where looping was disabled (and as a bug, looped back to a on the end of the file).
如果 a 在 b 之后，则行为相当于点按顺序给出，玩家将在穿过 a 后寻求 b 。这与旧行为不同，旧行为中循环被禁用（并且作为一个错误，循环回文件末尾的 a ）。

If either options are set to no (or unset), looping is disabled. This is different from old behavior, where an unset a implied the start of the file, and an unset b the end of the file.
如果任一选项设置为 no （或未设置），则循环被禁用。这与旧行为不同，未设置的 a 表示文件开始，未设置的 b 表示文件末尾。

The loop-points can be adjusted at runtime with the corresponding properties. See also ab-loop command.
可以通过相应的属性在运行时调整循环点。另请参阅 ab-loop 命令。

--ab-loop-count=<N|inf>

Run A-B loops only N times, then ignore the A-B loop points (default: inf). inf means that looping goes on forever. If this option is set to 0, A-B looping is ignored, and even the ab-loop command will not enable looping again (the command will show (disabled) on the OSD message if both loop points are set, but ab-loop-count is 0).
仅运行 A-B 循环 N 次，然后忽略 A-B 循环点（默认：无限）。 inf 表示循环永远进行。如果此选项设置为 0，则忽略 A-B 循环，并且即使 ab-loop 命令也不会再次启用循环（如果设置了两个循环点，但 ab-loop-count 为 0，则命令将在 OSD 消息上显示 (disabled) ）。

--ordered-chapters=<yes|no>

Enable support for Matroska ordered chapters. mpv will load and search for video segments from other files, and will also respect any chapter order specified for the main file (default: yes).
启用对 Matroska 有序章节的支持。mpv 将加载并搜索来自其他文件的视频段，并且还将尊重为主文件指定的任何章节顺序（默认：是）。

--ordered-chapters-files=<playlist-file>

Loads the given file as playlist, and tries to use the files contained in it as reference files when opening a Matroska file that uses ordered chapters. This overrides the normal mechanism for loading referenced files by scanning the same directory the main file is located in.
将指定的文件作为播放列表加载，并在打开使用有序章节的 Matroska 文件时尝试使用其中包含的文件作为参考文件。这将覆盖正常机制，通过扫描主文件所在的同一目录来加载参考文件。

Useful for loading ordered chapter files that are not located on the local filesystem, or if the referenced files are in different directories.
对于加载不在本地文件系统上的有序章节文件，或者参考文件位于不同目录的情况非常有用。

Note: a playlist can be as simple as a text file containing filenames separated by newlines.
注意：播放列表可以是一个简单的文本文件，其中包含通过换行符分隔的文件名。

--chapters-file=<filename>

Load chapters from this file, instead of using the chapter metadata found in the main file.
从该文件加载章节，而不是使用主文件中找到的章节元数据。

This accepts a media file (like mkv) or even a pseudo-format like ffmetadata and uses its chapters to replace the current file's chapters. This doesn't work with OGM or XML chapters directly.
此功能接受媒体文件（如 mkv）或伪格式如 ffmetadata，并使用其章节替换当前文件的章节。此功能不能直接与 OGM 或 XML 章节一起使用。

--sstep=<sec>

Skip <sec> seconds after every frame.
每帧后跳过秒。

Note  注意

Without --hr-seek, skipping will snap to keyframes.
没有 --hr-seek ，跳过将自动对齐到关键帧。

--stop-playback-on-init-failure=<yes|no>

Stop playback if either audio or video fails to initialize (default: no). With no, playback will continue in video-only or audio-only mode if one of them fails. This doesn't affect playback of audio-only or video-only files.
如果音频或视频初始化失败则停止播放（默认：否）。使用 no ，如果其中一个失败，则播放将仅以视频或音频模式继续。这不会影响仅音频或视频文件的播放。

--play-direction=<forward|+|backward|->

Control the playback direction (default: forward). Setting backward will attempt to play the file in reverse direction, with decreasing playback time. If this is set on playback starts, playback will start from the end of the file. If this is changed at during playback, a hr-seek will be issued to change the direction.
控制播放方向（默认：正向）。设置 backward 将尝试以反向方向播放文件，播放时间递减。如果在此设置播放开始时，播放将从文件末尾开始。如果在播放过程中更改，将发出 hr-seek 以更改方向。

+ and - are aliases for forward and backward.
+ 和 - 是 forward 和 backward 的别名。

The rest of this option description pertains to the backward mode.
此选项描述的其余部分适用于 backward 模式。

Note  注意

Backward playback is extremely fragile. It may not always work, is much slower than forward playback, and breaks certain other features. How well it works depends mainly on the file being played. Generally, it will show good results (or results at all) only if the stars align.
反向播放非常脆弱。它可能并不总是有效，比正向播放慢得多，并且会破坏某些其他功能。它的工作效果主要取决于正在播放的文件。通常，只有当所有星星都排成一行时，它才会显示良好的结果（或者任何结果）。

mpv, as well as most media formats, were designed for forward playback only. Backward playback is bolted on top of mpv, and tries to make a medium effort to make backward playback work. Depending on your use-case, another tool may work much better.
mpv 以及大多数媒体格式都仅设计用于正向播放。反向播放是附加在 mpv 之上的，并试图尽力使反向播放工作。根据您的使用情况，另一个工具可能效果会好得多。

Backward playback is not exactly a 1st class feature. Implementation tradeoffs were made, that are bad for backward playback, but in turn do not cause disadvantages for normal playback. Various possible optimizations are not implemented in order to keep the complexity down. Normally, a media player is highly pipelined (future data is prepared in separate threads, so it is available in realtime when the next stage needs it), but backward playback will essentially stall the pipeline at various random points.
反向播放并不是一个一等特性。在实现上做出了权衡，这对反向播放不利，但同时也不会对正常播放造成不利。为了降低复杂性，没有实现各种可能的优化。通常，媒体播放器高度管道化（未来数据在单独的线程中准备，以便在下一个阶段需要时实时可用），但反向播放将本质上在各个随机点阻塞管道。

For example, for intra-only codecs are trivially backward playable, and tools built around them may make efficient use of them (consider video editors or camera viewers). mpv won't be efficient in this case, because it uses its generic backward playback algorithm, that on top of it is not very optimized.
例如，对于仅内编解码器来说，向后播放是显而易见的，围绕它们构建的工具可能能够有效地使用它们（考虑视频编辑器或相机查看器）。在这种情况下，mpv 不会很高效，因为它使用其通用的向后播放算法，而这个算法本身并不是非常优化。

If you just want to quickly go backward through the video and just show "keyframes", just use forward playback, and hold down the left cursor key (which on CLI with default config sends many small relative seek commands).
如果您只想快速向后浏览视频并仅显示“关键帧”，请使用正向播放，并按住左光标键（在默认配置的 CLI 中，这会发送许多小相对搜索命令）。

The implementation consists of mostly 3 parts:
实现主要分为 3 个部分：

• Backward demuxing. This relies on the demuxer cache, so the demuxer cache should (or must, didn't test it) be enabled, and its size will affect performance. If the cache is too small or too large, quadratic runtime behavior may result.
  向后解复用。这依赖于解复用器缓存，因此解复用器缓存应该（或必须，未对其进行测试）启用，其大小将影响性能。如果缓存太小或太大，可能会导致二次方运行时行为。
• Backward decoding. The decoder library used (libavcodec) does not support this. It is emulated by feeding bits of data in forward, putting the result in a queue, returning the queue data to the VO in reverse, and then starting over at an earlier position. This can require buffering an extreme amount of decoded data, and also completely breaks pipelining.
  反向解码。所使用的解码器库（libavcodec）不支持此功能。通过正向输入数据位，将结果放入队列，将队列数据反向返回给 VO，然后从较早的位置重新开始来实现仿真。这可能需要缓冲大量解码数据，并且完全破坏了流水线。
• Backward output. This is relatively simple, because the decoder returns the frames in the needed order. However, this may cause various problems because filters see audio and video going backward.
  反向输出。这相对简单，因为解码器以所需顺序返回帧。然而，这可能会引起各种问题，因为过滤器看到音频和视频在反向流动。

Known problems:  已知问题：

• It's fragile. If anything doesn't work, random behavior may occur. In simple cases, the player will just play nonsense and artifacts. In other cases, it may get stuck or heat the CPU. (Exceeding memory usage significantly beyond the user-set limits would be a bug, though.)
  它很脆弱。如果任何东西不起作用，可能会出现随机行为。在简单情况下，播放器将播放无意义的内容和伪影。在其他情况下，它可能会卡住或加热 CPU。（然而，超过用户设置的内存限制显著增加将是一个错误。）
• Performance and resource usage isn't good. In part this is inherent to backward playback of normal media formats, and in parts due to implementation choices and tradeoffs.
  性能和资源使用不佳。部分原因是正常媒体格式的回放本身具有，部分原因是实现选择和权衡。
• This is extremely reliant on good demuxer behavior. Although backward demuxing requires no special demuxer support, it is required that the demuxer performs seeks reliably, fulfills some specific requirements about packet metadata, and has deterministic behavior.
  这极其依赖于良好的解复用器行为。尽管向后解复用不需要特殊的解复用器支持，但解复用器必须能够可靠地进行搜索，满足一些关于数据包元数据的特定要求，并且具有确定性行为。
• Starting playback exactly from the end may or may not work, depending on seeking behavior and file duration detection.
  从末尾开始播放可能工作也可能不工作，这取决于搜索行为和文件持续时间检测。
• Some container formats, audio, and video codecs are not supported due to their behavior. There is no list, and the player usually does not detect them. Certain live streams (including TV captures) may exhibit problems in particular, as well as some lossy audio codecs. h264 intra-refresh is known not to work due to problems with libavcodec. WAV and some other raw audio formats tend to have problems - there are hacks for dealing with them, which may or may not work.
  由于某些容器格式、音频和视频编解码器的行为，不支持它们。没有列表，并且播放器通常不会检测到它们。某些实时流（包括电视捕获）可能会出现特定问题，以及一些有损音频编解码器。由于 libavcodec 的问题，h264 intra-refresh 已知无法工作。WAV 和一些其他原始音频格式往往存在问题 - 有一些处理它们的技巧，这些技巧可能或可能不工作。
• Backward demuxing of subtitles is not supported. Subtitle display still works for some external text subtitle formats. (These are fully read into memory, and only backward display is needed.) Text subtitles that are cached in the subtitle renderer also have a chance to be displayed correctly.
  不支持字幕的向后解复用。对于某些外部文本字幕格式，字幕显示仍然有效。（这些将被完全读入内存，只需要向后显示。）在字幕渲染器中缓存的文本字幕也有机会正确显示。
• Some features dealing with playback of broken or hard to deal with files will not work fully (such as timestamp correction).
  一些处理损坏或难以处理的文件的功能可能无法完全工作（例如时间戳校正）。
• If demuxer low level seeks (i.e. seeking the actual demuxer instead of just within the demuxer cache) are performed by backward playback, the created seek ranges may not join, because not enough overlap is achieved.
  如果通过向后播放执行解复用器的低级查找（即查找实际的解复用器而不是仅限于解复用器缓存），创建的查找范围可能不会连接，因为重叠不足。
• Trying to use this with hardware video decoding will probably exhaust all your GPU memory and then crash a thing or two. Or it will fail because --hwdec-extra-frames will certainly be set too low.
  尝试使用此功能与硬件视频解码结合可能会耗尽您的 GPU 内存，然后导致一些程序崩溃。或者它将失败，因为 --hwdec-extra-frames 肯定会被设置得太低。
• Stream recording is broken. --stream-record may keep working if you backward play within a cached region only.
  流录制已损坏。如果仅在缓存区域内回放， --stream-record 可能仍然可以工作。
• Relative seeks may behave weird. Small seeks backward (towards smaller time, i.e. seek -1) may not really seek properly, and audio will remain muted for a while. Using hr-seek is recommended, which should have none of these problems.
  相对定位可能表现异常。小范围向后定位（即朝较小的时间，即 seek -1 ）可能实际上无法正确定位，并且音频将保持静音一段时间。建议使用 hr-seek，它应该没有这些问题。
• Some things are just weird. For example, while seek commands manipulate playback time in the expected way (provided they work correctly), the framestep commands are transposed. Backstepping will perform very expensive work to step forward by 1 frame.
  有些事情就是很奇怪。例如，虽然定位命令以预期的方式操作播放时间（前提是它们能正确工作），但帧步命令是错位的。向后步进将执行非常昂贵的操作以向前步进 1 帧。

Tuning:  调整：

• Remove all --vf/--af filters you have set. Disable hardware decoding. Disable functions like SPDIF passthrough.
  删除您设置的 --vf / --af 过滤器。禁用硬件解码。禁用如 SPDIF 透传等功能。
• Increasing --video-reversal-buffer might help if reversal queue overflow is reported, which may happen in high bitrate video, or video with large GOP. Hardware decoding mostly ignores this, and you need to increase --hwdec-extra-frames instead (until you get playback without logged errors).
  如果报告了回放队列溢出，增加 --video-reversal-buffer 可能有所帮助，这可能在高比特率视频或大型 GOP 视频中发生。硬件解码主要忽略这一点，您需要增加 --hwdec-extra-frames （直到您获得无错误日志的回放）。
• The demuxer cache is essential for backward demuxing. Make sure to set --cache=yes. The cache size might matter. If it's too small, a queue overflow will be logged, and backward playback cannot continue, or it performs too many low level seeks. If it's too large, implementation tradeoffs may cause general performance issues. Use --demuxer-max-bytes to potentially increase the amount of packets the demuxer layer can queue for reverse demuxing (basically it's the --video-reversal-buffer equivalent for the demuxer layer).
  解复用器缓存对于向后解复用至关重要。请确保设置 --cache=yes 。缓存大小可能很重要。如果太小，将记录队列溢出，回放无法继续，或者执行过多的低级搜索。如果太大，实现权衡可能会导致性能问题。使用 --demuxer-max-bytes 可能有增加解复用器层可以排队进行反向解复用的数据包数量的作用（基本上是解复用器层的 --video-reversal-buffer 相当物）。
• Setting --vd-queue-enable=yes can help a lot to make playback smooth (once it works).
  设置 --vd-queue-enable=yes 可以在很大程度上帮助使回放流畅（一旦它工作）。
• --demuxer-backward-playback-step also factors into how many seeks may be performed, and whether backward demuxing could break due to queue overflow. If it's set too high, the backstep operation needs to search through more packets all the time, even if the cache is large enough.
  --demuxer-backward-playback-step 也会影响到可能执行多少次查找，以及是否由于队列溢出而导致反向解复用可能中断。如果设置得太高，回退操作需要不断搜索更多的数据包，即使缓存足够大。
• Setting --demuxer-cache-wait may be useful to cache the entire file into the demuxer cache. Set --demuxer-max-bytes to a large size to make sure it can read the entire cache; --demuxer-max-back-bytes should also be set to a large size to prevent that tries to trim the cache.
  设置 --demuxer-cache-wait 可能有助于将整个文件缓存到解复用器缓存中。将 --demuxer-max-bytes 设置为较大的大小以确保它可以读取整个缓存； --demuxer-max-back-bytes 也应该设置为较大的大小以防止尝试修剪缓存。
• If audio artifacts are audible, even though the AO does not underrun, increasing --audio-backward-overlap might help in some cases.
  如果音频伪影可闻，即使 AO 没有欠载，增加 --audio-backward-overlap 在某些情况下可能有所帮助。

--video-reversal-buffer=<bytesize>, --audio-reversal-buffer=<bytesize>

For backward decoding. Backward decoding decodes forward in steps, and then reverses the decoder output. These options control the approximate maximum amount of bytes that can be buffered. The main use of this is to avoid unbounded resource usage; during normal backward playback, it's not supposed to hit the limit, and if it does, it will drop frames and complain about it.
用于反向解码。反向解码以步进方式向前解码，然后反转解码器的输出。这些选项控制可以缓存的近似最大字节数。这主要用于避免无界资源使用；在正常反向播放期间，不应达到限制，如果达到限制，它将丢弃帧并对此进行抱怨。

Use this option if you get reversal queue overflow errors during backward playback. Increase the size until the warning disappears. Usually, the video buffer will overflow first, especially if it's high resolution video.
在向后播放时遇到回放队列溢出错误时请使用此选项。增加大小直到警告消失。通常，视频缓冲区会首先溢出，尤其是如果是高分辨率视频。

This does not work correctly if video hardware decoding is used. The video frame size will not include the referenced GPU and driver memory. Some hardware decoders may also be limited by --hwdec-extra-frames.
如果使用视频硬件解码，则此操作可能不会正确执行。视频帧大小将不包括引用的 GPU 和驱动内存。某些硬件解码器也可能受到 --hwdec-extra-frames 的限制。

How large the queue size needs to be depends entirely on the way the media was encoded. Audio typically requires a very small buffer, while video can require excessively large buffers.
队列大小需要多大完全取决于媒体编码的方式。音频通常只需要非常小的缓冲区，而视频可能需要非常大的缓冲区。

(Technically, this allows the last frame to exceed the limit. Also, this does not account for other buffered frames, such as inside the decoder or the video output.)
(技术上，这允许最后一帧超过限制。此外，这也不考虑其他缓冲帧，例如解码器内部或视频输出中的缓冲帧。)

This does not affect demuxer cache behavior at all.
这根本不影响解复用器缓存行为。

See --list-options for defaults and value range. <bytesize> options accept suffixes such as KiB and MiB.
查看 --list-options 以获取默认值和值范围。 <bytesize> 选项接受后缀，例如 KiB 和 MiB 。

--video-backward-overlap=<auto|number>, --audio-backward-overlap=<auto|number>

Number of overlapping keyframe ranges to use for backward decoding (default: auto) ("keyframe" to be understood as in the mpv/ffmpeg specific meaning). Backward decoding works by forward decoding in small steps. Some codecs cannot restart decoding from any packet (even if it's marked as seek point), which becomes noticeable with backward decoding (in theory this is a problem with seeking too, but --hr-seek-demuxer-offset can fix it for seeking). In particular, MDCT based audio codecs are affected.
用于向后解码的重叠关键帧范围数量（默认：自动）（“关键帧”应理解为在 mpv/ffmpeg 特定含义中）。向后解码通过小步正向解码来实现。某些编解码器无法从任何数据包（即使标记为寻址点）重新启动解码，这在向后解码时尤为明显（理论上这同样是寻址的问题，但 --hr-seek-demuxer-offset 可以修复寻址问题）。特别是基于 MDCT 的音频编解码器受到影响。

The solution is to feed a previous packet to the decoder each time, and then discard the output. This option controls how many packets to feed. The auto choice is currently hardcoded to 0 for video, and uses 1 for lossy audio, 0 for lossless audio. For some specific lossy audio codecs, this is set to 2.
解决方案是在每次解码时向解码器提供前一个数据包，然后丢弃输出。此选项控制要提供多少个数据包。目前 auto 选项对于视频硬编码为 0，对于有损音频使用 1，对于无损音频使用 0。对于某些特定的有损音频编解码器，此值设置为 2。

--video-backward-overlap can potentially handle intra-refresh video, depending on the exact conditions. You may have to use the --vd-lavc-show-all option as well.
--video-backward-overlap 可能能够处理内部刷新视频，具体取决于确切条件。您可能还需要使用 --vd-lavc-show-all 选项。

--video-backward-batch=<number>, --audio-backward-batch=<number>

Number of keyframe ranges to decode at once when backward decoding (default: 1 for video, 10 for audio). Another pointless tuning parameter nobody should use. This should affect performance only. In theory, setting a number higher than 1 for audio will reduce overhead due to less frequent backstep operations and less redundant decoding work due to fewer decoded overlap frames (see --audio-backward-overlap). On the other hand, it requires a larger reversal buffer, and could make playback less smooth due to breaking pipelining (e.g. by decoding a lot, and then doing nothing for a while).
在向后解码时一次解码的关键帧范围数量（默认：视频为 1，音频为 10）。另一个毫无意义的调整参数，没有人应该使用。这应该只会影响性能。理论上，将音频的数字设置为大于 1 将减少由于较少的回退操作和较少的冗余解码工作（由于解码重叠帧较少）而产生的开销（见 --audio-backward-overlap ）。另一方面，它需要更大的反转缓冲区，并且可能会因为打破流水线（例如，解码很多，然后一段时间不做任何事情）而使播放不够平滑。

It probably never makes sense to set --video-backward-batch. But in theory, it could help with intra-only video codecs by reducing backstep operations.
可能永远没有设置 --video-backward-batch 的意义。但在理论上，它可以通过减少回退操作来帮助仅内编码的视频编解码器。

--demuxer-backward-playback-step=<seconds>

Number of seconds the demuxer should seek back to get new packets during backward playback (default: 60). This is useful for tuning backward playback, see --play-direction for details.
解复用器在向后播放期间应回退多少秒以获取新数据包（默认：60）。这对于调整向后播放很有用，请参阅 --play-direction 以获取详细信息。

Setting this to a very low value or 0 may make the player think seeking is broken, or may make it perform multiple seeks.
将此值设置为非常低或 0 可能会导致播放器认为搜索已损坏，或者可能导致它执行多次搜索。

Setting this to a high value may lead to quadratic runtime behavior.
将此值设置为高值可能会导致二次方运行时行为。

Program Behavior  程序行为

--help, --h

Show short summary of options.
显示选项的简短摘要。

You can also pass a string to this option, which will list all top-level options which contain the string in the name, e.g. --h=scale for all options that contain the word scale. The special string * lists all top-level options.
您还可以传递一个字符串到这个选项，这将列出所有名称中包含该字符串的顶级选项，例如，对于所有包含单词 scale 的选项，使用 --h=scale 。特殊字符串 * 列出所有顶级选项。

-v

Increment verbosity level, one level for each -v found on the command line.
增加详细程度级别，每次在命令行中找到 -v 就增加一级。

--version, -V

Print version string and exit.
打印版本字符串并退出。

--no-config

Do not load default configuration or any user files. This prevents loading of both the user-level and system-wide mpv.conf and input.conf files. Other user files are blocked as well, such as resume playback files and cache files. This option only takes effect when used as a command line flag.
不要加载默认配置或任何用户文件。这防止了加载用户级和系统级的 mpv.conf 和 input.conf 文件。其他用户文件也会被阻止，例如恢复播放文件和缓存文件。此选项仅在用作命令行标志时生效。

Note  注意

Files explicitly requested by command line options, like --include or --use-filedir-conf, will still be loaded.
由命令行选项明确请求的文件，如 --include 或 --use-filedir-conf ，仍然会被加载。

See also: --config-dir.  另请参阅： --config-dir 。

--list-options

Prints all available options.
打印所有可用选项。

--list-properties

Print a list of the available properties.
打印可用属性的列表。

--list-protocols

Print a list of the supported protocols.
打印支持的协议列表。

--log-file=<path>

Opens the given path for writing, and print log messages to it. Existing files will be truncated. The log level is at least -v -v, but can be raised via --msg-level (the option cannot lower it below the forced minimum log level).
以写入模式打开指定的路径，并将日志消息打印到其中。现有文件将被截断。日志级别至少为 -v -v ，但可以通过 --msg-level （选项不能将其降低到强制最低日志级别）提高。

A special case is the macOS bundle, it will create a log file at ~/Library/Logs/mpv.log by default.
一个特殊情况是 macOS 包，它将默认在 ~/Library/Logs/mpv.log 创建一个日志文件。

--config-dir=<path>

Force a different configuration directory. If this is set, the given directory is used to load configuration files, and all other configuration directories are ignored. This means the global mpv configuration directory as well as per-user directories are ignored, and overrides through environment variables (MPV_HOME) are also ignored.
强制使用不同的配置目录。如果设置了此选项，则使用指定的目录来加载配置文件，并忽略所有其他配置目录。这意味着将忽略全局 mpv 配置目录以及用户目录，并且也忽略通过环境变量（ MPV_HOME ）进行的覆盖。

Note that the cache and state paths (~~/cache, ~~/state) are not considered "configuration" and keep their auto-detection logic.
请注意，缓存和状态路径（ ~~/cache ， ~~/state ）不被视为“配置”，并保持其自动检测逻辑。

Note that the --no-config option takes precedence over this option.
请注意， --no-config 选项优先于此选项。

--dump-stats=<filename>

Write certain statistics to the given file. The file is truncated on opening. The file will contain raw samples, each with a timestamp. To make this file into a readable, the script TOOLS/stats-conv.py can be used (which currently displays it as a graph).
将某些统计信息写入指定的文件。文件在打开时将被截断。文件将包含原始样本，每个样本都有一个时间戳。要将此文件转换为可读格式，可以使用脚本 TOOLS/stats-conv.py （当前显示为图形）.

This option is useful for debugging only.
此选项仅用于调试。

--idle=<no|yes|once>

Makes mpv wait idly instead of quitting when there is no file to play. Mostly useful in input mode, where mpv can be controlled through input commands. (Default: no)
当没有文件可播放时，使 mpv 空闲等待而不是退出。主要在输入模式下有用，在此模式下，mpv 可以通过输入命令进行控制。（默认： no ）

once will only idle at start and let the player close once the first playlist has finished playing back.
once 仅在开始时空闲，并在第一个播放列表播放完毕后关闭播放器。

--include=<configuration-file>

Specify configuration file to be parsed after the default ones.
指定要解析的配置文件，在默认配置文件之后。

--load-scripts=<yes|no>

If set to no, don't auto-load scripts from the scripts configuration subdirectory (usually ~/.config/mpv/scripts/). (Default: yes)
如果设置为 no ，则不要从 scripts 配置子目录（通常为 ~/.config/mpv/scripts/ ）自动加载脚本。（默认： yes ）

--script=<filename>, --scripts=file1.lua:file2.lua:...

Load a Lua script. The second option allows you to load multiple scripts by separating them with the path separator (: on Unix, ; on Windows).
加载 Lua 脚本。第二个选项允许您通过路径分隔符（Unix 上的 : ，Windows 上的 ; ）分隔来加载多个脚本。

--scripts is a path list option. See List Options for details.
--scripts 是一个路径列表选项。有关详细信息，请参阅列表选项。

--script-opt=<key=value>, --script-opts=key1=value1,key2=value2,...

Set options for scripts. A script can query an option by key. If an option is used and what semantics the option value has depends entirely on the loaded scripts. Values not claimed by any scripts are ignored.
设置脚本的选项。脚本可以通过键查询选项。如果使用选项，其值具有的语义完全取决于加载的脚本。任何脚本未声明的值都将被忽略。

Each use of the --script-opt option will add another option to the internal list, while --script-opts takes a list of options at once, and overwrites the internal list with it. The latter is a key/value list option. See List Options for details.
每次使用 --script-opt 选项都会将另一个选项添加到内部列表中，而 --script-opts 一次接受一个选项列表，并用它覆盖内部列表。后者是一个键/值列表选项。有关详细信息，请参阅列表选项。

--merge-files

Pretend that all files passed to mpv are concatenated into a single, big file. This uses timeline/EDL support internally.
假设传递给 mpv 的所有文件都被连接成一个单独的大文件。这内部使用时间轴/EDL 支持。

--profile=<profile1,profile2,...>

Use the given profile(s), --profile=help displays a list of the defined profiles.
使用指定的配置文件， --profile=help 显示定义的配置文件列表。

--reset-on-next-file=<all|option1,option2,...>

Normally, mpv will try to keep all settings when playing the next file on the playlist, even if they were changed by the user during playback. (This behavior is the opposite of MPlayer's, which tries to reset all settings when starting next file.)
通常，mpv 在播放播放列表中的下一个文件时将尝试保留所有设置，即使用户在播放过程中更改了它们。（这种行为与 MPlayer 相反，MPlayer 在启动下一个文件时尝试重置所有设置。）

Default: Do not reset anything.
默认：不重置任何内容。

This can be changed with this option. It accepts a list of options, and mpv will reset the value of these options on playback start to the initial value. The initial value is either the default value, or as set by the config file or command line.
可以通过此选项更改此设置。它接受一个选项列表，mpv 将在播放开始时将这些选项的值重置为初始值。初始值是默认值，或由配置文件或命令行设置。

The special name all resets as many options as possible.
特殊名称 all 将尽可能重置多个选项。

This is a string list option. See List Options for details.
这是一个字符串列表选项。有关详细信息，请参阅列表选项。

Examples  示例

• --reset-on-next-file=pause Reset pause mode when switching to the next file.
  --reset-on-next-file=pause 在切换到下一个文件时重置暂停模式。
• --reset-on-next-file=fullscreen,speed Reset fullscreen and playback speed settings if they were changed during playback.
  --reset-on-next-file=fullscreen,speed 如果在播放过程中进行了更改，则重置全屏和播放速度设置。
• --reset-on-next-file=all Try to reset all settings that were changed during playback.
  --reset-on-next-file=all 尝试重置在播放过程中更改的所有设置。

--show-profile=<profile>

Show the description and content of a profile. Lists all profiles if no parameter is provided.
显示个人资料的描述和内容。如果没有提供参数，则列出所有个人资料。

--use-filedir-conf

Look for a file-specific configuration file in the same directory as the file that is being played. See File-specific Configuration Files.
在正在播放的文件所在的同一目录中查找特定文件的配置文件。参见特定文件配置文件。

Warning  警告

May be dangerous if playing from untrusted media.
如果从不受信任的媒体播放，可能存在危险。

--ytdl=<yes|no>

Enable the youtube-dl hook-script. It will look at the input URL, and will play the video located on the website. This works with many streaming sites, not just the one that the script is named after. This requires a recent version of youtube-dl to be installed on the system (default: yes).
启用 youtube-dl 钩子脚本。它将检查输入 URL，并播放位于网站上的视频。这适用于许多流媒体网站，而不仅仅是脚本命名的那个网站。这需要在系统上安装最近版本的 youtube-dl（默认：是）。

If the script can't do anything with an URL, it will do nothing.
如果脚本对 URL 无能为力，它将什么都不做。

This accepts a set of options, which can be passed to it with the --script-opts option (using ytdl_hook- as prefix):
此操作接受一组选项，可以使用 --script-opts 选项（使用 ytdl_hook- 作为前缀）传递给它：

try_ytdl_first=<yes|no>

If 'yes' will try parsing the URL with youtube-dl first, instead of the default where it's only after mpv failed to open it. This mostly depends on whether most of your URLs need youtube-dl parsing.
如果选择 'yes'，将首先尝试使用 youtube-dl 解析 URL，而不是默认情况下在 mpv 打开失败之后。这主要取决于您的大多数 URL 是否需要 youtube-dl 解析。

exclude=<URL1|URL2|...

A |-separated list of URL patterns which mpv should not use with youtube-dl. The patterns are matched after the http(s):// part of the URL.
一个由 | 分隔的 URL 模式列表，mpv 不应与 youtube-dl 一起使用。模式匹配在 URL 的 http(s):// 部分之后。

^ matches the beginning of the URL, $ matches its end, and you should use % before any of the characters ^$()%|,.[]*+-? to match that character.
^ 匹配 URL 的开头， $ 匹配其结尾，您应该在匹配 ^$()%|,.[]*+-? 中的任何字符之前使用 % 。

URLs are converted to lower case before matching.
URLs 在匹配之前被转换为小写。

Examples  示例

• --script-opts=ytdl_hook-exclude='^youtube%.com' will exclude any URL that starts with http://youtube.com or https://youtube.com.
  --script-opts=ytdl_hook-exclude='^youtube%.com' 将排除以 http://youtube.com 或 https://youtube.com 开头的任何 URL 。
• --script-opts=ytdl_hook-exclude='%.mkv$|%.mp4$' will exclude any URL that ends with .mkv or .mp4.
  --script-opts=ytdl_hook-exclude='%.mkv$|%.mp4$' 将排除以 .mkv 或 .mp4 结尾的任何 URL 。

See more lua patterns here: https://www.lua.org/manual/5.1/manual.html#5.4.1
在此处查看更多 lua 模式：https://www.lua.org/manual/5.1/manual.html#5.4.1

include=<URL1|URL2|...

A |-separated list of URL patterns which mpv should try to parse with youtube-dl first when try_ytdl_first is no. The patterns are matched in the same way as exclude.
一个由 | 分隔的 URL 模式列表，mpv 应首先尝试使用 youtube-dl 解析这些模式，当 try_ytdl_first 为 no 时。模式匹配方式与 exclude 相同。

Default: ^%w+%.youtube%.com/|^youtube%.com/|^youtu%.be/|^%w+%.twitch%.tv/|^twitch%.tv/  默认： ^%w+%.youtube%.com/|^youtube%.com/|^youtu%.be/|^%w+%.twitch%.tv/|^twitch%.tv/

all_formats=<yes|no>

If 'yes' will attempt to add all formats found reported by youtube-dl (default: no). Each format is added as a separate track. In addition, they are delay-loaded, and actually opened only when a track is selected (this should keep load times as low as without this option).
如果选择 'yes'，将尝试添加由 youtube-dl 报告的所有找到的格式（默认：no）。每个格式都作为单独的轨道添加。此外，它们是延迟加载的，实际上只有在选择轨道时才会打开（这应该可以保持没有此选项时的加载时间）。

It adds average bitrate metadata, if available, which means you can use --hls-bitrate to decide which track to select. (HLS used to be the only format whose alternative quality streams were exposed in a similar way, thus the option name.)
如果可用，它将添加平均比特率元数据，这意味着您可以使用 --hls-bitrate 来决定选择哪个轨道。（HLS 曾经是唯一一种以类似方式公开替代质量流的格式，因此选项名称。）

Tracks which represent formats that were selected by youtube-dl as default will have the default flag set. This means mpv should generally still select formats chosen with --ytdl-format by default.
代表由 youtube-dl 默认选择的格式的轨道将设置默认标志。这意味着 mpv 通常仍然会默认选择使用 --ytdl-format 选择的格式。

Although this mechanism makes it possible to switch streams at runtime, it's not suitable for this purpose for various technical reasons. (It's slow, which can't be really fixed.) In general, this option is not useful, and was only added to show that it's possible.
尽管这种机制可以在运行时切换流，但由于各种技术原因，它不适合此目的。（它很慢，这实际上无法真正修复。）一般来说，此选项并不实用，仅添加以表明这是可能的。

There are two cases that must be considered when doing quality/bandwidth selection:
在进行质量/带宽选择时必须考虑两种情况：

1. Completely separate audio and video streams (DASH-like). Each of these streams contain either only audio or video, so you can mix and combine audio/video bandwidths without restriction. This intuitively matches best with the concept of selecting quality by track (what all_formats is supposed to do).
   完全分离的音频和视频流（类似 DASH）。这些流中的每一个都只包含音频或视频，因此您可以无限制地混合和组合音频/视频带宽。这直观地与按轨道选择质量的概念（ all_formats 应该执行的操作）最匹配。

2. Separate sets of muxed audio and video streams. Each version of the media contains both an audio and video stream, and they are interleaved. In order not to waste bandwidth, you should only select one of these versions (if, for example, you select an audio stream, then video will be downloaded, even if you selected video from a different stream).
   分离的复用音频和视频流集合。每种媒体版本都包含音频和视频流，并且它们是交错排列的。为了不浪费带宽，您应该只选择这些版本中的一个（例如，如果您选择音频流，则即使您从不同的流中选择了视频，也会下载视频）。

   mpv will still represent them as separate tracks, but will set the title of each track to muxed-N, where N is replaced with the youtube-dl format ID of the originating stream.
   mpv 仍然将它们表示为单独的轨道，但会将每个轨道的标题设置为 muxed-N ，其中 N 将被原始流的 youtube-dl 格式 ID 替换。

Some sites will mix 1. and 2., but we assume that they do so for compatibility reasons, and there is no reason to use them at all.
一些网站会混合 1.和 2.，但我们假设它们这样做是为了兼容性原因，实际上完全没有必要使用它们。

force_all_formats=<yes|no>

If set to 'yes', and all_formats is also set to 'yes', this will try to represent all youtube-dl reported formats as tracks, even if mpv would normally use the direct URL reported by it (default: yes).
如果设置为'yes'，并且 all_formats 也设置为'yes'，这将尝试将 youtube-dl 报告的所有格式表示为轨道，即使 mpv 通常会使用它报告的直接 URL（默认：yes）。

It appears this normally makes a difference if youtube-dl works on a master HLS playlist.
这似乎在 youtube-dl 在主 HLS 播放列表上工作时会有所不同。

If this is set to 'no', this specific kind of stream is treated like all_formats is set to 'no', and the stream selection as done by youtube-dl (via --ytdl-format) is used.
如果设置为'no'，这种特定的流将像 all_formats 设置为'no'一样处理，并且使用 youtube-dl（通过 --ytdl-format ）进行的流选择将被使用。

thumbnails=<all|best|none>

Add thumbnails as video tracks (default: none).
添加缩略图作为视频轨道（默认：无）。

Thumbnails get downloaded when they are added as tracks, so 'all' can have a noticeable impact on how long it takes to open the video when there are a lot of thumbnails.
当缩略图作为轨道添加时，它们会被下载，因此当缩略图很多时，'all'可能会对打开视频所需的时间产生明显影响。

use_manifests=<yes|no>

Make mpv use the master manifest URL for formats like HLS and DASH, if available, allowing for video/audio selection in runtime (default: no). It's disabled ("no") by default for performance reasons.
如果可用，让 mpv 使用 HLS 和 DASH 等格式的 master manifest URL，允许在运行时选择视频/音频（默认：否）。默认情况下禁用（"no"），出于性能考虑。

ytdl_path=youtube-dl

Configure paths to youtube-dl's executable or a compatible fork's. The paths should be separated by : on Unix and ; on Windows. mpv looks in order for the configured paths in PATH and in mpv's config directory. The defaults are "yt-dlp", "yt-dlp_x86" and "youtube-dl". On Windows the suffix extension is not necessary, but only ".exe" is acceptable.
配置 youtube-dl 的可执行文件或兼容分支的路径。在 Unix 上，路径应由:分隔，在 Windows 上由;分隔。mpv 将按照配置的路径顺序在 PATH 和 mpv 的配置目录中查找。默认值为"yt-dlp"，"yt-dlp_x86"和"youtube-dl"。在 Windows 上，不需要后缀扩展名，但只接受".exe"。

Why do the option names mix _ and -?
为什么选项名称会混合使用 _ 和 - ?

I have no idea.
我不知道。

--ytdl-format=<ytdl|best|worst|mp4|webm|...>

Video format/quality that is directly passed to youtube-dl. The possible values are specific to the website and the video, for a given url the available formats can be found with the command youtube-dl --list-formats URL. See youtube-dl's documentation for available aliases. (Default: bestvideo+bestaudio/best)
直接传递给 youtube-dl 的视频格式/质量。可能的值特定于网站和视频，对于给定的 url，可以通过命令 youtube-dl --list-formats URL 查找可用的格式。有关可用的别名，请参阅 youtube-dl 的文档。（默认： bestvideo+bestaudio/best ）

The ytdl value does not pass a --format option to youtube-dl at all, and thus does not override its default. Note that sometimes youtube-dl returns a format that mpv cannot use, and in these cases the mpv default may work better.
ytdl 值根本不会将 --format 选项传递给 youtube-dl，因此不会覆盖其默认设置。请注意，有时 youtube-dl 返回的格式是 mpv 无法使用的，在这些情况下，mpv 的默认设置可能更好。

--ytdl-raw-options=<key>=<value>[,<key>=<value>[,...]]

Pass arbitrary options to youtube-dl. Parameter and argument should be passed as a key-value pair. Options without argument must include =.
将任意选项传递给 youtube-dl。参数和参数应以键值对的形式传递。没有参数的选项必须包含 = 。

There is no sanity checking so it's possible to break things (i.e. passing invalid parameters to youtube-dl).
没有进行合理性检查，因此可能会破坏某些东西（例如，向 youtube-dl 传递无效参数）。

A proxy URL can be passed for youtube-dl to use it in parsing the website. This is useful for geo-restricted URLs. After youtube-dl parsing, some URLs also require a proxy for playback, so this can pass that proxy information to mpv. Take note that SOCKS proxies aren't supported and https URLs also bypass the proxy. This is a limitation in FFmpeg.
可以为 youtube-dl 传递一个代理 URL，以便在解析网站时使用它。这对于地理限制的 URL 很有用。在 youtube-dl 解析后，某些 URL 也需要代理进行播放，因此可以将该代理信息传递给 mpv。请注意，SOCKS 代理不受支持，并且 https URL 也会绕过代理。这是 FFmpeg 的限制。

This is a key/value list option. See List Options for details.
这是一个键/值列表选项。请参阅列表选项以获取详细信息。

Example  示例

• --ytdl-raw-options=username=user,password=pass
• --ytdl-raw-options=force-ipv6=
• --ytdl-raw-options=proxy=[http://127.0.0.1:3128]
• --ytdl-raw-options-append=proxy=http://127.0.0.1:3128

--js-memory-report=<yes|no>

Enable memory reporting for javascript scripts in the stats overlay. This is disabled by default because it has an overhead and increases memory usage. This option will only work if it is enabled before mpv is started.
启用在统计叠加中为 javascript 脚本启用内存报告。默认情况下此功能是禁用的，因为它会产生开销并增加内存使用。此选项仅在 mpv 启动之前启用时才会生效。

--load-stats-overlay=<yes|no>

Enable the builtin script that shows useful playback information on a key binding (default: yes). By default, the i key is used (I to make the overlay permanent).
启用内置脚本，该脚本在按键绑定上显示有用的回放信息（默认：是）。默认情况下，使用 i 键（使用 I 使覆盖永久）。

--load-console=<yes|no>

Enable the built-in script to handle textual input (default: yes).
启用内置脚本以处理文本输入（默认：是）。

--load-commands=<yes|no>

Enable the built-in script to enter commands in the console (default: yes). The ` key is used to activate this by default.
启用内置脚本以在控制台中输入命令（默认：是）。默认使用 ` 键激活此功能。

--load-auto-profiles=<yes|no|auto>

Enable the builtin script that does auto profiles (default: auto). See Conditional auto profiles for details. auto will load the script, but immediately unload it if there are no conditional profiles.
启用内置脚本以自动生成配置文件（默认：自动）。有关条件自动配置文件的详细信息，请参阅条件自动配置文件。 auto 将加载脚本，但如果没有条件配置文件，将立即卸载它。

--load-select=<yes|no>

Enable the builtin script that lets you select from lists of items (default: yes). By default, its keybindings start with the g key.
启用内置脚本，允许您从项目列表中选择（默认：是）。默认情况下，其快捷键从 g 键开始。

--load-positioning=<yes|no>

Enable the builtin script that provides various keybindings to pan videos and images (default: yes).
启用内置脚本，提供各种键绑定以滚动视频和图像（默认：是）。

--player-operation-mode=<cplayer|pseudo-gui>

For enabling "pseudo GUI mode", which means that the defaults for some options are changed. This option should not normally be used directly, but only by mpv internally, or mpv-provided scripts, config files, or .desktop files. See PSEUDO GUI MODE for details.
启用 "伪 GUI 模式"，这意味着某些选项的默认值已更改。此选项通常不应直接使用，而应由 mpv 内部、mpv 提供的脚本、配置文件或.desktop 文件使用。有关详细信息，请参阅 PSEUDO GUI MODE。

Watch Later  稍后观看

--save-position-on-quit

Always save the current playback position on quit, and also when the loadfile command is used to replace the current playlist. When this file is played again later, the player will seek to the old playback position on start. This does not happen if playback of a file is stopped in other ways. For example, going to the next file in the playlist will not save the position, and will start playback at beginning the next time the file is played.
退出时始终保存当前播放位置，并在使用 loadfile 命令替换当前播放列表时也保存。稍后再次播放此文件时，播放器将在启动时跳转到旧的播放位置。如果以其他方式停止播放文件，则不会发生此情况。例如，转到播放列表中的下一个文件将不会保存位置，并且下一次播放该文件时将从开头开始播放。

This behavior is disabled by default, but is always available when quitting the player with Shift+Q.
默认情况下禁用此行为，但始终在按 Shift+Q 退出播放器时可用。

See RESUMING PLAYBACK.  查看 RESUMING PLAYBACK。

--watch-later-dir=<path>

The directory in which to store the "watch later" temporary files.
存储 "稍后观看" 临时文件的目录。

--watch-later-directory is an alias for --watch-later-dir.
--watch-later-directory 是 --watch-later-dir 的别名。

If this option is unset, the files will be stored in a subdirectory named "watch_later" underneath the local state directory (usually ~/.local/state/mpv/).
如果未设置此选项，文件将存储在本地状态目录（通常为 ~/.local/state/mpv/ ）下的名为 "watch_later" 的子目录中。

--resume-playback=<yes|no>

Restore playback position from the watch_later configuration subdirectory, usually ~/.config/mpv/watch_later/ (default: yes).
从 watch_later 配置子目录恢复播放位置，通常为 ~/.config/mpv/watch_later/ （默认：是）。

--resume-playback-check-mtime=<yes|no>

Only restore the playback position from the watch_later configuration subdirectory (usually ~/.config/mpv/watch_later/) if the file's modification time is the same as at the time of saving. This may prevent skipping forward in files with the same name which have different content. (Default: no)
仅在文件的修改时间与保存时相同的情况下，从 watch_later 配置子目录（通常为 ~/.config/mpv/watch_later/ ）恢复播放位置。这可以防止在具有相同名称但内容不同的文件中跳过。 （默认： no ）

--watch-later-options=option1,option2,...

The options that are saved in "watch later" files if they have been changed since when mpv started. These values will be restored the next time the files are played. Note that the playback position is saved via the start option.
保存到“稍后观看”文件中的选项，如果它们自 mpv 启动以来已更改。这些值将在下次播放文件时恢复。请注意，播放位置是通过 start 选项保存的。

When removing options, existing watch later data won't be modified and will still be applied fully, but new watch later data won't contain these options.
在删除选项时，现有的稍后观看数据不会修改，并且仍然会完全应用，但新的稍后观看数据将不包含这些选项。

See --help=watch-later-options for the list of the properties that are restored by default.
查看 --help=watch-later-options 以获取默认恢复的属性列表。

This is a string list option. See List Options for details.
这是一个字符串列表选项。有关详细信息，请参阅列表选项。

Examples  示例

• --watch-later-options-remove=sid The subtitle track selection will not be restored.
  --watch-later-options-remove=sid 字幕轨道选择将不会被恢复。
• --watch-later-options-remove=volume --watch-later-options-remove=mute The volume and mute state won't be saved to watch later files.
  --watch-later-options-remove=volume --watch-later-options-remove=mute 音量静音状态不会保存到稍后观看的文件中。
• --watch-later-options=start No option will be saved to watch later files, except the playback position.
  --watch-later-options=start 除了播放位置外，不会将任何选项保存到稍后观看的文件中。

--write-filename-in-watch-later-config

Prepend the watch later config files with the name of the file they refer to. This is simply written as comment on the top of the file.
将引用的文件名添加到“watch later”配置文件的开头。这简单地写在文件顶部作为注释。

Warning  警告

This option may expose privacy-sensitive information and is thus disabled by default.
此选项可能会暴露隐私敏感信息，因此默认禁用。

--ignore-path-in-watch-later-config

Ignore path (i.e. use filename only) when using watch later feature. (Default: disabled)
使用“watch later”功能时忽略路径（即仅使用文件名）。（默认：禁用）

Watch History  观看历史

--save-watch-history

Whether to save which files are played. These can be then selected with the default g-h key binding.
是否保存播放的文件。然后可以使用默认的 g-h 快捷键进行选择。

Warning  警告

This option may expose privacy-sensitive information and is thus disabled by default.
此选项可能会暴露隐私敏感信息，因此默认禁用。

--watch-history-path=<path>

The path in which to store the watch history. Default: ~~state/watch_history.jsonl (see PATHS).
存储监视历史记录的路径。默认： ~~state/watch_history.jsonl （参见 PATHS）。

This file contains one JSON object per line. Its time field is the UNIX timestamp when the file was opened, its path field is the normalized path, and its title field is the title when it was available.
此文件每行包含一个 JSON 对象。其 time 字段是文件打开时的 UNIX 时间戳，其 path 字段是归一化路径，其 title 字段是可用时的标题。

Video  视频

--vo=<driver>

Specify the video output backend to be used. See VIDEO OUTPUT DRIVERS for details and descriptions of available drivers.
指定要使用的视频输出后端。有关详细信息以及可用驱动程序的描述，请参阅视频输出驱动程序。

--vd=<...>

Specify a priority list of video decoders to be used, according to their family and name. See --ad for further details. Both of these options use the same syntax and semantics; the only difference is that they operate on different codec lists.
指定要使用的视频解码器的优先级列表，根据其家族和名称。参见 --ad 以获取更多详细信息。这两个选项使用相同的语法和语义；唯一的区别是它们操作不同的编解码器列表。

Note  注意

See --vd=help for a full list of available decoders.
参见 --vd=help 以获取可用解码器的完整列表。

--vf=<filter1[=parameter1:parameter2:...],filter2,...>

Specify a list of video filters to apply to the video stream. See VIDEO FILTERS for details and descriptions of the available filters. The option variants --vf-add, --vf-pre, and --vf-clr exist to modify a previously specified list, but you should not need these for typical use.
指定要应用于视频流的视频过滤器列表。有关可用过滤器的详细信息及其描述，请参阅 VIDEO FILTERS。选项变体 --vf-add 、 --vf-pre 和 --vf-clr 存在用于修改之前指定的列表，但在典型使用中您可能不需要这些。

--untimed

Do not sleep when outputting video frames. Useful for benchmarks when used with --audio=no.
输出视频帧时不要睡眠。与 --audio=no 结合使用时对基准测试很有用。

--framedrop=<mode>

Skip displaying some frames to maintain A/V sync on slow systems, or playing high framerate video on video outputs that have an upper framerate limit.
跳过显示一些帧以在慢速系统上保持音视频同步，或在具有上限帧率的视频输出上播放高帧率视频。

The argument selects the drop methods, and can be one of the following:
此参数选择丢弃方法，可以是以下之一：

<no>  <无>

Disable any frame dropping. Not recommended, for testing only.
禁用任何帧丢弃。不建议使用，仅用于测试。

<vo>  <音>

Drop late frames on video output (default). This still decodes and filters all frames, but doesn't render them on the VO. Drops are indicated in the terminal status line as Dropped: field.
在视频输出时丢弃过晚的帧（默认）。这仍然解码和过滤所有帧，但不在 VO 上渲染它们。丢弃的帧在终端状态行中的 Dropped: 字段中指示。

In audio sync. mode, this drops frames that are outdated at the time of display. If the decoder is too slow, in theory all frames would have to be dropped (because all frames are too late) - to avoid this, frame dropping stops if the effective framerate is below 10 FPS.
在音频同步模式下，这会丢弃在显示时过时的帧。如果解码器太慢，理论上所有帧都必须丢弃（因为所有帧都太晚） - 为了避免这种情况，如果有效帧率低于 10 FPS，则停止帧丢弃。

In display-sync. modes (see --video-sync), this affects only how A/V drops or repeats frames. If this mode is disabled, A/V desync will in theory not affect video scheduling anymore (much like the display-resample-desync mode). However, even if disabled, frames will still be skipped (i.e. dropped) according to the ratio between video and display frequencies.
在显示同步模式（见 --video-sync ）中，这仅影响视频和音频帧的丢失或重复。如果此模式被禁用，理论上将不再影响视频调度（类似于 display-resample-desync 模式）。然而，即使禁用，帧仍然会根据视频和显示频率之间的比例被跳过（即丢失）。

This is the recommended mode, and the default.
这是推荐的模式，也是默认模式。

<decoder>  <解码器>

Old, decoder-based framedrop mode. (This is the same as --framedrop=yes in mpv 0.5.x and before.) This tells the decoder to skip frames (unless they are needed to decode future frames). May help with slow systems, but can produce unwatchable choppy output, or even freeze the display completely.
旧的、基于解码器的帧丢失模式。（这与 mpv 0.5.x 及之前版本中的 --framedrop=yes 相同。）这告诉解码器跳过帧（除非它们是解码未来帧所需的）。可能有助于慢速系统，但可能会产生难以观看的卡顿输出，甚至完全冻结显示。

This uses a heuristic which may not make sense, and in general cannot achieve good results, because the decoder's frame dropping cannot be controlled in a predictable manner. Not recommended.
这使用了一种可能没有意义的方法，并且通常无法获得良好的结果，因为解码器的帧丢弃无法以可预测的方式控制。不推荐使用。

Even if you want to use this, prefer decoder+vo for better results.
即使你想使用这个，也建议使用 decoder+vo 以获得更好的结果。

The --vd-lavc-framedrop option controls what frames to drop.
--vd-lavc-framedrop 选项控制要丢弃哪些帧。

<decoder+vo>  <解码器+语音>

Enable both modes. Not recommended. Better than just decoder mode.
启用两种模式。不推荐使用。比仅 decoder 模式更好。

Note  注意

--vo=vdpau has its own code for the vo framedrop mode. Slight differences to other VOs are possible.
--vo=vdpau 拥有自己用于 vo framedrop 模式的代码。与其他 VOs 可能存在细微差异。

--video-latency-hacks=<yes|no>

Enable some things which tend to reduce video latency by 1 or 2 frames (default: no). Note that this option might be removed without notice once the player's timing code does not inherently need to do these things anymore. Using this option is known to break other options such as interpolation, so it is not recommended to enable this.
启用一些可能会减少视频延迟 1 或 2 帧的功能（默认：不启用）。请注意，一旦玩家的定时代码不再需要执行这些操作，此选项可能会不通知就被移除。使用此选项已知会破坏其他选项，如插值，因此不建议启用此选项。

This does:  这会做到：

• Use the demuxer reported FPS for frame dropping. This avoids the player needing to decode 1 frame in advance, lowering total latency in effect. This also means that if the demuxer reported FPS is wrong, or the video filter chain changes FPS (e.g. deinterlacing), then it could drop too many or not enough frames.
  使用解复用器报告的 FPS 进行帧丢弃。这避免了播放器需要提前解码 1 帧，从而降低总延迟。这也意味着，如果解复用器报告的 FPS 错误，或者视频过滤器链更改 FPS（例如，去隔行扫描），则可能会丢弃过多的帧或不足的帧。
• Disable waiting for the first video frame. Normally the player waits for the first video frame to be fully rendered before starting playback properly. Some VOs will lazily initialize stuff when rendering the first frame, so if this is not done, there is some likeliness that the VO has to drop some frames if rendering the first frame takes longer than needed.
  禁用等待第一个视频帧。通常播放器会在正确开始播放之前等待第一个视频帧完全渲染。一些 VO 会在渲染第一个帧时懒加载一些内容，所以如果这样做，那么如果渲染第一个帧所需时间超过预期，VO 可能会丢失一些帧。

--display-fps-override=<fps>

Set the display FPS used with the --video-sync=display-* modes. By default, a detected value is used. Keep in mind that setting an incorrect value (even if slightly incorrect) can ruin video playback. On multi-monitor systems, there is a chance that the detected value is from the wrong monitor.
设置与 --video-sync=display-* 模式一起使用的显示 FPS。默认情况下，使用检测到的值。请注意，设置不正确的值（即使略微不正确）可能会破坏视频播放。在多显示器系统中，检测到的值可能是来自错误的显示器。

Set this option only if you have reason to believe the automatically determined value is wrong.
仅在有理由相信自动确定的值错误时设置此选项。

--hwdec=<api1,api2,...|no|auto|auto-copy>

Specify the hardware video decoding API that should be used if possible. Whether hardware decoding is actually done depends on the video codec. If hardware decoding is not possible, mpv will fall back on software decoding.
尽可能指定应使用的硬件视频解码 API。是否实际进行硬件解码取决于视频编解码器。如果无法进行硬件解码，mpv 将回退到软件解码。

Hardware decoding is not enabled by default, to keep the out-of-the-box configuration as reliable as possible. However, when using modern hardware, hardware video decoding should work correctly, offering reduced CPU usage, and possibly lower power consumption. On older systems, it may be necessary to use hardware decoding due to insufficient CPU resources; and even on modern systems, sufficiently complex content (eg: 4K60 AV1) may require it.
默认情况下未启用硬件解码，以尽可能保持出厂配置的可靠性。然而，当使用现代硬件时，硬件视频解码应能正确工作，降低 CPU 使用率，并可能降低功耗。在较旧的系统上，可能需要使用硬件解码，因为 CPU 资源不足；甚至在现代系统上，足够复杂的内容（例如：4K60 AV1）可能也需要它。

This is a string list option. See List Options for details.
这是一个字符串列表选项。有关详细信息，请参阅列表选项。

Note  注意

Use the Ctrl+h shortcut to toggle hardware decoding at runtime. It toggles this option between auto and no.
使用 Ctrl+h 快捷键在运行时切换硬件解码。它将在 auto 和 no 之间切换此选项。

If you decide you want to use hardware decoding by default, the general recommendation is to try out decoding with the command line option, and prove to yourself that it works as desired for the content you care about. After that, you can add it to your config file.
如果您决定希望默认使用硬件解码，一般建议是尝试使用命令行选项进行解码，并证明它确实为您关心的内容按预期工作。之后，您可以将它添加到您的配置文件中。

When testing, you should start by using hwdec=auto as it will limit itself to choosing from hwdecs that are actively supported by the development team. If that doesn't result in working hardware decoding, you can try hwdec=auto-unsafe to have it attempt to load every possible hwdec, but if auto didn't work, you will probably need to know exactly which hwdec matches your hardware and read up on that entry below.
在测试时，您应该首先使用 hwdec=auto ，因为它将限制自己从开发团队积极支持的 hwdecs 中进行选择。如果这没有导致有效的硬件解码，您可以尝试 hwdec=auto-unsafe ，让它尝试加载每个可能的 hwdec，但如果 auto 不起作用，您可能需要确切知道哪个 hwdec 与您的硬件匹配，并阅读下面的条目。

If auto produced the desired results, we recommend just sticking with that and only setting a specific hwdec in your config file if it is really necessary.
如果 auto 产生了期望的结果，我们建议就坚持使用它，并且只有在确实有必要的情况下才在您的配置文件中设置特定的 hwdec。

If you use the Ubuntu package, keep in mind that their /etc/mpv/mpv.conf contains hwdec=vaapi, which is less than ideal as it may not be the right choice for your system, and it may end up using an inefficient wrapper library under the covers. We recommend removing this line or deleting the file altogether.
如果您使用 Ubuntu 软件包，请注意，它们的 /etc/mpv/mpv.conf 包含 hwdec=vaapi ，这并不理想，因为它可能不是您系统的正确选择，并且最终可能会在幕后使用一个低效的包装库。我们建议删除此行或完全删除文件。

Note  注意

Even if enabled, hardware decoding is still only white-listed for some codecs. See --hwdec-codecs to enable hardware decoding in more cases.
即使启用，硬件解码也仅对某些编解码器进行白名单。参见 --hwdec-codecs 以在更多情况下启用硬件解码。

Which method to choose?
选择哪种方法？

• If you only want to enable hardware decoding at runtime, don't set the parameter, or put hwdec=no into your mpv.conf (relevant on distros which force-enable it by default, such as on Ubuntu). Use the Ctrl+h default binding to enable it at runtime.
  如果您只想在运行时启用硬件解码，不要设置该参数，或将 hwdec=no 放入您的 mpv.conf （在默认强制启用的发行版上相关，例如在 Ubuntu 上）。使用 Ctrl+h 默认绑定在运行时启用它。
• If you're not sure, but want hardware decoding always enabled by default, put hwdec=yes into your mpv.conf, and acknowledge that this may cause problems.
  如果您不确定，但希望硬件解码始终默认启用，请将 hwdec=yes 放入您的 mpv.conf ，并承认这可能会引起问题。
• If you want to test available hardware decoding methods, pass --hwdec=auto --hwdec-codecs=all and look at the terminal output.
  如果您想测试可用的硬件解码方法，请传递 --hwdec=auto --hwdec-codecs=all 并查看终端输出。
• If you're a developer, or want to perform elaborate tests, you may need any of the other possible option values.
  如果您是开发者或想进行详细测试，您可能需要其他可能的选项值。

This option accepts a comma delimited list of api types, along with certain special values:
此选项接受以逗号分隔的 api 类型列表，以及某些特殊值：

no:  no：	always use software decoding (default) 始终使用软件解码（默认）
auto:	enable any whitelisted hw decoder (see below) 启用任何白名单硬件解码器（见下文）
auto-unsafe:	forcibly enable any hw decoder found (see below) 强制启用找到的任何硬件解码器（见下文）
yes:	exactly the same as auto 完全相同于 auto
auto-safe:	exactly the same as auto 完全相同于 auto

Note  注意

Special values can be mixed with api names. eg: vaapi,auto will try and use the vaapi hwdec, and if that fails, will run through the normal auto logic.
特殊值可以与 api 名称混合使用。例如： vaapi,auto 将尝试使用 vaapi hwdec，如果失败，将运行正常的 auto 逻辑。

Actively supported hwdecs:
积极支持的 hwdecs:

d3d11va:	requires --vo=gpu with --gpu-context=d3d11 or --gpu-context=angle (Windows 8+ only) 需要使用 --vo=gpu 与 --gpu-context=d3d11 或 --gpu-context=angle （仅限 Windows 8 及以上版本）
d3d11va-copy:	copies video back to system RAM (Windows 8+ only) 将视频复制回系统 RAM（仅限 Windows 8 及以上版本）
videotoolbox:	requires --vo=gpu (macOS 10.8 and up), or --vo=libmpv (iOS 9.0 and up) 需要使用 --vo=gpu （macOS 10.8 及以上版本），或 --vo=libmpv （iOS 9.0 及以上版本）
videotoolbox-copy:
	copies video back into system RAM (macOS 10.8 or iOS 9.0 and up) 将视频复制回系统 RAM（macOS 10.8 或 iOS 9.0 及以上版本）
vaapi:	requires --vo=gpu, --vo=vaapi or --vo=dmabuf-wayland (Linux only) 需要 --vo=gpu , --vo=vaapi 或 --vo=dmabuf-wayland (仅限 Linux)
vaapi-copy:	copies video back into system RAM (Linux with some GPUs or Windows) 将视频复制回系统 RAM (Linux 和某些 GPU 或 Windows)
nvdec:	requires --vo=gpu (Any platform CUDA is available) 需要 --vo=gpu （任何平台 CUDA 都可用）
nvdec-copy:	copies video back to system RAM (Any platform CUDA is available) 将视频复制回系统 RAM（任何平台 CUDA 可用）
drm:	requires --vo=gpu (Linux only) 需要 --vo=gpu (仅限 Linux)
drm-copy:	copies video back to system RAM (Linux only) 将视频复制回系统 RAM (仅限 Linux)
vulkan:	requires --vo=gpu-next (Any platform with Vulkan Video Decoding) 需要 --vo=gpu-next (支持 Vulkan 视频解码的任何平台)
vulkan-copy:	copies video back to system RAM (Any platform with Vulkan Video Decoding) 将视频复制回系统 RAM (支持 Vulkan 视频解码的任何平台)

Other hwdecs (only use if you know you have to):
其他 hwdec（仅在您知道必须使用时使用）：

dxva2:	requires --vo=gpu with --gpu-context=d3d11, --gpu-context=angle or --gpu-context=dxinterop (Windows only) 需要使用 --vo=gpu 与 --gpu-context=d3d11 ， --gpu-context=angle 或 --gpu-context=dxinterop （仅限 Windows）
dxva2-copy:	copies video back to system RAM (Windows only) 将视频复制回系统 RAM（仅限 Windows）
vdpau:	requires --vo=gpu with --gpu-context=x11, or --vo=vdpau (Linux only) 需要 --vo=gpu 与 --gpu-context=x11 ，或 --vo=vdpau （仅限 Linux）
vdpau-copy:	copies video back into system RAM (Linux with some GPUs only) 将视频复制回系统 RAM（仅限某些 GPU 的 Linux）
mediacodec:	requires --vo=gpu --gpu-context=android or --vo=mediacodec_embed (Android only) 需要 --vo=gpu --gpu-context=android 或 --vo=mediacodec_embed （仅限 Android）
mediacodec-copy:
	copies video back to system RAM (Android only) 将视频复制回系统 RAM（仅限 Android）
cuda:	requires --vo=gpu (Any platform CUDA is available) 需要 --vo=gpu （任何平台 CUDA 都可用）
cuda-copy:	copies video back to system RAM (Any platform CUDA is available) 将视频复制回系统 RAM（任何平台 CUDA 可用）
crystalhd:	copies video back to system RAM (Any platform supported by hardware) 将视频复制回系统 RAM（任何硬件支持的平台）
rkmpp:	requires --vo=gpu (some RockChip devices only) 需要 --vo=gpu (仅限某些 RockChip 设备)

auto tries to automatically enable hardware decoding using the first available method, but allows only whitelisted methods that are considered "safe". This is supposed to be a reasonable way to enable hardware decoding by default in a config file (even though you shouldn't do that anyway; prefer runtime enabling with Ctrl+h). Unlike auto-unsafe, this will not try to enable unknown or known-to-be-bad methods. In addition, this may disable hardware decoding in other situations when it's known to cause problems, but currently this mechanism is quite primitive. (As an example for something that still causes problems: certain combinations of HEVC and Intel chips on Windows tend to cause mpv to crash, most likely due to driver bugs.)
auto 尝试自动使用第一个可用方法启用硬件解码，但只允许白名单中的“安全”方法。这应该是在配置文件中默认启用硬件解码的合理方式（尽管你实际上不应该这样做；建议使用 Ctrl+h 在运行时启用）。与 auto-unsafe 不同，它不会尝试启用未知或已知有问题的方法。此外，当已知这会导致问题时，它还可能在其他情况下禁用硬件解码，但目前这种机制相当原始。（例如，某些仍然会导致问题的东西：Windows 上 HEVC 和 Intel 芯片的某些组合往往会引起 mpv 崩溃，最有可能是因为驱动程序错误。）

auto-unsafe is similar to auto, but without the whitelist. In general, you should never need to use this beyond debugging or development use. Any known unsafe hwdec you want to test can simply be appended to the list option such as --hwdec=auto,unsafe-hwdec. This still depends what VO you are using. See the list above, for which --vo and gpu-context is required for a given hwdec. It will go down the list of available hwdecs until one is successfully initialised. If all of them fail, it will fallback to software decoding.
auto-unsafe 与 auto 类似，但没有白名单。通常情况下，您不需要在调试或开发之外使用此功能。您想测试的任何已知不安全的 hwdec 可以简单地追加到列表选项中，例如 --hwdec=auto,unsafe-hwdec 。这仍然取决于您使用的 VO。请参阅上面的列表，其中对于给定的 hwdec 需要 --vo 和 gpu-context 。它将遍历可用的 hwdec 列表，直到成功初始化一个。如果所有这些都失败，它将回退到软件解码。

auto-copy selects only modes that copy the video data back to system memory after decoding. This selects modes like vaapi-copy (and so on), but it only allows whitelisted methods that are considered "safe". If none of these work, hardware decoding is disabled. This mode is usually guaranteed to incur no additional quality loss compared to software decoding (assuming modern codecs and an error free video stream), and will allow CPU processing with video filters. This mode works with all video filters and VOs.
auto-copy 仅选择在解码后将视频数据复制回系统内存的模式。这选择了类似于 vaapi-copy （等等）的模式，但它只允许被认为是“安全”的白名单方法。如果这些方法都不起作用，则禁用硬件解码。此模式通常保证与软件解码相比不会产生额外的质量损失（假设现代编解码器和无错误的视频流），并且将允许使用视频过滤器进行 CPU 处理。此模式与所有视频过滤器以及 VOs 兼容。

auto-copy-safe is an alias for auto-copy
auto-copy-safe 是 auto-copy 的别名

auto-copy-unsafe is the same as auto-copy except that it goes through all methods and not just the whitelisted ones that are considered "safe".
auto-copy-unsafe 与 auto-copy 相同，但它是通过所有方法，而不仅仅是被认为是“安全”的白名单方法。

Because these copy the decoded video back to system RAM, they're often less efficient than the direct modes, and may not help too much over software decoding if you are short on CPU resources.
因为这些会将解码后的视频复制回系统 RAM，所以它们通常比直接模式效率低，如果您 CPU 资源不足，可能对软件解码的帮助不大。

Note  注意

Most non-copy methods only work with the OpenGL GPU backend. Currently, only the vaapi, nvdec, cuda and vulkan methods work with Vulkan.
大多数非复制方法仅适用于 OpenGL GPU 后端。目前，只有 vaapi 、 nvdec 、 cuda 和 vulkan 方法适用于 Vulkan。

The vaapi mode, if used with --vo=gpu or --vo=gpu-next most likely works with Intel and AMD GPUs only. It requires the opengl EGL backend if the GPU does not support drm modifiers.
如果与 --vo=gpu 或 --vo=gpu-next 一起使用， vaapi 模式最有可能仅适用于 Intel 和 AMD GPU。如果 GPU 不支持 drm 修饰符，则需要 opengl EGL 后端。

nvdec and nvdec-copy are the newest, and recommended method to do hardware decoding on Nvidia GPUs.
nvdec 和 nvdec-copy 是在 Nvidia GPU 上进行硬件解码的最新、推荐方法。

cuda and cuda-copy are an older implementation of hardware decoding on Nvidia GPUs that uses Nvidia's bitstream parsers rather than FFmpeg's. This can lead to feature deficiencies, such as incorrect playback of HDR content, and nvdec/nvdec-copy should always be preferred unless you specifically need Nvidia's deinterlacing algorithms. To use this deinterlacing you must pass the option: vd-lavc-o=deint=[weave|bob|adaptive]. Pass weave (or leave the option unset) to not attempt any deinterlacing.
cuda 和 cuda-copy 是 Nvidia GPU 上硬件解码的较旧实现，它使用 Nvidia 的比特流解析器而不是 FFmpeg 的。这可能导致功能不足，例如 HDR 内容播放不正确，并且 nvdec / nvdec-copy 应始终优先考虑，除非您特别需要 Nvidia 的去隔行算法。要使用此去隔行功能，您必须传递选项： vd-lavc-o=deint=[weave|bob|adaptive] 。传递 weave （或保留选项未设置）以不尝试任何去隔行。

Quality reduction with hardware decoding
硬件解码导致的画质降低

In theory, hardware decoding does not reduce video quality (at least for the codecs h264 and HEVC). However, due to restrictions in video output APIs, as well as bugs in the actual hardware decoders, there can be some loss, or even blatantly incorrect results. This has largely ceased to be a problem with modern hardware, but there is a lot of hardware out there, so caveat emptor. Known problems are discussed below, but the list cannot be considered exhaustive, as even hwdecs that work well on certain hardware generations may be problematic on other ones.
从理论上讲，硬件解码不会降低视频质量（至少对于 h264 和 HEVC 编解码器）。然而，由于视频输出 API 的限制以及实际硬件解码器中的错误，可能会有一些损失，甚至可能是明显错误的结果。在现代硬件上，这已经不再是问题，但市面上有很多硬件，所以消费者需谨慎。以下讨论了已知问题，但此列表不能被认为是详尽的，因为即使在某些硬件代际上表现良好的 hwdecs 也可能在其他代际上存在问题。

In some cases, RGB conversion is forced, which means the RGB conversion is performed by the hardware decoding API, instead of the shaders used by --vo=gpu. This means certain colorspaces may not display correctly, and certain filtering (such as debanding) cannot be applied in an ideal way. This will also usually force the use of low quality chroma scalers instead of the one specified by --cscale. In other cases, hardware decoding can also reduce the bit depth of the decoded image, which can introduce banding or precision loss for 10-bit files.
在某些情况下，RGB 转换被强制执行，这意味着 RGB 转换由硬件解码 API 执行，而不是由 --vo=gpu 使用的着色器执行。这意味着某些色彩空间可能无法正确显示，并且某些过滤（如去带）可能无法以理想的方式应用。这通常还会强制使用低质量色度缩放器，而不是由 --cscale 指定的缩放器。在其他情况下，硬件解码还可以降低解码图像的位深度，这可能会为 10 位文件引入带状或精度损失。

vdpau always does RGB conversion in hardware, which does not support newer colorspaces like BT.2020 correctly. However, vdpau doesn't support 10 bit or HDR encodings, so these limitations are unlikely to be relevant.
vdpau 始终在硬件中执行 RGB 转换，这不支持像 BT.2020 这样的新色彩空间。然而， vdpau 不支持 10 位或 HDR 编码，因此这些限制可能不太相关。

dxva2 is not safe. It appears to always use BT.601 for forced RGB conversion, but actual behavior depends on the GPU drivers. Some drivers appear to convert to limited range RGB, which gives a faded appearance. In addition to driver-specific behavior, global system settings might affect this additionally. This can give incorrect results even with completely ordinary video sources.
dxva2 不安全。它似乎始终使用 BT.601 进行强制 RGB 转换，但实际行为取决于 GPU 驱动程序。一些驱动程序似乎转换为有限范围的 RGB，这会导致颜色变淡。除了驱动程序特定的行为外，全局系统设置还可能进一步影响。这甚至可能在使用完全普通的视频源时产生错误的结果。

mediacodec is not safe. It forces RGB conversion (not with -copy) and how well it handles non-standard colorspaces is not known. In the rare cases where 10-bit is supported the bit depth of the output will be reduced to 8.
mediacodec 不安全。它强制进行 RGB 转换（不是使用 -copy ）并且不知道它处理非标准色彩空间的能力如何。在罕见的情况下，如果支持 10 位，输出位深将降低到 8 位。

cuda should usually be safe, but depending on how a file/stream has been mixed, it has been reported to corrupt the timestamps causing glitched, flashing frames. It can also sometimes cause massive framedrops for unknown reasons. Caution is advised, and nvdec should always be preferred.
cuda 通常应该是安全的，但根据文件/流的混合方式，有报告称它会导致时间戳损坏，造成闪烁帧。有时也可能由于未知原因造成大量帧率下降。建议谨慎操作，并且始终优先使用 nvdec 。

crystalhd is not safe. It always converts to 4:2:2 YUV, which may be lossy, depending on how chroma sub-sampling is done during conversion. It also discards the top left pixel of each frame for some reason.
crystalhd 不安全。它总是转换为 4:2:2 YUV，这可能会在转换过程中由于色度子采样方式不同而造成损失。此外，出于某种原因，它还会丢弃每个帧的左上角像素。

If you run into any weird decoding issues, frame glitches or discoloration, and you have --hwdec turned on, the first thing you should try is disabling it.
如果您遇到任何奇怪的解码问题、帧闪烁或颜色失真，并且您已开启 --hwdec ，您应该首先尝试禁用它。

--gpu-hwdec-interop=<auto|all|no|name>

This option is for troubleshooting hwdec interop issues. Since it's a debugging option, its semantics may change at any time.
此选项用于解决 hwdec 互操作问题。由于它是一个调试选项，其语义可能随时更改。

This is useful for the gpu and libmpv VOs for selecting which hwdec interop context to use exactly. Effectively it also can be used to block loading of certain backends.
这对于选择要使用的确切 hwdec 互操作上下文的 gpu 和 libmpv VOs 非常有用。实际上，它也可以用来阻止某些后端的加载。

If set to auto (default), the behavior depends on the VO: for gpu, it does nothing, and the interop context is loaded on demand (when the decoder probes for --hwdec support). For libmpv, which has has no on-demand loading, this is equivalent to all.
如果设置为 auto （默认值），行为取决于 VO：对于 gpu ，它不起作用，互操作上下文将在需要时加载（当解码器探测 --hwdec 支持时）。对于没有按需加载的 libmpv ，这相当于 all 。

The empty string is equivalent to auto.
空字符串等同于 auto 。

If set to all, it attempts to load all interop contexts at GL context creation time.
如果设置为 all ，则在创建 GL 上下文时尝试加载所有互操作上下文。

Other than that, a specific backend can be set, and the list of them can be queried with help (mpv CLI only).
除此之外，可以设置特定的后端，并且可以通过 help （仅限 mpv CLI）查询它们的列表。

Runtime changes to this are ignored (the current option value is used whenever the renderer is created).
对此的运行时更改将被忽略（创建渲染器时始终使用当前选项值）。

--hwdec-extra-frames=<N>

Number of GPU frames hardware decoding should preallocate (default: see --list-options output). If this is too low, frame allocation may fail during decoding, and video frames might get dropped and/or corrupted. Setting it too high simply wastes GPU memory and has no advantages.
GPU 帧硬件解码应预分配的数量（默认：见 --list-options 输出）。如果这个值太低，解码过程中帧分配可能会失败，视频帧可能会丢失和/或损坏。设置得太高会简单地浪费 GPU 内存，没有任何优势。

This value is used only for hardware decoding APIs which require preallocating surfaces (known examples include d3d11va and vaapi). For other APIs, frames are allocated as needed. The details depend on the libavcodec implementations of the hardware decoders.
此值仅用于需要预分配表面的硬件解码 API（已知示例包括 d3d11va 和 vaapi ）。对于其他 API，帧按需分配。具体细节取决于硬件解码器的 libavcodec 实现。

The required number of surfaces depends on dynamic runtime situations. The default is a fixed value that is thought to be sufficient for most uses. But in certain situations, it may not be enough.
所需表面的数量取决于动态运行时情况。默认值是一个被认为是大多数用途足够固定的值。但在某些情况下，可能不足以满足需求。

--hwdec-image-format=<name>

Set the internal pixel format used by hardware decoding via --hwdec (default no). The special value no selects an implementation specific standard format. Most decoder implementations support only one format, and will fail to initialize if the format is not supported.
通过 --hwdec 设置硬件解码使用的内部像素格式（默认 no ）。特殊值 no 选择特定实现的标准化格式。大多数解码器实现只支持一种格式，如果格式不受支持，将无法初始化。

Some implementations might support multiple formats. In particular, videotoolbox is known to require uyvy422 for good performance on some older hardware. d3d11va can always use yuv420p, which uses an opaque format, with likely no advantages.
某些实现可能支持多种格式。特别是，videotoolbox 在旧硬件上为了获得良好的性能，通常需要使用 uyvy422 。d3d11va 始终可以使用 yuv420p ，它使用不透明格式，可能没有优势。

--cuda-decode-device=<auto|0..>

Choose the GPU device used for decoding when using the cuda or nvdec hwdecs with the OpenGL GPU backend, and with the cuda-copy or nvdec-copy hwdecs in all cases.
当使用 OpenGL GPU 后端和 cuda 或 nvdec hwdecs 进行解码时，请选择用于解码的 GPU 设备，以及在所有情况下使用 cuda-copy 或 nvdec-copy hwdecs。

For the OpenGL GPU backend, the default device used for decoding is the one being used to provide gpu output (and in the vast majority of cases, only one GPU will be present).
对于 OpenGL GPU 后端，默认用于解码的设备是用于提供 gpu 输出的设备（并且在绝大多数情况下，只有一个 GPU）。

For the copy hwdecs, the default device will be the first device enumerated by the CUDA libraries - however that is done.
对于 copy hwdecs，默认设备将是 CUDA 库枚举的第一个设备——无论这样做的方式如何。

For the Vulkan GPU backend, decoding must always happen on the display device, and this option has no effect.
对于 Vulkan GPU 后端，解码必须始终在显示设备上发生，此选项无效果。

--vaapi-device=<device file|adapter name>

Choose the DRM device for vaapi-copy. This should be the path to a DRM device file. (Default: /dev/dri/renderD128)
选择用于 vaapi-copy 的 DRM 设备。这应该是 DRM 设备文件的路径。（默认： /dev/dri/renderD128 ）

On Windows this takes adapter name as an input. Will pick the default adapter if unset. Alternatives are listed when the name "help" is given.
在 Windows 上，此选项以适配器名称作为输入。如果未设置，将选择默认适配器。当给出“help”名称时，将列出替代选项。

--panscan=<0.0-1.0>

Enables pan-and-scan functionality (cropping the sides of e.g. a 16:9 video to make it fit a 4:3 display without black bands). The range controls how much of the image is cropped. May not work with all video output drivers.
启用平移和扫描功能（例如，裁剪 16:9 视频的两侧，使其适合 4:3 显示器而不出现黑色边带）。范围控件控制裁剪多少图像。可能不适用于所有视频输出驱动程序。

This option has no effect if --video-unscaled option is used.
此选项在使用 --video-unscaled 选项时没有效果。

The difference between --panscan and --video-zoom is that --panscan can only zoom in until either the video width or height fills the window, while --video-zoom can zoom in or out arbitrary amounts, and also works with --video-unscaled.
在 --panscan 和 --video-zoom 之间的区别是 --panscan 只能放大到视频宽度或高度填满窗口为止，而 --video-zoom 可以任意放大或缩小，并且还与 --video-unscaled 一起工作。

--video-aspect-override=<ratio|no>

Override video aspect ratio, in case aspect information is incorrect or missing in the file being played.
覆盖视频宽高比，以防正在播放的文件中的宽高信息不正确或缺失。

These values have special meaning:
这些值具有特殊含义：

no:  no：	use the method of the --video-aspect-method option (default) 使用 --video-aspect-method 选项的方法（默认）
0:	disable aspect ratio handling, pretend the video has square pixels (deprecated, use --video-aspect-override=no --video-aspect-method=ignore instead) 禁用纵横比处理，假装视频具有正方形像素（已弃用，请使用 --video-aspect-override=no --video-aspect-method=ignore 代替）
-1:	strictly prefer the container aspect ratio (deprecated, use --video-aspect-override=no --video-aspect-method=container instead) 严格优先选择容器纵横比（已弃用，请使用 --video-aspect-override=no --video-aspect-method=container 代替）

But note that handling of these special values might change in the future.
但请注意，这些特殊值的处理可能在将来发生变化。

Examples  示例

• --video-aspect-override=4:3 or --video-aspect-override=1.3333   --video-aspect-override=4:3 或 --video-aspect-override=1.3333
• --video-aspect-override=16:9 or --video-aspect-override=1.7777   --video-aspect-override=16:9 或 --video-aspect-override=1.7777
• --no-video-aspect-override or --video-aspect-override=no   --no-video-aspect-override 或 --video-aspect-override=no

--video-aspect-method=<bitstream|container|ignore>

This sets the default video aspect determination method (if the aspect is _not_ overridden by the user with --video-aspect-override or others).
这设置了默认的视频宽高比确定方法（如果宽高比没有被用户通过 --video-aspect-override 或其他方式覆盖）。

container:	Strictly prefer the container aspect ratio. This is apparently the default behavior with VLC, at least with Matroska. Note that if the container has no aspect ratio set, the behavior is the same as with bitstream. 严格优先选择容器的宽高比。这显然是 VLC 的默认行为，至少在 Matroska 中是这样。请注意，如果容器没有设置宽高比，其行为与比特流相同。
bitstream:  比特流：	Strictly prefer the bitstream aspect ratio, unless the bitstream aspect ratio is not set. This is apparently the default behavior with XBMC/kodi, at least with Matroska. 严格优先选择比特流宽高比，除非未设置比特流宽高比。这显然是 XBMC/kodi 的默认行为，至少在 Matroska 中是这样。
ignore:  忽略：	Disable aspect ratio handling, pretend the video has square pixels. 禁用宽高比处理，假装视频具有正方形像素。

The current default for mpv is container.
mpv 的当前默认值为 container 。

Normally you should not set this. Try the various choices if you encounter video that has the wrong aspect ratio in mpv, but seems to be correct in other players.
通常您不应该设置此选项。如果在 mpv 中遇到视频纵横比错误，但在其他播放器中看起来是正确的，请尝试各种选择。

--video-unscaled=<no|yes|downscale-big>

Disable scaling of the video. If the window is larger than the video, black bars are added. Otherwise, the video is cropped, unless the option is set to downscale-big, in which case the video is fit to window. The video still can be influenced by the other --video-... options. This option disables the effect of --panscan.
禁用视频缩放。如果窗口比视频大，则添加黑色边框。否则，视频将被裁剪，除非将选项设置为 downscale-big ，在这种情况下，视频将适应窗口。视频仍然可能受到其他 --video-... 选项的影响。此选项禁用 --panscan 的效果。

Note that the scaler algorithm may still be used, even if the video isn't scaled. For example, this can influence chroma conversion. The video will also still be scaled in one dimension if the source uses non-square pixels (e.g. anamorphic widescreen DVDs).
请注意，即使视频没有缩放，缩放算法仍然可能被使用。例如，这可以影响色度转换。如果源使用非正方形像素（例如，变形宽屏 DVD），视频也将在一个维度上缩放。

This option is disabled if --keepaspect=no is used.
如果使用 --keepaspect=no ，则此选项被禁用。

--video-pan-x=<value>, --video-pan-y=<value>

Moves the displayed video rectangle by the given value in the X or Y direction. The unit is in fractions of the size of the scaled video (the full size, even if parts of the video are not visible due to panscan or other options).
通过给定的值在 X 或 Y 方向上移动显示的视频矩形。单位是缩放视频大小的分数（即使由于 panscan 或其他选项，视频的部分不可见，也是整个视频的大小）。

For example, displaying a video fullscreen on a 1920x1080 screen with --video-pan-x=-0.1 would move the video 192 pixels to the left and --video-pan-y=-0.1 would move the video 108 pixels up.
例如，在 1920x1080 屏幕上使用 --video-pan-x=-0.1 将全屏显示视频，会使视频向左移动 192 像素，而使用 --video-pan-y=-0.1 会使视频向上移动 108 像素。

This option is disabled if --keepaspect=no is used.
如果使用 --keepaspect=no ，则此选项被禁用。

--video-rotate=<0-359|no>

Rotate the video clockwise, in degrees. If no is given, the video is never rotated, even if the file has rotation metadata. (The rotation value is added to the rotation metadata, which means the value 0 would rotate the video according to the rotation metadata.)
顺时针旋转视频，单位为度。如果给出 no ，即使文件有旋转元数据，视频也不会旋转。（旋转值将添加到旋转元数据中，这意味着 0 将根据旋转元数据旋转视频。）

When using hardware decoding without copy-back, only 90° steps work, while software decoding and hardware decoding methods that copy the video back to system memory support all values between 0 and 359.
在使用无拷贝回显的硬件解码时，只有 90° 步长有效，而软件解码以及将视频拷贝回系统内存的硬件解码方法支持 0 到 359 之间的所有值。

--video-crop=<[W[xH]][+x+y]>, --video-crop=<x:y>

Crop the video by starting at the x, y offset for w, h pixels. The crop is applied to the source video rectangle (before anamorphic stretch) by the VO. A crop rectangle that is not within the video rectangle will be ignored. This works with hwdec, unlike the equivalent 'lavfi-crop'. When offset is omitted, the central area will be cropped. Setting the crop to empty one --video-crop=0x0+0+0 overrides container crop and disables cropping. Setting the crop to --video-crop="" disables manual cropping and restores the container crop if it's specified.
通过从 x, y 偏移开始裁剪视频，裁剪 w, h 像素。裁剪由 VO 应用到源视频矩形（在变形拉伸之前），不在视频矩形内的裁剪矩形将被忽略。这与等效的 'lavfi-crop' 不同，此操作与 hwdec 一起工作。当省略偏移时，将裁剪中央区域。将裁剪设置为空 --video-crop=0x0+0+0 将覆盖容器裁剪并禁用裁剪。将裁剪设置为 --video-crop="" 将禁用手动裁剪并恢复容器裁剪（如果已指定）。

--video-zoom=<value>

Adjust the video display scale factor by the given value. The parameter is given log 2. For example, --video-zoom=0 is unscaled, --video-zoom=1 is twice the size, --video-zoom=-2 is one fourth of the size, and so on.
通过给定值调整视频显示缩放因子。该参数以 2 为底的对数给出。例如， --video-zoom=0 为未缩放， --video-zoom=1 为两倍大小， --video-zoom=-2 为四分之一大小，以此类推。

This option is disabled if --keepaspect=no is used.
如果使用 --keepaspect=no ，则此选项被禁用。

--video-scale-x=<value>, --video-scale-y=<value>

Multiply the video display size with the given value (default: 1.0). If a non-default value is used, this will be different from the window size, so video will be either cut off, or black bars are added.
将视频显示大小乘以给定值（默认：1.0）。如果使用非默认值，则与窗口大小不同，因此视频可能会被截断，或者添加黑色边框。

This value is multiplied with the value derived from --video-zoom and the normal video aspect ratio. This option is disabled if --keepaspect=no is used.
此值与从 --video-zoom 得到的值以及正常视频宽高比相乘。如果使用 --keepaspect=no ，则此选项将禁用。

--video-align-x=<-1-1>, --video-align-y=<-1-1>

When the video is bigger than the window, these move the displayed rectangle to show different parts of the video. --video-align-y=-1 would display the top of the video, 0 would display the center (default), and 1 would display the bottom.
当视频大于窗口大小时，这些操作将移动显示的矩形以显示视频的不同部分。 --video-align-y=-1 将显示视频顶部， 0 将显示中心（默认），而 1 将显示视频底部。

When the video is smaller than the window and --video-recenter is disabled, these move the video rectangle within the black borders, which are usually added to pad the video to the window if video and window aspect ratios are different. --video-align-y=-1 would move the video to the top of the window (leaving a border only on the bottom), 0 would center it, and 1 would put the video at the bottom of the window.
当视频小于窗口且 --video-recenter 禁用时，这些操作将在黑色边框内移动视频矩形，这些边框通常添加以填充视频至窗口，如果视频和窗口宽高比不同。 --video-align-y=-1 将将视频移动到窗口顶部（只留下底部边框）， 0 将将其居中，而 1 将将视频放置在窗口底部。

If video and screen aspect match perfectly, these options do nothing.
如果视频和屏幕宽高比完全匹配，则这些选项不执行任何操作。

Unlike --video-pan-x and --video-pan-y, these don't go beyond the video's or window's boundaries or make the displayed rectangle drift off after zooming.
与 --video-pan-x 和 --video-pan-y 不同，这些不会超出视频或窗口的边界，也不会在缩放后使显示的矩形漂移。

This option is disabled if --keepaspect=no is used.
如果使用 --keepaspect=no ，则此选项被禁用。

--video-recenter=<yes|no>

Whether to behave as if --video-align-x and --video-align-y were 0 when the video becomes smaller than the window in the respective direction
当视频在相应方向上小于窗口时，是否表现得像 --video-align-x 和 --video-align-y 为 0。

After zooming in until the video is bigger the window, panning with --video-align-x and/or --video-align-y, and zooming out until the video is smaller than the window, this is useful to recenter the video in the window.
在视频大于窗口之前缩放，使用--video-align-x 和/或--video-align-y 进行平移，然后缩放直到视频小于窗口，这有助于在窗口中重新居中视频。

Default: no.  默认：no。

--video-margin-ratio-left=<val>, --video-margin-ratio-right=<val>, --video-margin-ratio-top=<val>, --video-margin-ratio-bottom=<val>

Set extra video margins on each border (default: 0). Each value is a ratio of the window size, using a range 0.0-1.0. For example, setting the option --video-margin-ratio-right=0.2 at a window size of 1000 pixels will add a 200 pixels border on the right side of the window.
设置每个边框的额外视频边距（默认：0）。每个值是窗口大小的比例，使用范围 0.0-1.0。例如，在 1000 像素的窗口大小上设置选项 --video-margin-ratio-right=0.2 将在窗口右侧添加 200 像素的边框。

The video is "boxed" by these margins. The window size is not changed. In particular it does not enlarge the window, and the margins will cause the video to be downscaled by default. This may or may not change in the future.
视频被这些边距“包围”。窗口大小不会改变。特别是它不会放大窗口，并且边距将默认导致视频缩放。这可能在将来改变，也可能不会。

The margins are applied after 90° video rotation, but before any other video transformations.
边距在 90°视频旋转之后应用，但在任何其他视频转换之前。

This option is disabled if --keepaspect=no is used.
如果使用 --keepaspect=no ，则此选项被禁用。

Subtitles still may use the margins, depending on --sub-use-margins and similar options.
字幕仍然可能使用边距，这取决于 --sub-use-margins 和类似选项。

These options were created for the OSC. Some odd decisions, such as making the margin values a ratio (instead of pixels), were made for the sake of the OSC. It's possible that these options may be replaced by ones that are more generally useful. The behavior of these options may change to fit OSC requirements better, too.
这些选项是为 OSC 创建的。一些奇怪的决定，例如将边距值设为比率（而不是像素），是为了满足 OSC 的需求。这些选项可能会被更通用的选项所取代。这些选项的行为也可能改变，以更好地适应 OSC 的要求。

--correct-pts=<yes|no>

--correct-pts=no switches mpv to a mode where video timing is determined using a fixed framerate value (either using the --container-fps-override option, or using file information). Sometimes, files with very broken timestamps can be played somewhat well in this mode. Note that video filters, subtitle rendering, seeking (including hr-seeks and backstepping), and audio synchronization can be completely broken in this mode.
--correct-pts=no 将 mpv 切换到一种使用固定帧率值确定视频时序的模式（无论是使用 --container-fps-override 选项，还是使用文件信息）。有时，在这种模式下，带有非常破损的时间戳的文件可以播放得相对较好。请注意，在这种模式下，视频过滤器、字幕渲染、搜索（包括 hr-seeks 和 backstepping）以及音频同步可能会完全损坏。

--container-fps-override=<float>

Override video framerate. Useful if the original value is wrong or missing.
覆盖视频帧率。如果原始值错误或缺失，则很有用。

Note  注意

Works in --correct-pts=no mode only.
仅在 --correct-pts=no 模式下工作。

--deinterlace=<yes|no|auto>

Enable or disable deinterlacing (default: no). Interlaced video shows ugly comb-like artifacts, which are visible on fast movement. Enabling this typically inserts the bwdif video filter in order to deinterlace the video, or lets the video output apply deinterlacing if supported.
启用或禁用去隔行扫描（默认：否）。隔行扫描的视频会显示难看的梳状伪影，这在快速移动时尤为明显。启用此功能通常会在视频插入 bwdif 过滤器以去隔行，或者如果支持，则让视频输出应用去隔行扫描。

When using auto, mpv will insert a deinterlacing filter if ffmpeg detects that the video frame is interlaced. Be aware that there can be false positives in certain cases, such as when files are encoded as interlaced despite the video not actually being so. This is why auto is not the default value.
当使用 auto 时，如果 ffmpeg 检测到视频帧是隔行扫描的，mpv 将插入一个去隔行滤波器。请注意，在某些情况下可能会出现误报，例如文件被编码为隔行扫描，而实际上视频并非如此。这就是为什么 auto 不是默认值的原因。

Keep in mind that using this filter will conflict with any manually inserted deinterlacing filters, and that this will make video look worse if it's not actually interlaced.
请注意，使用此滤波器将与任何手动插入的去隔行滤波器冲突，并且如果视频实际上不是隔行扫描的，这将使视频看起来更差。

--deinterlace-field-parity=<tff|bff|auto>

Specify the field parity/order when deinterlacing (default: auto). Each frame of an interlaced video is divided into two fields, which are then separately transmitted. Top field represents even lines while bottom field represents odd lines. When deinterlacing the deinterlacer needs to know the correct temporal order of the fields else the video will appear jittery.
去隔行时指定场奇偶性/顺序（默认：自动）。隔行扫描视频的每一帧被分为两个场，然后分别传输。上场代表偶数行，而下场代表奇数行。去隔行时，去隔行器需要知道场的正确时间顺序，否则视频将出现抖动。

auto will automatically try to detect the field order of the video, tff forces top field first while bff forces bottom field first.
auto 将自动尝试检测视频的场顺序， tff 强制先传输上场，而 bff 强制先传输下场。

--frames=<number>

Play/convert only first <number> video frames, then quit.
仅播放/转换第一个 <number> 视频帧，然后退出。

--frames=0 loads the file, but immediately quits before initializing playback. (Might be useful for scripts which just want to determine some file properties.)
--frames=0 加载文件，但立即退出初始化播放。（可能对只想确定某些文件属性的脚本有用。）

For audio-only playback, any value greater than 0 will quit playback immediately after initialization. The value 0 works as with video.
对于仅音频播放，任何大于 0 的值将在初始化后立即退出播放。值为 0 时与视频相同。

--video-output-levels=<outputlevels>

RGB color levels used with YUV to RGB conversion. Normally, output devices such as PC monitors use full range color levels. However, some TVs and video monitors expect studio RGB levels. Providing full range output to a device expecting studio level input results in crushed blacks and whites, the reverse in dim gray blacks and dim whites.
在 YUV 到 RGB 转换中使用的 RGB 颜色级别。通常，输出设备如 PC 显示器使用全范围颜色级别。然而，一些电视和视频监视器期望使用工作室 RGB 级别。向期望工作室级别输入的设备提供全范围输出会导致黑色和白色压缩，反之在暗灰色黑色和暗白色中。

Not all VOs support this option. Some will silently ignore it.
并非所有 VOs 都支持此选项。一些将静默忽略它。

Available color ranges are:
可用的颜色范围包括：

auto:	automatic selection (equals to full range) (default) 自动选择（等于全范围）（默认）
limited:  有限：	limited range (16-235 per component), studio levels 有限范围（每个组件 16-235），工作室级别
full:  完整：	full range (0-255 per component), PC levels 全范围（每个组件 0-255），PC 级别

Note  注意

It is advisable to use your graphics driver's color range option instead, if available.
如果可用，建议使用您的显卡驱动程序的色彩范围选项。

--hwdec-codecs=<codec1,codec2,...|all>

Allow hardware decoding for a given list of codecs only. The special value all always allows all codecs.
仅允许给定列表中的编解码器进行硬件解码。特殊值 all 总是允许所有编解码器。

You can get the list of allowed codecs with mpv --vd=help. Remove the prefix, e.g. instead of lavc:h264 use h264.
您可以使用 mpv --vd=help 获取允许的编解码器列表。移除前缀，例如，使用 lavc:h264 而不是 h264 。

By default, this is set to h264,vc1,hevc,vp8,vp9,av1,prores. Note that the hardware acceleration special codecs like h264_vdpau are not relevant anymore, and in fact have been removed from FFmpeg in this form.
默认情况下，这设置为 h264,vc1,hevc,vp8,vp9,av1,prores 。请注意，像 h264_vdpau 这样的硬件加速专用编解码器不再相关，实际上这种形式的 FFmpeg 已经移除了它们。

This is usually only needed with broken GPUs, where a codec is reported as supported, but decoding causes more problems than it solves.
这通常只在 GPU 损坏时需要，其中编解码器报告为支持，但解码引起的问题比解决的问题更多。

Note  注意

On some broken drivers (e.g. NVIDIA on Linux), probing for codecs which the GPU does not support can unnecessarily slow down video playback initialization. To alleviate this, explicitly specify a list which only includes the codecs supported on the setup.
在某些损坏的驱动程序（例如 Linux 上的 NVIDIA）中，探测 GPU 不支持的视频编解码器可能会不必要地减慢视频播放初始化。为了缓解这种情况，明确指定一个只包含在设置上支持的编解码器的列表。

Example  示例

mpv --hwdec=vdpau --hwdec-codecs=h264,mpeg2video

Enable vdpau decoding for h264 and mpeg2 only.
仅启用 vdpau 解码 h264 和 mpeg2。

--hwdec-software-fallback=<yes|no|N>

Fallback to software decoding if the hardware-accelerated decoder fails (default: 3). If this is a number, then fallback will be triggered if N frames fail to decode in a row. 1 is equivalent to yes.
如果硬件加速解码器失败则回退到软件解码（默认：3）。如果这是一个数字，则当连续 N 帧解码失败时将触发回退。1 等同于 yes 。

Setting this to a higher number might break the playback start fallback: if a fallback happens, parts of the file will be skipped, approximately by to the number of packets that could not be decoded. Values below an unspecified count will not have this problem, because mpv retains the packets.
将此设置为更高的数字可能会破坏回放开始回退：如果发生回退，文件的部分将被跳过，大约相当于无法解码的数据包数量。低于未指定计数的值将不会出现此问题，因为 mpv 会保留这些数据包。

--vd-lavc-check-hw-profile=<yes|no>

Check hardware decoder profile (default: yes). If no is set, the highest profile of the hardware decoder is unconditionally selected, and decoding is forced even if the profile of the video is higher than that. The result is most likely broken decoding, but may also help if the detected or reported profiles are somehow incorrect.
检查硬件解码器配置文件（默认：是）。如果 no 被设置，则无条件选择硬件解码器的最高配置文件，即使视频的配置文件高于该配置文件，也会强制解码。结果很可能是解码损坏，但如果有检测或报告的配置文件不正确，也可能有所帮助。

--vd-lavc-film-grain=<auto|cpu|gpu>

Enables film grain application on the GPU. If video decoding is done on the CPU, doing film grain application on the GPU can speed up decoding. This option can also help hardware decoding, as it can reduce the number of frame copies done.
启用 GPU 上的电影颗粒应用。如果视频解码在 CPU 上完成，则可以在 GPU 上应用电影颗粒以加快解码。此选项还可以帮助硬件解码，因为它可以减少帧复制的数量。

By default, it's set to auto, so if the VO supports film grain application, then it will be treated as gpu. If the VO does not support this, then it will be treated as cpu, regardless of the setting. Currently, only gpu-next supports film grain application.
默认情况下，它设置为 auto ，因此如果 VO 支持电影颗粒应用，则它将被视为 gpu 。如果 VO 不支持此功能，则无论设置如何，它都将被视为 cpu 。目前，只有 gpu-next 支持电影颗粒应用。

--vd-lavc-dr=<auto|yes|no>

Enable direct rendering (default: auto). If this is set to yes, the video will be decoded directly to GPU video memory (or staging buffers). This can speed up video upload, and may help with large resolutions or slow hardware. This works only with the following VOs:
启用直接渲染（默认：自动）。如果设置为 yes ，则视频将直接解码到 GPU 视频内存（或暂存缓冲区）。这可以加快视频上传，并可能有助于处理高分辨率或硬件较慢的情况。此功能仅适用于以下 VO：

• gpu: requires at least OpenGL 4.4 or Vulkan.
  gpu ：需要至少 OpenGL 4.4 或 Vulkan。
• libmpv: The libmpv render API has optional support.
  libmpv ：libmpv 渲染 API 具有可选支持。

The auto option will try to guess whether DR can improve performance on your particular hardware. Currently this enables it on AMD or NVIDIA if using OpenGL or unconditionally if using Vulkan.

Using video filters of any kind that write to the image data (or output newly allocated frames) will silently disable the DR code path.

--vd-lavc-bitexact

Only use bit-exact algorithms in all decoding steps (for codec testing).

--vd-lavc-fast (MPEG-1/2 and H.264 only)

Enable optimizations which do not comply with the format specification and potentially cause problems, like simpler dequantization, simpler motion compensation, assuming use of the default quantization matrix, assuming YUV 4:2:0 and skipping a few checks to detect damaged bitstreams.
启用不符合格式规范且可能引起问题的优化，例如更简单的去量化、更简单的运动补偿、假设使用默认量化矩阵、假设 YUV 4:2:0 并跳过一些检测损坏比特流的检查。

--vd-lavc-o=<key>=<value>[,<key>=<value>[,...]]

Pass AVOptions to libavcodec decoder. Note, a patch to make the o= unneeded and pass all unknown options through the AVOption system is welcome. A full list of AVOptions can be found in the FFmpeg manual.
将 AVOptions 传递给 libavcodec 解码器。注意，一个使 o= 不再需要并通过 AVOption 系统传递所有未知选项的补丁是受欢迎的。AVOptions 的完整列表可以在 FFmpeg 手册中找到。

Some options which used to be direct options can be set with this mechanism, like bug, gray, idct, ec, vismv, skip_top (was st), skip_bottom (was sb), debug.
一些以前是直接选项的选项可以通过此机制设置，例如 bug 、 gray 、 idct 、 ec 、 vismv 、 skip_top （曾是 st ）、 skip_bottom （曾是 sb ）、 debug 。

This is a key/value list option. See List Options for details.
这是一个键/值列表选项。请参阅列表选项以获取详细信息。

Example  示例

--vd-lavc-o=debug=pict

--vd-lavc-show-all=<yes|no>

Show even broken/corrupt frames (default: no). If this option is set to no, libavcodec won't output frames that were either decoded before an initial keyframe was decoded, or frames that are recognized as corrupted.
显示即使损坏/损坏的帧（默认：否）。如果此选项设置为否，libavcodec 不会输出在初始关键帧解码之前解码的帧，或者被识别为损坏的帧。

--vd-lavc-skiploopfilter=<skipvalue> (H.264, HEVC only)   --vd-lavc-skiploopfilter=<skipvalue> （H.264, 仅 HEVC）

Skips the loop filter (AKA deblocking) during decoding. Since the filtered frame is supposed to be used as reference for decoding dependent frames, this has a worse effect on quality than not doing deblocking on e.g. MPEG-2 video. But at least for high bitrate HDTV, this provides a big speedup with little visible quality loss. Codecs other than H.264 or HEVC may have partial support for this option (often only all and none).
在解码过程中跳过环路滤波器（又称去块）。由于滤波后的帧应作为解码依赖帧的参考，因此这比在例如 MPEG-2 视频上不进行去块对质量的影响更差。但至少对于高比特率 HDTV，这可以提供很大的速度提升，同时几乎看不到质量损失。除了 H.264 或 HEVC 之外的编解码器可能对此选项有部分支持（通常只有 all 和 none ）。

<skipvalue> can be one of the following:
<skipvalue> 可以是以下之一：

none:	Never skip.  从不跳过。
default:  默认：	Skip useless processing steps (e.g. 0 size packets in AVI). 跳过无用的处理步骤（例如 AVI 中的 0 大小数据包）。
nonref:	Skip frames that are not referenced (i.e. not used for decoding other frames, the error cannot "build up"). 跳过未引用的帧（即未用于解码其他帧，错误无法“累积”）。
bidir:	Skip B-Frames.  跳过 B 帧。
nonkey:  非关键帧：	Skip all frames except keyframes. 跳过所有帧，除了关键帧。
all:	Skip all frames.  跳过所有帧。

--vd-lavc-skipidct=<skipvalue> (MPEG-1/2/4 only)   --vd-lavc-skipidct=<skipvalue> (仅 MPEG-1/2/4)

Skips the IDCT step. This degrades quality a lot in almost all cases (see skiploopfilter for available skip values).
跳过 IDCT 步骤。在几乎所有情况下都会严重降低质量（参见 skiploopfilter 以获取可跳过的值）。

--vd-lavc-skipframe=<skipvalue>

Skips decoding of frames completely. Big speedup, but jerky motion and sometimes bad artifacts (see skiploopfilter for available skip values).
完全跳过帧的解码。大幅提升速度，但动作可能不流畅，有时出现不良伪影（参见 skiploopfilter 了解可用的跳过值）。

--vd-lavc-framedrop=<skipvalue>

Set framedropping mode used with --framedrop (see skiploopfilter for available skip values).
设置与 --framedrop 一起使用的 framedropping 模式（有关可用的 skip 值，请参阅 skiploopfilter）。

--vd-lavc-threads=<N>

Number of threads to use for decoding. Whether threading is actually supported depends on codec (default: 0). 0 means autodetect number of cores on the machine and use that, up to the maximum of 16. You can set more than 16 threads manually.
用于解码的线程数。是否实际支持线程取决于编解码器（默认：0）。0 表示自动检测机器上的核心数并使用该数，最多为 16。您可以手动设置超过 16 个线程。

--vd-lavc-assume-old-x264=<yes|no>

Assume the video was encoded by an old, buggy x264 version (default: no). Normally, this is autodetected by libavcodec. But if the bitstream contains no x264 version info (or it was somehow skipped), and the stream was in fact encoded by an old x264 version (build 150 or earlier), and if the stream uses 4:4:4 chroma, then libavcodec will by default show corrupted video. This option sets the libavcodec x264_build option to 150, which means that if the stream contains no version info, or was not encoded by x264 at all, it assumes it was encoded by the old version. Enabling this option is pretty safe if you want your broken files to work, but in theory this can break on streams not encoded by x264, or if a stream encoded by a newer x264 version contains no version info.
"假设视频是由旧版、有缺陷的 x264 版本编解码的（默认：否）。通常，这由 libavcodec 自动检测。但如果比特流不包含 x264 版本信息（或它被某种方式跳过），并且实际上是由旧版 x264 版本（构建 150 或更早）编解码的，并且如果流使用 4:4:4 色度，那么 libavcodec 默认会显示损坏的视频。此选项将 libavcodec x264_build 选项设置为 150 ，这意味着如果流不包含版本信息，或者根本不是由 x264 编解码的，它假定是由旧版本编解码的。如果您希望损坏的文件能够工作，启用此选项相当安全，但从理论上讲，这可能会在不是由 x264 编解码的流上中断，或者如果由较新版本的 x264 编解码的流不包含版本信息。

--vd-apply-cropping

Certain video codecs support cropping, meaning that only a sub-rectangle of the decoded frame is intended for display. This option controls how cropping is handled by libavcodec. Cropping during decoding has certain limitations with regards to alignment and hardware decoding. If this option is enabled, decoder will apply the crop, else VO will handle it. Enabled by default.
某些视频编解码器支持裁剪，这意味着仅对解码帧的子矩形进行显示。此选项控制 libavcodec 如何处理裁剪。解码过程中的裁剪在对齐和硬件解码方面存在某些限制。如果启用此选项，解码器将应用裁剪，否则 VO 将处理。默认启用。

--swapchain-depth=<N>

Allow up to N in-flight frames. This essentially controls the frame latency. Increasing the swapchain depth can improve pipelining and prevent missed vsyncs, but increases visible latency. This option only mandates an upper limit, the implementation can use a lower latency than requested internally. A setting of 1 means that the VO will wait for every frame to become visible before starting to render the next frame. (Default: 3)
允许最多 N 个正在传输的帧。这实际上控制了帧延迟。增加 swapchain 深度可以提高流水线和防止错过 vsync，但会增加可见延迟。此选项仅强制规定上限，实现可以使用比请求的内部延迟更低的延迟。设置为 1 表示 VO 将在开始渲染下一帧之前等待每个帧变得可见。（默认：3）