Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

file 803 lines (591 sloc) 38.284 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<title>SoundManager 2: JavaScript Sound For The Web</title>
<meta name="description" content="Play sound from JavaScript including MP3, MPEG-4 and HTML5-supported audio formats with SoundManager 2, a cross-browser/platform sound API. BSD licensed."/>
<meta name="keywords" content="javascript sound, html5 audio, html5 sound, javascript audio, javascript play mp3, javascript sound control, mp3, mp4, mpeg4, aac, Scott Schiller, Schill, Schillmania"/>
<meta name="author" content="Scott Schiller"/>
<meta name="copyright" content="Copyright (C) 1997 onwards Scott Schiller"/>
<meta name="language" content="en-us"/>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>

<!-- inline demo CSS (combined + minified for performance; see comments for raw source URLs) -->
<link rel="stylesheet" type="text/css" href="demo/index-rollup.css"/>

<!-- the SoundManager 2 API -->
<script type="text/javascript" src="script/soundmanager2.js"></script>

<!-- 360 UI demo, canvas magic for IE -->
<!--[if lt IE 9]><script type="text/javascript" src="demo/360-player/script/excanvas.js"></script><![endif]-->

<!-- SM2 demo/homepage-specific stuff -->
<script type="text/javascript">var is_home = true;</script>

<!-- inline demo JS (combined + minified; see comments for raw source URLs) -->
<script type="text/javascript" src="demo/index-rollup.js"></script>
<!-- IE CSS font hax -->
<!--[if lte IE 8]>
<style>
h2.special {
/* IE 6-8 font reset, doesn't like sort-of-defined @font-family */
font-family:"helvetica neue",helvetica,arial,verdana,tahoma,"sans serif";
}
</style>
<![endif]-->
<style type="text/css">
/* "SM2 loves you" */
#heart {
line-height: 1em;
padding-top: 0px;
text-indent: 1em;
}

#heart-icon {
width: auto;
font-family: arial;
color: red;
font-size: 48px;
    }
</style>
</head>

<body class="home">

<div id="content">

<div id="lights"></div>

<div id="top">

<h1>A JavaScript Sound API supporting MP3, MPEG4 and HTML5 Audio.</h1>

<div id="nav">
<div id="version" title="Version of SM2 loaded on this page"></div>
<ul>
<li>
<strong><a href="#home">Home</a></strong>
</li>
<li>
<a href="#">Demos</a>
<ul>
<li><a href="demo/template/">Basic Template</a></li>
<li><a href="demo/api/">API Examples</a></li>
<li><a href="demo/play-mp3-links/">Playable MP3 links</a></li>
<li><a href="demo/mp3-player-button/" class="exclude">Basic MP3 Play Button</a></li>
<li><a href="demo/page-player/">Muxtape-style UI</a></li>
<li><a href="demo/360-player/">360&deg; Player UI</a></li>
<li><a href="demo/mpc/">Drum Machine (MPC)</a></li>
<li><a href="demo/animation/">DOM/Animation Demos</a></li>
<li><a href="demo/flashblock/">FlashBlock Handling</a></li>
</ul>
</li>
<li>
<a href="doc/getstarted/">Getting Started</a>
<ul>
<li><a href="doc/getstarted/#how-sm2-works">How SoundManager 2 works</a></li>
<li><a href="doc/getstarted/#basic-inclusion">Including SM2 on your site</a></li>
<li><a href="doc/getstarted/#troubleshooting">Troubleshooting</a></li>
</ul>
</li>
<li>
<a href="doc/">Documentation</a>
<ul>
<li><a href="doc/#sm-config">SoundManager Properties</a></li>
<li><a href="doc/#sound-object-properties">Sound Object Properties</a></li>
<li><a href="doc/#smdefaults">Global Sound Defaults</a></li>
<li><a href="doc/#api">SoundManager Core API</a></li>
<li><a href="doc/#smsoundmethods">Sound Object (SMSound) API</a></li>
<li><a href="doc/generated/script/soundmanager2.html">Generated Documentation</a></li>
</ul>
</li>
<li>
<a href="doc/download/">Download</a>
<ul>
<li><a href="doc/download/#latest">Get SoundManager 2</a></li>
<li><a href="doc/download/#revision-history">Revision History</a></li>
</ul>
</li>
<li>
<a href="doc/technotes/">Technical Notes</a>
<ul>
<li><a href="doc/technotes/#requirements">System Requirements</a></li>
<li><a href="doc/technotes/#debug-output">Debug + Console Output</a></li>
</ul>
</li>
<li>
<a href="doc/resources/">Resources</a>
<ul>
<li><a href="doc/resources/#licensing">Licensing</a></li>
<li><a href="doc/resources/#related">Related Projects</a></li>
<li><a href="http://getsatisfaction.com/schillmania/products/schillmania_soundmanager_2/">SM2 support / discussion</a></li>
<li><a href="http://www.schillmania.com/content/react/contact/">Contact Info @ Schillmania.com</a></li>
</ul>
</li>
</ul>
<div class="clear"></div>
</div>
</div>

<div id="main-wrapper">

   <div id="main" class="triple">

<div id="col3" class="c3">

<div id="support-wrapper">
<div id="get-satisfaction" class="box">
<div id="gsfn_list_widget">
<h2><a href="http://getsatisfaction.com/schillmania/products/schillmania_soundmanager_2/" title="User discussion, FAQs and support for SoundManager 2" rel="nofollow">Discussion / Support</a><span class="l"></span><span class="r"></span></h2>
<div id="gsfn_content">
</div>
<div class="powered_by">
<a href="http://getsatisfaction.com/" rel="nofollow">Get Satisfaction support network</a>
</div>
</div>
<!-- /.box -->
</div>

<div id="sm2-options">
<p>
SM2 options:&nbsp; <span id="with-html5"><a href="?sm2-usehtml5audio=1" title="View this page with HTML5 audio support enabled">+html5</a></span>
<span id="options-divider-with-html5" class="options-divider">&nbsp;|&nbsp;</span>
<span id="without-html5"><a href="?sm2-usehtml5audio=0" title="View this page with HTML5 audio support disabled">-html5</a></span>
<span id="options-divider-without-html5" class="options-divider">&nbsp;|&nbsp;</span>
<span id="with-debug"><a href="#debug=1" title="View this page with debug output mode enabled (console.log() or HTML-based)" onclick="document.location.href=this.href;document.location.reload()">+debug</a></span>
</p>
</div>

</div>

<!-- /main -->
</div>

<div id="live-demos" class="columnar">

<div id="about-sm2">

<div id="about-header">

<div id="sm2-support-warning">
<!-- as needed, warning is displayed here -->
</div>

<div class="sm2-speaker">
<img src="demo/_image/soundmanager2-speaker.png" alt="SoundManager 2 speaker logo" class="ie6sucks" />
</div>

<h2 class="special">SoundManager 2 makes it easier to play audio using JavaScript.</h2>

<p style="line-height:2em">
Using HTML5 and Flash, SoundManager 2 provides reliable cross-platform audio under a single JavaScript API.&nbsp; <a href="doc/download/" title="Download SoundManager 2" class="feature" style="font-family:helvetica;font-weight:bold;margin:0px;white-space:nowrap">Get SoundManager 2</a>
</p>

</div>

<hr />

<!--
<div id="thank-you" style="clear:both;position:relative;top:2em;margin: 0em 2em 0px 3em;border:1px solid #999;border-color:rgba(0,0,0,0.05);border-radius:5px;padding:1.5em 1em 0px 1em;background:#eee;background:rgba(128,192,256,0.1);box-shadow:0px 0px 8px rgba(0,128,192,0.1)">

<h2 id="heart" class="special">SM2 <span id="heart-icon" title="&quot;heart&quot;">♥</span> You!</h2>

<div class="threeup first" style="padding-top:0px">

<div class="column">

<div class="column-wrapper" style="padding-left:0px">

<p style="line-height:1.5em">How time flies; the SoundManager project is officially <strong>ten years old!</strong> It was born in late 2001, out of a need to have JavaScript-driven audio available in personal <a href="http://www.flickr.com/photos/schill/sets/72157616019003181/" title="Schillmania.com: DHTML Interface Design Archives" class="cta">DHTML web experiments</a>.</p>

<p style="line-height:1.5em">Since its release in 2006, SoundManager 2 has grown to become a full-fledged API used on major web sites, web-based games and applications not solely because it "just works," but because people like yourself choose to believe in it.</p>

</div>

</div>

<div class="column">

<div class="column-wrapper">

<p style="line-height:1.5em">At some point in the future, native browser audio support will become consistent enough to make SM2 redundant; until then, the plan is to keep things going as long as there's a need and people find it useful.</p>

<p style="line-height:1.5em">SoundManager is still maintained by myself (with occasional patches via GitHub users,) and is supported entirely by good-will and nice emails from people who have found it useful over the years. Keep those coming. :)</p>


</div>

</div>

<div class="column">

<div class="column-wrapper">

<p style="line-height:1.5em">It has been a personal goal to give something back to the web community which I learned so much from in the past, and continue to learn from today.</p>

<p style="line-height:1.5em"><strong>Thank you for your support!</strong></p>

<p style="font-size:small;color:#666"><em>&mdash; Scott "Schill" Schiller</em></p>

</div>

</div>

</div>

<div class="clear"></div>

</div>
-->

<div class="threeup first">

<div class="column">
<div class="column-wrapper">

<h3>Speak and <b style="white-space:nowrap">be heard<span class="music-note icon"></span></b></h3>
<h4>More sound, <b>in more places</b></h4>

<p>Despite being one of the senses, sound has largely been missing from the web due to inconsistent technology support. SoundManager 2 bridges this gap, making it easier to use audio across a growing variety of devices and platforms, both desktop and mobile.</p>

<p>A few live examples:</p>

<div id="sm2-support" class="demo-block">
<!-- "oh snap", SM2 didn't load etc. messaging -->
</div>

<div style="position:relative;*zoom:1;min-width:275px">

<div id="special-demo-left" class="sm2-inline-list">

<div class="ui360">
<a href="demo/_mp3/office_lobby.mp3" class="norewrite exclude button-exclude inline-exclude">Office lobby sound</a>
</div>

<div class="ui360" style="float:left;display:inline">
<a href="demo/_mp3/mak.mp3" title="360 demo: Angry Cow Sound" class="norewrite exclude button-exclude inline-exclude">Random</a>
</div>

<div class="ui360" style="float:left;display:inline">
<a href="http://freshly-ground.com/data/audio/sm2/water-drop.mp3" title="360 Demo: Water Drop" class="exclude button-exclude inline-exclude">Water Drop</a>
</div>

<div class="demo-more-abs" style="margin-right:1.5em">
<a href="demo/360-player/" title="360&deg; UI player demo" class="cta">360&deg; UI <span>&raquo;</span></a>
</div>

</div>

<div id="special-demo-right">
<a href="demo/_mp3/coins.mp3" title="Play &quot;Change&quot;" class="sm2_button exclude inline-exclude norewrite">coins.mp3</a>
&nbsp;&nbsp; <a href="demo/christmas-lights/sound/glass0.mp3" class="sm2_button exclude inline-exclude norewrite" title="Play &quot;Glass break 1&quot;">glass0.mp3</a>
&nbsp;&nbsp; <a href="demo/christmas-lights/sound/glass1.mp3" class="sm2_button exclude inline-exclude threesixty-exclude norewrite" title="Play &quot;Glass break 2&quot;">glass1.mp3</a>

<div class="demo-more-abs">
<a href="demo/mp3-player-button/" title="MP3 buttons demo" class="cta">mp3 buttons <span>&raquo;</span></a>
</div>

</div>

</div>

</div>
</div>


<div class="column">
<div class="column-wrapper">

<h3>HTML5 + flash <b style="white-space:nowrap">hybrid<span class="package icon"></span></b></h3>
<h4>Complexity, <b>reduced</b></h4>

<p>Supporting HTML5 audio can be tedious in modern browsers, let alone legacy ones. With real-world visitors using browsers ranging from mobile Safari to IE 6 across a wide range of devices, there can be many support cases to consider.</p>

<p>SoundManager 2 gives you a single, powerful API that supports both new and old, using HTML5 audio where supported and optional Flash-based fallback where needed. Ideally when using SoundManager 2, audio "just works."</p>

<div class="icons">
<ul>
<li class="desktop" title="Desktop support: Windows, Mac OS, Linux">Desktop support: Windows, Mac OS, Linux</li>
<li class="laptop" title="Laptop/tablet support: Windows, Mac OS, Linux / Blackberry Playbook, Kindle Fire + other HTML5/Flash devices">Laptop/tablet support: Windows, Mac OS, Linux / Blackberry Playbook, Kindle Fire + other HTML5/Flash devices</li>
<li class="iphone" title="iPhone support: iPhone with iOS 4.0 and newer">iPhone support: iOS 4.0 and newer</li>
<li class="ipad" title="iPad support: Version 1.0 (iOS 3.2) and newer">iPad support: Version 1.0 (iOS 3.2) and newer</li>
<li class="android" title="Android platforms supporting HTML5 and/or Flash">Android platforms supporting HTML5 and/or Flash</li>
</ul>
The details: <a href="doc/getstarted/#intro" class="cta" style="text-align:right">how it works <span>&raquo;</span></a>
</div>

</div>
</div>

<div class="column">
<div class="column-wrapper">
<h3 style="cursor:help" title="Gzip-compressed file size on a typical set-up is 11 KB. And was it supposed to be the &quot;Swiss Army&quot; kind? I forget.">The ginsu knife: <b style="white-space:nowrap">11 KB<span style="color:#999">*</span><span class="performance icon"></span></b></h3>
<h4>Big&nbsp;features, <b>small footprint</b></h4>
<p><em>But wait, there's more!</em></p>
<div>
<p>Performance is an important metric, too. SoundManager 2 packs a comprehensive, feature-rich API into as little as <a href="doc/getstarted/#basic-inclusion" title="SoundManager 2: Build options (down to ~11 KB in size)" style="white-space:nowrap" class="cta">11 KB</a> over the wire when optimized; that's less than 8% of the original, uncompressed file size.</p>
</div>
<p>The source code is BSD-licensed and is provided in fully-commented, non-debug and compiler-optimized "minified" versions appropriate for development and production use.</p>
<p class="sidenote">* Gzip-compressed file size on a typical set-up is 11 KB. And was it supposed to be the <i>Swiss Army</i> kind? I forget.</p>
</div>
</div>

</div>


<div class="threeup">

<div class="column">
<div class="column-wrapper">

<h3>Basic</h3>
<h4>Playable <b>links and playlists</b></h4>

<p>These demos use unordered lists with MP3 links that play in-place; the UI is easily customized via CSS.</p>

<ul class="graphic">
<li><a href="demo/_mp3/rain.mp3" class="exclude">Rain</a></li>
<li><a href="demo/_mp3/walking.mp3" class="exclude">Walking</a></li>
<!-- files from the web (note that ID3 information will *not* load from remote domains without permission, Flash restriction) -->
<li><a href="http://freshly-ground.com/data/video/Rain%20on%20Car%20Roof.aac" title="Rain on car roof (AAC)" class="exclude">Rain On Car Roof <span class="sidenote">(AAC)</span></a></li>
</ul>

<div class="demo-more" style="text-align:right;white-space:normal">
<a href="demo/play-mp3-links/" title="&quot;Play MP3 Links&quot; demo" class="cta">play MP3 links <span>&raquo;</span></a>
</div>

<div style="clear:both"></div>

<p>A richer playlist theme with optional time, seekable progress bar and a VU meter where supported:</p>

<ul id="inline-playlist" class="playlist">
<li><a href="http://freshly-ground.com/data/audio/mpc/20060826 - Armstrong.mp3" class="button-exclude inline-exclude threesixty-exclude">Armstrong Beat</a></li>
<li><a href="http://freshly-ground.com/data/audio/mpc/20090119 - Untitled Groove.mp3" class="button-exclude inline-exclude threesixty-exclude">Untitled Groove</a></li>
<li><a href="http://freshly-ground.com/data/audio/sm2/quail-64kbps-he-aac-from-itunes-renamed-from-mp4.aac" title="48 kbps MPEG4 High-Efficiency AAC test sound: BC Quail" class="button-exclude inline-exclude threesixty-exclude">BC Quail <span class="sidenote">(HE-AAC)</span></a></li>
<li><a href="http://freshly-ground.com/data/audio/sm2/20060924%20-%20Ghosts%20&amp;%20Goblins%20Reconstructed.ogg" title="Ghosts + Goblins Reconstructed: OGG sound format, requires HTML5 Audio() support to play" class="muxtape-html5 button-exclude inline-exclude threesixty-exclude">Ghosts+Goblins Reconstructed <span class="sidenote">(OGG)</span></a></li>
<li><a href="http://freshly-ground.com/data/audio/sm2/bottle-pop.wav" title="WAV sound format, requires HTML5 Audio() support to play" class="muxtape-html5 button-exclude inline-exclude threesixty-exclude">A corked beer bottle <span class="sidenote">(WAV)</span></a></li>
</ul>
<div class="demo-more">
<a href="demo/page-player/" title="Muxtape-style UI demo" class="cta">muxtape-style UI <span>&raquo;</span></a>
</div>

</div>
</div>

<div class="column">
<div class="column-wrapper">

<h3>Shiny</h3>
<h4>Data <b>visualization features</b></h4>

<p>The 360&deg; player UI demo uses &lt;canvas&gt; and includes options for waveform and spectrum analysis data via Flash 9, adding beautiful visual feedback to the interface.</p>

<p style="font-size:92%;text-align:left;color:#666;white-space:normal"><em>Seven Or Eight Days</em> courtesy of <a href="http://www.adrianglynn.com/" title="Adrian Glynn, Vancouver, Canadian singer/songwriter" class="cta">Adrian Glynn</a>, from&nbsp;the album <em>Bruise</em>. For more, see the <a href="https://www.youtube.com/watch?v=dFc2QQiGcUQ" title="Adrian Glynn: &quot;Seven Or Eight Days&quot video" rel="nofollow" class="cta">music video</a>.</p>

<!--
<div id="inline-demos">
<h4 id="inline-demo-header">Inline demos using SoundManager 2</h4>
</div>
-->

<div>

<div id="sm2-visualization" class="sm2-inline-list">

<div class="ui360 ui360-vis">
<a href="http://freshly-ground.com/data/audio/sm2/Adrian%20Glynn%20-%20Seven%20Or%20Eight%20Days.mp3" class="exclude button-exclude inline-exclude" style="position:absolute;color:#333">Adrian Glynn - Seven Or Eight Days</a>
</div>

</div>

<div class="demo-more" style="width:256px;margin:0.5em auto 0px auto;clear:both">
<a href="demo/360-player/canvas-visualization.html" title="360&deg; UI: JavaScript + Canvas Visualization" class="cta">360&deg; + spectrum UI <span>&raquo;</span></a>
</div>

</div>

</div>
</div>

<div class="column">
<div class="column-wrapper">

<h3>Experimental</h3>
<h4>Advanced <b>prototypes</b></h4>

<p>No audio API is complete without at least <em>one</em> crazy demo. The "Wheels Of Steel" started as a simple CSS prototype, and evolved to replicate most of the UI and functionality of a traditional DJ set-up. Pitch bending, scratch and EQ effects are present where supported.</p>
<p style="margin:1em 0px;padding:0px;text-align:center" class="bonus-demo"><a href="http://wheelsofsteel.net/" title="The Wheels Of Steel: Online turntable / browser-based DJ prototype" style="margin:0px;padding:0px;background:#fff"><img src="demo/_image/wheelsofsteel-full-ui.jpg" alt="wheelsofsteel.net: Online turntable demo (screenshot)" style="display:block;width:100%;max-width:315px;margin-left:-4px;border:none" /></a></p>
<p style="margin:0px;padding:0px;font-size:92%;text-align:left;color:#666;margin-bottom:0.5em;white-space:normal">The <a href="http://wheelsofsteel.net/" title="The Wheels Of Steel: Online turntable / browser-based DJ prototype" class="cta">Wheels Of Steel</a>, a browser-based DJ turntable prototype. For the tech details, read <a href="http://www.schillmania.com/content/entries/2011/wheels-of-steel/" title="The making of 'The Wheels Of Steel': An Ode To Turntables (in HTML)" class="cta">An Ode To Turntables (in HTML.)</a></p>

</div>
</div>

</div>

<div class="twoup">

<div class="column">
<div class="column-wrapper">

<h3>Bonus</h3>
<h4>Additional <b>demos</b></h4>

<p>
Examples using multi-track playback, progress and combinations of sound and animation:
</p>

<ul class="bonus-demos">

<li>
<p class="smaller"><strong>SURVIVOR remake</strong></p>
<a href="http://www.schillmania.com/survivor/" style="display:inline-block" title="SURVIVOR (1982 Commodore 64 game remake)"><img src="demo/_image/survivor-screenshot.png" alt="SURVIVOR (C64 game remake) demo screenshot" style="display:block;width:100%;max-width:200px" /></a>
</li>

<li>
<p class="smaller"><strong>MPC (Drum Machine)</strong></p>
<a href="demo/mpc/" style="display:inline-block" title="MPC (sampler/drum machine) demo"><img src="demo/_image/mpc-screenshot.png" alt="MPC (drum machine) demo screenshot" style="display:block;width:100%;max-width:200px" /></a>
</li>

<li>
<p class="smaller"><strong>Christmas Lights</strong></p>
<a href="demo/christmas-lights/" style="display:inline-block" title="Smashable Christmas Lights demo"><img src="demo/_image/christmas-lights.jpg" alt="Smash Christmas Lights demo" style="display:block;width:100%;max-width:200px;border-radius:7px" /></a>
</li>

</ul>

<h4 style="clear:left;padding-top:1em">"Audio sprites" (sound segments / samples) demo</h4>

<p>With sound playback options like <code>from</code> and <code>to</code>, you can play portions of a larger, single-file "sprite" of many sounds.</p>

<p class="bonus-demo clear">
<a href="demo/api/#fitter-happier" title="&quot;Fitter, Happier&quot; sound sample demo"><img src="demo/_image/fitter-happier-waveform.jpg" alt="&quot;Fitter, Happier&quot; waveform screenshot" style="width:100%;max-width:562px" /></a>
</p>


<p>
For more live examples, see the <a href="demo/api/" title="SoundManager 2 API demos" class="cta">API Demos</a>.
</p>

</div>
</div>

<div class="column">
<div class="column-wrapper">

<h3>Elsewhere</h3>
<h4>As heard on <b><span class="scratched-out">TV</span> the internets</b></h4>

<p>A few nifty places SoundManager 2 has been seen in use on the Wild World Web:</p>

<div class="inthewild active">

<ul class="inthewild">
<li>
<a id="soundcloud" href="http://thecloudplayer.com/" title="Soundcloud / The Cloud Player"><span>SoundCloud / The Cloud Player</span></a>
</li>
<li>
<a id="lastfm" href="http://www.last.fm/" title="last.fm"><span>last.fm</span></a>
</li>
<li>
<a id="pitchfork" href="http://www.pitchfork.com/" title="Pitchfork"><span>Pitchfork</span></a>
</li>
<li>
<a id="opera" href="http://www.opera.com/" title="Opera Software ASA (Media Player component)"><span>Opera Software ASA</span></a>
</li>
<li>
<a id="eight-tracks" href="http://8tracks.com/" title="8tracks"><span>8tracks</span></a>
</li>
<li>
<a id="discogs" href="http://www.discogs.com/" title="Discogs"><span>Discogs</span></a>
</li>
<li>
<a id="hypem" href="http://hypem.com/" title="The Hype Machine"><span>The Hype Machine</span></a>
</li>
<li>
<a id="nyancat" href="http://nyan.cat/" title="NON-STOP NYAN CAT!"><span>NON-STOP NYAN CAT!</span></a>
</li>
<li>
<a id="turntable-dot-fm" href="http://turntable.fm/" title="Turntable.fm"><span>Turntable.fm</span></a>
</li>
<li>
<a id="audiogalaxy" href="http://audiogalaxy.com/" title="Audiogalaxy"><span>Audiogalaxy</span></a>
</li>
<li>
<a id="freesound" href="http://freesound.org" title="Freesound.org"><span>freesound.org</span></a>
</li>
<li>
<a id="baroque-me" href="http://blog.chenalexander.com/2011/baroque-bach-cello/" title="Alexander Chen's &quot;baroque.me&quot;"><span>baroque.me</span></a>
</li>
</ul>

</div>

<h4 style="padding-top:1em">Articles and presentations</h4>

<p>Some other words, pictures and video on the subject of HTML5 and web audio:</p>

<ul class="standard">
<li>Video, 02/2012: <a href="http://www.youtube.com/watch?v=C2Tw0BeZb8Q" title="Scott Schiller: Web Audio: HTML5 + Flash (in a tree)" class="cta">Web Audio: HTML5 + Flash (in a tree)</a> (<a href="http://isflashdeadyet.com/talks/html5/bayjax_yahoo_sunnyvale_02-06-2012/" title="&quot;Web Audio: HTML5 + Flash (in a tree)&quot; presentation slides" class="cta">slides</a>.) Updated HTML5 content, demos and <a href="http://www.schillmania.com/content/entries/2012/survivor-c64-html-remake/" title="SURVIVOR: Remaking a Commodore 64 game in HTML" class="cta">SURVIVOR</a> C64 game demo.</li>
<li>Video presentation: <a href="http://www.youtube.com/watch?v=KjdPNtWV3Z0#t=56s" title="Scott Schiller: &quot;Adding Sound To HTML&quot;" class="cta">Adding Sound To HTML</a> (<a href="http://isflashdeadyet.com/talks/html5/" title="&quot;Adding Sound To HTML&quot; presentation slides" class="cta">slides</a>) (12/2011)</li>
<li>Video: <a href="http://www.youtube.com/watch?v=ffk65q5Rl9I" title="Yahoo!/YUI Blog, video presentation: Scott Schiller on the State of HTML5 Audio" class="cta">Probably, Maybe, No: The State of HTML5 Audio</a> + turntable demo (05/2011)</li>
<li>24ways.org article, <a href="http://24ways.org/2010/the-state-of-html5-audio" title="Probably, Maybe, No: The State Of HTML5 Audio (24ways.org)" class="cta">The State Of HTML5 Audio</a> (12/2010)</li>
</ul>

<h4 style="padding-top:1em">Credits and thank-yous</h4>

<ul class="standard">
<li>Icons: Desktop / mobile / iOS device iconography via <a href="http://glyphish.com/" class="cta">glyphish.com</a> (<a href="http://creativecommons.org/licenses/by/3.0/" title="Creative Commons Attribution 3.0 Unported" class="cta">CC</a>)</li>
<li>Music: <em>Seven Or Eight Days</em> courtesy of <a href="http://www.adrianglynn.com/" title="Adrian Glynn, Vancouver-based Singer/Songwriter" class="cta">Adrian Glynn</a>. <em>Graffiti Sex</em> courtesy of <a href="http://www.fugitives.ca/" title="The Fugitives, multi-instrumentalists from Vancouver" class="cta">The Fugitives</a>, from the album <em>In Streetlight Communion</em>. <em>I Tried</em> and <em>People Asking</em> courtesy of <a href="http://sonreal.bandcamp.com/album/the-lightyear-mixtape" title="The Lightyear Mixtape from SonReal, Vancouver-based hip-hop artist" class="cta">SonReal</a>.</li>
<li>Homepage header typeface: <a href="http://work.meredithmandel.com/#379252/Typeface-Chunk-Five" class="cta">Chunk (Five)</a> by Meredith Mandel (<a href="http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&amp;id=OFL&amp;_sc=1" title="SIL Open Font License (OFL)" class="cta">OFL</a>)</li>
</ul>

</div>

</div>

<!--
<div class="column">
<div class="column-wrapper">

<h3>Download <b>the code</b></h3>

<p>
<a href="doc/download/" class="feature">Get SoundManager 2</a>
</p>

</div>
</div>
-->


</div>

<div class="threeup">

<div class="column">
<div class="column-wrapper">

<h3>Technical <b>overview</b></h3>

<h4>HTML5 audio + optional Flash fallback</h4>

<ul id="html5-audio-notes" class="standard">
<li>100% Flash-free audio on iPad, iPhone (iOS4) and other HTML5-enabled devices + browsers</li>
<li>Invisible Flash SWF provides HTML5 fallback as needed</li>
<li>API is consistent whether using HTML5 or Flash</li>
<li>See <a href="doc/#soundmanager-usehtml5audio" title="soundManager.useHTML5Audio HTML5 Audio() support feature documentation" class="cta">useHTML5Audio</a> for implementation details</li>
</ul>

</div>
</div>

<div class="column">
<div class="column-wrapper"> <!-- spaced-out -->

<h3>API <b>specifics</b></h3>
<h4>Basic API features (HTML5, Flash 8*)</h4>

<ul class="standard">
<li>Load, stop, play, pause, mute, seek, pan*, volume control from JavaScript</li>
<li>Events: <code>onload()</code>, <code>whileloading()</code>, <code>whileplaying()</code>, <code>onfinish()</code> and more</li>
<li>ID3V1 + ID3V2 tag support for MP3s (title, artist, genre etc.)*</li>
</ul>

<br />

<h4 id="flash9-features">Additional Flash 9-based API features</h4>

<ul class="standard">
<li>RTMP / Flash Media Server streaming support (experimental) - see <a href="doc/#smsound-serverurl" title="SMSound.serverURL parameter" class="cta">serverURL</a></li>
<li>MPEG-4 (AAC, HE-AAC, H.264) audio support</li>
<li>"MultiShot" play (layered/chorusing effects)</li>
<li>Waveform/frequency spectrum data</li>
<li>Peak (L/R channel volume) data</li>
<li>Audio buffering state/event handling</li>
</ul>

</div>
</div>

<div class="column">
<div class="column-wrapper"> <!-- spaced-out -->

<h3>Everything <b>else</b></h3>
<h4>Documentation, tools and demos</h4>

<ul class="standard">
<li>Extensive <a href="doc/" title="SoundManager 2 documentation" class="cta">API Documentation</a> with examples and notes</li>
<li>Built-in <a href="doc/technotes/#debug-output" title="SoundManager 2 console.log()-style debug output" class="cta">debugging</a> and <a href="doc/getstarted/#troubleshooting" title="SoundManager 2 troubleshooting tool" class="cta">troubleshooting tools</a></li>
<li>Community-based <a href="http://getsatisfaction.com/schillmania/products/schillmania_soundmanager_2" title="discussion/support for SoundManager 2 on Get Satisfaction" class="cta">discussion/support</a></li>
<li id="licensing"><a href="license.txt" title="SoundManager 2 BSD license" class="cta norewrite">BSD licensed</a></li>
</ul>

<br />
<h4 class="home-shopping-network">Not only do you get the ginsu knife...</h4>
<p style="font-size:92%">Even more demos and examples using the SoundManager 2 API...</p>
<ul class="standard">
<li><a href="demo/play-mp3-links/" title="Links to MP3 files that play inline" class="cta">Playable MP3 links</a></li>
<li><a href="demo/mpc/" title="MPC sampler/drum machine demo" class="cta">MPC sampler/drum machine</a></li>
<li><a href="demo/animation-1/" title="Bouncing ball animation with sound effects" class="cta">Basic animation + sound</a></li>
<li><a href="demo/christmas-lights/" title="Smashable christmas lights demo (animation and sound)" class="cta">Smashable christmas lights</a></li>
<li><a href="demo/api/" title="See the code, click the button, watch it run: Live API demos using test sounds" class="cta">Live API + code examples</a></li>
</ul>


</div>
</div>

<!--/min-width -->

</div>

<!-- three -->


<div id="how-to" class="twoup">

<div class="column">
<div class="column-wrapper">

<h3>Getting <b>started</b></h3>

<h4>Basic SoundManager 2 set-up</h4>

<p>Including the script, configuring <code>soundManager.url</code> (SWF file path) and registering an <code>onready()</code> callback:</p>

<pre class="block"><code>&lt;script src="soundmanager2.js"&gt;&lt;/script&gt;
&lt;script&gt;
soundManager.setup({
  <span><span>// where to find flash SWFs, as needed</span></span>
  url: '<span>/path/to/swf-files/</span>',
  onready: function() {
    <span><span>// SM2 is ready to play audio!</span></span>
  })
});
&lt;/script&gt;</code></pre>

<p>Upon execution of soundmanager2.js, SM2 will determine what Flash SWF to load (if any) based on the path defined in <code>soundManager.url</code>.</p>
<p>After successful initialization, <code>soundManager.onready()</code> will fire and sounds can be played.</p>
<p>By default, SM2 uses a Flash 8-based SWF build. Some <a href="#flash9-features" title="SoundManager 2: Flash 9 API-based features" class="cta">additional features</a> are available when using the Flash 9-based build.</p>

<p>For a live example, see the <a href="demo/template/" class="cta">basic template demo</a>.</p>


<!--
<h4>Additional Flash 9 features, HTML5 behaviour, flash blocking etc.</h4>

<p>You can enable additional features via <code>soundManager.flashVersion = 9</code>, configure HTML5 audio behaviour, flash blocker handling and so forth.</p>

<pre class="block"><code>&lt;script&gt;
soundManager.setup({

url: '<span>/path/to/swf-files/</span>',

<span><span>// enable extra API features via flash 9 SWF build (default = 8)</span></span>
flashVersion: 9,

<span><span>// optional: <a href="../../demo/flashblock/" title="SoundManager 2 flash block handling demo">flash block handling</a></span></span>
<span><span>// useFlashBlock = true,</span></span>

<span><span>/**
* tweak: if both flash + HTML5 are available, try HTML5 first.
* iPad/iPhone and non-flash clients will always try HTML5 mode.
* further reading: see <a href="../#soundmanager-usehtml5audio">HTML5 audio support</a>
*/</span></span>
preferFlash: <span>false</span>,

onready: function() {
<span><span>// Ready to use.</span></span>
})

});
&lt;/script&gt;</code></pre>

<p>
Want more? See the <a href="demo/template/" class="cta">basic template demo</a>. For compressed and optimized builds, see <a href="doc/getstarted/#basic-inclusion" class="cta">basic inclusion</a>. For deferred or dynamic loading of SM2, see <a href="doc/getstarted/#lazy-loading" class="cta">lazy-loading</a>.
</p>

-->

</div>
</div>

<div class="column">
<div class="column-wrapper">

<h3>Playing <b>audio</b></h3>
<h4>Basic playback control</h4>

<p>Once <code>soundManager.onready()</code> has fired, sounds can be loaded and played.</p>

<h4>Creating and playing a sound object</h4>

<pre class="block"><code><span><span>// create "mySound"...</span></span>
soundManager.createSound({
  id: '<span>mySound</span>',
  url: '<span>/path/to/an.mp3</span>'
});

<span><span>// ...and play it</span></span>
soundManager.play('<span>mySound</span>');
</code></pre>

<!--

<h4>Create and play, with additional parameters</h4>

<p>Sounds inherit default properties which can be overridden by passing parameters to <code>createSound()</code> and <code>play()</code> methods. For example, providing <code>volume</code> to <code>createSound()</code> will determine the default volume for the life of that sound object. Defaults can be overridden on a per-play basis by passing <code>volume</code> to <code>play()</code>.</p>

<p>Events like <code>onfinish</code>, <code>whileloading</code> and <code>whileplaying</code> can also be specified in this fashion.</p>

<pre class="block"><code><span><span>// create a sound, using volume and onload parameters</span></span>
var demoSound = soundManager.createSound({
id: '<span>someSound</span>',
url: '<span>/path/to/some.mp3</span>',
volume: <span>50</span>,
onload: function() {
console.log('<span>sound </span>' + <span>this.id</span> + '<span> loaded!</span>');
}
});

<span><span>// One-time options: 25% volume + onfinish() callback</span></span>
demoSound.play({
volume: <span>25</span>,
onfinish: function() {
console.log('<span>sound </span>' + <span>this.id</span> + '<span> finished!</span>');
}
});</code></pre>

-->

<p>Additional options and events can be specified when loading and playing sounds. For more examples of playback features, see <a href="demo/api/" class="cta">API Demos</a>.</p>

</div>
</div>

</div>

<!-- /#about-sm2 -->
</div>

</div>

<div class="clear">&nbsp;</div>

<!-- /content -->

</div>

<script type="text/javascript">
// <![CDATA[
if (document.location.href.match(/debug=1/i)) {
document.getElementById('with-debug').style.display = 'none';
}
if (document.location.href.match(/debug/i)) {
document.getElementById('options-divider-with-html5').style.display = 'none';
}
if (soundManager.useHTML5Audio || document.location.href.match(/html5audio=1/i)) {
document.getElementById('with-html5').style.display = 'none';
document.getElementById('options-divider-with-html5').style.display = 'none';
} else {
document.getElementById('without-html5').style.display = 'none';
document.getElementById('options-divider-without-html5').style.display = 'none';
}
init();
// ]]>
</script>

</div>

</div>

</body>
</html>
Something went wrong with that request. Please try again.