跳转到内容

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是否启用静态模式,即图片在更换后就会保持静止状态并禁用更新,以节省性能
rendererCanvasEplorRenderer设置渲染器。默认渲染器有可能会随着版本更新而更换。新版:EplorRenderer(真流体背景);旧版:PixiRenderer