ویجت پخشکننده صدا
ویجت پخشکننده صدا برای قرار دادن یک فایل صوتی در صفحه استفاده میشود.
با این ویجت میتوانید صدا را از فایل داخلی یا از یک لینک آنلاین پخش کنید، برای آن کاور و عنوان بگذارید، و حتی برای زمانهای خاصِ پخش، عملکردهای جداگانه تعریف کنید.
این ویجت چه کارهایی انجام میدهد؟
با ویجت پخشکننده صدا میتوانید:
- یک فایل صوتی انتخاب کنید
- یا بهجای فایل، لینک مستقیم صوت قرار دهید
- پخش خودکار را فعال کنید
- هنگام خروج کاربر از صفحه، پخش را متوقف کنید
- فایل را برای استفاده بعدی در کش ذخیره کنید
- عنوان، توضیح و کاور برای صدا نمایش دهید
- پخش را تکرار کنید
- تعداد تکرار را قابل انتخاب کنید
- برای ثانیههای خاصِ پخش، یک عملکرد مشخص تعریف کنید
تنظیمات اصلی ویجت
1) انتخاب فایل صوتی
در این بخش میتوانید فایل صوتی را از رسانههای پروژه انتخاب کنید.
- اگر پخش آنلاین فعال نباشد، این گزینه برای انتخاب فایل استفاده میشود.
- نوع فایل باید صوتی باشد.
نکته:
وقتی حالت پخش آنلاین فعال شود، انتخاب فایل داخلی غیرفعال میشود.
2) پخش آنلاین
اگر میخواهید صدا را از یک آدرس اینترنتی پخش کنید، این گزینه را فعال کنید.
در این حالت:
- بهجای فایل، لینک صوت استفاده میشود
- گزینه انتخاب فایل داخلی غیرفعال میشود
3) لینک موزیک
وقتی پخش آنلاین را فعال کرده باشید، میتوانید آدرس فایل صوتی را وارد کنید.
مثال:
http://example.com/my-music.mp3
در لینک موزیک میتوانید از متغیرهای داینامیک هم استفاده کنید؛ مثل https://example.com/audio/{{audioId}}.mp3. مقدار متغیر هنگام اجرای اپلیکیشن جایگزین میشود.
4) دانلود خودکار و ذخیره در کش
اگر این گزینه را فعال کنید:
- فایل صوتی بهصورت خودکار دانلود میشود
- برای پخشهای بعدی در حافظه موقت برنامه نگهداری میشود
این گزینه بیشتر برای بهتر شدن سرعت پخش و کاهش مصرف اینترنت مفید است.
5) عنوان
عنوانی که برای فایل صوتی نمایش داده میشود.
مثال:
- موسیقی آرامشبخش
- پادکست قسمت اول
6) شرح
متنی کوتاه برای توضیح بیشتر درباره فایل صوتی.
7) انتخاب کاور
میتوانید یک تصویر برای کاور صدا انتخاب کنید.
این تصویر معمولاً کنار عنوان یا در بخش نمایش صوت استفاده میشود.
تنظیمات پخش
8) پخش خودکار
اگر این گزینه روشن باشد:
- صدا بهمحض باز شدن صفحه یا نمایش ویجت، خودکار شروع به پخش میکند
9) توقف پخش موقع ترک صفحه
اگر این گزینه فعال باشد:
- وقتی کاربر از صفحه خارج شود، پخش صدا متوقف میشود
10) تکرار مداوم پخش
این گزینه باعث میشود صدا بعد از پایان، دوباره از ابتدا پخش شود.
11) قابلیت انتخاب تعداد تکرار
اگر این گزینه فعال باشد:
- کاربر میتواند تعداد دفعات تکرار را مشخص کند
نکته:
اگر «تکرار مداوم پخش» فعال باشد، این گزینه غیرفعال میشود.
12) تعداد تکرار
اگر تعداد تکرار را تعریف کنید، صدا به همان تعداد تکرار میشود.
تنظیمات نمایش
13) دکمه پخش و توقف
ویجت دارای دکمههای پخش و توقف است و میتوان برای آنها آیکون اختصاصی هم تعریف کرد.
14) نمایش نوار پیشرفت
ویجت میتواند نوار پیشرفت پخش را نمایش دهد.
15) نمایش زمان
در صورت فعال بودن، زمان سپریشده و زمان کل صدا نمایش داده میشود.
16) رنگها و اندازهها
میتوانید ظاهر ویجت را هم شخصیسازی کنید، از جمله:
- رنگ پسزمینه
- رنگ آیکون
- رنگ نوار پیشرفت
- رنگ زمان
- اندازه آیکون
تنظیمات پیشرفته
17) تغییر سرعت پخش
اگر این قابلیت فعال باشد، کاربر میتواند سرعت پخش را تغییر دهد.
18) اشتراکگذاری
میتوان قابلیت اشتراکگذاری صوت را فعال کرد تا کاربر بتواند آن را با دیگران بهاشتراک بگذارد.
19) باز کردن فایل
در صورت فعال بودن این گزینه، کاربر میتواند فایل صوتی را در محیطی دیگر نیز باز کند.
20) ذخیره فایل
این گزینه اجازه میدهد کاربر فایل را ذخیره کند.
21) زمان رایگان
در برخی حالتها، ممکن است بخشی از صدا بهصورت رایگان قابل شنیدن باشد و ادامه آن وابسته به تنظیمات ویژه باشد.
22) تنظیمات پولی
این بخش برای زمانی است که بخواهید دسترسی به صدا را محدود کنید یا برای آن منطق پرداخت در نظر بگیرید.
رویدادهای زماندار صدا
یکی از قابلیتهای مهم این ویجت، تعریف عملکرد در ثانیههای خاص است.
این قابلیت چه میکند؟
مثلاً میتوانید مشخص کنید:
- در ثانیه 10 یک پیام نمایش داده شود
- در ثانیه 30 یک اکشن اجرا شود
- در ثانیه 45 صفحهای باز شود
ساختار هر رویداد
هر رویداد از دو بخش تشکیل میشود:
- زمان بر حسب ثانیه
- عملکرد یا اکشن مربوط به آن زمان
مدیریت رویدادها
در پنل تنظیمات، یک لیست جدولی برای مدیریت این رویدادها وجود دارد که میتوانید:
- رویداد جدید اضافه کنید
- آن را ویرایش کنید
- حذف کنید
- یا جابهجا کنید
رفتار ویجت در حالت آنلاین و آفلاین
ویجت پخشکننده صدا دو حالت اصلی دارد:
حالت آفلاین
- فایل صوتی داخل پروژه انتخاب میشود
- صدا از همان فایل پخش میشود
حالت آنلاین
- لینک مستقیم صوت وارد میشود
- صدا از اینترنت پخش میشود
- در صورت نیاز میتواند بهصورت خودکار دانلود و در کش ذخیره شود
نکات مهم برای کاربر
- اگر فایل صوتی از اینترنت پخش میشود، مطمئن شوید لینک درست و قابل دسترس است.
- اگر پخش خودکار را روشن کنید، صدا بلافاصله شروع میشود.
- اگر توقف هنگام ترک صفحه را فعال کنید، با خروج از صفحه پخش قطع میشود.
- اگر تعداد تکرار را تنظیم کنید، صدا فقط همان تعداد دفعات پخش میشود.
- رویدادهای زماندار فقط روی ثانیههای مشخص اجرا میشوند.
جمعبندی
ویجت پخشکننده صدا یک ابزار کامل برای نمایش و پخش فایلهای صوتی در اپلیکیشن است.
این ویجت علاوه بر پخش ساده، امکاناتی مثل:
- پخش آنلاین
- ذخیره در کش
- پخش خودکار
- تکرار
- نمایش کاور و عنوان
- و رویدادهای زماندار