---
title: bgRender组件
---

# bgRender组件

## 概述

bgRender是AMLL的核心组件之一。AMLL的动静态背景渲染由bgRender完成。

AMLL对bgRender进行了React绑定，因此你可以方便的在React项目中使用bgRender。

bgRender的快速入门，你可以在[AMLL React快速入门](./quick-start)中找到。

## 使用

请参考[AMLL React快速入门](./quick-start)中的教程。

## 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 |