مجموعه DOM Audio HTML
شیء Audio
شیء Audio یک شیء جدید در HTML5 است.
شیء Audio نماینده عنصر HTML <audio> است.
دسترسی به شیء Audio
شما می‌توانید با استفاده از روش getElementById() به عنصر <audio> دسترسی پیدا کنید:
var x = document.getElementById("myAudio");
ایجاد شیء Audio
شما می‌توانید با استفاده از روش document.createElement()، عنصر <audio> را ایجاد کنید:
var x = document.createElement("AUDIO");
ویژگی‌های شیء Audio
| ویژگی‌ها | توضیحات |
|---|---|
| audioTracks | برگشتی از اشیای AudioTrackList که مسیرهای صوتی قابل استفاده را نشان می‌دهد. |
| autoplay | تنظیم یا بازگشت به وضعیت پخش خودکار پس از بارگذاری. |
| buffered | برگشتی از اشیای TimeRanges که بخش‌های موجود صوتی را نشان می‌دهد. |
| controller | برگشتی از اشیای MediaController که کنترل‌های صوتی فعلی را نشان می‌دهد. |
| controls | تنظیم یا بازگشت به وضعیت نمایش کنترل‌ها (مثل پخش/توقف و غیره). |
| crossOrigin | تنظیم یا بازگشت به تنظیمات CORS صوتی. |
| currentSrc | URL فعلی صوتی را بازگرداند. |
| currentTime | تنظیم یا بازگشت به موقعیت فعلی پخش صوتی (به صورت ثانیه). |
| defaultMuted | تنظیم یا بازگشت به وضعیت پیش‌فرض مکبول صوتی. |
| defaultPlaybackRate | تنظیم یا بازگشت به سرعت پیش‌فرض پخش صوتی. |
| duration | طول صوتی را (به صورت ثانیه) بازگرداند. |
| ended | وضعیت پایان یافتن پخش صوتی را بازگرداند. |
| error | برگشتی از اشیای MediaError که وضعیت خطای صوتی را نشان می‌دهد. |
| loop | تنظیم یا بازگشت به وضعیت چرخه‌ای بودن صوتی. |
| mediaGroup | تنظیم یا بازگشت به نام ترکیب رسانه صوتی. |
| muted | تنظیم یا بازگشت به وضعیت مکبول صدای صوتی. |
| networkState | وضعیت شبکه فعلی صوتی را بازگرداند. |
| paused | تنظیم یا بازگشت به وضعیت تعلیق صدای صوتی. |
| playbackRate | سرعت پخش صوت را تنظیم یا بازگردانید. |
| played | یک شیء TimeRanges بازگرداند که نشان‌دهنده بخش‌های پخش شده صوت است. |
| preload | مقدار ویژگی preload صوتی را تنظیم یا بازگردانید. |
| readyState | وضعیت آماده‌سازی فعلی صوت را بازگرداند. |
| seekable | یک شیء TimeRanges بازگرداند که نشان‌دهنده بخش‌های قابل جستجوی صوت است. |
| seeking | بازگرداندن این که کاربر در حال جستجو در صوت است یا خیر. |
| src | مقدار ویژگی src صوتی را تنظیم یا بازگردانید. |
| textTracks | یک شیء TextTrackList بازگرداند که نشان‌دهنده مسیرهای متن قابل استفاده است. |
| volume | گوشت صوتی را تنظیم یا بازگردانید. |
روش‌های شیء Audio
| روش | توضیحات |
|---|---|
| addTextTrack() | یک مسیر جدید برای متن صوتی اضافه کنید. |
| canPlayType() | بررسی کنید که آیا مرورگر می‌تواند نوع صوتی مشخص شده را پخش کند یا خیر. |
| fastSeek() | زمان پخش را در پخش‌کننده صوتی مشخص کنید. |
| getStartDate() | یک شیء جدید Date بازگرداند که نشان‌دهنده موقعیت خط زمانی فعلی است. |
| load() | عنصر صوتی را دوباره بارگذاری کنید. |
| play() | پخش صوت را شروع کنید. |
| pause() | پخش فعلی صوت را متوقف کنید. |
