تطبيق تجريبي للمحوِّل

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

توضّح هذه الصفحة كيفية الحصول على التطبيق التجريبي وتجميعه وتشغيله. ويوضّح هذا الدليل أيضًا كيفية استخدام التطبيق التجريبي لتحويل الوسائط الخاصة بك.

حصول على الرمز

يمكن العثور على رمز المصدر للتطبيق التجريبي الرئيسي في المجلد demos/transformer من مشروع GitHub. إذا لم تكن قد فعلت ذلك بالفعل، فانسخ المشروع في دليل محلي:

git clone https://github.com/androidx/media.git

بعد ذلك، افتح المشروع في "استوديو Android". من المفترض أن يظهر لك ما يلي في عرض مشروع Android (تم توسيع المجلدات ذات الصلة من التطبيق التجريبي):

المشروع في "استوديو Android"
المشروع في "استوديو Android"

تجميع العرض التوضيحي وتشغيله

لتجميع التطبيق التجريبي وتشغيله، اختَر إعداد demo-transformer وشغِّله في "استوديو Android". سيتم تثبيت التطبيق التجريبي وتشغيله على جهاز متصل يعمل بنظام التشغيل Android. ننصح باستخدام جهاز مادي إن أمكن، لأنّ تنفيذ المحاكي لحزمة الوسائط في نظام Android عادةً ما يكون له إمكانات وأخطاء مختلفة مقارنةً بالجهاز الحقيقي.

نشاط إعداد التطبيق التجريبي
نشاط إعداد التطبيق التجريبي

يبدأ التطبيق التجريبي بعلامة 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 لتجربة ذلك.