WebNowPlaying
Macro Deck 自带通过 WebNowPlaying 扩展控制浏览器中播放的音乐和视频,并显示正在播放的内容。
两个正在播放曲目的音乐播放器组件,一个为“全封面”样式,一个为“小封面”样式,标题栏中都有 WebNowPlaying 的名称和标志
- 控制浏览器中媒体的播放、暂停、切换、跳转和音量
- 跟随当前正在播放的标签页
- 显示标题、艺术家和封面的音乐播放器组件
- 提供曲目、艺术家、网站、进度和评分的变量
- 没有设置对话框:启用集成并开启扩展的适配器即可
WebNowPlaying 集成将 Macro Deck 连接到 WebNowPlaying 浏览器扩展。该扩展会读取浏览器中受支持网站(例如音乐和视频网站)上正在播放的内容,并将其传给 Macro Deck。Macro Deck 则会将播放、暂停、切换等命令发回给网站。
该集成没有设置对话框。在 Macro Deck 中启用集成,并在扩展设置中开启 Macro Deck 适配器即可。Macro Deck 会在同一台电脑的 8698 端口上监听扩展的连接。
可以做什么
- 对浏览器中播放的内容进行播放、暂停、切换曲目、跳转、开启或关闭随机播放、设置循环模式和更改音量。
- 在 音乐播放器 组件中显示正在播放的内容,包括网站名称、封面、进度以及播放和切换按钮。
- 在按键标签中使用
webnowplaying_current_track_name和webnowplaying_player_name等变量。 - 将滑块绑定到
webnowplaying_volume或webnowplaying_current_position。
一些示例设置:
- 一个 Toggle Play/Pause 按键,接电话时暂停浏览器中的视频。
- 一个音乐播放器组件,显示浏览器标签页中正在播放的歌曲。
- 一个绑定到
webnowplaying_volume的滑块,无需切换窗口即可更改网站的音量。
运行方式
当多个标签页都报告了媒体时,Macro Deck 会跟随其中一个:优先是有声播放且最近处于活动状态的标签页,其次是任何正在播放的标签页,最后是最后处于活动状态的标签页。命令会发送到该标签页。并非每个网站都支持所有命令;当网站无法执行某项操作(例如设置循环模式)时,该命令不会产生任何效果。当浏览器关闭扩展的连接时,组件会显示没有正在播放的内容,扩展重新连接后 Macro Deck 会再次接收。
如果其他应用程序已占用 8698 端口(例如带有 WebNowPlaying 插件的 Macro Deck 2),该集成页面上的问题 WebNowPlaying 端口已被占用 会提示这一点。
准备工作
- 网页浏览器中已安装 WebNowPlaying 扩展。
- 浏览器与 Macro Deck 运行在同一台电脑上。
- 已在扩展的 Adapters 设置中开启 Macro Deck 适配器(端口
8698)。
设置步骤
第 1 步: 安装 WebNowPlaying 扩展
在运行 Macro Deck 的电脑上,为网页浏览器安装 WebNowPlaying 扩展。
第 2 步: 启用集成
在 Macro Deck 中,点击侧边栏中的 集成,然后点击 WebNowPlaying。用右上角的开关启用该集成。它默认处于关闭状态。由于无需任何设置,概览 选项卡会显示 此集成没有可用的配置选项。
第 3 步: 在扩展中开启 Macro Deck 适配器
打开 WebNowPlaying 扩展的设置,进入 Adapters。开启使用
8698端口的 Macro Deck 适配器。第 4 步: 检查连接
在受支持的网站上播放一首歌曲或一个视频。在 集成 下的 WebNowPlaying 页面上打开 变量 选项卡:
webnowplaying_is_connected显示为true,webnowplaying_current_track_name显示正在播放的内容。第 5 步: 为按键添加动作
在 面板 页面上,点击要使用的按键。面板必须处于解锁状态:右上角的按钮显示为 锁定 时,面板即为解锁状态。编辑器打开时已选中 短按。点击 + 添加动作,在 添加动作 对话框左侧选择 WebNowPlaying,然后选择一个动作,例如 Toggle Play/Pause。然后点击 保存。
第 6 步: 按下按键
在面板上按下该按键。浏览器中的媒体会暂停或继续播放。
动作12
可以放在按键上,也可以在流程中运行。
- Play
- 在浏览器中继续播放。
- Pause
- 在浏览器中暂停播放。
- Toggle Play/Pause
- 在播放和暂停之间切换,并在按键上显示播放状态。
- Next Track
- 在网站支持时跳到下一首曲目。
- Previous Track
- 在网站支持时跳到上一首曲目。
- Refresh State
- 立即读取当前的播放状态。
- Set Volume
- 设置网站的音量,范围为 0 到 100%。
- Volume Up
- 将音量提高 10%。
- Volume Down
- 将音量降低 10%。
- Seek
- 跳转到当前曲目中的某个位置,单位为秒。
- Toggle Shuffle
- 在网站支持时开启、关闭或切换随机播放。
- Set Repeat Mode
- 在网站支持该模式时,将循环模式设为 Off、Repeat Track 或 Repeat Album/Playlist。
触发器6
按键或流程可以对这些事件做出响应。
- 曲目已切换
- 开始播放另一首曲目,附带其标题、艺术家和专辑(位于 音乐播放器 下)。
- 播放已开始
- 播放已开始或继续(位于 音乐播放器 下)。
- 播放已暂停
- 播放已暂停(位于 音乐播放器 下)。
- 播放已停止
- 播放已停止(位于 音乐播放器 下)。
- 音量已更改
- 音量发生了变化,附带新值和旧值(位于 音乐播放器 下)。
- 播放设备已更改
- Macro Deck 改为跟随另一个网站上的标签页,附带新网站名称和之前的网站名称(位于 音乐播放器 下)。
变量15
在按键和组件上显示这些值,或在条件中使用它们。
webnowplaying_is_connected- 扩展是否已连接到 Macro Deck。
webnowplaying_player_name- 正在播放的网站的名称。
webnowplaying_current_track_name- 正在播放内容的标题。
webnowplaying_current_artist- 正在播放内容的艺术家。
webnowplaying_current_album- 正在播放内容的专辑。
webnowplaying_album_art_url- Macro Deck 中当前封面的地址。
webnowplaying_playback_state- 播放状态:
playing、paused或stopped。 webnowplaying_is_playing- 当前是否有内容正在播放。
webnowplaying_current_position- 曲目已播放的秒数。也可以设置它以进行跳转。
webnowplaying_track_duration- 曲目的长度,单位为秒。
webnowplaying_progress_percentage- 曲目已播放的百分比。
webnowplaying_volume- 网站的音量百分比。也可以设置它,例如通过滑块。
webnowplaying_shuffle_enabled- 随机播放是否开启。
webnowplaying_repeat_mode- 循环模式:
off、track或context。 webnowplaying_rating- 网站报告的曲目评分,以数字表示。
组件1
从组件选择器中将它们添加到面板。
- 音乐播放器
- 显示浏览器中正在播放的内容,包括网站名称、封面、进度以及播放、暂停和切换按钮。
常见问题解答
哪些网站可以使用?
WebNowPlaying 扩展支持的所有网站。Macro Deck 只能看到扩展报告的内容,因此扩展不支持的网站不会显示。
浏览器运行在另一台电脑上时能用吗?
不能。Macro Deck 只接受来自同一台电脑的扩展连接。请在运行浏览器的电脑上安装 Macro Deck,并将面板连接到它。
按键为什么没有反应?
正在播放的网站可能不支持该命令,例如随机播放或某种循环模式。此时 Macro Deck 会跳过该命令。另外请确认 webnowplaying_is_connected 变量显示为 true,并且正在播放的是正确的标签页。
Macro Deck 提示 WebNowPlaying 端口已被占用,该怎么办?
已有其他应用程序在监听 8698 端口,通常是带有 WebNowPlaying 插件的 Macro Deck 2。请关闭该应用程序,然后在 集成 中将 WebNowPlaying 集成关闭再重新打开。
我在 Macro Deck 2 中使用过 WebNowPlaying 插件,按键会被迁移过来吗?
大部分会。从 Macro Deck 2 迁移时,该插件的播放/暂停、下一首、上一首和随机播放按键会迁移到对应的动作。循环按键不会迁移,因为 Macro Deck 3 是设置一种循环模式,而不是在模式之间轮换;请改用 Set Repeat Mode。
“音乐和音频”分类中的更多集成
Spotify
Macro Deck 自带控制 Spotify 播放、喜欢歌曲、管理播放列表,并在面板上显示正在播放的内容。
YouTube Music Desktop App
Macro Deck 自带在面板上控制 YouTube Music Desktop App:播放、音量、评分和正在播放的内容。
Jellyfin
Macro Deck 自带在面板上控制 Jellyfin 应用和电视,显示正在播放的内容,并在播放开始或停止时做出响应。
SoundPad
Macro Deck 自带播放 SoundPad 列表中的声音,控制录音,并在面板上显示正在播放的声音。
Voicemeeter
Macro Deck 自带在面板上控制 Voicemeeter、Banana 或 Potato 的增益、静音、路由和宏按钮。