---
title: 照明音乐律动库扩展
summary: 介绍照明音乐律动库扩展的安装和使用方法，支持云端律动库、本地律动库和 App 律动库的开发。
questions:
- 音乐律动库扩展适用于哪些品类？
- 如何安装音乐律动库扩展？
- 云端律动库如何进行代码注入？
- 本地律动库和 App 律动库有什么区别？
- 使用在线律动库需要什么条件？
- 云端律动库跳转失败怎么解决？
- 如何在项目中引用注入的律动库代码？
---
## 功能介绍
### 前置条件
#### 适用范围
本扩展适用于存在音乐律动功能的照明品类，实现开发过程的可视化同时大幅开发效率提升。
#### 适用场景
- 产品存在音乐律动 dp（music_data 或 mic_music_data），同时需求上要开发音乐律动。
### 功能
- 云端律动库
- 本地律动库
- App 律动库
## 使用流程
### 安装
1. 在 Tuya MiniApp Tools 中，打开设备工具，授权登录后，在设备列表中选择一个设备。点击进入设备页面。
2. 在设备页面，点击右上角“扩展管理”，进入扩展市场，在扩展市场中，找到 “音乐库扩展”，点击安装。
### 使用
**1. 安装成功后，在设备页面中，顶部导航栏中会出现“律动库”入口, 点击“律动库”，进入律动库管理页面。**
**2. 在律动库管理页面中，可以进行云端律动库、本地律动库和 App 律动库的开发。**
**2.1 云端律动库**
2.1.1 切到云端律动库后
2.1.2 点击律动库代码能力注入
2.1.3 如果已经注入过，弹出确认框，确认后将代码覆盖注入到项目中
2.1.4 在项目中引用对应代码，即可完成开发
**注意⚠️：在线情景库需要开通高级能力，可直接在官方群咨询或 https://tuyaos.com/viewforum.php?f=10 发帖咨询**
```tsx
import { useDevice } from '@ray-js/panel-sdk';
import { jumpToCoolBar } from '@/standModel/musicModel/CloudMusic';
type Props = {};
export const Demo: React.FC = ({ style }) => {
const { devInfo } = useDevice();
const handleJumpToCoolBar = () => {
const { devId, groupId } = devInfo || {};
jumpToCoolBar(devId, groupId);
};
return (
跳转在线律动库
);
};
```
**2.2 本地设备律动**
2.2.1 切到本地律动库
2.2.2 选中需要的律动效果，可单选也可全选
2.2.3 选好需要的效果项目后，点击律动库代码能力注入
2.2.4 如果已经注入过，弹出确认框，确认后将代码覆盖注入到项目中
2.2.5 在项目中引用对应代码，即可完成开发 (如果有自定义开发需求，可在 `@/standModel/musicModel/LocalMusic` 文件夹下修改对应的代码适配)
```tsx
import LocalMusic from '@/standModel/musicModel/LocalMusic';
export const Music: React.FC = ({ style }) => {
return (
);
};
```
**2.3 App 律动**
2.3.1 切到 App 律动库
2.4.2 选中需要的律动效果，可单选也可全选
2.3.3 选好需要的效果项目后，点击律动库代码能力注入
2.3.4 如果已经注入过，弹出确认框，确认后将代码覆盖注入到项目中
2.3.5 在项目中引用对应代码，即可完成开发 (如果有自定义开发需求，可在 `@/standModel/musicModel/AppMusic` 文件夹下修改对应的代码适配)
```tsx
import AppMusic from '@/standModel/musicModel/AppMusic';
export const Music: React.FC = ({ style }) => {
return (
);
};
```
## 注意事项
- 注意⚠️：在线律动库需要开通高级能力，可直接在官方群咨询或 https://tuyaos.com/viewforum.php?f=10 发帖咨询
- 注意⚠️：如果云端律动库跳转失败，请查看 `app.config.ts` 中是否已经配置
```json
"functionalPages": {
"rayPlayCoolFunctional": {
"appid": "tyg0szxsm3vog8nf6n"
}
}
```
## 发布日志
- 2024.10.25 - v0.0.9
- 支持云端律动库
- 支持本地律动库
- 支持 App 律动库