يمكنك توفير تجربة تفاعلية أكثر للمستخدمين في تطبيقك من خلال تحميل ملف قابل للرسم لعرض صور متحركة. تكون الصور المتحركة مفيدة لإنشاء مؤشرات التحميل أو مؤشرات النجاح أو الخطأ، وتسهيل تطوير الألعاب، ووظائف أخرى مختلفة لواجهة المستخدم.
توافق الإصدار
يتطلّب هذا التنفيذ ضبط الحد الأدنى من إصدار حزمة SDK لمشروعك على المستوى 21 من واجهة برمجة التطبيقات أو إصدار أحدث.
التبعيات
عرض صورة متحركة
يعرض الرمز البرمجي التالي متجهًا متحركًا يتحوّل تلقائيًا بين حالتَين:
@Composable fun AnimatedVectorDrawable() { val image = AnimatedImageVector.animatedVectorResource(R.drawable.ic_hourglass_animated) var atEnd by remember { mutableStateOf(false) } Image( painter = rememberAnimatedVectorPainter(image, atEnd), contentDescription = "Timer", modifier = Modifier.clickable { atEnd = !atEnd }, contentScale = ContentScale.Crop ) }
النقاط الرئيسية حول الرمز
- تحمِّل هذه الوظيفة موردًا مرسومًا متّجهًا، ما يؤدي إلى إضافة حركة إلى سمات الرسم بمرور الوقت.
- مثيل
Image
يستخدم مثيلPainter
لتنفيذ التأثير المتحرك الذي تم إنشاؤه من حالتَيAnimatedImageVector
وboolean
بواسطة الدالةrememberAnimatedVectorPainter()
. - عندما يكون
atEnd
هوtrue
، يتوقف مثيلPainter
عن عرض الصور المتحركة.
النتائج
![ساعة رملية تُظهر محتوياتها وتدور](https://developer.android.google.cn/static/develop/ui/compose/images/animations/avd_example_compose.gif?hl=ar)
المجموعات التي تتضمّن هذا الدليل
هذا الدليل هو جزء من مجموعات الأدلة السريعة المنظَّمة التي تتناول أهداف تطوير Android الأوسع نطاقًا:
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=ar)