itch:// 协议链接:从网页或命令行直达应用页面
安装客户端时会向系统注册 itch://(以及等价的 itchio://)协议。任何地方——网页、聊天工具、命令行——打开这类链接,应用都会被拉到前台执行对应动作。这是把应用当自动化组件用的官方入口。
两条规则先记住
- 没有链接会静默执行操作:动作类链接只是打开一个对话框等你确认,未登录时链接会被保存,登录完成后继续。
- 导航类链接只负责打开页面。
动作类链接
itch://install?game_id=<游戏id>
itch://install?game_id=<游戏id>&upload_id=<文件id>
itch://install?game_id=<游戏id>&launch
itch://steam-shortcuts
itch://steam-shortcuts?game_id=<游戏id>&mode=direct
install打开安装对话框;加launch参数则在装完后直接启动(已安装时仅确认一下就启动)。steam-shortcuts打开快捷方式对话框,可预勾选某个游戏并指定模式(见 Steam 快捷方式)。
常用导航链接
| 链接 | 打开 |
|---|---|
| itch://library / library/owned / library/installed | 库 / 拥有 / 已安装 |
| itch://collections | 集合列表 |
| itch://games/\<id\> | 某游戏页面 |
| itch://featured | 探索页 |
| itch://dashboard | 创作者面板 |
| itch://downloads | 下载页 |
| itch://preferences / locations | 偏好设置 / 安装位置 |
| itch://applog | 应用日志(排障用) |
普通的 itch.io 网址也认:把游戏页网址丢给应用,就在内置浏览器里打开那个页面。
命令行打开
# Linux
xdg-open "itch://install?game_id=12345&launch"
# macOS
open "itch://install?game_id=12345&launch"
# Windows (PowerShell/CMD)
start "" "itch://install?game_id=12345&launch"
把链接直接作为应用可执行文件的参数也可以(Linux 与 Windows)。需要无人确认的静默启动时,改用 itch-setup 的无头模式,见 无头启动游戏。