Fabric.js 中实现 Lottie 动画支持的技术方案

背景介绍

Fabric.js 是一个功能强大的 JavaScript 画布库，用于创建交互式的图形应用程序。在实际开发中，我们经常需要将 Lottie 动画集成到 Fabric.js 画布中。Lottie 是 Airbnb 开发的一种基于 JSON 的动画格式，可以轻松地在 Web 和移动应用中实现高质量的矢量动画。

技术实现方案

1. 创建 Lottie 类

我们可以通过扩展 Fabric.js 的 Image 类来创建一个支持 Lottie 动画的自定义类：

class Lottie extends fabric.Image {
  type = 'lottie';
  lockRotation = true;
  lockSkewingX = true;
  lockSkewingY = true;
  srcFromAttribute = false;

  constructor(path, options = {}) {
    if (!options.width) options.width = 480;
    if (!options.height) options.height = 480;

    const tmpCanvasEl = fabric.util.createCanvasElement();
    tmpCanvasEl.width = options.width;
    tmpCanvasEl.height = options.height;

    const lottieItem = lottie.loadAnimation({
      renderer: 'canvas',
      loop: true,
      autoplay: true,
      path,
      rendererSettings: {
        context: tmpCanvasEl.getContext('2d'),
        preserveAspectRatio: 'xMidYMid meet',
      },
    });

    lottieItem.addEventListener('enterFrame', () => {
      this.canvas?.requestRenderAll();
    });

    super(tmpCanvasEl, options);
    this.path = path;
    this.tmpCanvasEl = tmpCanvasEl;
    this.lottieItem = lottieItem;
  }

  play() {
    this.lottieItem.play();
  }

  stop() {
    this.lottieItem.stop();
  }

  getSrc() {
    return this.path;
  }
}

2. 序列化与反序列化处理

为了使 Lottie 对象能够正确序列化和反序列化，我们需要实现 fromObject 方法。在 Fabric.js 6.x 版本中，我们可以利用新的 API 来实现：

static fromObject({ filters: f, resizeFilter: rf, src, crossOrigin, type, ...object }, options) {
  return Promise.all([
    Promise.resolve(), // 不需要加载图片
    f && enlivenObjects(f, options),
    rf && enlivenObjects([rf], options),
    enlivenObjectEnlivables(object, options)
  ]).then(([, filters = [], [resizeFilter] = [], hydratedProps = {}]) => {
    return new this(src, {
      ...object,
      src,
      filters,
      resizeFilter,
      ...hydratedProps
    });
  });
}

3. 使用示例

创建并添加 Lottie 动画到画布非常简单：

const lottieAnim = new Lottie('https://example.com/animation.json', {
  scaleX: 0.5,
  left: 100,
  top: 100
});
canvas.add(lottieAnim);

技术要点解析

1. 渲染机制：通过创建一个临时 canvas 元素作为 Lottie 的渲染目标，然后将该 canvas 作为源传递给 Fabric.js 的 Image 类。

2. 动画控制：提供了 play() 和 stop() 方法来控制动画的播放状态。

3. 性能优化：使用 enterFrame 事件监听器来触发画布重绘，确保动画流畅运行。

4. 序列化支持：通过实现 fromObject 方法，确保 Lottie 对象可以被正确保存和恢复。

注意事项

1. 在使用前需要确保已加载 lottie-web 库。

2. 由于 Lottie 动画是矢量图形，建议设置合理的默认尺寸（如 480x480）以保证显示效果。

3. 在 Fabric.js 6.x 中，序列化相关 API 有所变化，需要注意兼容性问题。

4. 对于复杂的交互需求，可以进一步扩展该类，添加更多自定义功能。

通过这种实现方式，我们可以在 Fabric.js 项目中无缝集成 Lottie 动画，同时保持 Fabric.js 强大的交互和序列化能力。