Lottie Windows

Lottie-Windows

Lottie-Windows是一个库，用于在您的应用程序中呈现Adobe After After Effects动画。该项目将窗口添加到洛蒂（Lottie）的工具家族中，也针对Android，iOS和Web。

Lottie simplifies the design-to-code workflow for bringing engaging, interactive vector animations to your Windows applications, with significant improvements in terms of performance, quality, and engineering efficiency over traditional approaches such as gifs, manually coded animations, etc. Lottie-Windows uses the Windows.UI.Composition APIs to provide smooth 60fps animations and resolution-independent vector graphics.

Lottie-Windows由3种相关产品组成：

• Lottie-Windows库，用于解析和翻译BodyMovin JSON文件
• Lottiegen命令行工具用于生成要使用C＃或C ++代码而不是JSON
• Lottie查看器应用程序预览JSON并生成代码

此存储库还包含样本的源代码。

快速开始

将Lottie动画集成到Winui 3或UWP项目中有两种选择。

选项＃1，使用动态加载器

1. 安装CommunityToolkit.WinUI.Lottie nuget软件包，用于winui项目（或UWP项目的CommunityToolkit.Uwp.Lottie ）。
2. 如果您使用的是C＃，则可能需要将Microsoft.Graphics.Win2D （1.0.5或以下版本）安装Winui Project（或Win2D.uwp和Microsoft.UI.Xaml ）进行UWP项目。
3. 在您的.xaml标记文件中添加：

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

   或为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 >

选项＃2，使用Codegen（推荐）

1. 使用dotnet tool install lottiegen
2. 运行CodeGen工具lottiegen -InputFile MyAnimation.json -Language cs -WinUIVersion 3
   • 对于UWP项目，使用-WinUIVersion 2.X具体取决于Microsoft.UI.Xaml的版本
   • 其他语言选项： cppwinrt和cppcx
3. 将生成的源文件添加到项目
4. 如果需要，请从选项＃1的步骤2安装软件包。
5. 在您的.xaml标记文件中添加：

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

   或为UWP项目：

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

支持的SDK

• 2019年5月更新（18362）及以后

文档

• 文档和教程
• 洛蒂样品
• Lottie的观众

建立状态

包裹	分支	地位	最新的Nuget版本
communityToolkit.winui.lottie	主要的
communityToolkit.uwp.lottie	主要的
洛蒂根	主要的

反馈和请求

请使用GitHub问题进行错误报告和功能请求。

原则

该项目采用了贡献者盟约定义的行为准则，以阐明我们社区的预期行为。有关更多信息，请参见.NET基金会行为守则。

.NET基金会

该项目得到了.NET基金会的支持。