Merge pull request #400 from hooke007/dev

update manual_chs for v5.8.0.0
2022-04-05 19:55:19 +02:00
parent 27dc98af21 88e5628d7b
commit 1bc6fb9509
1 changed files with 204 additions and 16 deletions
--- 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 <command> <arguments>`
+
+mpv.net命令可在mpv命令不存在或缺乏某种功能时使用。
+
+### cycle-audio
+切换到下一个音轨并显示该音轨的信息。
+
+### load-audio
+显示一个资源管理器的对话框来加载外部音频文件。
+
+### load-sub
+显示一个资源管理器的对话框来加载外部字幕文件。
+
+### open-conf-folder
+用Windows资源管理器打开配置文件夹。
+
+### open-files [\<flags\>]
+**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 \<audio|video|image\>
+注册文件关联。
+
+### scale-window \<factor\>
+减小或增大窗口的尺寸。
+
+### shell-execute \<file|URL\>
+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 [\<flags\>]
+**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 \<text\> \<duration\> \<font-size\>
+显示一个具有指定文本、持续时间和字体大小的OSD信息。
+
+### window-scale \<factor\>
+职能类似于mpv的属性 [window-scale](https://mpv.io/manual/master/#command-interface-window-scale)
+
+
 mpv.net的专属选项
 ------------------------

@@ -255,6 +419,11 @@ mpv.net的专属选项
 打开单个文件时，自动将整个目录加载到播放列表中。可以通过 shift 键临时禁用。默认：yes


+#### --auto-play=\<yes|no\>
+
+如果在播放器暂停时，加载另一个文件，会自动恢复播放。
+
+
 ### General

 #### --process-instance=\<value\>
@@ -315,7 +484,7 @@ mpv.net的专属选项
 从不


-#### ---dark-theme=\<string\>
+#### --dark-theme=\<string\>

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

@@ -329,6 +498,11 @@ mpv.net的专属选项
 [配色主题](#配色主题)


+#### --show-logo=\<yes|no\>
+
+在原始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)，在打开媒体文件前尚未初始化。