LottieAnimation QML Type
Un reproductor de Lottie para Qt. Más información...
| Import Statement: | import Qt.labs.lottieqt 1.0 |
Propiedades
- autoPlay : bool
- currentFrame : int
(since 6.12) - direction : enumeration
- endFrame : int
- frameRate : int
- loops : int
- quality : enumeration
- source : url
- startFrame : int
- status : enumeration
Señales
- finished()
Métodos
- double getDuration(bool inFrames)
- void gotoAndPlay(int frame)
- bool gotoAndPlay(string frameMarker)
- void gotoAndStop(int frame)
- bool gotoAndStop(string frameMarker)
- void pause()
- void play()
- void start()
- void stop()
- void togglePause()
Descripción detallada
El tipo LottieAnimation muestra archivos en formato Lottie.
LottieAnimation se utiliza para cargar y reproducir archivos Lottie exportados desde Adobe After Effects. Actualmente, solo se admite un subconjunto de la especificación completa de Lottie. Las diferencias más notables son:
- Solo se admiten capas de forma
- Solo se admite el modo de fotogramas enteros en la línea de tiempo (los números de fotograma y el tiempo reales se redondean al entero más cercano)
- No se admiten expresiones
Para consultar la lista completa de diferencias, véase la sección «Limitaciones ».
Ejemplo de uso
El siguiente ejemplo muestra un uso sencillo del tipo «LottieAnimation»
LottieAnimation {
loops: 2
quality: LottieAnimation.MediumQuality
source: "animation.json"
autoPlay: false
onStatusChanged: {
if (status === LottieAnimation.Ready) {
// any acvities needed before
// playing starts go here
gotoAndPlay(startFrame);
}
}
onFinished: {
console.log("Finished playing")
}
}Nota: Cambiar el ancho o la altura del elemento no modifica el tamaño de la animación que contiene. Además, no es posible alinear el contenido dentro de un elemento ` LottieAnimation `. Para lograrlo, coloque la animación dentro de, por ejemplo, un elemento ` Item`.
Rendimiento de la representación
Internamente, los datos de los fotogramas renderizados se almacenan en caché para mejorar el rendimiento. Puedes controlar el uso de memoria configurando la variable de entorno QLOTTIE_RENDER_CACHE_SIZE (el valor por defecto es 2).
Puedes supervisar el rendimiento del renderizado activando dos categorías de registro:
qt.lottieqt.lottie.render- Proporciona información sobre cómo se renderiza la animaciónqt.lottieqt.lottie.render.thread- Proporciona información sobre cómo avanza el proceso de renderizado.
En concreto, puedes comprobar si la caché de fotogramas se llena constantemente o si el proceso de renderizado tiene que esperar a que los fotogramas estén listos. El primer caso implica que la animación es demasiado compleja y que el renderizado no puede seguir el ritmo. Intenta simplificar la animación u optimizar la escena QML.
Documentación de propiedades
autoPlay : bool
Define si el reproductor comenzará a reproducir la animación automáticamente una vez que se haya cargado el archivo de animación.
El valor por defecto es « true ».
currentFrame : int [read-only, since 6.12]
El número del fotograma de la animación que se muestra actualmente.
Esta propiedad se introdujo en Qt 6.12.
direction : enumeration
Esta propiedad almacena la dirección de representación.
| Constante | Descripción |
|---|---|
LottieAnimation.Forward | Dirección hacia delante (por defecto) |
LottieAnimation.Reverse | Dirección inversa |
endFrame : int [read-only]
Número de fotograma del final de la animación. El valor está disponible una vez que la animación se ha cargado y está lista para reproducirse.
frameRate : int
Esta propiedad contiene el valor de la velocidad de fotogramas de la animación Lottie.
frameRate Cambia una vez que se ha cargado el recurso. Modificar la velocidad de fotogramas no surte efecto antes de ese momento, ya que el valor definido en el recurso prevalece sobre este. Para cambiar la velocidad de fotogramas, puedes escribir:
LottieAnimation {
source: "animation.json"
onStatusChanged: {
if (status === LottieAnimation.Ready)
frameRate = 60;
}loops : int
Esta propiedad indica el número de repeticiones que realizará el reproductor. El valor « LottieAnimation.Infinite » significa que el reproductor repite la animación de forma continua.
El valor por defecto es « 1 ».
quality : enumeration
Especifica la calidad de renderizado del reproductor Lottie. Si se selecciona « LowQuality », el renderizado se realizará en un objeto de búfer de fotogramas, mientras que con otras opciones, el renderizado se realizará en un « QImage » (que, a su vez, se mostrará en pantalla).
| Constante | Descripción |
|---|---|
LottieAnimation.LowQuality | No se utiliza el suavizado ni un algoritmo de transformación suave de mapas de píxeles |
LottieAnimation.MediumQuality | Se utiliza un algoritmo de transformación suave de mapas de píxeles, pero no se aplica suavizado de bordes (por defecto) |
LottieAnimation.HighQuality | Se utilizan tanto el suavizado como un algoritmo de transformación suave de mapas de píxeles |
source : url
La fuente del recurso Lottie que reproduce LottieAnimation.
LottieAnimation puede admitir cualquier esquema de URL compatible con Qt. La URL puede ser absoluta o relativa a la URL del componente.
Al establecer la propiedad «source», se inicia la carga de la animación de forma asíncrona. Para supervisar el progreso de la carga, conéctate a la señal de cambio « status ».
startFrame : int [read-only]
Número de fotograma en el que comienza la animación. El valor está disponible una vez que la animación se ha cargado y está lista para reproducirse.
status : enumeration
Esta propiedad contiene el estado actual del elemento « LottieAnimation ».
| Constante | Descripción |
|---|---|
LottieAnimation.Null | Un valor inicial que se utiliza cuando la fuente no está definida (por defecto) |
LottieAnimation.Loading | El reproductor está cargando un archivo Lottie |
LottieAnimation.Ready | La carga se ha completado correctamente y el reproductor está listo para reproducir la animación |
LottieAnimation.Error | Se ha producido un error al cargar la animación |
Por ejemplo, podrías implementar un controlador de señal de « onStatusChanged » para supervisar el progreso de la carga de una animación de la siguiente manera:
LottieAnimation {
source: "animation.json"
autoPlay: false
onStatusChanged: {
if (status === LottieAnimation.Ready)
start();
}Documentación sobre señales
finished()
Esta señal se emite cuando el reproductor ha terminado de reproducir. En caso de reproducción en bucle, la señal se emite cuando ha finalizado el último bucle.
Nota: El controlador correspondiente es onFinished.
Documentación del método
double getDuration(bool inFrames)
Devuelve la duración del recurso que se está reproduciendo actualmente.
Si el parámetro « inFrames » tiene el valor « true », el valor devuelto es la duración en número de fotogramas. En caso contrario, devuelve la duración en segundos.
void gotoAndPlay(int frame)
Reproduce el recurso desde la dirección frame.
bool gotoAndPlay(string frameMarker)
Reproduce el recurso a partir del fotograma que contiene un marcador con el valor « frameMarker » especificado. Devuelve « true » si se ha encontrado el «frameMarker» y, en caso contrario, « false ».
void gotoAndStop(int frame)
Mueve el indicador de reproducción a la dirección especificada frame y se detiene.
bool gotoAndStop(string frameMarker)
Mueve el indicador de reproducción hasta el marcador indicado y se detiene. Devuelve ` true ` si se ha encontrado ` frameMarker `, y ` false ` en caso contrario.
void pause()
Pone en pausa la reproducción.
void play()
Comienza o continúa la reproducción desde la posición actual.
void start()
Comienza a reproducir la animación desde el principio.
void stop()
Detiene la reproducción y vuelve a startFrame.
void togglePause()
Alterna el estado del reproductor entre «en reproducción» y «en pausa».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.