node-raumkernel is a nodeJs lib to control the raumfeld multiroom system with.
It has events where you can hook on and it allows you to send actions to the raumfeld system like 'play', 'pause', aso..
You can even browse the content directory or modify a zone playlist.
Changelog can be found here
Please use with node version 7.x or above
For Version lower than 7.6.0 the --harmony-async-await parameter has to be used
npm install node-raumkernel
Following example shows you how to initialize the kernel for your usage
var RaumkernelLib = require('node-raumkernel');
var raumkernel = new RaumkernelLib.Raumkernel();
raumkernel.createLogger();
raumkernel.init();
the node.raumkernel emits some events you can use to get information when the system changes states or a media renderer was found or is available for play. Following events are available. You may click here to get detailed information about the event
- systemHostFound(_host)
- systemHostLost()
- deviceListChanged(_deviceList)
- mediaRendererAdded(_deviceUdn, _device)
- mediaRendererRaumfeldAdded(_deviceUdn, _device)
- mediaRendererRaumfeldVirtualAdded(_deviceUdn, _device)
- mediaServerAdded(_deviceUdn, _device)
- mediaServerRaumfeldAdded(_deviceUdn, _device)
- mediaRendererRemoved(_deviceUdn, _name)
- mediaRendererRaumfeldRemoved(_deviceUdn, _name)
- mediaRendererRaumfeldVirtualRemoved(_deviceUdn, _name)
- mediaServerRemoved(_deviceUdn, _name)
- mediaServerRaumfeldRemoved(_deviceUdn, _name)
- zoneConfigurationChanged(_zoneConfiguration)
- rendererStateChanged(_mediaRenderer, _rendererState)
- rendererStateKeyValueChanged(_mediaRenderer, _key, _oldValue, _newValue, _roomUdn)
- rendererMediaItemDataChanged(_mediaRenderer, _mediaItemData)
- mediaListDataReady(_listId, _mediaListData)
- mediaListDataPackageReady(_id, _mediaListDataPkg, _pkgIdx, _pgkIdxEnd, _pkgDataCount)
- mediaRendererPlaylistReady(_rendererUdn, _mediaListData)
- zoneCreated(_zoneUDN)
- zoneRemoved(_zoneUDN)
- roomAddedToZone(_zoneUDN, _roomUDN)
- roomRemovedFromZone(_zoneUDN, _roomUDN)
- combinedZoneStateChanged(_combinedStateData)
There are some interessting methods and data storages you can use. I will not describe all of them here you may look it up in the code. However some of them should be mentioned as they are important. Please take a look here for detailed descriptions.
- raumkernel.managerDisposer.deviceManager.getRaumfeldMediaServer()
- raumkernel.managerDisposer.deviceManager.getVirtualMediaRenderer(_UdnOrChildName)
- raumkernel.managerDisposer.zoneManager.connectRoomToZone(_roomUdn, _zoneUdn)
- raumkernel.managerDisposer.zoneManager.dropRoomFromZone(_roomUdn)
- raumkernel.managerDisposer.zoneManager.zoneConfiguration
- raumkernel.managerDisposer.mediaListManager.getMediaList(_listId, _objectId, _useListCache = true, _emitReady = true)
There are sample apps in the package like the "sample_contentBrowser.js".
Start it with node and see the magic
You may lookup the requests sources in the node-raumserver which is using node-raumkernel You'll find all actions as requests and you can study the source code.
You may study following minimalistc examples
Stop playing the zone where room "Kitchen" is in it.
var mediaRenderer = raumkernel.managerDisposer.deviceManager.getVirtualMediaRenderer("Kitchen");
mediaRenderer.stop().then(function(_data){
console.log("Stopped playing")
});
Set Volume on whole zone with a given zoneUdn
var mediaRenderer = raumkernel.managerDisposer.deviceManager.getVirtualMediaRenderer("uuid:30e3c8cd-1ce0-4842-89d0-63ea58858cd8");
mediaRenderer.setVolume(25).then(function(_data){
console.log("Volume was set")
});
Set Volume on a specific room
var mediaRenderer = raumkernel.managerDisposer.deviceManager.getVirtualMediaRenderer("uuid:30e3c8cd-1ce0-4842-89d0-63ea58858cd8");
mediaRenderer.setRoomVolume("uuid:3f68f253-df2a-4474-8640-fd45dd9ebf88", 35).then(function(_data){
console.log("Volume was set")
});
Give info when volume changes on any renderer
raumkernel.on("rendererStateKeyValueChanged", function(_mediaRenderer, _key, _oldValue, _newValue, _roomUdn){
if(_key=="Volume")
console.log("Volume on " + _mediaRenderer.name() + " changed to " + _newValue.toString());
})
Give info when volume changes on a specific room The _mediaRenderer is the virtual renderer in case if _roomUdn is filled
raumkernel.on("rendererStateKeyValueChanged", function(_mediaRenderer, _key, _oldValue, _newValue, _roomUdn){
if(_roomUdn && _key=="Volume")
console.log("Volume on room: " + _roomUdn + " changed to " + _newValue.toString());
})
View the mediaItem information if it changes on a renderer (eg. if another track is choosen)
raumkernel.on("rendererMediaItemDataChanged", function(_mediaRenderer, _data){
console.log("MediaItem: " + JSON.stringify(_data));
})
Browse a list fron the content directory
var mediaServer = raunkernel.managerDisposer.deviceManager.getRaumfeldMediaServer();
mediaServer.browse("0").then(function(_data){
console.log("Root Data: " + JSON.stringify(_data));
});
mediaServer.browse("0/My Music").then(function(_data){
console.log("My Music data: " + JSON.stringify(_data));
});
Some actions for creating and modifying native playlists
// Add a container item to playlist (That means an item which direct childs are tracks)
raumkernel.nativePlaylistController.addItemToPlaylist("RAUMKERNELTEST", "0/My Music/Artists/4%20Non%20Blondes/4%20Non%20Blondes+What%27s%20Up", 294967295, true);
// Add one item to playlist. Here the mediaItemid is a track
raumkernel.nativePlaylistController.addItemToPlaylist("RAUMKERNELTEST", "0/My Music/Artists/Dido/Dido+No%20Angel/c7e7ad4423927a75c5017b2640db6574");
// Move an item in playlist to position 2 (index starts with 0)
raumkernel.nativePlaylistController.moveItemInPlaylist("RAUMKERNELTEST", "0/Playlists/MyPlaylists/RAUMKERNELTEST/31990", 1);
// Remove first and second item from playlist
raumkernel.nativePlaylistController.removeItemsFromPlaylist("RAUMKERNELTEST", 0, 1);
Some actions for creating and modifying zone playlists (title lists)
// Add a container item to playlist (That means an item which direct childs are tracks)
raumkernel.zonePlaylistController.addItemToPlaylist(zoneRendererUdn, "0/My Music/Artists/4%20Non%20Blondes/4%20Non%20Blondes+What%27s%20Up", 294967295, true);
// Add one item to playlist. Here the mediaItemid is a track
raumkernel.zonePlaylistController.addItemToPlaylist(zoneRendererUdn, "0/My Music/Artists/Dido/Dido+No%20Angel/c7e7ad4423927a75c5017b2640db6574");
// Move an item in playlist to position 2 (index starts with 0)
raumkernel.zonePlaylistController.moveItemInPlaylist(zoneRendererUdn, "0/Zones/uuid%3A00000000-5416-48eb-0000-0000541648eb/33761", 1);
// Remove first and second item from playlist
raumkernel.zonePlaylistController.removeItemsFromPlaylist(zoneRendererUdn, 0, 1);
Assign the first station button of a renderer to a containerId which should be played when the button is hit
var mediaServer = raunkernel.managerDisposer.deviceManager.getRaumfeldMediaServer();
mediaServer.assignStationButton("uuid:30e3c8cd-1ce0-4842-89d0-63ea58858cd8", 1, "0/My Music/Artists/4%20Non%20Blondes/4%20Non%20Blondes+What%27s%20Up").then(function(_data){
...
});
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent