HTML5 音频 Audio 标签详解

HTML5 引入了 <audio> 标签,允许开发者在网页中直接嵌入音频文件,而不需要依赖第三方插件。本文将全面介绍 <audio> 标签的各种属性,并通过实例代码详细说明其用法。

一、基础用法

1. 基本结构

HTML5 中使用 <audio> 标签嵌入音频文件,最简单的形式如下:

html 复制代码
<audio src="audio-file.mp3" controls></audio>

在这个示例中,src 属性指定音频文件的路径,controls 属性使浏览器显示音频控件。

2. 示例代码

html 复制代码
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>HTML5 Audio Example</title>
</head>
<body>
    <h1>HTML5 Audio Example</h1>
    <audio src="audio-file.mp3" controls>
        Your browser does not support the audio element.
    </audio>
</body>
</html>

这段代码将在网页上显示一个音频播放器,如果浏览器不支持 <audio> 标签,将显示替代文本 "Your browser does not support the audio element."。

二、属性详解

1. src

指定音频文件的 URL,可以是相对路径或绝对路径。

html 复制代码
<audio src="path/to/your-audio-file.mp3" controls></audio>

2. controls

显示音频控件(播放、暂停、音量等)。

html 复制代码
<audio src="audio-file.mp3" controls></audio>

3. autoplay

音频文件在页面加载完成后自动播放。需要注意的是,为了用户体验,很多浏览器默认禁止自动播放,特别是移动设备。

html 复制代码
<audio src="audio-file.mp3" controls autoplay></audio>

4. loop

音频文件播放结束后自动重新播放。

html 复制代码
<audio src="audio-file.mp3" controls loop></audio>

5. muted

初始加载时将音频设置为静音。

html 复制代码
<audio src="audio-file.mp3" controls muted></audio>

6. preload

提示浏览器在页面加载时如何处理音频文件。可能的值有:

  • none:不预加载音频文件。
  • metadata:只预加载音频文件的元数据。
  • auto:浏览器选择最佳方式预加载音频文件。
html 复制代码
<audio src="audio-file.mp3" controls preload="auto"></audio>

7. crossorigin

控制跨域资源共享 (CORS),允许你配置是否可以加载跨域资源。

  • anonymous:不使用凭据。
  • use-credentials:使用凭据(如 Cookies)。
html 复制代码
<audio src="audio-file.mp3" controls crossorigin="anonymous"></audio>

三、支持多种音频格式

由于不同浏览器对音频格式的支持不同,通常需要提供多种格式的音频文件,以确保兼容性。可以使用多个 <source> 标签来定义不同格式的音频文件。

html 复制代码
<audio controls>
    <source src="audio-file.mp3" type="audio/mpeg">
    <source src="audio-file.ogg" type="audio/ogg">
    Your browser does not support the audio element.
</audio>

示例代码

html 复制代码
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>HTML5 Audio Example</title>
</head>
<body>
    <h1>HTML5 Audio Example with Multiple Formats</h1>
    <audio controls>
        <source src="audio-file.mp3" type="audio/mpeg">
        <source src="audio-file.ogg" type="audio/ogg">
        Your browser does not support the audio element.
    </audio>
</body>
</html>

四、使用 JavaScript 控制音频

HTML5 提供了丰富的 JavaScript API,可以用来控制音频播放。以下是一些常用的属性和方法:

1. 常用属性

  • audio.currentTime:获取或设置当前播放时间(秒)。
  • audio.duration:获取音频总时长(秒)。
  • audio.paused:返回音频是否暂停。
  • audio.volume:获取或设置音量(0.0 到 1.0)。

2. 常用方法

  • audio.play():播放音频。
  • audio.pause():暂停音频。
  • audio.load():重新加载音频文件。

示例代码

html 复制代码
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>HTML5 Audio Control with JavaScript</title>
</head>
<body>
    <h1>Control HTML5 Audio with JavaScript</h1>
    <audio id="myAudio" src="audio-file.mp3" controls></audio>
    <br>
    <button onclick="playAudio()">Play</button>
    <button onclick="pauseAudio()">Pause</button>
    <button onclick="stopAudio()">Stop</button>

    <script>
        var audio = document.getElementById('myAudio');

        function playAudio() {
            audio.play();
        }

        function pauseAudio() {
            audio.pause();
        }

        function stopAudio() {
            audio.pause();
            audio.currentTime = 0; // Reset playback position to the start
        }
    </script>
</body>
</html>

在这个示例中,我们通过 JavaScript 控制音频的播放、暂停和停止。audio.pause() 方法用于暂停音频,audio.currentTime = 0 将播放位置重置到开始。

相关推荐
萧行之1 小时前
可视化技术复盘:从图形语法看 D3、Vega-Lite、ECharts、Observable Plot
前端·学习·数据可视化
尾善爱看海9 小时前
Vue 面试收官篇:SSR、性能优化落地、30 道高频面试题精讲(附标准答案)
前端·javascript·vue.js·面试·vue
驳是10 小时前
一个组件,提升 react-router 开发的幸福感
前端·preact
GreenTea10 小时前
OpenAI Agents API 上手实测:一次调用把整个 agent loop 甩给 OpenAI
前端·后端·算法
星云API技术支持10 小时前
企业微信二次开发:群权限设置、成员管理与群资料维护的接口组合实践
java·前端·企业微信
京东云开发者10 小时前
81.8 秒的视频,我们改了 15 个版本:一次纯 Codex 驱动的 AI-native 视频实践
前端·aigc
Csvn11 小时前
TypeScript 大型项目架构:从单体 tsconfig 到分层可扩展的工程
前端
计算机魔术师13 小时前
Dario Amodei 发文呼吁为前沿 AI 降速并提出三点计划
前端
计算机魔术师13 小时前
OpenAI的AI代理偷偷给RubyGems下毒,我们却毫无察觉
前端
甲维斯13 小时前
0代码,0建模,3句话开发一个3D游戏!
前端·游戏·游戏开发