Media3 Transformer is actively under development and we are looking to hear from you! We welcome your feedback, feature requests and bug reports in the issue tracker. Follow the ExoPlayer blog for the latest updates.
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
برنامه نمایشی Transformer به شما امکان می‌دهد قابلیت‌های API را امتحان کنید و رسانه خود را تغییر دهید، از جمله تبدیل رسانه بین فرمت‌ها، کوتاه کردن و اعمال جلوه‌های ویدیویی.
در این صفحه نحوه دریافت، کامپایل و اجرای برنامه آزمایشی توضیح داده شده است. این راهنما همچنین نحوه استفاده از برنامه آزمایشی برای تغییر رسانه خود را توضیح می دهد.
کد را دریافت کنید
کد منبع برنامه اصلی نسخه آزمایشی را می‌توانید در پوشه demos/transformerپروژه GitHub پیدا کنید. اگر قبلاً این کار را انجام نداده اید، پروژه را در یک فهرست محلی کلون کنید:
git clone https://github.com/androidx/media.git
سپس پروژه را در اندروید استودیو باز کنید. باید موارد زیر را در نمای پروژه Android مشاهده کنید (پوشه های مربوطه برنامه آزمایشی گسترش یافته است):
پروژه در اندروید استودیو
نسخه ی نمایشی را کامپایل و اجرا کنید
برای کامپایل و اجرای برنامه آزمایشی، پیکربندی demo-transformer در Android Studio انتخاب و اجرا کنید. برنامه آزمایشی روی یک دستگاه متصل به 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 برای امتحان کردن آن است.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Transformer demo application\n\nThe Transformer demo app lets you try out the API's capabilities and transform\nyour own media, including converting media between formats, trimming, and\napplying video effects.\n\nThis page describes how to get, compile, and run the demo app. This guide also\ndescribes how to use the demo app to transform your own media.\n\nGet the code\n------------\n\nThe source code for the main demo app can be found in the `demos/transformer`\nfolder of the [GitHub project](https://github.com/androidx/media). If you\nhaven't already done so, clone the project into a local directory: \n\n```\ngit clone https://github.com/androidx/media.git\n```\n\nNext, open the project in Android Studio. You should see the following in the\nAndroid Project view (the relevant folders of the demo app have been expanded):\nThe project in Android Studio\n\nCompile and run the demo\n------------------------\n\nTo compile and run the demo app, select and run the `demo-transformer`\nconfiguration in Android Studio. The demo app will install and run on a\nconnected Android-powered device. We recommend using a physical device if\npossible, because typically an emulator's implementation of Android's media\nstack has different capabilities and bugs compared to a real device.\nDemo app configuration activity\n\nThe demo app begins with the `ConfigurationActivity`, an activity where you can\nset up the input media item and the transformation you want to perform. The two\nbuttons at the top of the screen let you choose from a list of preset media\nfiles or pick a local file. Next, the scrollable list of options lets you\nconfigure the output format and transformations, and you can select effects to\napply to the media. Tapping the last button transitions to\n`TransformerActivity`, an activity that shows the current progress and a preview\nof frames as they are passing through Transformer. Once transformation\ncompletes, the input and output videos are shown together in two ExoPlayer\n`PlayerView` instances.\n\nTransform your own content\n--------------------------\n\nThe demo app supports selecting media for transformation using the buttons at\nthe top of the configuration screen. You can also pass a URL directly on the\ncommand line: \n\n```\nadb shell am start -a androidx.media3.demo.transformer.action.VIEW \\\n -d https://yourdomain.com/sample.mp4\n```\n| **Tip:** If you see errors when selecting local media using this feature, check the [troubleshooting page](/media/media3/transformer/troubleshooting#local-files).\n\nMediaPipe integration\n---------------------\n\nThe demo app includes an example integration with\n[MediaPipe](https://developers.google.com/mediapipe). You will need to build the\ndependency manually, then select the `withMediaPipe` build variant to enable\nbuilding the app with the media pipe frame processor. See the\n[README](https://github.com/androidx/media/tree/release/demos/transformer#mediapipe-frame-processing-demo)\nfor full instructions. The effects selector in the configuration activity\nincludes an example MediaPipe-based effect to try this out."]]
