BackgroundRender 组件
概述
bgRender是AMLL的核心组件之一。AMLL的动静态背景渲染由bgRender完成。
AMLL对bgRender进行了React绑定,因此你可以方便的在React项目中使用bgRender。
bgRender的快速入门,你可以在AMLL React快速入门中找到。
使用
请参考AMLL React快速入门中的教程。
Props参数
AMLL bgRender已进行React绑定,通过Props即可进行自定义配置。
bgRender提供以下Props:
Props | 类型 | 默认 | 作用 |
---|---|---|---|
albumImageUrl | 字符串 | true | 设置背景专辑图片 |
fps | 数字 | 30 | 设置当前背景动画帧率 |
playing | 布尔值 | true | 设置当前播放状态 |
flowSpeed | 数字 | 2 | 设置当前动画流动速度 |
hasLyric | 布尔值 | true | 设置背景是否根据“是否有歌词”这个特征调整自身效果,例如有歌词时会变得更加活跃。部分渲染器会根据这个特征调整自身效果。如果不确定是否需要赋值或无法知晓是否包含歌词,请传入 true 或不做任何处理。 |
lowFreqVolume | 数字 | 1.0 | 设置低频的音量大小,范围在 80hz-120hz 之间为宜,取值范围在 0.0-1.0 之间。部分渲染器会根据音量大小调整背景效果(例如根据鼓点跳动)。如果无法获取到类似的数据,请传入 undefined 或 1.0 作为默认值,或不做任何处理。 |
renderScale | 数字 | 0.5 | 设置当前渲染缩放比例 |
staticMode | 布尔值 | false | 是否启用静态模式,即图片在更换后就会保持静止状态并禁用更新,以节省性能 |
renderer | Canvas | EplorRenderer | 设置渲染器。默认渲染器有可能会随着版本更新而更换。新版:EplorRenderer(真流体背景);旧版:PixiRenderer |