pulsar_haptics_lottie #

Play Pulsar haptics in sync with a Lottie animation in Flutter.

Built on pulsar_haptics and the lottie package — it reuses Pulsar's haptic engine (no haptics reimplemented) and follows the Lottie AnimationController clock.

Install #

dependencies:
  pulsar_haptics_lottie: ^0.1.0

Usage — the widget #

import 'package:pulsar_haptics_lottie/pulsar_haptics_lottie.dart';
import 'package:pulsar_haptics/pulsar.dart';

final pattern = PatternData.fromArrays(
  amplitude: [[0, 0], [400, 1], [800, 0]],
  frequency: [[0, 0.3], [800, 0.8]],
  discrete: [[0, 1, 0.5]],
);

HapticLottie.asset(
  'assets/success.json',
  haptics: pattern,
  autoPlay: true,
  onControllerCreated: (c) => _controller = c, // drive transport later
);

Usage — attach to your own AnimationController #

If you already drive Lottie with an AnimationController, wrap it:

final anim = AnimationController(vsync: this);
final haptic = HapticLottieController(
  animationController: anim,
  haptics: pattern,
);
// ...
Lottie.asset('assets/success.json', controller: anim, onLoaded: (c) {
  anim.duration = c.duration;
});
// transport steers both animation + haptics:
haptic.play();
haptic.setTimestamp(1200);
haptic.pause();

Options #

Engine modes #

• realtime (default) — the AnimationController is the master clock; the pattern is sampled every frame into RealtimeComposer.set / playDiscrete. Honours pause / setTimestamp / loop. Continuous fidelity is realtime-grade (coarser on Android).
• pattern — the pre-parsed pattern plays whole via PatternComposer, aligned to the start (best native fidelity). Seek/pause on the haptic side are best-effort.

There is no playback-speed control — the haptic timeline can't be rate-shifted coherently, so the animation runs at its authored speed.

License #

MIT