Roundware is a location-based contributory audio platform. This framework provides a JavaScript SDK for interacting with the Roundware Server API. The goal is to enable the creation of browser-based contributory audio and audio augmented reality applications. The library is written in ES6 but is built to run in all modern browsers that support HTML5 audio.
This is currently alpha software; the code is in flux!//gitclonegit@github.com:roundware/roundware-web-framework.gitnpmrunbuild&&npmpack// isstall tarbal in your appcdroundware-web-templatenpmi../roundware-web-framework/roundware-web-framework-0.12.4.tgznpmstartnpmwatch// inside web projectnpmlink../roundware-web-framework<html><body><scripttype="text/javascript" src="https://unpkg.com/roundware-web-framework@0.9.0-alpha/dist/roundware.umd.min.js"></script><script>varroundwareServerUrl="http://localhost:8888/api/2";varroundwareProjectId=1;varroundware=newRoundware({serverUrl: roundwareServerUrl,projectId: roundwareProjectId});functionhandleListening(streamURL){varstreamPlayer=$("#streamplayer");varaudioSource=$("#audiosource");varpauseButton=$("#pause");console.info("Starting to listen to "+streamURL);audioSource.prop("src",streamURL);streamPlayer.trigger("load");streamPlayer.trigger("play");pauseButton.click(function(){console.info("pausing");streamPlayer.trigger("pause");}).show();};$(functionstartApp(){roundware.start().then(handleListening);});</script><audioid="streamplayer" style="border: solid 1px black;"><sourceid="audiosource" type="audio/mp3"></source></audio><buttonid="pause""display: none;">Pause</button></body></html>You can use TypeScript interfaces by prefixing the class name with I
Example:
import{IRoundware}from"roundware-web-framework/types";constroundware: IRoundware=newRoundware(options);Node
npm install roundware-web-frameworkBrowser
- See Roundware Web Demo for an example of using Roundware inside of an application
npm run devstart && open http://localhost:8080/ # open example/ app
npm run test# execute Jasmine test suite
npm run deploy # publish new version of packageSee HOW_TO_CONTRIBUTE.md for further details.
- Code of Conduct
- Documentation
- Demo Site (and also check out [examples])
- Roundware Terminology
- Source Code
- npm package
- CI Build
- TODO figure out how to display code coverage report
- How to Write an Open Source JavaScript Library: a lot of the initial project setup was adapted from this tutorial.
See HOW_TO_CONTRIBUTE.
By Mike Subelsky and other authors. See COPYRIGHT.txt and LICENSE.txt for more details.