Lottie Windows

Лотти-Винты

Lottie-Windows-это библиотека для отмены Adobe After Effects Animations изначально в вашем приложении. Этот проект добавляет Windows в семейство инструментов Lottie, также нацеленную на Android, iOS и Web.

Lottie упрощает рабочий процесс дизайна к коду для привлечения привлекательных, интерактивных векторных анимаций в ваши приложения Windows, со значительными улучшениями с точки зрения производительности, качества и инженерной эффективности по сравнению с традиционными подходами, такими как GIF, вручную кодированную анимацию и т. Д.

Lottie-Windows состоит из 3 связанных продуктов:

• Библиотека Lottie-Windows для анализа и перевода файлов bodymovin json
• Инструмент командной строки Lottiegen для генерации кода C# или C ++ для использования вместо JSON
• Приложение Lottie Viewer для предварительного просмотра JSON, а также создание кода

Этот репо также содержит исходный код для образцов .

Быстрый старт

Есть два варианта интеграции анимации Lottie в ваш проект Winui 3 или UWP .

Вариант № 1, используя динамический загрузчик

1. Установить CommunityToolkit.WinUI.Lottie Nuget Package для проекта Winui (или CommunityToolkit.Uwp.Lottie для UWP Project).
2. Если вы используете C#, вам также может потребоваться установить Microsoft.Graphics.Win2D (версия 1.0.5 или ниже) для проекта Winui (или Win2D.uwp и Microsoft.UI.Xaml для UWP Project).
3. В вашем файле .xaml Markup Add:

       ...
       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. Установить инструмент CodeGen с использованием dotnet tool install lottiegen в PowerShell
2. Запустить инструмент CodeGen lottiegen -InputFile MyAnimation.json -Language cs -WinUIVersion 3
   • Для проектов UWP Использование -WinUIVersion 2.X в зависимости от версии Microsoft.UI.Xaml
   • Другие языковые варианты: cppwinrt и cppcx
3. Добавить сгенерированные исходные файлы в проект
4. Установите пакеты с шага 2 опции № 1, если это необходимо.
5. В вашем файле .xaml Markup Add:

       ...
       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 г. обновление (18362), а затем

Документация

• Документация и учебные пособия
• Lottie Samples
• Лотти зритель

Статус сборки

Упаковка	Ветвь	Статус	Последняя версия Nuget
CommunityToolkit.winui.lottie	основной
Communitytoolkit.uwp.lottie	основной
Лоттиген	основной

Обратная связь и запросы

Пожалуйста, используйте проблемы GitHub для отчетов об ошибках и запросов функций.

Принципы

Этот проект принял Кодекс поведения, определяемый Заветом участника, чтобы прояснить ожидаемое поведение в нашем сообществе. Для получения дополнительной информации см. Код поведения .NET .NET.

.Net Foundation

Этот проект поддерживается Фондом .NET.