Steam
Macro Deck 自带启动和关闭 Steam 游戏，并在面板上显示正在玩的游戏、好友和游戏库。
Steam 库、Steam 好友、Steam 当前游戏和 Steam 游戏启动器组件
- 一键启动已安装的 Steam 游戏
- 显示正在玩的游戏和本次游戏时长
- 查看哪些好友在线、哪些正在游戏中
- 使用 Steam Web API 密钥获取拥有的游戏和游戏时间
- 游戏启动和好友上线的事件
Steam 集成会找到电脑上安装的 Steam，并通过它启动游戏，效果与在 Steam 库中双击游戏相同。它从 Steam 自己的库文件中读取已安装的游戏，并能察觉这台电脑上正在运行哪个游戏。使用可选的 Steam Web API 密钥，它还可以向 Steam 服务器查询在线状态、好友、拥有的游戏和游戏时间，并且可以用于任意数量的 Steam 账户。
无需密钥即可使用的功能
集成启用后，动作和组件即可使用：启动已安装的游戏、打开 Steam、打开游戏的商店或库页面，以及关闭在这台电脑上运行的游戏。Steam 当前游戏 组件会显示游戏及其封面和已玩时长，Steam 游戏启动器 组件可以一键启动最近玩过的或收藏的游戏。
密钥带来的功能
添加一个包含 SteamID 和 Web API 密钥的配置后，可以查看账户在其他设备上正在玩的游戏、在线及游戏中的好友数量、你自己的在线状态，以及拥有的游戏及其总游戏时间和近期游戏时间。Steam 好友 组件会列出在线的好友及其正在玩的游戏，Steam 库 组件会显示你的游戏时长和最近玩过的游戏。好友信息需要公开的好友列表，拥有的游戏和游戏时间需要公开的游戏详情。
一些示例设置：
- 在直播配置文件上放一个游戏启动器组件，包含你最喜欢的三款游戏。
- 一个使用 关闭 Steam 游戏 并开启 强制退出 的按键，用于卡住的游戏。
- 一个由 游戏已启动 触发的自动化，将面板切换到游戏配置文件。
- 一个由 好友上线 触发的自动化，显示一条通知。
每个配置对应一个 Steam 账户，并有自己的变量，以配置名称命名，例如名为 Main 的配置对应 steam_main_is_playing。没有配置就没有 Steam 变量。Macro Deck 每分钟检查一次好友，每 30 秒检查一次状态，每 10 分钟检查一次拥有的游戏，因此需要密钥的事件和变量可能会有相应的延迟。无法访问 Steam 时，这些变量会显示为不可用，而不是显示错误的数字。
关闭游戏仅适用于 Windows。在 macOS 和 Linux 上，该动作会提示不支持。
准备工作
- Windows、macOS 或 Linux 上的 Macro Deck 3
- 运行 Macro Deck 的电脑上已安装 Steam
- 可选：用于获取状态、好友和游戏时间的 SteamID 和 Steam Web API 密钥
- 可选：在 Steam 隐私设置中公开好友列表和游戏详情
设置步骤
第 1 步: 启用 Steam 集成
在侧边栏中点击 集成，然后点击 Steam。打开右上角的开关。在打开之前 Steam 处于关闭状态，因为它只在安装了 Steam 的电脑上才有作用。从现在起，动作和组件即可使用。
第 2 步: 获取 Steam Web API 密钥（可选）
如需状态、好友和游戏时间，请登录 Steam Web API 密钥页面（
https://steamcommunity.com/dev/apikey）并注册一个密钥。该页面会要求填写域名；任何值都可以。受限账户（从未在 Steam 上消费过的账户）无法获取密钥。第 3 步: 添加配置
Steam 变量也来自配置，因此即使没有密钥也请添加一个配置。在 Steam 页面的 概览 选项卡中，点击 配置 下的 添加配置。设置 Steam 对话框需要填写：
- 配置名称：账户在组件设置和变量名中使用的名称，例如
Main。 - Web API 密钥：上一步获取的密钥。请与 SteamID 一起填写，或者两者都留空。
- SteamID：17 位的 SteamID64、个人资料链接或自定义个人资料名称。留空则只使用已安装的游戏。
在 高级配置 下，其他库文件夹 可以添加 Macro Deck 无法自行找到的游戏文件夹。点击 继续。Macro Deck 会先向 Steam 验证 SteamID 和密钥，再保存它们。
- 配置名称：账户在组件设置和变量名中使用的名称，例如
第 4 步: 公开个人资料详情
如需显示好友，请打开 Steam，选择 编辑个人资料，然后选择 隐私设置，将 好友列表 设为 公开。如需显示拥有的游戏和游戏时间，请将 游戏详情 也设为 公开。
第 5 步: 为按键添加 Steam 动作
在 面板 页面上，确认面板已解锁（右上角的按钮显示为 锁定），然后点击一个按键。编辑器打开时已选中 短按。点击 + 添加动作，在 添加动作 对话框左侧选择 Steam，然后选择 启动 Steam 游戏。在 游戏 中选择一款已安装的游戏，或输入 Steam 应用 ID。
第 6 步: 按下按键
点击 保存，然后在面板上按下该按键。Steam 会启动该游戏，可能会先要求登录或更新游戏。
动作5
可以放在按键上，也可以在流程中运行。
- 启动 Steam 游戏
- 启动一款已安装的 Steam 游戏，可从游戏中选择或通过 Steam 应用 ID 指定。
- 启动 Steam
- 打开 Steam 客户端。
- 打开 Steam 商店页面
- 在 Steam 中打开游戏的商店页面。
- 打开 Steam 库页面
- 在 Steam 库中打开游戏的页面。
- 关闭 Steam 游戏
- 关闭在这台电脑上运行的 Steam 游戏，开启 强制退出 后会在 10 秒后强制结束（仅限 Windows）。
触发器6
按键或流程可以对这些事件做出响应。
- 游戏已启动
- 一款 Steam 游戏在这台电脑上启动，或者（使用 Web API 密钥时）在其他设备上启动。
- 游戏已关闭
- 一款 Steam 游戏已关闭，附带其运行的秒数。
- 好友上线
- 一位 Steam 好友从离线变为在线。需要 Web API 密钥。
- 好友下线
- 一位 Steam 好友下线了。需要 Web API 密钥。
- 好友开始游戏
- 一位 Steam 好友开始玩游戏或切换到另一款游戏。需要 Web API 密钥。
- 在线状态已更改
- 你的 Steam 账户的在线状态发生了变化，例如变为离开。需要 Web API 密钥。
变量10
在按键和组件上显示这些值，或在条件中使用它们。
steam_<account>_is_playing- 你是否正在玩游戏。
steam_<account>_current_game_name- 你正在玩的游戏的名称。
steam_<account>_current_game_id- 你正在玩的游戏的 Steam 应用 ID。
steam_<account>_current_game_playtime_seconds- 当前游戏已运行的秒数。
steam_<account>_games_installed- 这台电脑上已安装的游戏数量。
steam_<account>_friends_online- 该账户在线的好友数量。需要 Web API 密钥。
steam_<account>_friends_ingame- 该账户正在玩游戏的好友数量。需要 Web API 密钥。
steam_<account>_games_owned- 该账户拥有的游戏数量。需要 Web API 密钥。
steam_<account>_total_playtime_hours- 该账户的总游戏小时数。需要 Web API 密钥。
steam_<account>_recent_playtime_hours- 该账户过去两周的游戏小时数。需要 Web API 密钥。
组件4
从组件选择器中将它们添加到面板。
- Steam 当前游戏
- 显示你正在玩的游戏及其封面和本次游戏时长。
- Steam 游戏启动器
- 一键启动最近玩过的游戏、某款收藏的游戏或一款固定的游戏。
- Steam 好友
- 显示有多少好友在线和正在游戏中，在较大尺寸下还会显示他们是谁。
- Steam 库
- 显示你的游戏时间、拥有的游戏数量和最近玩过的游戏。
常见问题解答
需要 Steam Web API 密钥吗？
不需要。启动游戏、在这台电脑上运行的游戏、已安装的游戏以及游戏启动器组件都无需密钥即可使用。如需变量，请添加一个不含密钥的配置。只有在线状态、好友、拥有的游戏和游戏时间，以及在其他设备上玩的游戏才需要密钥。
可以添加多个 Steam 账户吗？
可以。每个配置对应一个 Steam 账户并有自己的变量，可以添加任意多个。在这台电脑上运行的游戏对每个配置都相同，因为 Macro Deck 无法判断这里的 Steam 登录的是哪个账户。
为什么没有显示好友或游戏时间？
Steam 只会共享公开个人资料的这些信息。请在 Steam 的 隐私设置 中将 好友列表 和 游戏详情 设为 公开。在此之前，这些变量会显示为不可用，集成也会在 集成 中显示提示。
“关闭 Steam 游戏”为什么在 Mac 上无效？
关闭游戏仅适用于 Windows。在 macOS 和 Linux 上，无法像关闭其窗口那样请求游戏关闭，因此该动作会提示不支持。
Web API 密钥存储在哪里？
密钥存储在运行 Macro Deck 的电脑上，只用于向 Steam 查询你的个人资料。使用密钥时，Macro Deck 会访问 api.steampowered.com；游戏封面和好友头像来自 Steam 自己的图片服务器。
能找到其他磁盘上的游戏吗？
能。每个磁盘上 Steam 自己的库文件夹都会被自动找到，未连接的磁盘会被跳过。对于 Steam 未列出的游戏文件夹，请在配置的 其他库文件夹 中添加。
“你的电脑”分类中的更多集成
系统
Macro Deck 自带在面板上控制电脑：应用、音量、命令、通知、睡眠和关机。
键盘
Macro Deck 自带通过按键在电脑上按下快捷键、输入文本和运行按键序列。
鼠标
Macro Deck 自带通过按键在电脑上点击、移动指针、拖动和滚动。
ADB / Android Debug Bridge
Macro Deck 自带通过 USB 或 Wi-Fi 控制 Android 手机或平板：唤醒设备、启动应用、点击、输入文本和截图。