diff --git a/docs/Manual_chs.md b/docs/Manual_chs.md index 579a991..778d9ad 100644 --- a/docs/Manual_chs.md +++ b/docs/Manual_chs.md @@ -2,7 +2,7 @@ mpv.net手册 ============== -同步源提交_[20211114](https://github.com/stax76/mpv.net/commit/243b45326ef8defa038edacd01fafee13f6a009a#diff-bf7b5e59783955f479505de4969f792255eca0a69945ccfe3ec5dda409495bbe) +同步源提交_[20220402](https://github.com/stax76/mpv.net/commit/27dc98af2195622d3443cc048b3c856c5238b9f5) **[ENGLISH](Manual.md)** | **简体中文** @@ -15,8 +15,10 @@ mpv.net手册 * [支持](#支持) * [设置](#设置) * [快捷键和上下文菜单](#快捷键和上下文菜单) +* [命令面板](#命令面板) * [命令行界面](#命令行界面) * [终端](#终端) +* [mpv.net的专属命令](#mpvnet的专属命令) * [mpv.net的专属选项](#mpvnet的专属选项) * [外部工具](#外部工具) * [脚本](#脚本) @@ -57,7 +59,8 @@ mpv专注命令行与终端的使用，而mpv.net保留了这些并加入了现 mpv.net需要.NET Framework 4.8运行库和高于win7版本的系统以及一张不太旧的显卡。 -对于网络串流，必须手动下载安装yt-dlp，它必须位于环境变量 PATH 或启动目录中。 +对于来自YouTube和类似网站的网络流，必须将yt-dlp复制到mpv.net的文件夹中， +或编辑用户环境变量PATH，使其包括yt-dlp的文件夹。 #### 文件关联 @@ -66,14 +69,16 @@ mpv.net需要.NET Framework 4.8运行库和高于win7版本的系统以及一张 注册完文件关联后，进入 "Windows设置 > 应用 > 默认应用" (Win+I, ms-settings:defaultapps) 然后选择mpv. net作为视频/音频/图像的默认程序。 -另一种注册文件关联的方式是使用文件资源管理器，选中媒体文件后，选择上下文菜单的 '打开方式 > 选择其它应用' 。 +另一种注册文件关联的方式是使用文件资源管理器，选中媒体文件后， +选择上下文菜单的 '打开方式 > 选择其它应用' 。 [Open with++](#open-with) 可用来扩展资源管理器的上下文菜单 [Play with mpv.net](https://github.com/stax76/OpenWithPlusPlus#play-with-mpvnet) 和 [Add to mpv.net playlist](https://github.com/stax76/OpenWithPlusPlus#add-to-mpvnet-playlist). 可用来获取 'Play with mpv.net' 和 'Add to mpv.net playlist' 的菜单子项 -当在资源管理器中选择多个文件并按 enter 键时，文件会在mpv.net随机排序打开，最多限制15个文件。 +当在资源管理器中选择多个文件并按 enter 键时，文件会在mpv.net随机排序打开， +最多限制15个文件。 支持 @@ -104,9 +109,7 @@ mpv.net的专属选项保存在 mpvnet.conf 文件中， ---------------------- 键鼠的快捷键和上下文菜单的操作保存在 input.conf 文件中， -如果设置目录中不存在，将使用以下文件生成默认的初始设置： - -[input.conf defaults](../../../tree/master/src/Resources/input.conf.txt) +如果设置目录中不存在，mpv.net会用默认值生成它。 请注意，一旦 input.conf 存在， mpv.net 就不能更新它，这意味着当 mpv.net 升级了 新的版本或改变了的默认菜单项时，菜单条目就会过时。获得最新菜单的唯一方法是 @@ -136,6 +139,35 @@ mpv的input选项： https://mpv.io/manual/master/#input +命令面板 +--------------- + +命令面板能用来快速查找、选择和执行命令。 + +它也可以用来方便的找到快捷键。 + +命令面板提供了以下功能： + +- 以不同方式显示 mediainfo +- 显示和选择音轨 +- 显示和选择字幕轨 +- 显示和选择播放列表的文件 +- 显示和选择最近的文件 +- 显示可用的mpv属性 +- 显示可用的解码器 +- 显示可用的解复用器 +- 显示可用的按键 +- 显示可用的协议 + +| 按键 | 动作 | +| ----- | -------------- | +| F1 | 显示命令面板 | +| Esc | 隐藏命令面板 | +| Enter | 执行所选的条目 | +| Up | 光标向上移动 | +| Down | 光标向下移动 | + + 命令行界面 ---------------------- @@ -161,12 +193,12 @@ mpv的参数与mpv.net共通，例如： https://mpv.io/manual/master/#properties -mpv.net可以使用以下功能列出所有属性： +mpv.net可以使用以下功能列出所有可用的属性： -'Context Menu > View > Show Properties' +_Context Menu > View > Advanced > Show Properties_ -mpv.net通常不支持非属性的运行时状态切换！ +mpv有一些基于非属性的开关，在mpv.net中一般不受支持。 终端 @@ -174,11 +206,143 @@ mpv.net通常不支持非属性的运行时状态切换！ 当mpv. net从终端启动时，它将输出状态、错误和调试消息，并接受终端的输入。 -在菜单中的 'Tools > Setup' 可以将mpv.net添加到环境变量PATH。 - 终端的常见用处是脚本调试。 +mpv.net的专属命令 +------------------------- + +`script-message mpv.net ` + +mpv.net命令可在mpv命令不存在或缺乏某种功能时使用。 + +### cycle-audio +切换到下一个音轨并显示该音轨的信息。 + +### load-audio +显示一个资源管理器的对话框来加载外部音频文件。 + +### load-sub +显示一个资源管理器的对话框来加载外部字幕文件。 + +### open-conf-folder +用Windows资源管理器打开配置文件夹。 + +### open-files [\] +**no-folder** +对于单个文件，防止将文件夹内的全部文件加载到播放列表中。 + +**append** +追加文件到播放列表中。 + +打开一个资源管理器的对话框，以便选择要打开的文件。资源管理器的对话框支持多选以 +一次性加载多个文件。按住CTRL键可以将这些文件追加到播放列表中。 + +### open-optical-media +显示一个资源管理器的对话框来打开一个DVD或BD文件夹。ISO镜像不需要被挂载， +但可以直接用 open-files 命令打开。 + +### open-clipboard +从剪贴板打开单个的URL或文件路径，或以文件剪贴板中的格式打开多个文件。 + +### play-pause +循环切换 pause 的属性。如果播放列表为空，将加载最近文件列表中的最新文件。 + +### playlist-first +跳转到播放列表的第一个条目，如果加载的文件已经是第一个条目，则无动作。 + +### playlist-last +跳转到播放列表的最后一个条目，如果加载的文件已经是最后一个条目，则无动作。 + +### reg-file-assoc \ +注册文件关联。 + +### scale-window \ +减小或增大窗口的尺寸。 + +### shell-execute \ +Shell执行单个文件或URL。 + +### show-about +显示 "关于" 的对话框。 + +### show-audio-devices +在一个信息框中显示可用的音频设备。 + +### show-audio-tracks +在命令面板中显示可用的音轨，并允许加载选中的音轨。 + +### show-command-palette +显示命令面板。 + +### show-commands +显示可用的mpv输入命令。 + +### show-conf-editor +显示配置编辑器。 + +### show-decoders +显示可用的解码器。 + +### show-demuxers +显示可用的解复用器。 + +### show-history +显示已有的历史文件。 + +### show-info +显示一个简易的文件信息。 + +### show-input-editor +显示器快捷键编辑器。 + +### show-keys +在命令面板中显示可用的按键。（与 `--input-keylist` 显示的内容一致） + +### show-media-info [\] +**msgbox** +在一个信息框中显示mediainfo + +**editor** +在一个文本编辑器中显示mediainfo + +**full** +显示mediainfo的完整细节 + +**raw** +显示带有原始属性名的mediainfo + +### show-menu +显示上下文菜单。 + +### show-playlist +在命令面板中显示播放列表，并允许播放选中的条目。 + +### show-profiles +用一个信息框显示可用的profile + +### show-progress +显示一个简易的OSD进度条信息。 + +### show-properties +在命令面板中显示可用的属性，并允许显示所选属性的值。 + +### show-protocols +在命令面板中显示可用的协议。 + +### show-recent +在命令面板中显示最近播放的文件和URL，并允许选择和播放条目。 + +### show-subtitle-tracks +在命令面板中显示可用的字幕轨，并允许激活选中的字幕。 + +### show-text \ \ \ +显示一个具有指定文本、持续时间和字体大小的OSD信息。 + +### window-scale \ +职能类似于mpv的属性 [window-scale](https://mpv.io/manual/master/#command-interface-window-scale) + + mpv.net的专属选项 ------------------------ @@ -255,6 +419,11 @@ mpv.net的专属选项 打开单个文件时，自动将整个目录加载到播放列表中。可以通过 shift 键临时禁用。默认：yes +#### --auto-play=\ + +如果在播放器暂停时，加载另一个文件，会自动恢复播放。 + + ### General #### --process-instance=\ @@ -315,7 +484,7 @@ mpv.net的专属选项 从不 -#### ---dark-theme=\ +#### --dark-theme=\ 深色模式中使用的配色主题。默认：dark @@ -329,6 +498,11 @@ mpv.net的专属选项 [配色主题](#配色主题) +#### --show-logo=\ + +在原始OSC标志的基础上绘制蓝色的mpvnet图标。更改将在应用程序重新启动后生效。默认：yes + + 外部工具 -------------- @@ -385,6 +559,15 @@ Universal Remote 的 File Browser 功能十分有用。 Philips code 0556 和 FLIRC USB (gen2) 一同被使用。 +### External Application Button + +视频可以通过Chrome扩展程序的外部应用按钮进行流式传输或轻松下载，对于下载（推荐）： + +path: `wt` + +args: `-- pwsh -NoLogo -Command "yt-dlp --ignore-errors --download-archive 'C:\External Application Button.txt' --output 'C:\YouTube\%(channel)s - %(title)s.%(ext)s' ('[HREF]' -replace '&list=.+','')"` + + 脚本 --------- @@ -396,13 +579,17 @@ Philips code 0556 和 FLIRC USB (gen2) 一同被使用。 Lua脚本的host由libmpv内建。 -没有调试支持，只有错误和调试消息输出在终端上。 +错误和调试消息输出在终端上。 Lua脚本在第一个媒体文件打开之前加载。 [mpv Lua 文档](https://mpv.io/manual/master/#lua-scripting) -[mpv用户脚本](https://github.com/mpv-player/mpv/wiki/User-Scripts) +[mpv 用户脚本 wiki](https://github.com/mpv-player/mpv/wiki/User-Scripts) + +[mpv 用户脚本 GitHub](https://github.com/topics/mpv-script) + +[mpv 用户脚本 Google](https://www.google.com/search?q=mpv+script) #### JavaScript @@ -413,7 +600,7 @@ Lua脚本在第一个媒体文件打开之前加载。 JavaScriptLua脚本的host由libmpv内建。 -没有调试支持，只有错误和调试消息输出在终端上。 +错误和调试消息输出在终端上。 JavaScript脚本在第一个媒体文件打开之前加载。 @@ -445,6 +632,7 @@ mpv.net没有定义脚本接口，而是公开了它的完整内部，没有兼 脚本代码可以在C#[扩展](../../../tree/master/src/Extensions)中编写，这样就可以获得 完整的代码和调试器支持。一旦代码被调试和开发完成，就可以将其从扩展转移到轻量级的独立脚本。 +脚本host使用的是旧的C#版本，像字符串插值这样的现代功能是不存在的。 C#脚本的host类似于[扩展](../../../tree/master/src/Extensions)，在打开媒体文件前尚未初始化。