PreMiD Activities开发指南:3步创建你的第一个Discord状态增强插件

PreMiD Activities开发指南:3步创建你的第一个Discord状态增强插件 PreMiD Activities开发指南3步创建你的第一个Discord状态增强插件【免费下载链接】Presences Storage for Activities located at our Activity Library.项目地址: https://gitcode.com/gh_mirrors/pr/PresencesPreMiD Activities是一款强大的Discord状态增强工具它能帮助开发者为各种网站创建自定义的Discord状态显示插件。本指南将通过3个简单步骤教你如何快速开发并部署属于自己的PreMiD Activity插件让你的Discord个人资料展示更丰富的在线状态信息。准备开发环境在开始编写代码前需要先搭建基础开发环境。首先确保你的系统已安装Node.js和Git然后通过以下命令克隆项目仓库git clone https://gitcode.com/gh_mirrors/pr/Presences cd Presences npm install项目结构中websites目录存放所有网站的Activity插件每个网站对应一个子目录包含核心代码文件presence.ts和配置文件metadata.json。开发工具主要集中在cli目录提供了项目构建、测试和部署的完整工具链。第1步创建基础文件结构使用PreMiD CLI工具可以快速生成新Activity的基础文件。在项目根目录执行以下命令npx pmd new根据提示输入网站名称如ExampleSite和基础信息CLI会自动在websites/E/ExampleSite目录下生成两个核心文件presence.ts这是插件的主逻辑文件用于定义状态检测和更新逻辑。基础结构如下const presence new Presence({ clientId: YOUR_CLIENT_ID, // 需要从Discord开发者平台获取 mediaKeys: [album, artist, title] }); // 在这里实现状态检测逻辑metadata.json插件配置文件包含网站基本信息、支持的URL模式和多语言描述等。关键配置项包括{ service: ExampleSite, version: 1.0.0, author: Your Name, url: https://examplesite.com, regExp: ^https?://examplesite\\.com/.*, description: { en: Displays your activity on ExampleSite }, tags: [social, example], logo: logo.png, thumbnail: thumbnail.jpg }第2步实现核心功能逻辑打开presence.ts文件开始编写状态检测逻辑。PreMiD提供了丰富的API来获取页面信息和控制Discord状态以下是一个简单的示例// 导入必要的类型和工具 import { Presence } from premid; // 初始化Presence实例 const presence new Presence({ clientId: 123456789012345678, // 替换为你的Discord应用ID detectionOptions: { checkPresence: true, interval: 1000 } }); // 监听页面变化事件 presence.on(UpdateData, async () { const presenceData: PresenceData { details: 浏览网站, state: document.title, largeImageKey: logo // 对应metadata.json中定义的logo }; // 根据不同页面路径显示不同状态 if (document.location.pathname.startsWith(/watch)) { const videoTitle document.querySelector(.video-title)?.textContent; const videoAuthor document.querySelector(.video-author)?.textContent; presenceData.details 观看视频; presenceData.state ${videoTitle} - ${videoAuthor}; presenceData.smallImageKey play; } // 更新状态 presence.setActivity(presenceData); });核心功能实现后需要添加必要的资产文件如logo和缩略图确保它们的路径在metadata.json中正确配置。第3步测试与部署插件本地测试使用PreMiD CLI的开发模式可以实时测试插件效果npx pmd dev ExampleSite这会启动一个本地开发服务器并自动将插件加载到PreMiD扩展中。访问目标网站观察Discord状态是否按预期更新。构建与提交测试通过后构建生产版本npx pmd build ExampleSite构建完成后所有文件会输出到dist目录。此时可以将你的插件提交到官方仓库或通过本地加载方式使用压缩dist目录为ZIP文件在PreMiD扩展中选择加载活动选择生成的ZIP文件高级开发技巧多语言支持在metadata.json中添加多语言描述让插件支持不同地区用户description: { en: Displays your activity on ExampleSite, zh: 显示你在ExampleSite上的活动, ja: ExampleSiteでのアクティビティを表示 }视频播放状态使用媒体会话API获取视频播放信息if (navigator.mediaSession.metadata) { presenceData.details navigator.mediaSession.metadata.title; presenceData.state navigator.mediaSession.metadata.artist; presenceData.smallImageKey navigator.mediaSession.playbackState playing ? play : pause; }配置项支持在metadata.json中添加可配置项让用户自定义插件行为settings: [ { id: showDetails, title: 显示详细信息, description: 是否在状态中显示详细内容, type: boolean, default: true } ]在代码中获取用户配置const showDetails await presence.getSettingboolean(showDetails); if (showDetails) { presenceData.details 完整信息; }结语通过以上3个步骤你已经掌握了PreMiD Activity插件的开发流程。PreMiD社区提供了丰富的示例和文档你可以在websites/目录下找到各种网站的实现代码作为参考。开始创建你的第一个插件为你喜爱的网站添加Discord状态支持吧官方文档docs/API参考cli/src/classes/Presence.ts示例插件websites/Y/YouTube/presence.ts【免费下载链接】Presences Storage for Activities located at our Activity Library.项目地址: https://gitcode.com/gh_mirrors/pr/Presences创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考