# av.audio.music 库模块帮助文档

## av.audio.music 成员列表 <a id="av.audio.music" href="#av.audio.music">&#x23;</a>

程序化配乐：按风格、bpm、段落强度与重音生成背景音乐（现场合成，不需要素材）

### av.audio.music.chord(root,mode,degree,size) <a id="av.audio.music.chord" href="#av.audio.music.chord">&#x23;</a>
调内第 degree 级和弦的音级数组（size 3 或 4）

### av.audio.music.instruments <a id="av.audio.music.instruments" href="#av.audio.music.instruments">&#x23;</a>
乐器表：kick,clap,snare,hat,shaker,crash,bass,pad,pluck,keys,bell；每个函数返回单声道片段

### av.audio.music.modes <a id="av.audio.music.modes" href="#av.audio.music.modes">&#x23;</a>
调式音阶表

### av.audio.music.parseKey(key) <a id="av.audio.music.parseKey" href="#av.audio.music.parseKey">&#x23;</a>
解析调：返回 主音音级(0~11),调式名

### av.audio.music.styles <a id="av.audio.music.styles" href="#av.audio.music.styles">&#x23;</a>
风格表：16 步节奏型（X 重音、x、o 轻、. 休止）按强度 0~3 分套，可添加自定义风格

### av.audio.music.voicing(pcs,lo,hi,prev) <a id="av.audio.music.voicing" href="#av.audio.music.voicing">&#x23;</a>
把音级排成 lo~hi 之间的 MIDI 和弦，尽量贴近上一个和弦

## av.audio 成员列表 <a id="av.audio" href="#av.audio">&#x23;</a>

### av.audio.music(style,opt) <a id="av.audio.music" href="#av.audio.music">&#x23;</a>
生成配乐，返回立体声 av.audio.clip（响度 -16 LUFS）；  
style: "tech"|"upbeat"|"ambient"|"lofi" 或风格表；  
opt: duration(秒，必填),bpm,key("A minor"),seed,sections({{t;energy}}，强度 0~3),hits({{t;strength}}),mode("continuous" 时固定 groove),energy,autoAccents,hitMergeWindow,beatOffset,endAt(终止和弦时刻),lufs,stems(true 时返回值另附 stems 各总线片段、events 音符事件)  
返回值附带 beats,bars,sections,bpm,key,endAt,mode,beatOffset  

[返回对象:avAudioClipObject](#avAudioClipObject)