TapHome

Bluesound

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 08. 2026

Toto zariadenie podporuje mDNS

Namiesto IP adresy môžete zariadenie osloviť na:

{MODEL}-{MAC4}.local

Nahraďte {MAC} MAC adresou zariadenia (veľké písmená, bez dvojbodiek).

TapHome podporuje mDNS — použitie hostname je spoľahlivejšie ako statická IP.

Bluesound

Bluesound je rad multiroom audio zariadení postavený na BluOS, streamovacej platforme spoločnosti Lenbrook pre bezstratový zvuk až do 24-bit/192 kHz. Každý prehrávač BluOS poskytuje v lokálnej sieti BluOS Custom Integration API: obyčajné HTTP GET požiadavky na TCP porte 11000, odpovede vo formáte UTF-8 XML, bez autentifikácie a bez cloudového konta. TapHome komunikuje s prehrávačom priamo cez lokálnu sieť.

Šablóna nie je viazaná na konkrétny model — neobsahuje žiadnu väzbu na model ani výrobcu a hovorí výhradne cez HTTP API, takže platí pre celý aktuálny rad (NODE, NODE X, NODE NANO, NODE ICON, POWERNODE, POWERNODE EDGE, PULSE, PULSE M, PULSE MINI, PULSE FLEX, PULSE CINEMA, PULSE CINEMA MINI, PULSE SOUNDBAR, VAULT a HUB) aj pre staršie generácie. Keďže BluOS dodávajú aj NAD Electronics, DALI, PSB Speakers, Monitor Audio, Roksan, Cyrus a Peachtree, prehrávače týchto značiek poskytujú rovnaké API a reagujú na rovnaké požiadavky.

Sieťové pripojenie

Nie je potrebné nič zapájať. Prehrávač BluOS sa pripojí do domácej siete cez Ethernet alebo Wi-Fi pomocou sprievodcu v aplikácii BluOS Controller a TapHome ho následne osloví cez HTTP. Jedinou podmienkou je, aby riadiaca jednotka TapHome a prehrávač boli v rovnakom segmente siete a aby medzi nimi bol priechodný port 11000.

Port 11000 platí pre každý prehrávač BluOS s jedinou zdokumentovanou výnimkou: NAD CI580 obsahuje v jednom šasi štyri streamovacie uzly na portoch 11000 / 11010 / 11020 / 11030. Šablóna oslovuje iba port 11000, takže na CI580 ovláda uzol 1.

Konfigurácia

Zistenie IP adresy prehrávača

Adresa sa zobrazuje v obrazovke Diagnostics aplikácie BluOS Controller:

  • Android / iOS — karta Players → vyberte prehrávač → karta Home → Settings → v sekcii Help & Support ťuknite na Diagnostics.
  • Windows / macOS — Player Drawer → vyberte prehrávač → ľavý Navigation Drawer → Help → Diagnostics.

Tá istá obrazovka vypisuje pod položkou Other Players aj adresy ostatných prehrávačov v sieti. Bez aplikácie vráti otvorenie adresy http://<ip_prehravaca>:11000/SyncStatus v prehliadači atribút id prehrávača (adresa a port) spolu s jeho atribútom mac.

Udržanie stálej adresy

Šablóna oslovuje prehrávač podľa IP adresy, takže zmenená DHCP zápožička integráciu ticho zastaví. Lenbrook výslovne odporúča rezerváciu DHCP na routeri namiesto statickej adresy nastavenej priamo v prehrávači:

  1. Otvorte administračné rozhranie routera a nájdite nastavenia rezervácií DHCP / LAN.
  2. Zadajte MAC adresu prehrávača — nesie ju odpoveď /SyncStatus, takže sa dá prečítať cez HTTP aj bez aplikácie.
  3. Priraďte adresu, ktorú si má prehrávač ponechať, a uložte.
  4. Reštartujte prehrávač, aby obnovil zápožičku, a overte, že prevzal rezervovanú adresu.
Import šablóny

Šablóna má jediný importný parameter, IpAddress (zástupná hodnota 192.168.0.1). Zadajte adresu prehrávača; port 11000 aj formát požiadaviek sú už súčasťou šablóny.

Povinné nastavenie po importe — Zoskupiť s prehrávačom

Prepínač Zoskupiť s prehrávačom sa dodáva s premennou IP nastavenou na zástupný text 192.168.x.x. Nie je to funkčná predvolená hodnota — kým sa nenahradí, čítací skript hľadá 192.168.x.x medzi podriadenými prehrávačmi, nikdy ho nenájde a prepínač zostáva natrvalo vypnutý.

Po importe šablóny otvorte zariadenie Zoskupiť s prehrávačom v aplikácii TapHome a nastavte IP na adresu prehrávača, ktorý sa má pripojiť ako podriadený člen skupiny. Použite obrazovku Diagnostics opísanú vyššie (položka Other Players vypisuje presne tieto adresy) alebo prečítajte /SyncStatus na ktoromkoľvek prehrávači v sieti.

Všetky ostatné zariadenia šablóny fungujú hneď po vyplnení parametra IpAddress. Zoskupiť s prehrávačom je jediné zariadenie, ktoré po importe potrebuje druhú hodnotu — ak v ňom ostane 192.168.x.x, prepínač bude pôsobiť pokazene namiesto toho, aby ohlásil chybu.

Možnosti zariadenia

Ovládanie prehrávania

Prehrávanie riadi päť tlačidiel:

  • Play — spustí aktuálny zdroj zvuku. Pozastavený prehrávač obnoví, zastavený však znova nerozbehne.
  • Pauza — posiela prepnutie, takže tým istým tlačidlom sa hrajúci prehrávač pozastaví a pozastavený opäť rozbehne. Ak hrá budík s časovým limitom, pozastavenie tento limit zároveň zruší.
  • Stop — zastaví prehrávanie. Na rozdiel od pauzy sa zastavený prehrávač tlačidlom Play už neobnoví. Zastavenie tiež zruší bežiaci limit budíka.
  • Ďalšia skladba — preskočí dopredu vo fronte prehrávania a na konci fronty sa vráti na prvú skladbu, nech je nastavenie opakovania akékoľvek.
  • Predchádzajúca skladba — ak aktuálna skladba hrá dlhšie než štyri sekundy, spustí ju znova, inak sa vráti na predchádzajúcu skladbu.

Tieto tlačidlá pracujú s frontou prehrávania. Keď prehrávač streamuje rádiovú stanicu alebo hrá z fyzického vstupu, fronta nie je zdrojom zvuku a preskakovanie dopredu ani dozadu nie je dostupné — API tento prípad rieši cez samostatný endpoint, ktorý šablóna nevyužíva.

Hlasitosť

Hlasitosť je stmievač. Číta úroveň prehrávača (0–100) a škáluje ju do rozsahu stmievača 0,0–1,0; pri zápise posiela hodnotu späť ako celé percento. Vypnutie stmievača posiela príkaz na stlmenie namiesto hlasitosti 0, takže vlastná úroveň prehrávača zostáva zachovaná a po zrušení stlmenia sa obnoví.

Oba zápisy nesú tell_slaves=1, čo zodpovedá skupinovému posuvníku hlasitosti v aplikácii BluOS Controller: keď je prehrávač hlavným členom skupiny, hlasitosť sa mení na všetkých prehrávačoch v skupine naraz, nie iba na oslovenom.

Použiteľný rozsah hlasitosti sa nastavuje v aplikácii BluOS Controller v Settings → Player → Audio a býva typicky −80…0 dB. Všetky úrovne sa orezávajú do tohto rozsahu, takže stmievač TapHome na 100 % nemusí znamenať 0 dB. Prehrávače s pevnou linkovou úrovňou výstupu nehlásia použiteľnú hlasitosť vôbec a stmievač potom ukazuje nezmyselnú úroveň namiesto chyby.

Stmievač hlasitosti sa prehrávača dopytuje každých 2,5 sekundy, kým BluOS API žiada integrácie bez long-pollingu, aby posielali najviac jednu požiadavku za 30 sekúnd. Pri jednom prehrávači ide o hŕstku malých požiadaviek za minútu, naprieč domom plným prehrávačov sa to však sčítava — majte to na pamäti pri vyťaženej Wi-Fi a tam, kde je sieť zaneprázdnená, uprednostnite prehrávače pripojené káblom.

Náhodné prehrávanie a opakovanie

Náhodné prehrávanie zapína a vypína premiešanie fronty. Premiešanie frontu prestaví; po vypnutí sa obnoví pôvodné poradie.

Opakovanie je trojstavový prepínač — Bez opakovania, Opakovať jednu a Opakovať všetko. TapHome radí tieto sloty v opačnom poradí než API a šablóna používa rovnaké premapovanie pri čítaní aj pri zápise, takže oba smery zostávajú konzistentné.

Obe zariadenia čítajú svoj stav z hodnoty, ktorú si modul ukladá pri vlastnom 30-sekundovom dopyte stavu, namiesto toho, aby posielali vlastné požiadavky. Tým sa šetrí sieťová prevádzka, cenou je až 30-sekundové oneskorenie, kým sa zmena vykonaná v aplikácii BluOS prejaví v TapHome.

Predvoľby

Predvoľba načíta predvoľbu uloženú v prehrávači — rádiovú stanicu, playlist alebo vstup. Predvoľby sa dajú vytvárať a mazať výhradne v aplikácii BluOS Controller; API ich vie len načítať.

Zariadenie je iba na zápis: posiela príkaz na predvoľbu, ale nikdy nečíta späť, ktorá predvoľba hrá, takže prepínač neodráža skutočný stav prehrávača.

Používajte sloty predvolieb 1–9. Slot 0 posiela predvoľbu s identifikátorom 64 namiesto 0, čo vyzerá skôr na pozostatok zástupnej hodnoty než na skutočnú predvoľbu. Identifikátory predvolieb navyše nemusia ísť po sebe — prehrávač môže mať predvoľby 1, 2, 3, 5, 7 a 8 — preto si v aplikácii BluOS Controller overte, ktoré identifikátory naozaj existujú, skôr než slot zapojíte do scény.

Zoskupovanie multiroom

Zoskupiť s prehrávačom pripojí k tomuto prehrávaču druhý prehrávač BluOS. Prehrávač, ktorý TapHome oslovuje, sa stáva hlavným: vyberá zdroj hudby a rozvádza svoj zvuk, kým prehrávač určený premennou IP sa pripája ako podriadený. Vypnutie zariadenia tento prehrávač zo skupiny opäť odoberie. Stav sa číta späť zo zoznamu pripojených podriadených prehrávačov, takže zoskupenie vykonané z aplikácie BluOS sa v TapHome prejaví.

Zo spôsobu, akým zoskupovanie v BluOS funguje, vyplývajú dva dôsledky:

  • K zvyšku skupiny sa dostanú iba externé vstupy pripojené k hlavnému prehrávaču. Ak má zvuk z televízora cez optický alebo HDMI vstup hrať všade, TapHome musí oslovovať prehrávač, ku ktorému je tento vstup pripojený.
  • Aplikácia BluOS Controller zvládne najviac osem skupín po ôsmich prehrávačoch alebo štyri skupiny po šestnástich. Jeden prepínač TapHome obsluhuje jednu dvojicu hlavný–podriadený, takže trojica prehrávačov potrebuje druhý prepínač.

Požiadavky na zoskupovanie používajú zápis parametrov, ktorý mieša jednotné a množné číslo z API. V praxi to funguje, pretože port 11000 je zdokumentovaná predvolená hodnota, no oplatí sa o tom vedieť, ak by sa niektorý príkaz na zoskupenie zachoval nečakane.

Ukážkové tlačidlá — demonštrácie, nie funkcie prehrávača

Šablóna sa dodáva s dvoma tlačidlami s názvami Ukážka – Jungle a Ukážka – Vypnutie. Sú to demonštrácie streamovania z URL, nie schopnosti prehrávača: každé z nich zastaví prehrávanie, vyprázdni frontu a prehrá jeden zvukový súbor z adresy uloženej v premennej zariadenia.

Sú určené na úpravu alebo zmazanie. Ukážka Jungle smeruje na cudzí server so zvukovými ukážkami mimo kontroly TapHome a prestane fungovať vždy, keď sa tá stránka zmení. Ukážka Vypnutie smeruje na MP3 hosťované u TapHome a je použiteľným vzorom pre zvuk zvončeka alebo hlásenia, ak sa adresa nahradí vlastnou — pozor, adresa musí byť v percentuálnom kódovaní, pretože sa posiela prehrávaču bez úprav.

Riešenie problémov

Prehrávač neodpovedá
  1. Otvorte v prehliadači http://<ip_prehravaca>:11000/SyncStatus — odpoveď vo formáte XML znamená, že prehrávač je dostupný a API je živé.
  2. Ak neodpovedá, skontrolujte adresu v obrazovke Diagnostics aplikácie BluOS Controller; mohla ju posunúť obnova DHCP. Nastavte rezerváciu DHCP opísanú vyššie, aby sa to prestalo diať.
  3. Skúste namiesto IP adresy mDNS názov prehrávača.
  4. Overte, že riadiaca jednotka TapHome a prehrávač sú v tej istej sieti / VLAN a že medzi nimi nič neblokuje port 11000.
Prepínač zoskupenia sa nikdy nezapne

Premenná IP na zariadení Zoskupiť s prehrávačom je stále zástupný text 192.168.x.x, alebo obsahuje adresu, ktorá nepatrí prehrávaču BluOS. Nastavte ju na skutočnú adresu podriadeného prehrávača — pozri nastavenie po importe vyššie.

Predvoľba nič nerobí

Buď za slotom v tomto prehrávači žiadna predvoľba nie je, alebo bol použitý slot 0. Otvorte aplikáciu BluOS Controller, skontrolujte, ktoré identifikátory predvolieb prehrávač naozaj má, a priraďte sloty TapHome k týmto identifikátorom. Predvoľby treba najprv vytvoriť v aplikácii — šablóna ich vytvárať nevie.

Ďalšia / Predchádzajúca nefungujú

Prehrávač nehrá zo svojej fronty. Rádiové streamy a fyzické vstupy nie sú založené na fronte a preskakovanie dopredu ani dozadu sa na ne nevzťahuje. Spustite prehrávanie z playlistu, albumu alebo fronty a tlačidlá začnú znova fungovať.

Zmeny z aplikácie BluOS sa prejavia oneskorene

Náhodné prehrávanie a opakovanie sa čítajú z uloženého stavu modulu, ktorý sa obnovuje každých 30 sekúnd. Hlasitosť sa dopytuje častejšie. Tlačidlá prehrávania a Predvoľba sú iba na zápis a vonkajšie zmeny neodrážajú vôbec.

Prehrávač je stlmený, ale TapHome ukazuje úroveň

Stlmenie sa zapíše pri vypnutí stmievača hlasitosti, no stav stlmenia sa nikdy nečíta späť. Prehrávač stlmený z aplikácie BluOS Controller alebo z jeho diaľkového ovládača naďalej ukazuje v TapHome predchádzajúcu úroveň stmievača. Zosúladíte ich vypnutím a opätovným zapnutím stmievača.

Dostupné zariadenia

Bluesound Modul
Vlastné premenné

Bluesound

Čítanie (modul)
var response := SENDHTTPREQUEST("/Status");
shuffle := PARSEXML(response.Content, "//shuffle");
repeat := PARSEXML(response.Content, "//repeat");
Ďalšia skladba Tlačidlo

Preskočí na ďalšiu skladbu vo fronte prehrávania; na konci fronty sa vráti na prvú skladbu bez ohľadu na nastavenie opakovania

button push

Ďalšia skladba

Zápis stavu tlačidla
SENDHTTPREQUEST("/Skip");
Hlasitosť Stmievač

Hlasitosť prehrávača — vypnutie stmievača prehrávač stlmí namiesto nastavenia úrovne na nulu a zmena sa prejaví na všetkých prehrávačoch v skupine

numeric Jednotka: % dimmer

Hlasitosť

Čítanie úrovne
var response := SENDHTTPREQUEST("/Volume");
PARSEXML(response.Content, "//volume") / 100;
Zápis úrovne
if St
	SENDHTTPREQUEST("/Volume?level=" + round(Le*100) + "&tell_slaves=1");
else
	SENDHTTPREQUEST("/Volume?mute=1&tell_slaves=1");
end
Náhodné prehrávanie Prepínač

Stav náhodného prehrávania fronty — stav sa číta z hodnoty /Status uloženej v module, zápis ide cez HTTP

boolean switch
Hodnoty / Stavy: ${shuffle} · ${noShuffle}

Náhodné prehrávanie

Čítanie stavu prepínača
shuffle
Zápis stavu prepínača
var response := SENDHTTPREQUEST("/Shuffle?state=" + St);
shuffle := PARSEXML(response.Content, "//playlist/@shuffle");
Opakovanie Viacstavový prepínač

Režim opakovania — bez opakovania, opakovanie jednej skladby alebo opakovanie celej fronty

enum multi-value
Hodnoty / Stavy: Bez opakovania · Opakovať jednu · Opakovať všetko

Opakovanie

Čítanie stavu prepínača
switch(repeat,0,2,1,1,0)
Zápis stavu prepínača
var tmp := switch(Mu,0,2,1,1,0);
var response := SENDHTTPREQUEST("/Repeat?state=" + switch(Mu,0,2,1,1,0));
repeat := PARSEXML(response.Content, "//playlist/@repeat");
Pauza Tlačidlo

Prepína medzi pozastavením a prehrávaním — opätovné stlačenie tlačidla prehrávanie obnoví

button push

Pauza

Zápis stavu tlačidla
SENDHTTPREQUEST("/Pause?toggle=1");
Predchádzajúca skladba Tlačidlo

Ak aktuálna skladba hrá dlhšie než štyri sekundy, spustí ju znova; inak sa vráti na predchádzajúcu skladbu vo fronte

button push

Predchádzajúca skladba

Zápis stavu tlačidla
SENDHTTPREQUEST("/Back");
Play Tlačidlo

Spustí prehrávanie aktuálneho zdroja zvuku — pozastavený prehrávač obnoví, zastavený nie

button push

Play

Zápis stavu tlačidla
SENDHTTPREQUEST("/Play");
Predvoľba Viacstavový prepínač

Načíta predvoľbu uloženú v prehrávači — rádiové stanice, playlisty a vstupy, ktoré sa vytvárajú výhradne v aplikácii BluOS Controller. Iba na zápis, takže prepínač neukazuje, ktorá predvoľba hrá

enum multi-value

Predvoľba

Zápis stavu prepínača
SENDHTTPREQUEST("/Preset?id=" + Mu);
Ukážka – Jungle Tlačidlo

Ukážka streamovania z URL, nie funkcia prehrávača — zastaví prehrávanie, vyprázdni frontu a prehrá jeden zvukový súbor z nastavenej adresy

button push
Premenná: encodedURL — Adresa zvukového streamu pre toto tlačidlo, zapísaná v percentuálnom kódovaní URL. Predvolená hodnota smeruje na cudzí server s ukážkami a mala by sa nahradiť

Ukážka – Jungle

Zápis stavu tlačidla
SENDHTTPREQUEST("/Stop");
SENDHTTPREQUEST("/Clear");
SENDHTTPREQUEST("/Play?url=" + encodedURL);
Ukážka – Vypnutie Tlačidlo

Druhá ukážka streamovania z URL — zastaví prehrávanie, vyprázdni frontu a prehrá jeden zvukový súbor z nastavenej adresy

button push
Premenná: encodedURL — Adresa zvukového streamu pre toto tlačidlo, zapísaná v percentuálnom kódovaní URL

Ukážka – Vypnutie

Zápis stavu tlačidla
SENDHTTPREQUEST("/Stop");
SENDHTTPREQUEST("/Clear");
SENDHTTPREQUEST("/Play?url=" + encodedURL);
Zoskupiť s prehrávačom Prepínač

Pripojí druhý prehrávač BluOS ako podriadený člen skupiny — prehrávač ovládaný z TapHome sa stane hlavným a rozvádza svoj zvuk. Po importe je potrebné doplniť IP adresu druhého prehrávača

boolean switch
Hodnoty / Stavy: ON · OFF
Premenná: IP — IP adresa prehrávača BluOS, ktorý sa má pripojiť ako podriadený člen skupiny. Dodaná hodnota 192.168.x.x je zástupný text a musí sa nahradiť, inak prepínač zostane natrvalo vypnutý

Zoskupiť s prehrávačom

Čítanie stavu prepínača
var response := SENDHTTPREQUEST("/SyncStatus");
var slaves := PARSEXML(response.Content, "//SyncStatus/slave/@id");
indexof(slaves, IP) >= 0
Zápis stavu prepínača
if St
	SENDHTTPREQUEST("/AddSlave?slave=" + IP + "&ports=11000");
else
	SENDHTTPREQUEST("/RemoveSlave?slave=" + IP + "&ports=11000");
end
Stop Tlačidlo

Zastaví prehrávanie — na rozdiel od pauzy sa zastavený prehrávač tlačidlom Play už neobnoví

button push

Stop

Zápis stavu tlačidla
SENDHTTPREQUEST("/Stop");
Pripojenie: Packet Parser → HTTP • Hostname: {MODEL}-{MAC4}.local
Možné vylepšenia (17)
  • Long Polling — Holds the connection open and returns only when something changes. Would cut request volume substantially and is the mechanism the documented 30 s polling ceiling exists to make unnecessary. The template uses plain repeated GETs on 2.5 s / 10 s / 30 s intervals.
  • Now Playing Metadata — Playback state, three-line track description, album art URL, track length and elapsed seconds. The module already fetches /Status every 30 s but only extracts shuffle and repeat from it, so this would cost no extra requests.
  • Mute State (read) — The volume dimmer writes /Volume?mute=1 when switched off but never reads mute back, so a player muted from the BluOS app still shows its old dimmer level in TapHome.
  • Doorbell Chime — Plays the player's configured chime at its configured chime volume without touching the play queue. The most obviously useful addition for a smart home — the Sample buttons approximate it far more crudely by clearing the queue.
  • Direct Input Selection — Switches the player to a physical input by type and index — spdif, analog, coax, bluetooth, arc, earc, phono, computer, aesebu, balanced, microphone. Requires BluOS firmware 4.2.0 or newer; older firmware uses /Play?inputIndex=. Natural fit for a multi-value switch.
  • Input Discovery — Lists the inputs actually present on the player, including inputs shared by a BluOS HUB elsewhere on the network. HUB input selection is only supported through this route plus /Play?url=.
  • List Presets — Returns the real preset ids, names and artwork. Would let the Preset device show what it is actually switching between instead of a fixed 0–9 list.
  • Next / Previous Preset — Steps through presets without knowing their ids — two push buttons would cover it and would not depend on the ids matching.
  • Relative Volume Step — Volume up / down by a dB step (typical value 2 dB). Cheaper than the dimmer for wall-button control and does not need the current level to be read first.
  • Absolute dB Volume — Sets volume on the dB scale instead of the 0–100 percentage, which is what the player's configured volume range is actually expressed in.
  • Play Queue Management — List the queue, delete or move a track, save the queue as a named playlist. The template only uses /Clear, and only inside the two demo buttons.
  • Content Browsing and Search — Navigate and search music services, local library, playlists and inputs. A large surface that does not map naturally onto TapHome device models, but it is the reason the template has no way to choose what plays beyond presets.
  • Radio Station Actions — Skip, back, love and ban on streaming radio stations that do not use the play queue. This is what Next Track and Previous Track would need to fall back to when /Status carries a <streamUrl>.
  • Player Identity and Group Name — MAC address (the value a router DHCP reservation needs), player name, model, brand and the current group name. The grouping switch already fetches /SyncStatus every 30 s, so these would be free service attributes.
  • Battery Level — Present only on players with a battery pack, such as PULSE FLEX with the BP100 — state of charge in percent plus a charging flag.
  • Bluetooth Mode — Manual, Automatic, Guest or Disabled. Useful for locking guest access to a player from a scene.
  • Soft Reboot — The only POST endpoint in the API — the PacketParser HTTP module issues GETs, so this would need a different mechanism.

Zdroje

Našli ste problém s touto šablónou zariadenia?

Napíšte nám, čo nefunguje, čo chýba, alebo ako by sa mala šablóna správať. Vaša spätná väzba nám pomáha udržiavať katalóg presný.

Overené TapHomom

Chcete to použiť vo svojom TapHome jadre?

Otvorte túto šablónu v Customer Portali a aplikujte ju na svoj domov, alebo navrhnite zmenu a odošlite ju späť do katalógu.

Otvoriť v portáli