#功能介绍

#前置条件

#适用范围

本扩展适用于存在音乐律动功能的照明品类，实现开发过程的可视化同时大幅开发效率提升。

#适用场景

• 产品存在音乐律动 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 发帖咨询

import { useDevice } from '@ray-js/panel-sdk';
import { jumpToCoolBar } from '@/standModel/musicModel/CloudMusic';

type Props = {};

export const Demo: React.FC<Props> = ({ style }) => {
  const { devInfo } = useDevice();

  const handleJumpToCoolBar = () => {
    const { devId, groupId } = devInfo || {};
    jumpToCoolBar(devId, groupId);
  };

  return (
    <View onClick={handleJumpToCoolBar}>
      跳转在线律动库
    </View>
  );
};

2.2 本地设备律动

2.2.1 切到本地律动库
2.2.2 选中需要的律动效果，可单选也可全选
2.2.3 选好需要的效果项目后，点击律动库代码能力注入

2.2.4 如果已经注入过，弹出确认框，确认后将代码覆盖注入到项目中

2.2.5 在项目中引用对应代码，即可完成开发 (如果有自定义开发需求，可在 @/standModel/musicModel/LocalMusic 文件夹下修改对应的代码适配)

import LocalMusic from '@/standModel/musicModel/LocalMusic';

export const Music: React.FC<Props> = ({ style }) => {
  return (
    <View style={style} className={styles.list}>
      <LocalMusic />
    </View>
  );
};

2.3 App 律动

2.3.1 切到 App 律动库
2.4.2 选中需要的律动效果，可单选也可全选
2.3.3 选好需要的效果项目后，点击律动库代码能力注入

2.3.4 如果已经注入过，弹出确认框，确认后将代码覆盖注入到项目中

2.3.5 在项目中引用对应代码，即可完成开发 (如果有自定义开发需求，可在 @/standModel/musicModel/AppMusic 文件夹下修改对应的代码适配)

import AppMusic from '@/standModel/musicModel/AppMusic';

export const Music: React.FC<Props> = ({ style }) => {
  return (
    <View style={style} className={styles.list}>
      <AppMusic />
    </View>
  );
};

#注意事项

• 注意⚠️：在线律动库需要开通高级能力，可直接在官方群咨询或 https://tuyaos.com/viewforum.php?f=10 发帖咨询
• 注意⚠️：如果云端律动库跳转失败，请查看 app.config.ts 中是否已经配置

"functionalPages": {
  "rayPlayCoolFunctional": {
    "appid": "tyg0szxsm3vog8nf6n"
  }
}

#发布日志

• 2024.10.25 - v0.0.9
  • 支持云端律动库
  • 支持本地律动库
  • 支持 App 律动库