Scheme URL 深度链接——从浏览器或外部 APP 调用洛雪音乐

什么是 Scheme URL

Scheme URL（深度链接）是一种自定义 URL 协议，让你的浏览器或其他 APP 可以直接调用洛雪音乐执行特定操作。就像：

mailto:xxx@example.com 打开邮件客户端
tel:123456 打开电话拨号
weixin:// 打开微信

洛雪音乐注册了自己的 Scheme：lx-music://。只要你的电脑或手机上安装了洛雪音乐，打开带有这个协议的 URL，就会直接唤起洛雪音乐执行对应的命令。

支持的协议版本

版本	说明
桌面版 v1.17.0+	支持 Scheme URL
移动版 v1.6.0+	支持 Scheme URL

支持的操作

搜索并播放歌曲

lx-music://search-and-play?keyword=周杰伦

用指定关键词搜索。
自动播放搜索结果的第一首歌。

搜索并播放歌单

lx-music://search-and-play-playlist?keyword=华语经典

搜索歌单。
自动播放搜索到的第一个歌单。

播放指定 URL 的歌曲

某些音源脚本可能支持通过 URL 直接获取歌曲信息并播放：

lx-music://open-url?url=https://...

具体支持情况取决于音源脚本的实现。

实际应用场景

场景一：油猴脚本配套使用

官方文档提到，洛雪音乐有一个油猴（Tampermonkey）用户脚本可以和 Scheme URL 配合使用。这个脚本可以：

在网页上检测选中的文字或歌曲信息。
自动构造 lx-music://search-and-play?keyword=... 这样的 URL。
点击后直接唤起洛雪音乐搜索并播放。

比如在某篇推荐音乐的文章上选中了一首歌名，点击油猴脚本提供的按钮，就直接在洛雪音乐里搜到并播放了。

场景二：浏览器书签

可以把常用的搜索做成书签，比如：

点一下书签就能搜「周杰伦新歌」并播放。
点一下书签就能搜「华语老歌」歌单。

在浏览器中新建书签，URL 填：

lx-music://search-and-play?keyword=华语老歌

场景三：从命令行调用

在 Windows cmd 或 PowerShell 中：

start lx-music://search-and-play?keyword=稻香

macOS 终端：

open 'lx-music://search-and-play?keyword=稻香'

Linux 终端：

xdg-open 'lx-music://search-and-play?keyword=稻香'

场景四：从其他 APP 触发

任何能发起 HTTP/HTTPS 链接的 APP（比如笔记软件、Todo 清单、浏览器扩展）都可以通过 Scheme URL 唤起洛雪音乐。

URL 编码

URL 中的关键词如果包含中文、空格或特殊字符，必须进行 URL 编码。比如：

「周杰伦新歌」→ 编码后是 %E5%91%A8%E6%9D%B0%E4%BC%A6%20%E6%96%B0%E6%AD%8C
完整 URL：lx-music://search-and-play?keyword=%E5%91%A8%E6%9D%B0%E4%BC%A6%20%E6%96%B0%E6%AD%8C

大多数情况下，浏览器会自动处理编码。但如果你手动拼接 URL，记得编码中文字符。

与开放 API 的区别

Scheme URL 和开放 API 都能从外部控制洛雪音乐，但用途不同：

特性	Scheme URL	开放 API
触发方式	点击链接、系统级唤起	HTTP 请求
是否需要洛雪音乐已运行	不需要，会自动启动	需要洛雪音乐已经在运行
操作类型	搜索播放等高层操作	查询状态、底层控制
是否需要启用	默认支持	需要手动启用开放 API
适合场景	浏览器、命令行、跨 APP	脚本、自动化、Web 面板

常见组合：Scheme URL 用来唤起搜索和播放（高层操作），开放 API 用来查询实时状态和精细控制（底层操作）。