音乐播放器支持-帮助文档

  1. 简介
    1. 什么是音乐播放器支持
    2. 音乐播放器支持可以做什么
  2. 前置需求
    1. 系统需求
    2. SAO Utils需求
    3. 播放器需求
  3. 获取播放器信息
    1. Foobar2000
    2. 网易云音乐、虾米音乐、QQ音乐、酷狗音乐、千千静听(老版)
    3. 通用播放器
  4. 控制播放器
  5. Q&A
  6. 反馈

 

1 简介

1.1 什么是音乐播放器支持

音乐播放器支持是为SAO Utils开发的第三方扩展插件,其开发目标是将更多的常用播放器与SAO Utils相连接起来,达到互通的目的。包括为SAO Utils提供来自常用音乐播放器的信息(如播放曲目、播放进度等),以及为SAO Utils提供对播放器本身的控制(如播放、切歌、调整音量等)。

这不是一个播放器,而是一个将你的播放器与SAO Utils互联的组件。

1.2 音乐播放器支持可以做什么

  • 获取播放器信息

曲目名称、艺术家、专辑、播放进度等

  • 控制播放器操作

上一曲、下一曲、播放、暂停、调整音量等

 

2 前置需求

2.1 系统需求

 x86x64
Windows 2000-
Windows XP
Windows Vista
Windows 7
Windows 8
Windows 8.1
Windows ⑨--
Windows 10

2.2 SAO Utils需求

SAO Utils版本不低于Alpha 3/Beta 1,NERvGear版本不低于0.3.0。

2.3 播放器需求

播放器名称版本需求备注
Foobar2000不低于1.1.11需要安装foo_cad_plus插件备用地址
网易云音乐?
虾米音乐不低于2.0
QQ音乐?
酷狗音乐?
千千静听(老版)?
其他播放器-支持多媒体按键

Foobar2000相关

Foobar2000安装foo_cad插件或foo_cad_plus插件后可以作为CAD兼容播放器使用,因此请确保您的Foobar2000版本不低于1.1.11,并已安装、启用foo_cad插件foo_cad_plus插件在SAO Utils中的所有操作使用CAD兼容播放器即可。

网易云音乐、虾米音乐、QQ音乐、酷狗音乐相关

这类播放器的信息来源是窗口标题,因此只能获取到有限的信息,包括播放进度、音量大小暂时无法获取。同理,播放器控制暂时只能使用上一曲、播放/暂停、下一曲。

其他播放器相关

若您使用的播放器不属于前述播放器,您可以尝试使用通用播放器这一项。使用通用播放器虽不能获取播放器的信息,但是仍可以通过模拟多媒体控制键来操作播放器。 同时可以将您使用的播放器反馈至下方评论区或反馈邮箱,以便在后续的开发中对您使用的播放器进行适配。

 

3 获取播放器信息

 

注:0.1.0及以上版本在更新参数的开头写上“%@%开启新世界大门启用滚动模式。如果只想在内容超过一定长度的情况下滚动,可以写成“%@n%”的形式,n为指定整数,例如“%@10%”表示在长度超过10的情况下滚动。

调整更新间隔可以改变滚动速度,效果如下

3.1 Foobar2000

支持从Foobar2000获取的播放器信息包括播放进度、播放进度(格式化)、音量、标题,以及自定义格式字符串。其中,播放进度与音量是数值类型,可用于绘制图形。

名称类型备注
播放进度整数型已播放时长,单位:秒,可用于绘图,可取相反值
播放进度(格式化)字符串格式为“时:分:秒”
音量整数型可用于绘图,可取相反值
标题字符串
艺术家字符串
专辑字符串

效果如下

自定义:可以显示任意自定义的字符串,同时可用指定关键词代表某项信息,组成特定的字符串。关键字是两端带有%的单词,对应字符串请输入在更新参数中。

例如:“%title% by %artist%”可以按“标题 by 艺术家”的格式输出,“%vol%/100”可以按“音量/100”的格式输出等等。

支持的关键词如下:

信息关键词备注
播放进度%pos%当前播放秒数
音量%vol%最大值为100
标题%title%
艺术家%artist%
专辑%album%

特别的,目前Foobar2000安装了foo_cad_plus后可以获取歌曲专辑封面。利用网页挂件可以加载封面,0.3.0版本后的扩展附带了一个网页挂件,可以将程序目录下SAO Utils\Plugins\Music Player Support\widget\cover demo\index.html附加到网页挂件显示专辑封面。安装foo_cad_plus后请卸载老版的foo_cad以免冲突,foo_cad_plus包含了foo_cad的所有功能并100%兼容foo_cad的应用场合。

3.2 网易云音乐、虾米音乐、QQ音乐、酷狗音乐、千千静听(老版)

支持从上述播放器获取的信息目前仅有曲目信息,由于暂无其他信息的相关接口,仅能通过窗口标题获取信息,若有相关接口资料望告知。

效果如下

3.3 通用播放器

通用播放器不支持获取播放器信息,仅可以尝试使用控制播放器,详见下。

 

4 控制播放器

调用参数中填入某些特定的关键词,可以为使用这项数据的挂件添加对播放器的控制功能,例如单击挂件暂停、单击挂件下一曲等功能就是依此实现的。

各播放器支持参数如下。若您使用的播放器不支持某项参数,请尝试利用快捷键扩展或使用通用播放器参数。

参数含义播放暂停上一曲下一曲音量加/
音量减
音量加n/
音量减n
参数playpauseprevnextvol+/
vol-
vol+n/
vol-n
Foobar2000
网易云音乐××
虾米音乐××
QQ音乐××
酷狗音乐××
千千静听(老版)××××××
通用播放器×

注:vol+n/vol-n代表可以在vol+/vol-后带有数字,一次性调整n级音量,例如vol+5代表单击一次音量增加5。

以下为应用实例:

 

5 Q&A

Q:为何我的Foobar2000可以正常控制,但曲目信息却不能正常更新。

A:这可能是由于CAD连接姿势不正确引起,一般来说重启播放器即可。另外确保更新间隔设置合理,设置太长的更新间隔会导致更新不及时。

 

6 反馈

若此扩展在使用中出现任何异常、错误,欢迎在此页留言或发送邮件至feedback@debug.moe

《音乐播放器支持-帮助文档》有208个想法

      1. 我也是一样的问题,关联不上,连歌曲名和歌手都显示不出来,系统是win10专业版,SU版本是刚从官网下的,网易云是1.9.1

        1. 同上,我那个部分只有一个歌曲和歌手之间的杠,下面前进后退暂停也是不能用的。。

        2. 今天我设置SAO Utils开机启动(就算设置点随机启动也不会随机启动,我到启动里面添加了SAO Utils)突然就可以关联了,不知道会不会是这个原因。

  1. 获取的艺术家和标题名字可能会很长,超过了控件最大宽度,能不能让其中的内容变成滑动的

  2. 请问怎么给按钮换图标?音量加减,上一曲下一曲都可以用,但是图标是一条横线,求解答,真的很喜欢

  3. 自己按照B站上视频把音乐播放器的那几条做完了,,,可是。怎么和网易云音乐关联。完全没有头绪啊QAQ

  4. 怎么改图标啊? + – 音量的图标是一条横线,我看到下面有人问了,但更新参数怎么填???

  5. 为什么没有PDH的详细使用教程,我想做出温度控件。还有。。很多CMD命令无法使用。。。好奇怪啊。。难道是我打开的方式不对?求解。 我真的很想要PDH的详细使用教程!!!!

    1. 嘛,实际上是支持获取的,但是目前来说是没有合适的挂件能动态的刷新一张图片,所以暂时还不提供这个

    1. 因为通用的是通过模拟媒体键来实现的,缺点是,如果同时开着两个播放器,不论是音乐还是视频,都会一起受到影响

    2. 因为通用的是通过模拟媒体键来实现的,缺点是,如果同时开着两个播放器,不论是音乐还是视频,都会一起受到影响

  6. 第一次打开网易云音乐可以关联的上,音乐信息也可以获取,但如果将网易云关了再开,就只有重启saoutils才能重新关联获取信息,否则怎么都关联不上

  7. 如果出现FARBOO不能控制的情况,请针对FB2K和SAO两个主程序都设置为管理员启动(右键属性里),基本可以解决

  8. 话说我用的foobar……我在自定义那里输入“%playback_time_remaining% ”,最后什么也没显示……是暂时还不支持这个命令吗?

  9. 使用通用播放器不是可以调整系统音量吗?我想干脆设置一个系统音量的条形图查看好了,结果没找到,是我没找到还是确实没有?

      1. 这样子的话就需要两个按钮来设置了(就是一个为vol-100,一个为vol+100),不过我想到了一个设计,这个设计只需要一个按钮,如果播放器音量为0,那么点击这个按钮后播放器音量将调大到100,如果播放器音量为非0的数值(1-100),那么点击这个按钮后播放器音量将调小到0

          1. 如果这样的话那也可以这样设置:如果播放器音量为0,那么点击这个按钮后播放器音量将调大到20(这个数值可以由用户自由设置),如果播放器音量为非0的数值(1-100),那么点击这个按钮后播放器音量将调小到0。我想要的功能就像是一个按钮和一个灯,如果灯是亮的,那么按一下这个按钮灯就会灭,如果灯是灭的,那么按一下这个按钮灯就会亮。灯的亮与灭全部由这一个按钮操作。

  10. 大致明白了,可是调用参数里写命令就能控制播放,请问是在哪里的调用参数里写的(写那么多回复辛苦了)

  11. 怎么把里面的功能直接弄成我电脑里面的一些启动程序,在编辑里面的真是目录里 那些启动程序也无法运行?求教

  12. 建议给通用的播放器添加当前播放的歌名和歌手的选项,通过和网易云一样的方法应该能实现吧,通过读取窗口的名称

  13. 网易云音乐的曲目不能滚动。。。准确来说,说是要在更新参数前加上%@%是吧,然而网易云的曲目根本不用谢更新参数。。。即使加上也是没用的,求教

  14. 滚动功能用不了….不管是%@%还是%@n%都试过了,就添加在更新参数的开头,后面是%title%,有空格没空格也试过了…都不滚动QAQ

  15. 無法開起新世界大門-滾動模式….我在 數字或文本 > 選擇數值 > 自訂義 > 更新參數 裡打 [ %@10% ★%artist%-%album%-%title% ] 無法滾動

  16. 不知道为什么没法安装啊,总是出现“安装插件失败”的提示,不只是这个其他新的插件下下来也是这样= =

      1. 我是直接把SAO文件夹放在System里面的。权限的话要怎么设置?安装的时候不会跳出来管理员身份提示啊

  17. 开启和关闭插件没发现任何区别……简单的说就是没发现插件在哪儿…………怎么办

  18. 謝謝作者開發插件,有關於某字符無法正確於GGO掛件顯示的問題;使用Foobar,在Foobar能正確顯示字符. –> [?] U+30FB 請教解決方法,感謝.

      1. 那麼有何解決方法呢,嘗試過直接替換字體文件無效; 應該是有SCRIPT控制GGO掛件字體,不過我不知道哪裡可以修改.

  19. NERvGear是啥。。。哪儿看版本。。。音乐播放器支持插件和pdh数据扩展插件都是启用了的。。。然而用酷狗用wmp都没有任何显示

  20. 桌面唯一一个可以添加项目的hp血条,因为锁在了屏幕的左侧,无法解锁,导致桌面无法再添加新的项目了,求助

  21. 我是在b站看到的介绍视频才开始入坑的,现在通过自己摸索也会做一些桌面挂件了,但是唯独音乐播放器的挂件始终做不出来,可能是太笨了吧呵呵,如果你们有时间的话能做一个教学视频么,各种音乐播放器的,因为fb用不惯的感觉,另外,插件方面因为个人基本用的是wifi而流量监控只显示有线网络所以希望能把这二者结合起来,谢谢为此而奋斗的各位了。

  22. →_→那个显示专辑图片的…打开相应目录后并没发现那个index.html怎么办。。不如说连那个”widgetcover demo”都没有。。

    1. 到這裡更新你的Music Player Support插件:http://www.rangercd.com/sao/music-player-sp-log更新完就出現了。

    1. 到這裡更新你的Music Player Support插件:http://www.rangercd.com/sao/music-player-sp-log更新完就出現了。

  23. 网易云音乐可以使用通用播放器进行控制. 参数如下:播放:play 暂停:pause 上一曲:prev 下一曲:next歌词滚动在网易云音乐-曲目信息-更新参数输入%@n% n=整数,具体看自己喜好音量键+ 音量键- 打开或者关闭歌词等可以使用自定义组合键进行设置

    1. 快捷键指的是网易云音乐里面设置的全局的快捷键各位稍微注意一下

  24. 我设置GGO挂件的项目时 编辑一个“上一曲”的按键 然后是设置的 数字或文本>音乐播放器数据集>CAD兼容播放器>自定义 然后在调用参数那里填的prev 这样做出来确实有切换到上一曲的效果 可是那个设置出来的按键图标是个“-”号 做不出应用实例那里的 上一曲就对应着“<”键的效果

  25. 加仔封面的網頁掛件好像只能加載檔名為cover.jpg的封面,想請問一下有沒有辦法把它改成也能加載其他檔名或格式的封面? 如直接讓他加載 *.jpg

    1. 目前支持获取歌曲所在目录及上级目录下以cover、cover1、front、front1命名的jpg、png、bmp、gif文件作为封面,为了避免搜索到其他无关的图片而仅使用了满足上述条件的图片文件。

  26. 無論如何都無法獲取曲目信息啊啊啊為什麼QAQ
    用的是虾米音樂,參數什麼的都沒問題,
    然後我看虾米不行我換了QQ音樂,還是無法獲取曲目信息。
    系統WIN10,
    好絕望。。。。

发表评论

电子邮件地址不会被公开。 必填项已用*标注

您可以使用这些HTML标签和属性: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>