快速入门:向应用添加音频 (HTML)

[ 本文适用于编写 Windows 运行时应用的 Windows 8.x 和 Windows Phone 8.x 开发人员。如果你要针对 Windows 10 进行开发,请参阅 最新文档 ]

本主题介绍音频流类别并且介绍如何使用 <audio> 标记向应用中添加音频流功能。

Windows 8 提供了一个平台,使得使用 HTML5 向 Windows 应用商店应用中添加音频流功能变得相对简单。

音频标记有以下属性:

属性 允许值 描述
autoplay autoplay 指定准备就绪后立即开始播放音频
controls controls 指定应显示的音频控件(例如播放/暂停按钮等)。
loop loop 指定每次完成后重新开始播放音频
preload

auto

metadata

指定作者认为是否应在加载页面时加载音频以及加载方式
src <文件路径> 指定音频文件的路径

 

Microsoft 还提供了一个附加属性 msAudioCategory,你可以用它增强音频感知应用的行为。下表显示了此属性的允许值,以及它们所执行操作的简单描述。

流类别 描述 是否支持后台?
Alert 循环或更长时间地播放警报声音:
  • 闹铃
  • 响铃音
  • 响铃通知
  • 需要减弱现有音频的声音
BackgroundCapableMedia 用于需要继续在后台播放的音频。 示例包含以下本地媒体播放方案:
  • 本地播放列表
  • 流广播
  • 流播放列表
  • 音乐视频
  • 流音频/广播、YouTube、Netflix 等。
Communications 用于流通信音频,如下:
  • VOIP
  • 实时聊天或其他类型的电话通话
ForeGroundOnlyMedia 设计为仅在前台工作,但会将现有后台媒体声音设置为静音的游戏或其他声音。
  • 游戏体验所需的游戏音频(舞蹈游戏、音乐游戏)
  • 故事片(设计为在进入后台时暂停)
GameEffects 设计为与现有音频混合的游戏声音效果
  • 人物对话
  • 所有非音乐声音
GameMedia 游戏播放的背景音乐
SoundEffects 设计为与现有音频混合的游戏或其他声音效果:
  • 人物对话
  • 蜂鸣声、钟声、简短声音
其他 默认音频类型,以及推荐用于不需要在后台继续播放的所有音频媒体。

 

目标: 使用最简单的方法将音频功能添加到 Windows 应用商店应用中

先决条件

你必须熟悉 HTML、JavaScript、Windows 事件和事件处理。

你必须安装可以播放 MPEG-Layer 3 (MP3) 或其他数字音乐文件的媒体播放机。

完成所需时间: 15 分钟.

说明

使用 <audio> 标记添加音频

当你添加 <audio> 标记时,你必须使用 "controls" 属性以指示你要显示控件(按钮)。以下步骤介绍如何执行此操作。

  • 复制以下代码并将其粘贴到 HTML 文件中要显示音频控件的位置:

    // Adding the <audio> tag to your app
    <audio controls="controls"> 
    <source src="song.mp3"/> 
    </audio>
    

添加 msAudioCategory 属性

msAudioCategory 属性添加到 <audio> 标记中可提供更多功能。 msAudioCategory 属性会将某些增强的行为与音频标记关联,并改善你的应用的用户体验。以下步骤介绍如何添加 msAudioCategory 属性。

  • msAudioCategory 属性添加到 <audio> 标记中,如下所示:

    // Enhancing behavior of audio tag
    // with the msAudioCategory attribute
    <audio msAudioCategory="BackgroundCapableMedia" controls="controls"> 
    <source src="song.mp3"/> 
    </audio>
    

摘要和后续步骤

请仔细考虑为你的流选择的类别,这一点非常重要,因为你的应用在不同的情况下其行为会有所不同。

下一个主题如何配置媒体控件的键将介绍如何为你的 Windows 应用商店应用添加和配置媒体按钮。然后,你可使用这些按钮来播放、暂停、停止、甚至快进音频流。

相关主题

如何配置媒体控件的密钥

配置媒体示例的键

播放管理器示例