linus/mpv.net

Fork 0

Files

hooke007 a3f6b105de doc-manual:chs

2021-06-27 01:26:39 +08:00

36 KiB

Raw Blame History

mpv.net手册

同步源提交_20210623_1c23c10

关于

mpv.net是基于受欢迎的mpv的Windows现代媒体播放器。

mpv.net出于兼容mpv而设计，几乎所有mpv的功能都可用，因为它们都包含在libmpv中，这意味着mpv官方手册也适用于mpv.net。

mpv专注命令行与终端的使用，而mpv.net保留了这些并加入了现代化的图形界面。

下载

更新日志

稳定版

发布页面

测试版

OneDrive

DropBox

安装

mpv.net需要.NET Framework 4.8运行库和高于win7版本的系统以及一张不太旧的显卡。

安装版和便携版可供下载。

安装新版本之前应完全卸载旧版本，使用旧版本覆盖安装新版本通常不是推荐的做法，安装工具不强制执行这项操作，因为它难以实现。

对于网络串流，必须手动下载安装youtube-dl，它必须位于环境变量 PATH 或启动目录中。

mpv.net不限制系统平台，win32的用户必须替换目录中的4个工具:

Everything.dll
mpv-1.dll
MediaInfo.dll
mpvnet.com

文件关联

可以使用上下文菜单创建文件关联。 'Tools > Setup'

注册完文件关联后，进入 "Windows设置 > 应用 > 默认应用"，或者从powershell 执行 ms-settings:defaultapps ，然后选择mpv. net作为视频/音频/图像的默认程序。

可以使用资源管理器的上下文菜单的'Open with'功能更改默认应用程序。

Open with++ 可用来扩展资源管理器的上下文菜单 Play with mpv.net 和 Add to mpv.net playlist. 可用来获取 'Play with mpv.net' 和 'Add to mpv.net playlist' 的菜单子项

当在资源管理器中选择多个文件并按 enter 键时，文件会在mpv.net随机排序打开，最多限制15个文件。

支持

在提出支持请求之前，先尝试最新的测试版。

程序错误和功能请求可以在github的问题追踪上提出，任何与mpv. net相关的东西都可以使用，欢迎提交使用上出现的问题。

或者浏览VideoHelp论坛的讨论帖。 support thread

设置

mpv.net在以下路径寻找设置文件夹：

<程序启动目录>\portable_config
%APPDATA%\mpv.net

弱使用自定义目录，则创建以下文件：

<程序启动目录>\settings-directory.txt

并在此文件中输入你的自定义路径。

自定义目录路径可以使用相对路径： startup\...

只有在 portable_config 和 %APPDATA% 目录不存在的情况下，才可使用此自定义路径。

如果设置目录中不存在 mpv.conf ，将使用以下文件生成默认的初始设置：

mpv.conf defaults

mpv.net的专属选项保存在 mpvnet.conf 文件中，参数解释请参阅此处.

快捷键输入绑定

键鼠的快捷键和上下文菜单的操作保存在 input.conf 文件中，如果设置目录中不存在，将使用以下文件生成默认的初始设置：

input.conf defaults

通过 global-input.conf 文件支持全局热键。

配置文件夹可以从上下文菜单中打开： Settings > Open Config Folder

命令行界面

mpvnet [options] [file|URL|PLAYLIST|-]
mpvnet [options] files

mpv的参数与mpv.net共通，例如：

启用窗口装饰：

--border or --border=yes

禁用窗口装饰：

--no-boder or --border=no

所有支持的mpv属性，参阅此处：

https://mpv.io/manual/master/#properties

mpv.net可以使用以下功能列出所有属性：

'Context Menu > View > Show Properties'

mpv.net通常不支持非属性的运行时状态切换！

终端

当mpv. net从终端启动时，它将输出状态、错误和调试消息，并接受终端的输入。

在菜单中的 'Tools > Setup' 可以将mpv.net添加到环境变量PATH。

A common task for the terminal is debugging scripts.

mpv.net的专属选项

这些专属选项可以在 conf editor 中使用关键词 "mpv.net" 检索。

这些专属选项被修改后被保存在 mpvnet.conf 文件中。

--queue <files>

添加文件到播放列表，需要设置 --process-instance=single 。也可以在资源管理器中使用 Open with++ 添加文件。

--command=<input command>

发送一个输入命令。用于从命令行控制mpv.net，例如使用 AutoHotkey 创建全局热键，必须设置 process-instance=single 。空格必须用引号转义，引号必须用双引号转义。

Audio

--remember-volume=<yes|no>

在程序退出时保存音量并静音，在启动时恢复之前的音量。默认：yes

Screen

--start-size=<value>

设置为记住窗口大小。

video
窗口大小设置为视频分辨率。

width-session
记住当前的宽度。

width-always
始终记住宽度。

height-session
记住当前的高度。（默认值）

height-always
始终记住高度。

always
始终记住大小。

--start-threshold=<milliseconds>

在显示窗口之前等待libmpv返回视频分辨率的阈值（毫秒），否则将使用由 --autofit 和 --start-size 定义的初始大小。默认：1500

--minimum-aspect-ratio=<float>

最小宽高比，如果窗口宽高比小于定义的值，那么将窗口宽高比设置为16/9。这避免了音乐封面的方形窗口。默认：1.2

--remember-window-position=<yes|no>

在退出时保存窗口的位置。默认：no

Playback

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

打开单个文件时，自动将整个目录加载到播放列表中。可以通过 shift 键临时禁用。默认：yes

General

--update-check=<yes|no>

每日检查新版本（需要 PowerShell 5 和 curl）。默认：no

--process-instance=<value>

定义是否允许多个 mpv.net 进程。

提示：当打开文件或 url 时，只要按下CTRL键，就不会清除当前的播放列表，而只将文件或 url 追加到列表中。这不仅适用于进程启动，也适用于所有打开文件和 url 的功能。

multi
每次从 shell 启动 mpv.net 时创建一个新进程。

single
每次从 shell 启动 mpv.net 只允许唯一一个进程。（默认值）

queue
和 single 类似但会把文件追加到已打开的mpv.net的播放列表中。

--recent-count=<int>

最近文件的记录数量。默认：15

--video-file-extensions=<string>

用于创建文件关联的视频文件扩展名，由自动加载文件夹的功能使用。

--audio-file-extensions=<string>

用于创建文件关联的音频文件扩展名，由自动加载文件夹的功能使用。

--image-file-extensions=<string>

用于创建文件关联的图片文件扩展名，由自动加载文件夹的功能使用。

--debug-mode=<yes|no>

只有在开发人员要求时才启用此选项。默认：no

UI

--dark-mode=<value>

启用深色模式.

always
始终（默认值）

system
跟随系统。（需要win10及以上的系统）

never 从不

---dark-theme=<string>

深色模式中使用的配色主题。默认：dark

配色主题

--light-theme=<string>

浅色模式中使用的配色主题。默认：light

配色主题

外部工具

Play with mpv

Play with mpv 是一个支持调用mpv播放YouTube等网站视频的谷歌浏览器的扩展。

由于Chrome扩展无法启动一个应用程序，需要另一个与扩展程序通信的应用程序，该程序可以从此处下载。只有当该程序运行时扩展才能正常工作，为了让应用程序始终运行，应将其放在系统自启动目录中：

C:\Users\%username%\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup

这将使该程序随系统共同启动，并在后台运行。当mpv.net的文件关联注册被执行后，该程序应该会找到mpv.net的位置，或者将mpv.net文件夹添加到环境变量PATH。

Open With

或者可以使用Chrome/Firefox扩展 Open With 。

Open with++

Open with++ 可用来扩展资源管理器的上下文菜单 Play with mpv.net 和 Add to mpv.net playlist. 可用来获取 'Play with mpv.net' 和 'Add to mpv.net playlist' 的菜单子项

Universal Remote

Universal Remote 是一个收费的安卓远程控制app。

https://www.unifiedremote.com

https://play.google.com/store/apps/details?id=com.Relmtech.Remote

https://play.google.com/store/apps/details?id=com.Relmtech.RemotePaid

https://www.unifiedremote.com/tutorials/how-to-create-a-custom-keyboard-shortcuts-remote

https://www.unifiedremote.com/tutorials/how-to-install-a-custom-remote

我的配置

脚本

Lua

文件类型： lua

文件位置： <config folder>\scripts

Lua脚本的host由libmpv内建。

没有调试支持，只有错误和调试消息输出在终端上。

Lua脚本在第一个媒体文件打开之前加载。

mpv Lua 文档

mpv用户脚本

JavaScript

文件类型： js

文件位置： <config folder>\scripts

JavaScriptLua脚本的host由libmpv内建。

没有调试支持，只有错误和调试消息输出在终端上。

JavaScript脚本在第一个媒体文件打开之前加载。

mpv JavaScript 文档

mpv用户脚本

PowerShell

文件类型： ps1

文件位置： <config folder>\scripts-ps

PS脚本的host类似于扩展，在打开媒体文件前尚未初始化。

mpv.net没有定义脚本接口，而是公开了它的完整内部，没有兼容性保证。

示例脚本

C#

文件类型： cs

文件位置： <config folder>\scripts-cs

mpv.net没有定义脚本接口，而是公开了它的完整内部，没有兼容性保证。

脚本代码可以在C#扩展中编写，这样就可以获得完整的代码和调试器支持。一旦代码被调试和开发完成，就可以将其从扩展转移到轻量级的独立脚本。

C#脚本的host类似于扩展，在打开媒体文件前尚未初始化。

示例脚本

扩展

扩展位于设置目录的子文件夹 'extensions' 中，文件名必须与上级文件夹具有相同的名称：

<config folder>\extensions\ExampleExtension\ExampleExtension.dll

mpv.net没有定义脚本接口，而是公开了它的完整内部，没有兼容性保证。

创建扩展演示

下载安装 Visual Studio Community 。
创建新的项目类型 Class Library .NET Framework 并确保项目名称以 Extension 作结尾。
Add a reference to System.ComponentModel.Composition.
Add a reference to mpvnet.exe, select the mpvnet reference in the Solution Explorer, open the Properties window and set Copy Local to false to prevent mpvnet.exe being copied to the output directory when the project is built.
Now open the project properties and set the output path in the Build tab, extensions are like scripts located in your config folder, example: <config folder>\extensions\ExampleExtension\ExampleExtension.dll
Also in the project properties choose the option Start external program in the Debug tab and define the path to mpvnet.exe. In the Debug tab you may also define command line arguments like a video file to be played when you start debugging.

代码样本

RatingExtension

当mpv.net关闭时，这个扩展程序会对分级视频的文件名进行记录。

'input.conf defaults' 包含了用于设置评级扩展的键位绑定。

源码

配色主题

mpv.net支持自定义配色主题，内置主题的定义可以在以下文件中查看：

theme.txt

自定义的配色方案保存在以下文件中：

<conf folder>\theme.conf

theme.conf 文件可包含无限量的主题。

在 config editor 的 UI 词条中存在 dark-theme 和 light-theme 的设置来定义主题应用在深色/浅色模式。

高级功能

播放 VapourSynth 脚本

播放vpy文件的功能受 mpv.conf 中的以下参数支持：

[extension.vpy]
demuxer-lavf-format = vapoursynth

Python和VapourSynth必须在环境变量PATH中。

隐藏功能

使用mpv.net在资源管理器中选择多个文件并按下回车键打开。资源管理器将此限制为最多15个并且顺序将是随机的。

当打开文件或url时，只要按下CTRL键，就不会清除播放列表，而是将文件或url附加到播放列表中。这适用于mpv.net的所有打开文件或url的功能。

在打开单个文件时按下SHIFT键将禁止该文件夹的其它文件添加到播放列表中。

在全屏模式下点击顶部右上角关闭播放器。

与mpv的差异

mpv.net被设计的和mpv大体一致，但是有一些限制：

窗口限制

mpv.net实现了一个自己的主窗口，这意味着只有在mpv.net中有自己实现的mpv窗口功能才受支持。

当前不支持无窗口模式，即使从终端启动mpv.net并播放音乐，主窗口也始终可见。

mpv窗口特性的文档可以在此处找到：

https://mpv.io/manual/master/#window

mpv.net目前已实现了以下窗口属性：

部分支持的属性：

autofit

autofit-smaller

autofit-larger

命令行限制

mpv.net支持基于属性的mpv命令行选项，这意味着它支持mpv几乎所有的命令行选项。

不支持的是非基于属性的选项。它们在mpv.net中有自己的实现，到目前为止实现的有：

--ad=help
--audio-device=help
--input-keylist
--profile=help
--vd=help
--version

mpv.net的专属选项

在config editor中输入 'mpv.net' 检索这些选项，在此处的手册中有对应说明。

mpv.net的专属选项保存在 'mpvnet.conf' 文件中，与mpv一样可由命令行界面获取。

技术概览

mpv.net使用 C#7 编写并且需要 .NET Framework 4.8 来运行。

扩展的实现基于 Managed Extensibility Framework.

主窗口基于WinForms，与WPF相比对libmpv集成的更友好，所有其他窗口都是基于WPF的。

配置编辑器动态的添加控件，并使用 TOML 定义内容。

使用的第三方组件：

上下文菜单

mpv.net的上下文菜单由设置目录中的文件 input.conf 定义。

如果 input.conf 文件不存在，mpv.net由以下文件生成默认：

https://github.com/stax76/mpv.net/tree/master/src/Resources/input.conf.txt

input.conf 定义mpv的快捷键，同时mpv.net使用注释定义上下文菜单。

Open > Open Files

The Open Files menu entry is one way to open files in mpv.net, it supports multi selection.

Another way to open files is the command line which is used by File Explorer for existing associations.

A third way is to drag and drop files on the main window.

Whenever the control key is pressed when files or URLs are opened, the playlist is not cleared but the files or URLs are appended to the playlist. This works in all mpv.net features that open files or URLs.

Pressing the shift key while opening a single file will suppress loading all files in the folder.

Blu-ray and DVD ISO image files are supported.

Open > Open URL or file path from clipboard

Opens files and URLs from the clipboard. How to open URLs directly from the browser from sites like YouTube is described in the External Tools section.

For internet streaming youtube-dl must be downloaded and installed manually, meaning it must be located in the PATH environment variable or in the startup directory.

Open > Open DVD/Blu-ray Drive/Folder

Opens a DVD/Blu-ray Drive/Folder.

Open > Show media search

mpv.net supports system wide media searches using the Everything indexing service installed by the popular file search tool Everything.

Open > Load external audio files

Allows to load an external audio file. It's also possible to auto detect external audio files based on the file name, the option for this can be found in the settings under 'Settings > Show Config Editor > Audio > audio-file-auto'.

Open > Load external subtitle files

Allows to load an external subtitle file. It's also possible to auto detect external subtitle files based on the file name, the option for this can be found in the settings under 'Settings > Show Config Editor > Subtitles > sub-auto'.

Play/Pause

Play/Pause using the command:

cycle pause

cycle command

pause property

Stop

Stops the player and unloads the playlist using the command:

stop

stop command

Toggle Fullscreen

Toggles fullscreen using the command:

cycle fullscreen

cycle command

fullscreen property

Navigate > Previous File

Navigates to the previous file in the playlist using the command:

playlist-prev

playlist-prev command

Navigate > Next File

Navigates to the next file in the playlist using the command:

playlist-next

playlist-next command

Navigate > Next Chapter

Navigates to the next chapter using the command:

add chapter 1

36 KiB Raw Blame History Unescape Escape

mpv.net手册

目录

关于

下载

稳定版

测试版

安装

文件关联

支持

设置

快捷键输入绑定

命令行界面

终端

mpv.net的专属选项

--queue <files>

--command=<input command>

Audio

--remember-volume=<yes|no>

Screen

--start-size=<value>

--start-threshold=<milliseconds>

--minimum-aspect-ratio=<float>

--remember-window-position=<yes|no>

Playback

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

General

--update-check=<yes|no>

--process-instance=<value>

--recent-count=<int>

--video-file-extensions=<string>

--audio-file-extensions=<string>

--image-file-extensions=<string>

--debug-mode=<yes|no>

UI

--dark-mode=<value>

---dark-theme=<string>

--light-theme=<string>

外部工具

Play with mpv

Open With

Open with++

Universal Remote

脚本

Lua

JavaScript

PowerShell

C#

扩展

创建扩展演示

代码样本

RatingExtension

配色主题

高级功能

播放 VapourSynth 脚本

隐藏功能

与mpv的差异

窗口限制

命令行限制

mpv.net的专属选项

技术概览

上下文菜单

Open > Open Files

Open > Open URL or file path from clipboard

Open > Open DVD/Blu-ray Drive/Folder

Open > Show media search

Open > Load external audio files

Open > Load external subtitle files

Play/Pause

Stop

Toggle Fullscreen

Navigate > Previous File

Navigate > Next File

Navigate > Next Chapter

Navigate > Previous Chapter

Navigate > Jump Next Frame

Navigate > Jump Previous Frame

Navigate > Jump

Pan & Scan > Increase Size

Pan & Scan > Decrease Size

36 KiB

Raw Blame History