本文为《PVE安装Kodi》系列文章的一部分。
本文同步发表在我的个人博客https://evine.win。
- PVE 直接安装最新版 Kodi
- 为Kodi适配遥控器
- 修改Kodi字幕字体
- 修改Kodi皮肤字体
- 屏蔽Kodi的关机、重启按钮
- 设置Kodi启动的前置条件
- 像使用盒子/LibreELEC一样使用PVE直装的Kodi，实现遥控器启停
- kodi-send使用相关说明
- 转换遥控器的退出键为返回键
说明
kodi-send命令是Kodi自带命令行工具，可以安全的操控Kodi，除了下文使用的Quit指令，还有很多指令可以使用，方便想要自动化操作的人来使用，具体可用的指令见：Action_IDs 及 List_of_built-in_functions 。
安装
请先按照 PVE 直接安装最新版 Kodi 教程添加好
deb-multimedia软件源。
kodi-send命令需要安装kodi-eventclients-common（如果未启用deb-multimedia源，则需要安装debian官方源中的kodi-eventclients-kodi-send）：
apt install kodi-eventclients-common
如果是从backports源中安装的Kodi，那么也要从backports源中安装kodi-eventclients-common（假如是PVE 7，对应debian的bullseys版本）：
apt install -t bullseye-backports kodi-eventclients-common
设置
如需要使用kodi-send命令，需要在“Kodi设置->服务->控制”处勾选“允许通过本机应用远程控制”。
使用
输入kodi-send --help即可查看。
Usage
kodi-send [OPTION] --action=ACTION
kodi-send [OPTION] --button=BUTTON
Example
kodi-send --host=192.168.0.1 --port=9777 --action="Quit"
Options
-?, --help Will bring up this message
--host=HOST Choose what HOST to connect to (default=localhost)
--port=PORT Choose what PORT to connect to (default=9777)
--keymap=KEYMAP Choose which KEYMAP to use for key presses (default=KB)
--button=BUTTON Sends a key press event to Kodi, this option can be added multiple times to create a macro
-a ACTION, --action=ACTION Sends an action to XBMC, this option can be added multiple times to create a macro
-d T, --delay=T Waits for T ms, this option can be added multiple times to create a macro
如需对本机安装的Kodi执行退出，如果Kodi是默认的状态，直接输入以下命令即可（-a/--action二者都可以，带不带=都行）：
kodi-send -a "Quit"
kodi-send --action="Quit"
或者只是调出退出菜单，而不是直接退出（如果遥控器的电源键没有被evsieve劫持的话，电源键在Kodi中倒是原本就是调出退出菜单，不过被evsieve劫持之后就得就这种方式曲线还原了）：
# 直接调出退出菜单，只能调出，无法切出
kodi-send -a "ActivateWindow(shutdownmenu)"
# 用命令模拟按下sleep/power按键，以下两个命令作用同上，只能调出，无法切出
kodi-send --button="sleep"
kodi-send --button="power"
# 用命令模拟按下键盘的s键，键盘的s键作用也是调出退出菜单
# 相比上面的几个命令，当退出菜单已经调出时再次运行本命令可以切出退出菜单
# 而若是Kodi正处于输入文字的界面时，此命令只会真的打出“s”，调不出退出菜单
kodi-send --button="s"
注：以上命令均在Kodi的keymaps未作任何调整的情况下运行的。其他指令请见：Action_IDs 及 List_of_built-in_functions，全部按键见：Keyboard_controls 。
其他应用场景
针对《PVE 直接安装最新版 Kodi》中的/etc/systemd/system/kodi.service服务，可以修改ExecStop这一行为：
ExecStop = /usr/bin/kodi-send --action="Quit"
针对《像使用盒子/LibreELEC一样使用PVE直装的Kodi，实现遥控器启停》一文中的/usr/local/bin/kodi-power.sh脚本，可以修改systemctl stop kodi.service（就是原本的关闭Kodi的指令）这一行为下面任何一句命令，这样也算是在电源键被evsieve劫持之后曲线还原了。
# 直接退出
kodi-send --action="Quit"
# 或者只是调出退出菜单，而不是直接退出（根据上一节的说明选其一即可）
kodi-send -a "ActivateWindow(shutdownmenu)"
kodi-send --action="ActivateWindow(shutdownmenu)"
kodi-send --button="sleep"
kodi-send --button="power"
kodi-send --button="s"
