يتيح لك تطبيق Transformer التجريبي تجربة إمكانات واجهة برمجة التطبيقات وتحويل الوسائط الخاصة بك، بما في ذلك تحويل الوسائط بين التنسيقات وقطعها وتطبيق تأثيرات الفيديو.
توضّح هذه الصفحة كيفية الحصول على التطبيق التجريبي وتجميعه وتشغيله. ويوضّح هذا الدليل أيضًا كيفية استخدام التطبيق التجريبي لتحويل الوسائط الخاصة بك.
حصول على الرمز
يمكن العثور على رمز المصدر للتطبيق التجريبي الرئيسي في المجلد demos/transformer
من مشروع GitHub. إذا لم تكن قد فعلت ذلك بالفعل، فانسخ المشروع في دليل محلي:
git clone https://github.com/androidx/media.git
بعد ذلك، افتح المشروع في "استوديو Android". من المفترض أن يظهر لك ما يلي في عرض مشروع Android (تم توسيع المجلدات ذات الصلة من التطبيق التجريبي):
![المشروع في "استوديو Android"](https://developer.android.com/static/guide/topics/media/transformer/images/demo-project.png?authuser=5&hl=ar)
تجميع العرض التوضيحي وتشغيله
لتجميع التطبيق التجريبي وتشغيله، اختَر إعداد demo-transformer
وشغِّله في "استوديو Android". سيتم تثبيت التطبيق التجريبي وتشغيله على
جهاز متصل يعمل بنظام التشغيل Android. ننصح باستخدام جهاز مادي إن أمكن، لأنّ تنفيذ المحاكي لحزمة الوسائط في نظام Android
عادةً ما يكون له إمكانات وأخطاء مختلفة مقارنةً بالجهاز الحقيقي.
![نشاط إعداد التطبيق التجريبي](https://developer.android.com/static/guide/topics/media/transformer/images/configuration-activity.png?authuser=5&hl=ar)
يبدأ التطبيق التجريبي بعلامة ConfigurationActivity
، وهو نشاط يمكنك من خلاله إعداد عنصر وسائط الإدخال وإجراء التحويل الذي تريد تنفيذه. يتيح لك الزران في أعلى الشاشة الاختيار من قائمة ملفات الوسائط المعدّة مسبقًا أو اختيار ملف محلي. بعد ذلك، تتيح لك قائمة الخيارات القابلة للتمرير
ضبط تنسيق الإخراج وعمليات التحويل، ويمكنك اختيار التأثيرات
لتطبيقها على الوسائط. يؤدي النقر على الزر الأخير إلى الانتقال إلى
TransformerActivity
، وهو نشاط يعرض مستوى التقدم الحالي ومعاينة
للإطارات أثناء مرورها في Transformer. بعد اكتمال عملية التحويل، يتم عرض فيديوهات الإدخال والمخرجات معًا في حالتَي ExoPlayer
PlayerView
.
تحويل المحتوى الخاص بك
يتيح التطبيق التجريبي اختيار الوسائط للتحويل باستخدام الأزرار أعلى شاشة الضبط. يمكنك أيضًا تمرير عنوان URL مباشرةً في سطر الأوامر:
adb shell am start -a androidx.media3.demo.transformer.action.VIEW \ -d https://yourdomain.com/sample.mp4
دمج MediaPipe
يتضمن التطبيق التجريبي مثالاً على عملية الدمج مع
MediaPipe. عليك إنشاء
التبعية يدويًا، ثم تحديد صيغة الإصدار withMediaPipe
لتفعيل
إنشاء التطبيق باستخدام معالج إطار ممر الوسائط. راجِع
ملف README
للاطّلاع على التعليمات الكاملة. تشتمل أداة اختيار التأثيرات في نشاط الإعداد
على مثال مستند إلى MediaPipe لتجربة ذلك.