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

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

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

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

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

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

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

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

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

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

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

يبدأ التطبيق التجريبي بـ ConfigurationActivity، وهو نشاط يمكنك من خلاله لإعداد عنصر وسائط الإدخال والتحويل الذي تريد إجراؤه. الاثنين في أعلى الشاشة، يمكنكم الاختيار من قائمة وسائط معدّة مسبقًا من الملفات أو اختر ملفًا محليًا. بعد ذلك، تتيح لك قائمة الخيارات القابلة للتمرير وتهيئة تنسيق الإخراج والتحويل، كما يمكنك تحديد التأثيرات تطبيقها على وسائل الإعلام. يؤدي النقر على انتقالات الزر الأخير إلى TransformerActivity، نشاط يعرض مستوى التقدّم الحالي ومعاينة من الإطارات أثناء مرورها عبر المحوّل. بعد التحويل يتم عرض مقاطع الفيديو المدخلة والإخراج معًا في قائمتي ExoPlayer PlayerView أمثلة.

تحويل المحتوى الخاص بك

يدعم تطبيق العرض التوضيحي تحديد الوسائط للتحويل باستخدام الأزرار في الجزء العلوي من شاشة التهيئة. يمكنك أيضًا تمرير عنوان URL مباشرةً في سطر الأوامر:

adb shell am start -a androidx.media3.demo.transformer.action.VIEW \
    -d https://yourdomain.com/sample.mp4

دمج MediaPipe

يتضمن التطبيق التجريبي مثالاً للتكامل مع MediaPipe: ستحتاج إلى إنشاء الاعتمادية يدويًا، ثم حدِّد صيغة الإصدار withMediaPipe لتفعيلها إنشاء التطبيق باستخدام معالج إطار أنبوب الوسائط. يمكنك الاطّلاع على قراءة للحصول على التعليمات الكاملة. أداة اختيار التأثيرات في نشاط الضبط مثالاً لتأثير قائم على MediaPipe لتجربة ذلك.