Lottie Windows

Lottie-Windows

Lottie-Windows هي مكتبة لتقديم الرسوم المتحركة Adobe After Effects أصلاً في تطبيقك. يضيف هذا المشروع Windows إلى عائلة Lottie للأدوات التي تستهدف أيضًا Android و iOS و Web.

يقوم Lottie بتبسيط سير العمل من أجل التصميم لجلب الرسوم المتحركة المتجهة والجذابة إلى تطبيقات Windows الخاصة بك ، مع تحسينات كبيرة من حيث الأداء والجودة والكفاءة الهندسية على الأساليب التقليدية مثل GIFs ، الرسوم المتحركة المشفرة يدويًا ، وما إلى ذلك.

يتكون Lottie-Windows من 3 منتجات ذات صلة:

• مكتبة Lottie-Windows لتحليل وترجمة ملفات Json Bodymovin
• أداة سطر أوامر Lottiegen لإنشاء رمز C# أو C ++ لاستخدامه بدلاً من JSON
• تطبيق Lottie Viewer لمعاينة JSON وأيضًا إنشاء رمز

يحتوي هذا الريبو أيضًا على رمز المصدر للعينات .

بداية سريعة

هناك خياران لدمج الرسوم المتحركة Lottie في مشروع Winui 3 أو UWP .

الخيار رقم 1 ، باستخدام تحميل ديناميكي

1. تثبيت CommunityToolkit.WinUI.Lottie nuget Package لمشروع Winui (أو CommunityToolkit.Uwp.Lottie لمشروع UWP).
2. إذا كنت تستخدم C# ، فقد تحتاج أيضًا إلى تثبيت Microsoft.Graphics.Win2D (الإصدار 1.0.5 أو أدناه) لمشروع Winui (أو 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. تثبيت أداة Codegen باستخدام dotnet tool install lottiegen في PowerShell
2. Run Codegen Tool lottiegen -InputFile MyAnimation.json -Language cs -WinUIVersion 3
   • لمشاريع UWP استخدام -WinUIVersion 2.X اعتمادًا على إصدار Microsoft.UI.Xaml
   • خيارات لغة أخرى: cppwinrt و cppcx
3. إضافة ملفات مصدر تم إنشاؤها إلى المشروع
4. قم بتثبيت الحزم من الخطوة 2 من الخيار رقم 1 إذا لزم الأمر.
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 >

دعم SDKs

• تحديث مايو 2019 (18362) وبعد ذلك

الوثائق

• الوثائق والدروس
• عينات لوتي
• Lottie عارض

بناء الحالة

طَرد	فرع	حالة	أحدث إصدار nuget
communitytoolkit.winui.lottie	رئيسي
CommunityToolkit.uwp.lottie	رئيسي
Lottiegen	رئيسي

ردود الفعل والطلبات

يرجى استخدام مشكلات github لتقارير الأخطاء وطلبات الميزات.

مبادئ

اعتمد هذا المشروع مدونة السلوك التي حددها العهد المساهم لتوضيح السلوك المتوقع في مجتمعنا. لمزيد من المعلومات ، انظر .NET Foundation Code of Code.

.NET Foundation

هذا المشروع مدعوم من قبل مؤسسة .NET.