MicMusicTransformer(uuid?: string, defaultValue?: { v: number, power: boolean, id: number, isLight: number, mode: number, speed: number, sensitivity: number, a: number, b: number, c: number, brightness: number, colors: Unit[] })

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

本地麦克风音乐律动标准 DP 协议转换器，用于本地音乐律动配置与 DP 十六进制协议的双向转换

参数

参数类型必填说明
uuidstring否DP 标识符，默认为 mic_music 标准 DP Code
defaultValue{ v: number, power: boolean, id: number, isLight: number, mode: number, speed: number, sensitivity: number, a: number, b: number, c: number, brightness: number, colors: Unit[] }否默认音乐数据，当解析失败时返回此值

返回值

类型：MicMusicTransformer
MicMusicTransformer 实例

引用对象

interfaceUnit
属性类型必填描述
huenumber是色相
saturationnumber是饱和度

方法

方法名说明
parser将 DP 十六进制字符串解析为本地音乐律动数据对象
formatter将本地音乐律动数据对象格式化为 DP 十六进制字符串

示例代码

示例

import { MicMusicTransformer } from '@ray-js/panel-sdk';

const transformer = new MicMusicTransformer();
// 解析本地音乐 DP 字符串
const data = transformer.parser('0101003364320000006400000064007800640078006400f0006400500064011800640190006401180064');

// 格式化为 DP 字符串
const dpStr = transformer.formatter({
  v: 1, power: true, id: 0, isLight: 0, mode: 3,
  speed: 100, sensitivity: 50, a: 0, b: 0, c: 0,
  brightness: 100,
  colors: [{ hue: 0, saturation: 100 }, { hue: 120, saturation: 100 }],
});