LX Music

LX Music是一款免费的音乐下载收听软件。中文名为洛雪音乐，软件中使用了多个搜索引擎可以让你找到所有的流行歌曲，支持多种音乐平台免费收听。体积小巧的安装包可以在iOS和Android版本的移动设备上下载使用，随时随地享受美妙的聆听体验。喜欢的歌曲也支持下载到本地，在这里免费收听。你可以搜索歌曲、艺术家或专辑来快速找到你最喜爱的音乐。是一款免费的开源音乐搜索工具，界面友好，与传统播放器没有太大区别，你可以轻松熟练使用。

LX Music源码使用方法

环境要求

Node.js 16+

项目环境准备

安装Node.js环境(如已安装请跳过): 下载Node.js安装结束后，打开命令行输入node -v将会输出Node.js的版本号即表示已安装完成

安装Android开发环境: 若你没有安装有安装Android开发环境，可以看环境准备的React Native CLI Quickstart说明

拉取代码: 克隆本仓库代码

安装依赖: 在项目根目录打开命令行，执行命令：npm install，若此命令执行的过程中报错可以尝试百度报错内容找解决方法，或在此处贴出报错日志一起讨论解决

使用Android Studio打开项目根目录下的android文件夹，同步一遍gradle

项目启动步骤

启动模拟器或连接真实设备

启动开发服务器: 在项目根目录打开命令行，执行命令：npm run dev，若开发服务器意外停止了，可以执行npm start重新启动

开发: 修改项目下的JS即可实时看到修改后的效果

Native开发

使用Android Studio打开项目根目录下的android文件夹，即可在Android Studio内进行安卓代码的开发与调试

构建安装包

首先生成安卓签名文件，然后将你的签名文件放在android/app/，然后在android/新建keystore.properties文件，填入你的签名信息：

storeFile=

storePassword=

keyAlias=

keyPassword=

最后在android/执行命令./gradlew assembleRelease，构建的安装包在android/app/build/outputs/apk/release/

LX Music自定义源脚本编写说明

文件请使用UTF-8编码格式编写，脚本所用编程语言为JavaScript，可以使用ES6+语法，与PC端自定义源调用机制互通，由于移动端内部使用的是一个轻量级 JavaScript 引擎，浏览器、Node.js等常见宿主环境API不可用，部分 lx.utils API 不可用或者只有部分可用，可用宿主API见下面的附录。

脚本与应用的交互是使用类似事件收发的方式进行，这是一个基本的脚本例子：

/**

* @name 测试音乐源

* @description 我只是一个测试音乐源哦

* @version 1.0.0

* @author xxx

* @homepage http://xxx

*/

const { EVENT_NAMES, request, on, send } = globalThis.lx

const qualitys = {

kw: {

'128k': '128',

'320k': '320',

flac: 'flac',

flac24bit: 'flac24bit',

},

local: {},

}

const httpRequest = (url, options) => new Promise((resolve, reject) => {

request(url, options, (err, resp) => {

if (err) return reject(err)

resolve(resp.body)

})

})

const apis = {

kw: {

musicUrl({ songmid }, quality) {

return httpRequest('http://xxx').then(data => {

return data.url

})

},

},

}

// 注册应用API请求事件

// source 音乐源，可能的值取决于初始化时传入的sources对象的源key值

// info 请求附加信息，内容根据action变化

// action 请求操作类型，目前只有musicUrl，即获取音乐URL链接，

// 当action为musicUrl时info的结构：{type, musicInfo}，

// info.type：音乐质量，可能的值有128k / 320k / flac / flac24bit(取决于初始化时对应源传入的qualitys值中的一个)

// 特殊情况：源为local时，该值为 null

// info.musicInfo：音乐信息对象，里面有音乐ID、名字等信息

on(EVENT_NAMES.request, ({ source, action, info }) => {

// 被调用时必须返回 Promise 对象

switch (action) {

// action 为 musicUrl 时需要在 Promise 返回歌曲 url

case 'musicUrl':

return apis[source].musicUrl(info.musicInfo, qualitys[source][info.type]).catch(err => {

console.log(err)

return Promise.reject(err)

})

// action 为 lyric 时需要在 Promise 返回歌词信息

case 'lyric':

return apis[source].musicUrl(info.musicInfo).catch(err => {

console.log(err)

return Promise.reject(err)

})

// action 为 pic 时需要在 Promise 返回歌曲封面 url

case 'pic':

return apis[source].musicUrl(info.musicInfo).catch(err => {

console.log(err)

return Promise.reject(err)

})

}

})

// 脚本初始化完成后需要发送inited事件告知应用

// 注意：初始化事件被发送前，执行脚本的过程中出现任何错误将视为脚本初始化失败

send(EVENT_NAMES.inited, {

openDevTools: false, // 是否打开开发者工具，方便用于调试脚本

sources: { // 当前脚本支持的源

kw: { // 支持的源对象，可用key值：kw/kg/tx/wy/mg/local

name: '酷我音乐',

type: 'music', // 目前固定为 music

actions: ['musicUrl'], // 除了local外，其他的固定为 ['musicUrl']

qualitys: ['128k', '320k', 'flac', 'flac24bit'], // 当前脚本的该源所支持获取的Url音质，有效的值有：['128k', '320k', 'flac', 'flac24bit']

},

// ...

local: {

name: '本地音乐',

type: 'music', // 目前固定为 music

actions: ['musicUrl', 'lyric', 'pic'], // 源为 local 时，支持 ['musicUrl', 'lyric', 'pic']

qualitys: [], // 源为 local 时，该值传入空数组即可

},

},

})

自定义源信息

文件的开头必须包含以下注释：

/**

* @name 测试脚本

* @description 我只是一个测试脚本

* @version 1.0.0

* @author xxx

* @homepage http://xxx

*/

@name ：源的名字，建议不要过长，24个字符以内

@description ：源的描述，建议不要过长，36个字符以内，可不填，不填时可以删除 @description

@version：源的版本号，可不填，不填时可以删除 @version

@author ：脚本作者名字，可不填，不填时可以删除 @author

@homepage ：脚本主页，可不填，不填时可以删除 @homepage

软件作用

1、和其他歌曲平台一样的操作，让你可以轻松解锁并听到付费歌曲。

2、操作简单可以将当地音乐导入其中，获得舒适的聆听体验。

3、界面简单没有广告，让你听歌更舒服享受，不会受到干扰。

软件评测

LX Music软件中你可以自定义软件的主题设置，一键上传图片。喜欢的歌曲也支持下载到本地，在这里免费收听。可以搜索歌曲、艺术家或专辑来快速找到您最喜爱的音乐。