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

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

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

الشكل 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.