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 شامل مراحل زیر است:
Media3 Transformer را به عنوان یک وابستگی در پروژه خود اضافه کنید.
یک EditedMediaItem بسازید که نشان دهنده رسانه برای پردازش و ویرایش برای اعمال آن است.
یک Transformer بسازید که خروجی مورد نیاز و شنونده ای را برای رویدادهای تکمیل و خطا توصیف می کند.
عملیات صادرات را شروع کنید و از EditedMediaItem برای ویرایش و یک مسیر خروجی عبور دهید. در حین صادرات، می توانید پیشرفت فعلی را پرس و جو کنید یا عملیات را لغو کنید.
هنگام صادرات نهایی، خروجی را در صورت نیاز مدیریت کنید. به عنوان مثال، می توانید خروجی را در برنامه دیگری به اشتراک بگذارید یا آن را در یک سرور آپلود کنید.
برای جزئیات بیشتر در مورد این مراحل به ادامه مطلب بروید و برای مثال کامل، TransformerActivity در برنامه نمایشی ترانسفورماتور ببینید.
Media3 Transformer را به عنوان یک وابستگی اضافه کنید
ساده ترین راه برای شروع استفاده از Transformer اضافه کردن وابستگی های gradle به کتابخانه در فایل build.gradle ماژول برنامه است:
اگر قبلاً فعال نیست، باید پشتیبانی از جاوا 8 را در همه فایل‌های build.gradle که به Transformer وابسته هستند، با افزودن موارد زیر به بخش android فعال کنید:
در اینجا مثالی از ایجاد یک EditedMediaItem برای حذف صدا برای یک فایل ورودی، سپس ایجاد و پیکربندی یک نمونه Transformer برای صادر کردن ویدیوی H.265/HEVC و خروجی نتیجه به outputPath آورده شده است.
برای اطلاعات بیشتر در مورد موارد رسانه، به صفحه موارد رسانه ExoPlayer مراجعه کنید. ورودی می تواند یک جریان پیش رونده یا تطبیقی باشد، اما خروجی همیشه یک جریان پیش رونده است. برای ورودی‌های تطبیقی، آهنگ‌های با بالاترین وضوح همیشه برای تبدیل انتخاب می‌شوند. ورودی می تواند از هر فرمت کانتینری باشد که توسط ExoPlayer پشتیبانی می شود ، اما خروجی همیشه یک فایل MP4 است.
می توانید چندین عملیات صادرات را به صورت متوالی در یک نمونه Transformer اجرا کنید، اما صادرات همزمان با همان نمونه پشتیبانی نمی شود.
نکته ای در مورد نخ زنی
به نمونه های ترانسفورماتور باید از یک رشته برنامه دسترسی داشت و متدهای شنونده در همان رشته فراخوانی می شوند. در اکثر موارد، موضوع برنامه فقط می تواند موضوع اصلی برنامه باشد. در داخل، Transformer کار خود را در پس‌زمینه انجام می‌دهد و تماس‌های خود را با متدهای شنونده در رشته برنامه ارسال می‌کند.
به رویدادها گوش دهید
روش start ناهمزمان است. بلافاصله برمی‌گردد و برنامه از طریق شنونده که به سازنده Transformer ارسال می‌شود، از رویدادها مطلع می‌شود.
ExportResult شامل اطلاعات مربوط به فایل خروجی، از جمله اندازه فایل و میانگین نرخ بیت برای صدا و تصویر، در صورت لزوم است.
به روز رسانی پیشرفت را دریافت کنید
با Transformer.getProgress تماس بگیرید تا پیشرفت فعلی یک تبدیل را جویا شوید. مقدار برگشتی نشان دهنده وضعیت پیشرفت است. اگر وضعیت پیشرفت PROGRESS_STATE_AVAILABLE باشد، آنگاه ProgressHolder ارائه شده با درصد پیشرفت فعلی به روز می شود. مثال زیر نشان می دهد که چگونه می توان به طور دوره ای از پیشرفت یک تبدیل پرس و جو کرد، که در آن روش updateProgressInUi می تواند برای به روز رسانی نوار پیشرفت پیاده سازی شود.
اگر کاربر تصمیم گرفت از جریان صادرات خارج شود، عملیات صادرات را با Transformer.cancel لغو کنید. منابعی مانند کدک‌های ویدیوی سخت‌افزاری، به‌ویژه در دستگاه‌های پایین‌رده محدود هستند، بنابراین انجام این کار برای آزاد کردن منابع در صورت عدم نیاز به خروجی بسیار مهم است.
تاریخ آخرین بهروزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-08-27 بهوقت ساعت هماهنگ جهانی."],[],[],null,["Getting started with `Transformer` consists of the following steps:\n\n1. Add Media3 Transformer as a dependency in your project.\n2. Build an `EditedMediaItem` representing the media to process and edits to apply to it.\n3. Build a `Transformer`, describing the required output and a listener for completion and error events.\n4. Start the export operation, passing in the `EditedMediaItem` to edit and an output path. During export, you can query the current progress or cancel the operation.\n5. When exporting finishes, handle the output as needed. For example, you can share the output to another app or upload it to a server.\n\nRead on for more detail about these steps, and see `TransformerActivity` in the\n[transformer demo\napp](https://github.com/androidx/media/tree/release/demos/transformer) for a\ncomplete example.\n\nAdd Media3 Transformer as a dependency\n\nThe easiest way to get started using Transformer is to add gradle dependencies\non the library in the `build.gradle` file of your app module: \n\nKotlin \n\n```kotlin\nimplementation(\"androidx.media3:media3-transformer:1.8.0\")\nimplementation(\"androidx.media3:media3-effect:1.8.0\")\nimplementation(\"androidx.media3:media3-common:1.8.0\")\n```\n\nGroovy \n\n```groovy\nimplementation \"androidx.media3:media3-transformer:1.8.0\"\nimplementation \"androidx.media3:media3-effect:1.8.0\"\nimplementation \"androidx.media3:media3-common:1.8.0\"\n```\n\nwhere 1.8.0 is your preferred version. The latest version can be\nfound by consulting the [release\nnotes](https://github.com/androidx/media/tree/release/RELEASENOTES.md).\n| **Important:** If you're using any other Media3 modules, including Media3 ExoPlayer, they must all be the same version.\n\nMore information on the library modules that are available can be found on the\n[Google Maven AndroidX Media3\npage](https://maven.google.com/web/index.html?q=media3).\n\nTurn on Java 8 support\n\nIf not enabled already, you need to turn on Java 8 support in all `build.gradle`\nfiles that depend on Transformer by adding the following to the `android`\nsection: \n\n compileOptions {\n targetCompatibility JavaVersion.VERSION_1_8\n }\n\nStart a transformation\n\nHere's an example of creating an `EditedMediaItem` to remove audio for an input\nfile, then creating and configuring a `Transformer` instance to export\nH.265/HEVC video, outputting the result to `outputPath`. \n\nKotlin \n\n```kotlin\nval inputMediaItem = MediaItem.fromUri(\"path_to_input_file\")\nval editedMediaItem =\n EditedMediaItem.Builder(inputMediaItem).setRemoveAudio(true).build()\nval transformer = Transformer.Builder(context)\n .setVideoMimeType(MimeTypes.VIDEO_H265)\n .addListener(transformerListener)\n .build()\ntransformer.start(editedMediaItem, outputPath)\n```\n\nJava \n\n```java\nMediaItem inputMediaItem = MediaItem.fromUri(\"path_to_input_file\");\nEditedMediaItem editedMediaItem =\n new EditedMediaItem.Builder(inputMediaItem).setRemoveAudio(true).build();\nTransformer transformer =\n new Transformer.Builder(context)\n .setVideoMimeType(MimeTypes.VIDEO_H265)\n .addListener(transformerListener)\n .build();\ntransformer.start(editedMediaItem, outputPath);\n```\n\n\u003cbr /\u003e\n\nFor more information about media items, see the [ExoPlayer media items\npage](../exoplayer/media-items). The input can be a progressive or an adaptive\nstream, but the output is always a progressive stream. For adaptive inputs, the\nhighest-resolution tracks are always selected for the transformation. The input\ncan be of any container format [supported](/media/media3/transformer/supported-formats) by ExoPlayer, but\nthe output is always an MP4 file.\n\nYou can execute multiple export operations sequentially on the same\n`Transformer` instance, but concurrent exports with the same instance are not\nsupported.\n| **Note:** Support for generating media by composing together multiple inputs is planned for future versions of Transformer.\n\nA note on threading\n\nTransformer instances must be accessed from a single application thread, and the\nlistener methods are called on the same thread. For the majority of cases, the\napplication thread can just be the main thread of the application. Internally,\nTransformer does its work in the background and posts its calls to listener\nmethods on the application thread.\n\nListen to events\n\nThe `start` method is asynchronous. It returns immediately and the app is\nnotified of events through the listener passed to the `Transformer` builder. \n\nKotlin \n\n```kotlin\nval transformerListener: Transformer.Listener =\n object : Transformer.Listener {\n override fun onCompleted(composition: Composition, result: ExportResult) {\n playOutput()\n }\n\n override fun onError(composition: Composition, result: ExportResult,\n exception: ExportException) {\n displayError(exception)\n }\n}\n```\n\nJava \n\n```java\nTransformer.Listener transformerListener =\n new Transformer.Listener() {\n @Override\n public void onCompleted(Composition composition, ExportResult result) {\n playOutput();\n }\n\n @Override\n public void onError(Composition composition, ExportResult result,\n ExportException exception) {\n displayError(exception);\n }\n };\n```\n\n\u003cbr /\u003e\n\n`ExportResult` includes information about the output file, including the file\nsize and average bitrates for audio and video, as applicable.\n\nGet progress updates\n\nCall `Transformer.getProgress` to query the current progress of a\ntransformation. The returned value indicates the progress state. If the progress\nstate is `PROGRESS_STATE_AVAILABLE`, then the provided `ProgressHolder` is\nupdated with the current progress percentage. The following example shows how to\nperiodically query the progress of a transformation, where the\n`updateProgressInUi` method can be implemented to update a progress bar. \n\nKotlin \n\n```kotlin\ntransformer.start(inputMediaItem, outputPath)\nval progressHolder = ProgressHolder()\nmainHandler.post(\n object : Runnable {\n override fun run() {\n val progressState: @ProgressState Int = transformer.getProgress(progressHolder)\n updateProgressInUi(progressState, progressHolder)\n if (progressState != Transformer.PROGRESS_STATE_NOT_STARTED) {\n mainHandler.postDelayed(/* r= */this, /* delayMillis= */500)\n }\n }\n }\n)\n```\n\nJava \n\n```java\ntransformer.start(inputMediaItem, outputPath);\nProgressHolder progressHolder = new ProgressHolder();\nmainHandler.post(\n new Runnable() {\n @Override\n public void run() {\n @Transformer.ProgressState int progressState = transformer.getProgress(progressHolder);\n updateProgressInUi(progressState, progressHolder);\n if (progressState != PROGRESS_STATE_NOT_STARTED) {\n mainHandler.postDelayed(/* r= */ this, /* delayMillis= */ 500);\n }\n }\n });\n```\n\n\u003cbr /\u003e\n\nCancel a transformation\n\nIf the user chooses to back out of an export flow, cancel the export operation\nwith `Transformer.cancel`. Resources like hardware video codecs are limited,\nespecially on lower-end devices, so it's important to do this to free up\nresources if the output isn't needed."]]
