Lottie Windows

Lottie-Windows

Lottie-Windows es una biblioteca para hacer animaciones de Adobe After Effects de forma nativa en su aplicación. Este proyecto agrega Windows a la familia de herramientas Lottie también dirigida a Android, iOS y Web.

Lottie simplifica el flujo de trabajo de diseño a código para llevar animaciones vectoriales interactivas e interactivas a sus aplicaciones de Windows, con mejoras significativas en términos de rendimiento, calidad y eficiencia de ingeniería sobre enfoques tradicionales como GIF, gifs, animaciones codificadas manualmente, etc. Lottie-Windows utiliza las API de la posición Windows.ui.com para proporcionar animaciones suaves de 60FPS y grafics vectoriales resectoras resectoras.

Lottie-Windows consta de 3 productos relacionados:

• Biblioteca Lottie-Windows para analizar y traducir los archivos Bodymovin JSON
• Herramienta de línea de comandos de Lottiegen para generar código C# o C ++ que se utilizará en lugar de JSON
• Aplicación del visor de Lottie para una vista previa de JSON y también generar código

Este repositorio también contiene código fuente para muestras .

Comienzo rápido

Hay dos opciones para integrar animaciones Lottie en su proyecto Winui 3 o UWP .

Opción #1, usando un cargador dinámico

1. Instale CommunityToolkit.WinUI.Lottie Nuget Paquete para el proyecto Winui (o CommunityToolkit.Uwp.Lottie para el proyecto UWP).
2. Si está utilizando C#, es posible que también necesite instalar Microsoft.Graphics.Win2D (versión 1.0.5 o debajo) para el proyecto Winui (o Win2D.uwp y Microsoft.UI.Xaml para el proyecto UWP).
3. En su archivo de marcado .xaml , agregue:

       ...
       xmlns:lottie="using:CommunityToolkit.WinUI.Lottie"
       ...
       < AnimatedVisualPlayer >
           < lottie : LottieVisualSource UriSource = " <asset path or web link to a json file> " />
       </ AnimatedVisualPlayer >

   o para el proyecto UWP:

       ...
       xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
       xmlns:lottie="using:CommunityToolkit.Uwp.Lottie"
       ...
       < muxc : AnimatedVisualPlayer >
           < lottie : LottieVisualSource UriSource = " <asset path or web link to a json file> " />
       </ muxc : AnimatedVisualPlayer >

Opción #2, usando Codegen (recomendado)

1. Instale la herramienta CodeGen utilizando dotnet tool install lottiegen en PowerShell
2. Ejecutar la herramienta Codegen lottiegen -InputFile MyAnimation.json -Language cs -WinUIVersion 3
   • Para proyectos de UWP, use -WinUIVersion 2.X dependiendo de la versión de Microsoft.UI.Xaml
   • Otras opciones de idioma: cppwinrt y cppcx
3. Agregar archivos de origen generados al proyecto
4. Instale paquetes desde el paso 2 de la opción #1 si es necesario.
5. En su archivo de marcado .xaml , agregue:

       ...
       xmlns:animatedvisuals="using:AnimatedVisuals"
       ...
       < AnimatedVisualPlayer >
           < animatedvisuals : MyAnimation />
       </ AnimatedVisualPlayer >

   o para el proyecto UWP:

       ...
       xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
       xmlns:animatedvisuals="using:AnimatedVisuals"
       ...
       < muxc : AnimatedVisualPlayer >
           < animatedvisuals : MyAnimation />
       </ muxc : AnimatedVisualPlayer >

SDKS admitidos

• Actualización de mayo de 2019 (18362) y más tarde

Documentación

• Documentación y tutoriales
• Muestras de lottie
• Espectador de lottie

Estado de construcción

Paquete	Rama	Estado	Última versión de Nuget
CommunityToolkit.winui.lottie	principal
CommunityToolkit.uwp.lottie	principal
Lottiegen	principal

Comentarios y solicitudes

Utilice los problemas de GitHub para informes de errores y solicitudes de funciones.

Principios

Este proyecto ha adoptado el Código de Conducta definido por el Pacto de contribuyente para aclarar el comportamiento esperado en nuestra comunidad. Para obtener más información, consulte el Código de Conducta de la Fundación .NET.

Fundación .NET

Este proyecto es compatible con la Fundación .NET.