ion.sound

机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

用于在用户操作和页面事件中播放声音的 JavaScript 插件。

• 版本：3.0.7
• 项目页面和演示
• 下载ZIP
• 在 GitHub 赞助此插件

描述

• Ion.Sound — 基于 Web Audio API 的 JavaScript 插件，用于播放声音。
• 该插件可在大多数流行的桌面和移动浏览器上使用，并可以在任何地方使用，从普通网站到浏览器游戏。
• 对于不那么现代的浏览器，插件会回退到 HTML5 音频。
• 支持音频精灵。
• Ion.Sound 在 MIT 许可 条款下自由分发。
• 包含 25 个免费声音

如今的网站充满了事件（新邮件、新聊天消息、内容更新等）。通常仅通过视觉提示不足以吸引用户注意。你需要声音！这个用于播放小声音的库将帮助你完成这个任务。此外，Ion.Sound 新版本能够处理浏览器游戏的音频。它可以完全控制音频文件的加载、播放和移除。当然，还支持音频精灵。

支持的浏览器

Desktop Windows、OS X、Linux：

• 谷歌浏览器
• Mozilla 火狐
• 微软 Internet Explorer 9.0
• Opera 12.16
• Safari 5.1（Windows 上的 Safari 需要 QuickTime 播放声音）

移动设备：

• iOS Safari 及其他（有一些 限制 ）
• 安卓谷歌浏览器及其他（也有一些限制）
• WP8 互联网浏览器

我可以使用 Web Audio API 和 HTML5 Audio 吗？

演示

• 基本演示
• 高级演示

依赖项

• 无

使用方法

导入这个库：

• ion.sound.min.js

准备音频文件（包含25个声音）并将其放入某个文件夹（例如“sounds”）：

• my_cool_sound.mp3
• my_cool_sound.ogg
• my_cool_sound.aac

仅有MP3文件是不够的，你还应该制作OGG和AAC文件，因为并非所有浏览器都支持MP3。
你可以很容易地将MP3文件转换为OGG和AAC文件，网址为Media.io 或 CloudConvert.org.
为了改善iOS 8.x设备（iPhone、iPad）的跨浏览器支持，添加了AAC支持

使用 npm 安装

使用 NPM 下载插件的最新版本并直接安装到你的项目中。

• npm install ion-sound

使用 Yarn 安装

使用 Yarn 下载插件的最新版本并直接安装到你的项目中。

• yarn 添加 ion-sound

初始化

要初始化插件，请调用此方法：

ion.sound({
    sounds: [
        {
            name: "my_cool_sound"
        },
        {
            name: "notify_sound",
            volume: 0.2
        },
        {
            name: "alert_sound",
            volume: 0.3,
            preload: false
        }
    ],
    volume: 0.5,
    path: "sounds/",
    preload: true
});

并播放声音！

// Simple
ion.sound.play("my_cool_sound");

常规设置

声音对象

也包括单独属性：path、preload、multiplay、loop、volume、scope 和回调函数

插件可以在 jQuery 命名空间中启动

• 使用别名调用任何插件方法：ion.sound(); -> $.ionSound();
• ion.sound.play("sound_name"); -> $.ionSound.play("sound_name");
• 等

更新历史

支持 Ion 系列插件开发：

• 在 GitHub 赞助此插件

• 直接捐赠到我的 Paypal 账户：https://www.paypal.me/IonDen