---
title: 通用-音乐律动
summary: 设备音乐与 App 音乐律动功能，灯光随音乐节奏变化，含 mic_music_data DP 解析与 SDK 接口。
---

## 通用-音乐律动

### 功能介绍
1. 设备音乐律动（本地音乐律动）
 概念：通过本地麦克风采集音量信号，对信号的电压值进行一定的计算来实现音乐律动的效果。 由于该方案没有一个统一的实现逻辑，现在照明做过的有两个本地音乐律动逻辑。具体可参看。
注意： 如果在音乐模式下，打开灯光开关，固件上报开的音乐 DP，音乐状态打开。

2. App音乐律动
手机麦克风采集外界音乐的音频信息，通过智能生活 App 对音频信息进行时域和频域转换，输出 HSV，实现灯光随着音乐节奏进行变化的效果.
由 App 结合产品的控制面板,通过手机的外设收集周围的声音，App 能力负责收音并且提供给面板相关能力的接口,面板负责根据指定模式去固件间隔 300ms 下发音乐律动的 DP,设备根据指定的协议解析控制命令让设备显示相应的颜色。

### DP 协议
- dpCode: mic_music_data（DP 解析详情见 [MicMusicTransformer](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/ability-set/dp-parser/MicMusicTransformer)）

|序号 | 名称	|字节数	|标识	|数据类型	|字段属性	|字段说明|
| --- | --- | --- | --- | --- | --- |--- |
|1	 | 版本号 | 	1	| version| 	数值 |  	最大值：255 最小值：0 步距：1 倍数：0 | 无 |
|2	 | 本地麦克风开关	 | 2	 | switch | 	数值 | 		最大值：255 最小值：0 步距：1 倍数：0 |  无 |
|3	 | 音乐模式编号 | 	1	 | ID | 	数值	 | 	最大值：255 最小值：0 步距：1 倍数：0 |  无 |
|4	 | 变化方式 | 	1	 | mode | 	比特 | 反算		Bit0：变化方式标识：style1 0：变化方式 1：变化方式 Bit1：变化方式标识：style2 0：变化方式 1：变化方式 … |  无 |
|5	 | 变化速度 | 	1	 | speed	 | 数值 | 		最大值：100 最小值：1 步距：1 倍数：0 |  无 |
|6	 | 灵敏度	 | 1	 | sensitivity | 	数值	 | 	最大值：100 最小值：1 步距：1 倍数：0 |  无 |
|7	 | 设置项A | 	1	 | setting_A	 | 数值	 | 	最大值：255 最小值：0 步距：1 倍数：0 |  无 |
|8	 | 设置项B	 | 1	 | setting_B	 | 数值	 | 	最大值：255 最小值：0 步距：1 倍数：0 |  无 |
|9	 | 设置项C	 | 1	 | setting_C	 | 数值	 | 	最大值：255 最小值：0 步距：1 倍数：0 |  无 |
|10	 | 亮度	 | 1 | 	V	 | 数值		 | 最大值：100 最小值：0 步距：1 倍数：0 |  无 |
|11	 | 色度	 | 2	 | H	 | 数值		 | 最大值：360 最小值：0 步距：1 倍数：0 |  无 |
|12	 | 饱和度	 | 1 | 	S	 | 数值	 | 	最大值：100 最小值：0 步距：1 倍数：0 |  无 |

### 如何开发
- 根据 UI 交互进行 DP 的监听上报与下发
  - [具体监听与下发示例](/cn/miniapp/solution-panel/ability#dp-上报监听)

- 更近一步的，我们在 Tuya MiniApp IDE 上提供了扩展插件来辅助开发，点击 `扩展管理` 后可以看到 `面板 IDE 照明律动库扩展`, 下载后按照扩展上的说明方法使用即可。

### 注意事项
暂无

### 相关物料
- 【功能页】：无
- 【组件】：
  1. [音乐律动组件](https://developer.tuya.com/material/library_oHEKLjj0/component?code=ComponentsTyLamp&subCode=LampMusicCard)
- 【教程】：无
- 【SDK】：
  1. 监听 App 音乐拾音 => [onMusic2RgbChange](https://developer.tuya.com/cn/miniapp/develop/ray/api/light/music-rhythms/onMusic2RgbChange)
  2. 取消 App 音乐拾音 => [offMusic2RgbChange](https://developer.tuya.com/cn/miniapp/develop/ray/api/light/music-rhythms/offMusic2RgbChange)
- 【API】：无