临云音乐插件开发文档

临云音乐插件功能是临云音乐3.2.5版本正式推出的功能  
注：临云音乐3.x下面简称3，临云音乐4下面简称4

这里简单整理一下插件接口（目前按照3的标准来）

## 初始化函数 ##
函数名`PluginStart`
参数如下
| 参数 | 类型 | 备注 |
| --- | --- | --- |
| 主窗口句柄 | Int | 主程序发给扩展的主窗口窗口句柄 |
| 主程序句柄 | Int | 主程序发给扩展的调用子程序句柄 |
| 主程序版本 | Int | 主程序发给扩展的内部程序版本号 |

> 返回值如下

| 类型 | 备注 |
| --- | --- |
| Int | 扩展发给主程序的调用函数句柄，对应“主程序插件回调”部分 |

## 插件主程序回调 ##

插件提交命令给主程序处理
参数如下，具体类型看命令类型附表
| 参数 | 类型 |
| --- | --- |
| 命令类型 | Int |
| 参数1 | Int |
| 参数2 | Int |
| 参数3 | Int |

> 返回值如下

| 类型 | 备注 |
| --- | --- |
| Int | 主程序发给插件处理后的内容 |

> 命令类型对照表

| 参数 | 注释 |
| --- | --- |
| 1001 | 修改主窗口标题 |
| 1002 | 添加更多菜单项 |
| 1004 | 播控设置 |
| 1005 | 循环设置 |
| 1006 | 歌词显示设置 |
| 1007 | 主窗口显示/隐藏 |
| 1008 | 歌词锁定设置 |
| 1145 | 结束程序 |

## 主程序插件回调 ##

主程序提交命令给插件处理
提交参数如下，具体类型看命令类型附表
| 参数 | 类型 |
| --- | --- |
| 命令类型 | Int |
| 参数1 | Int |
| 参数2 | Int |
| 参数3 | Int |

> 命令类型对照表

| 参数 | 注释 |
| --- | --- |
| 2001 | 接收当前播放歌词 |
| 2002 | 接收未播放歌词 |
| 2003 | 接收当前播放歌曲名 |
| 2004 | 接收当前播放歌手名 |
| 2005 | 接收当前播放专辑名 |
| 2006 | 接收当前播放歌曲封面 |
| 2007 | 接收当前播放歌曲来源，但是4的来源标识和3不一样 |
| 2008 | 接收当前播放歌曲地址 |

## 音乐源插件回调（4已移除） ##

给临云音乐添加音源
| 参数 | 类型 |
| --- | --- |
| 命令类型 | Int |
| 参数1 | Int |
| 参数2 | Int |

> 返回值如下

| 类型 | 备注 |
| --- | --- |
| Text-Ansi | 扩展发给主程序的信息，编码ANSI |

> 命令类型附表

| 类型 | 备注 |
| --- | --- |
| 1009 | 插件插入音源 |
| 3001 | 主程序从插件获取搜索结果 |
| 3002 | 主程序从插件取播放地址 |
| 3003 | 主程序从插件取封面 |
| 3004 | 主程序从插件取歌词 |
| 3005 | 主程序从插件取下载地址 |
Fatmc's Notes

临云音乐插件开发文档
