Taskbar-Lyrics 技术文档

Taskbar-Lyrics 技术文档

Taskbar-Lyrics BetterNCM插件，在任务栏上嵌入歌词，目前仅建议Windows 11 项目地址: https://gitcode.com/gh_mirrors/ta/Taskbar-Lyrics

1. 安装指南

1.1 环境要求

• 操作系统：Windows 11
• 任务栏：仅适配原版任务栏，使用第三方软件修改后出现问题的均不解决。

1.2 依赖库安装

在编译和运行项目之前，需要安装以下依赖库：

• cpp-httplib:x86-windows
• nlohmann-json:x86-windows

可以通过以下命令安装这些依赖库：

vcpkg install cpp-httplib:x86-windows
vcpkg install nlohmann-json:x86-windows

2. 项目的使用说明

2.1 功能介绍

Taskbar-Lyrics 是一个 BetterNCM 插件，主要功能是在 Windows 11 的任务栏上嵌入歌词显示。该插件仅适配原版任务栏，使用第三方软件修改任务栏后可能会导致功能异常。

2.2 使用步骤

1. 确保已安装 BetterNCM 插件管理器。
2. 下载并安装 Taskbar-Lyrics 插件。
3. 启动 BetterNCM，插件会自动加载并在任务栏上显示当前播放歌曲的歌词。

3. 项目API使用文档

3.1 API 概述

Taskbar-Lyrics 插件提供了一个简单的 API，用于与 BetterNCM 插件管理器进行交互。以下是主要的 API 接口：

3.1.1 初始化插件

void initPlugin();

该接口用于初始化插件，加载必要的资源和配置。

3.1.2 更新歌词

void updateLyrics(const std::string& lyrics);

该接口用于更新任务栏上显示的歌词内容。参数 lyrics 为当前播放歌曲的歌词字符串。

3.1.3 显示/隐藏歌词

void toggleLyricsVisibility(bool show);

该接口用于控制歌词的显示或隐藏。参数 show 为布尔值，true 表示显示歌词，false 表示隐藏歌词。

4. 项目安装方式

4.1 下载项目

从 GitHub 仓库下载 Taskbar-Lyrics 项目的源代码。

4.2 编译项目

1. 打开命令行工具，进入项目根目录。
2. 运行以下命令进行编译：

   mkdir build
   cd build
   cmake ..
   make
   

3. 编译完成后，生成的可执行文件位于 build 目录下。

4.3 安装插件

1. 将编译生成的可执行文件复制到 BetterNCM 插件目录。
2. 启动 BetterNCM，插件会自动加载并开始工作。

通过以上步骤，您可以成功安装并使用 Taskbar-Lyrics 插件，在 Windows 11 的任务栏上嵌入歌词显示。

Taskbar-Lyrics BetterNCM插件，在任务栏上嵌入歌词，目前仅建议Windows 11 项目地址: https://gitcode.com/gh_mirrors/ta/Taskbar-Lyrics