شروع به کار با رابط کاربری مبتنی بر Compose

افزودن وابستگی

کتابخانه Media3 شامل دو واحد میانای کاربر مبتنی بر Jetpack Compose است. لازم نیست هر دو را اضافه کنید چون Material3 به هسته وابسته است.

کاتلین

// Include only one of the following dependencies
implementation("androidx.media3:media3-ui-compose:1.11.1")
implementation("androidx.media3:media3-ui-compose-material3:1.11.1")

شیک

// Include only one of the following dependencies
implementation "androidx.media3:media3-ui-compose:1.11.1"
implementation "androidx.media3:media3-ui-compose-material3:1.11.1"

اکیداً توصیه می‌کنیم برنامه‌تان را با رویکرد Compose-first توسعه دهید یا از Views مهاجرت کنید.

برنامه نمایشی Fully Compose

درحالی‌که کتابخانه media3-ui-compose شامل composableهای آماده (مانند دکمه‌ها، نشانگرها، تصاویر، یا کادرهای گفتگو) نیست، می‌توانید یک برنامه نمایشی کاملاً نوشته‌شده در Compose پیدا کنید که از هرگونه راه‌حل‌های تعامل‌پذیری مانند قرار دادن PlayerView در AndroidView اجتناب می‌کند. برنامه نمایشی از کلاس‌های نگه‌دارنده حالت میانای کاربر از ماژول media3-ui-compose و کتابخانه Compose Material3 استفاده می‌کند.

به کدام کتابخانه نیاز دارم؟

بسته به سطح سفارشی‌سازی موردنیازتان، می‌توانید بین دو کتابخانه Media3 Compose انتخاب کنید. برای درک تفاوت، بهتر است به خط لوله تولید حالت واسط کاربر فکر کنید: Business logic → UI logic → UI.

برای کنترل کامل بر مؤلفه‌های میانای کاربر، از media3-ui-compose استفاده کنید.

این کتابخانه اتصال Business logic → UI logic را ارائه می‌دهد. این لایه شامل مؤلفه‌های بنیادی مانند PlayerSurface و ContentFrame، به‌همراه کلاس‌های نگه‌دارنده حالت (مانند PlayPauseButtonState، CurrentMediaItemState، PlaylistState، ErrorState) است که حالت Player را به حالت میانای کاربر تبدیل می‌کنند.

این کتابخانه مؤلفه‌های «طراحی مواد» آماده استفاده را ارائه نمی‌دهد. شما مسئول ساختن مؤلفه‌های میانای کاربر خودتان و سبک‌دهی به آن‌ها هستید. این گزینه حداکثر کنترل را بر ظاهر و حس به شما می‌دهد و اگر سیستم طراحی بسیار سفارشی‌شده‌ای دارید، ایده‌آل است.

برای ادغام سریع‌تر با «طراحی مواد»، از media3-ui-compose-material3 استفاده کنید.

این کتابخانه بخش نهایی UI خط لوله را ارائه می‌دهد. این کتابخانه به media3-ui-compose وابسته است و شامل توابع ترکیب‌پذیر ازپیش‌ساخته‌ای است که با مؤلفه‌های Material3، ازجمله ترکیب‌پذیرهای Player و MiniController، سبک‌بندی شده‌اند. Player ترکیب‌پذیر تجربه بازپخش رسانه جامعی را با ویدیو، کنترل‌ها، و نوار پیشرفت ارائه می‌دهد که می‌توانید آن را بااستفاده از PlayerDefaults بیشتر سفارشی‌سازی کنید. MiniController ترکیب‌پذیر یک امکان فشرده برای کنترل پخش‌کننده ارائه می‌دهد و درعین‌حال اطلاعاتی درباره فایل رسانه‌ای فعلی نمایش می‌دهد. این کار نیاز به ساختن دکمه‌ها و دیگر عناصر میانای کاربر از ابتدا را ازبین می‌برد. همچنان می‌توانید طرح زمینه، رنگ‌ها، و نمادهای این مؤلفه‌ها را سفارشی‌سازی کنید، اما پیاده‌سازی اصلی برای شما ارائه شده است.

در یک نگاه

ویژگی media3-ui-compose media3-ui-compose-material3
مؤلفه‌های میانای کاربر عناصر بنیادی مانند PlayerSurface و ContentFrame، اما بدون دکمه‌ها یا کنترل‌های ازپیش سبک‌بندی‌شده. Player و MiniController قابل‌ساخت و مجموعه کاملی از قابل‌ساخت‌های ازپیش‌ساخته‌شده با سبک Material3 مانند PlayPauseButton، SeekBackButton، PositionAndDurationText، ErrorText، و غیره را ارائه می‌دهد.
مدیریت ایالت نگهدارنده‌های remember...State را برای مدیریت منطق ارائه می‌دهد. حالت را به‌صورت داخلی مدیریت می‌کند، اما اگر لازم باشد همچنان می‌توانید به نگه‌دارنده‌های حالت دسترسی داشته باشید.
وابستگی‌ها androidx.compose.foundation media3-ui-compose، androidx.compose.material3، com.google.android.material
مورد استفاده اصلی ساختن میانای کاربر پخش‌کننده با سیستم طراحی سفارشی. کنترل کامل بر ظاهر و حس. ساختن سریع میانای کاربر پخش‌کننده که از دستورالعمل‌های Material Design 3 پیروی می‌کند.