اختيار واجهة برمجة تطبيقات للصور المتحركة

يساعدك المخطّط البياني أدناه في تحديد واجهة برمجة التطبيقات التي تريد استخدامها لتنفيذ الصورة المتحركة.

مخطّط بياني انسيابي يصف شجرة القرار لاختيار الصورة المتحركة المناسبة
واجهة برمجة التطبيقات

الشكل 1. شجرة قرارات توضّح كيفية اختيار واجهة برمجة التطبيقات المناسبة للرسوم المتحركة

اتّبِع أسئلة شجرة القرارات أدناه لاختيار واجهة برمجة التطبيقات المناسبة للرسوم المتحركة والتي تناسب حالة الاستخدام الخاصة بك:

  • هل الصورة المتحركة تشبه العمل الفني، وتتكون من العديد من العناصر المرئية؟ مثلاً، ملفات SVG أو صور؟
    • نعم: هل يحتوي على صور SVG بسيطة؟ أي رمز يتضمّن رسومًا متحركة صغيرة؟
    • لا: هل يجب تكرار الإجراء إلى الأبد؟
      • نعم: rememberInfiniteTransition
      • لا: هل هذا تأثير متحرك للتخطيط؟
        • نعم: هل يمكن التبديل بين مكونات متعددة تتضمّن محتوى مختلفًا؟
          • نعم: باستخدام ميزة التنقّل-الإنشاء؟
          • لا: هل يتم عرض ظهور / اختفاء متحرك؟
            • نعم: AnimatedVisibility أو animateFloatAsState مع Modifier.alpha()
            • لا: هل تريد تغيير حجم الصورة المتحركة؟
              • نعم: Modifier.animateContentSize
              • لا: هل هناك سمة أخرى للتنسيق؟ مثل التوسيع أو الحشو وما إلى ذلك؟
                • نعم: راجِع السؤال "هل السمات مستقلة تمامًا عن بعضها؟"
                • لا: هل تريد إضافة صور متحركة لعناصر القائمة؟
                  • نعم: animateItemPlacement() (ستتوفّر ميزة إعادة الترتيب والحذف قريبًا)
        • لا: هل تحتاج إلى إضافة رسوم متحركة إلى مواقع متعددة؟
          • نعم: هل المواقع مستقلة تمامًا عن بعضها البعض؟
            • نعم: animate*AsState، للنص، استخدِم TextMotion.Animated
            • لا: هل المطلوب البدء في الوقت نفسه؟
              • نعم: نعم: updateTransition مع AnimatedVisibility وanimateFloat وanimateInt وما إلى ذلك
              • لا: Animatable مع animateTo التي يتم استدعاؤها بتوقيتات مختلفة (باستخدام دوال التعليق)
          • لا: هل تحتوي الصورة المتحركة على مجموعة من القيم المستهدَفة المحدّدة مسبقًا؟
            • نعم: animate*AsState، استخدِم TextMotion.Animated للنص.
            • لا: هل هناك صور متحركة مستندة إلى الإيماءات؟ هل الصورة المتحركة هي المصدر الوحيد للحقيقة؟
              • نعم: Animatable مع animateTo / snapTo
              • لا: هل المؤثر المتحرّك عبارة عن لقطة واحدة بدون إدارة الحالات؟

نزِّل نسخة الرسم البياني بتنسيق PDF.