TapHome

Bluesound

Packet Parser → HTTP
Autor
Posljednje ažuriranje: 10. 2026

Ovaj uređaj podržava mDNS

Umjesto IP adrese uređaju možete pristupiti na adresi:

{MODEL}-{MAC4}.local

Zamijenite {MAC} MAC adresom svog uređaja (velika slova, bez dvotočaka).

TapHome podržava mDNS. Naziv računala (hostname) pouzdaniji je od statične IP adrese.

Bluesound

Bluesound je linija multiroom audio uređaja izgrađena na platformi BluOS, platformi tvrtke Lenbrook za streaming zvuka bez gubitaka do 24 bita/192 kHz. Svaki reproduktor BluOS u lokalnoj mreži nudi BluOS Custom Integration API: obične HTTP GET zahtjeve na TCP portu 11000, odgovore u formatu UTF-8 XML, bez autentifikacije i bez računa u oblaku. TapHome s reproduktorom komunicira izravno preko lokalne mreže (LAN).

Predložak nije vezan uz određeni model: ne ovisi o modelu ni proizvođaču i koristi samo HTTP API, pa vrijedi za cijelu aktualnu ponudu (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 i HUB) i za starije generacije. Budući da BluOS koriste i NAD Electronics, DALI, PSB Speakers, Monitor Audio, Roksan, Cyrus i Peachtree, reproduktori tih marki nude isti API i odgovaraju na iste zahtjeve.

Mrežno povezivanje

Ožičenje nije potrebno. Reproduktor BluOS spaja se na kućnu mrežu preko Etherneta ili Wi-Fi mreže pomoću čarobnjaka za postavljanje u aplikaciji BluOS Controller, a TapHome mu zatim pristupa preko HTTP-a. Jedini je uvjet da centralna jedinica TapHome i reproduktor budu u istom segmentu lokalne mreže i da je port 11000 između njih otvoren.

Port 11000 vrijedi za svaki reproduktor BluOS uz jednu dokumentiranu iznimku: NAD CI580 u jednom kućištu ima četiri streamera na portovima 11000 / 11010 / 11020 / 11030. Predložak koristi samo port 11000, pa na uređaju CI580 upravlja prvim streamerom.

Konfiguracija

Pronalaženje IP adrese reproduktora

Adresa je prikazana na zaslonu Diagnostics u aplikaciji BluOS Controller:

  • Android / iOS: kartica Players → odaberite reproduktor → kartica Home → Settings → u odjeljku Help & Support dodirnite Diagnostics.
  • Windows / macOS: Player Drawer → odaberite reproduktor → lijevi Navigation Drawer → Help → Diagnostics.

Na istom zaslonu u odjeljku Other Players navedene su adrese ostalih reproduktora u mreži. Bez aplikacije, otvaranjem http://<player_ip>:11000/SyncStatus u pregledniku dobit ćete id reproduktora (adresu i port) zajedno s atributom mac.

Stalna adresa

Predložak reproduktoru pristupa preko IP adrese, pa promijenjena DHCP dodjela adrese neprimjetno prekida integraciju. Lenbrook izričito preporučuje DHCP rezervaciju na usmjerivaču umjesto statične adrese postavljene na reproduktoru:

  1. Otvorite administracijsko sučelje usmjerivača i pronađite postavke DHCP / LAN rezervacije.
  2. Unesite MAC adresu reproduktora: nalazi se u odgovoru /SyncStatus, pa se može očitati preko HTTP-a i bez aplikacije.
  3. Dodijelite adresu koju reproduktor treba zadržati i spremite.
  4. Ponovno pokrenite reproduktor kako bi obnovio dodjelu adrese, a zatim provjerite je li dobio rezerviranu adresu.
Uvoz predloška

Predložak ima jedan parametar uvoza, IpAddress (rezervirano mjesto 192.168.0.1). Unesite adresu reproduktora; port 11000 i format zahtjeva već su dio predloška.

Obavezno postavljanje nakon uvoza: Grupiraj s reproduktorom

Sklopka Grupiraj s reproduktorom isporučuje se s varijablom IP postavljenom na doslovno rezervirano mjesto 192.168.x.x. To nije upotrebljiva zadana vrijednost: dok se ne zamijeni, skripta za čitanje traži 192.168.x.x među podređenim reproduktorima, nikad ga ne pronađe i sklopka stalno pokazuje isključeno.

Nakon uvoza predloška otvorite uređaj Grupiraj s reproduktorom u aplikaciji TapHome i postavite IP na adresu reproduktora koji treba priključiti kao podređeni član grupe. Koristite gore opisani zaslon Diagnostics (Other Players navodi upravo te adrese) ili očitajte /SyncStatus na bilo kojem reproduktoru u mreži.

Svi ostali uređaji u predlošku rade čim se ispuni IpAddress. Grupiraj s reproduktorom jedini je uređaj kojemu nakon uvoza treba unijeti dodatnu vrijednost. Ako ostavite 192.168.x.x, sklopka će izgledati neispravno umjesto da javi pogrešku.

Mogućnosti uređaja

Upravljanje reprodukcijom

Pet gumba upravlja reprodukcijom:

  • Reproduciraj: pokreće trenutačni izvor zvuka. Nastavlja reprodukciju pauziranog reproduktora, ali zaustavljeni reproduktor njime se ne pokreće ponovno.
  • Pauza: šalje naredbu toggle, pa isti gumb pauzira reproduktor koji svira i nastavlja reprodukciju pauziranog. Ako svira alarm s vremenskim ograničenjem, pauza poništava i to ograničenje.
  • Zaustavi: zaustavlja reprodukciju. Za razliku od pauze, reprodukcija na zaustavljenom reproduktoru ne može se nastaviti gumbom Reproduciraj. Zaustavljanje poništava i vremensko ograničenje alarma koji je u tijeku.
  • Sljedeća pjesma: prelazi naprijed u redu za reprodukciju, a na kraju reda vraća se na prvu pjesmu, bez obzira na postavku ponavljanja.
  • Prethodna pjesma: ponovno pokreće trenutačnu pjesmu ako svira dulje od četiri sekunde, a inače se vraća na prethodnu pjesmu.

Ti gumbi djeluju na red za reprodukciju. Kad reproduktor reproducira radijsku postaju ili fizički ulaz, red nije izvor zvuka i preskakanje naprijed / natrag nije dostupno; API taj slučaj rješava posebnom krajnjom točkom koju predložak ne koristi.

Glasnoća

Glasnoća je dimer. Čita razinu reproduktora (0–100) i pretvara je u raspon dimera 0,0–1,0; pri upisu razine vrijednost se šalje natrag kao cijeli postotak. Isključivanje dimera šalje naredbu za isključivanje zvuka umjesto glasnoće 0, pa vlastita razina reproduktora ostaje sačuvana i ponovno uključivanje zvuka je vraća.

Oba upisa sadrže tell_slaves=1, što odgovara klizaču glasnoće grupe u aplikaciji BluOS Controller: kada je reproduktor glavni član grupe, svi reproduktori u grupi mijenjaju glasnoću zajedno, a ne samo onaj kojemu je naredba upućena.

Upotrebljivi raspon glasnoće reproduktora postavlja se u aplikaciji BluOS Controller u Settings → Player → Audio i obično iznosi od −80 do 0 dB. Sve se razine ograničavaju na taj raspon, pa dimer TapHome na 100 % ne znači nužno 0 dB. Reproduktori s fiksnim linijskim izlazom ne javljaju nikakvu upotrebljivu glasnoću, a dimer tada umjesto pogreške prikazuje besmislenu razinu.

Dimer glasnoće očitava reproduktor svakih 2,5 sekunde, dok BluOS API od integracija koje ne koriste long polling traži najviše jedan zahtjev svakih 30 sekundi. Na jednom reproduktoru to je nekoliko malih zahtjeva u minuti, ali u kući punoj reproduktora to se zbraja. Imajte to na umu kod opterećene Wi-Fi mreže i ondje gdje je mreža zauzeta radije koristite reproduktore spojene kabelom.

Nasumična reprodukcija i ponavljanje

Nasumična reprodukcija uključuje i isključuje nasumični redoslijed u redu za reprodukciju. Nasumična reprodukcija ponovno slaže red; izvorni redoslijed vraća se kad se ponovno isključi.

Ponavljanje je prekidač s više vrijednosti s tri stanja: Bez ponavljanja, Ponovi jednu i Ponovi sve. TapHome te vrijednosti slaže obrnutim redoslijedom od API-ja, a predložak isto preslikavanje primjenjuje pri čitanju i pri upisu, pa oba smjera ostaju usklađena.

Oba uređaja čitaju stanje iz vrijednosti koju modul pohranjuje pri vlastitom očitavanju stanja svakih 30 sekundi, umjesto da šalju vlastite zahtjeve. Tako je mrežni promet manji, ali promjena napravljena u aplikaciji BluOS može se u sustavu TapHome pojaviti tek nakon do 30 sekundi.

Preseti

Preset poziva preset spremljen na reproduktoru: radijsku postaju, popis za reprodukciju ili ulaz. Presete je moguće izraditi i izbrisati samo u aplikaciji BluOS Controller; API ih može samo učitati.

Uređaj služi samo za upis: šalje naredbu za preset, ali nikad ne očitava koji preset svira, pa sklopka ne prikazuje stvarno stanje reproduktora.

Koristite mjesta za preset 1–9. Mjesto 0 šalje preset id 64 umjesto 0, što izgleda kao zaostalo rezervirano mjesto, a ne pravi preset. Id-ovi preseta ne moraju biti ni uzastopni (reproduktor može imati presete 1, 2, 3, 5, 7 i 8), pa prije nego što mjesto povežete sa scenom u aplikaciji BluOS Controller provjerite koji id-ovi stvarno postoje.

Multiroom grupiranje

Grupiraj s reproduktorom ovom reproduktoru priključuje drugi reproduktor BluOS. Reproduktor kojem TapHome pristupa postaje glavni: odabire izvor glazbe i prosljeđuje svoj zvuk ostalim reproduktorima, a reproduktor naveden u varijabli IP pridružuje se kao podređeni. Isključivanjem uređaja taj se reproduktor ponovno uklanja iz grupe. Stanje se očitava iz popisa priključenih podređenih reproduktora, pa se i grupiranje napravljeno u aplikaciji BluOS prikazuje u sustavu TapHome.

Iz načina na koji radi grupiranje BluOS proizlaze dvije posljedice:

  • Samo vanjski ulazi spojeni na glavni reproduktor dolaze do ostatka grupe. Ako zvuk televizora s optičkog ili HDMI ulaza treba svirati posvuda, TapHome mora pristupati reproduktoru na koji je taj ulaz spojen.
  • Aplikacija BluOS Controller podržava najviše osam grupa od po osam reproduktora ili četiri grupe od po šesnaest. Jedna sklopka TapHome obrađuje jedan par glavni–podređeni, pa grupa od tri reproduktora treba drugu sklopku.

Zahtjevi za grupiranje šalju parametar u jednini slave= zajedno s parametrom u množini ports=, a tu kombinaciju dokumentacija BluOS API-ja ne navodi. Najvjerojatnije ipak radi jer je 11000 ionako dokumentirani zadani port, ali to je dobro znati ako se naredba za grupu ikad ponaša neočekivano.

Gumbi s primjerima: demonstracije, ne funkcije reproduktora

Predložak se isporučuje s dva gumba nazvana Primjer - Jungle i Primjer - Isključivanje. Oni su demonstracija streaminga s URL-a, a ne mogućnosti reproduktora: svaki zaustavlja reprodukciju, prazni red za reprodukciju i reproducira jednu audiodatoteku s URL-a spremljenog u varijabli uređaja.

Namijenjeni su za uređivanje ili brisanje. Primjer Jungle pokazuje na poslužitelj s primjerima treće strane, izvan kontrole TapHome, i prestat će raditi kad god se ta stranica promijeni. Primjer Isključivanje pokazuje na MP3 datoteku koju poslužuje TapHome i upotrebljiv je obrazac za zvuk zvona na vratima ili obavijesti ako URL zamijenite vlastitim. Adresa mora biti postotno kodirana (percent-encoding), jer se izravno prosljeđuje reproduktoru.

Rješavanje problema

Reproduktor ne odgovara
  1. U pregledniku otvorite http://<player_ip>:11000/SyncStatus: odgovor u formatu XML znači da je reproduktor dostupan i da API radi.
  2. Ako ne odgovara, provjerite adresu na zaslonu Diagnostics u aplikaciji BluOS Controller; obnova DHCP dodjele možda ju je promijenila. Postavite gore opisanu DHCP rezervaciju kako se to ne bi ponavljalo.
  3. Umjesto IP adrese pokušajte mDNS naziv hosta reproduktora.
  4. Provjerite jesu li centralna jedinica TapHome i reproduktor u istoj mreži / VLAN-u te ne blokira li nešto između njih port 11000.
Sklopka za grupiranje nikad se ne uključi

Varijabla IP na uređaju Grupiraj s reproduktorom još uvijek je rezervirano mjesto 192.168.x.x ili sadrži adresu koja nije reproduktor BluOS. Postavite je na stvarnu adresu podređenog reproduktora, kako je opisano u postavljanju nakon uvoza.

Preset ne radi ništa

Na tom mjestu na ovom reproduktoru nema preseta ili je korišteno mjesto 0. Otvorite aplikaciju BluOS Controller, provjerite koje id-ove preseta reproduktor stvarno ima i mjesta u sustavu TapHome povežite s tim id-ovima. Presete najprije treba izraditi u aplikaciji, predložak ih ne može izraditi.

Sljedeća / Prethodna pjesma ne rade ništa

Reproduktor ne svira iz reda za reprodukciju. Radijski streamovi i fizički ulazi ne temelje se na redu, pa se preskakanje naprijed / natrag na njih ne odnosi. Pokrenite reprodukciju s popisa za reprodukciju, albuma ili iz reda i gumbi će ponovno raditi.

Promjene napravljene u aplikaciji BluOS prikazuju se kasno

Nasumična reprodukcija i ponavljanje čitaju se iz pohranjenog stanja modula, koje se osvježava svakih 30 sekundi. Glasnoća se očitava češće. Gumbi za reprodukciju i Preset služe samo za upis i nikad ne prikazuju vanjske promjene.

Reproduktor je bez zvuka, a TapHome prikazuje razinu

Isključivanje zvuka upisuje se pri isključivanju dimera glasnoće, ali stanje isključenog zvuka nikad se ne očitava. Reproduktor kojem je zvuk isključen iz aplikacije BluOS Controller ili daljinskim upravljačem u sustavu TapHome i dalje prikazuje prethodnu razinu dimera. Isključite i ponovno uključite dimer kako bi se oba stanja ponovno uskladila.

Dostupni uređaji

Bluesound Modul
Prilagođene varijable

Bluesound

Čitanje (modul)
var response := SENDHTTPREQUEST("/Status");
shuffle := PARSEXML(response.Content, "//shuffle");
repeat := PARSEXML(response.Content, "//repeat");
Sljedeća pjesma Tipkalo

Prelazi na sljedeću pjesmu u redu za reprodukciju, a na kraju reda vraća se na prvu pjesmu bez obzira na postavku ponavljanja

button push

Sljedeća pjesma

Zapis stanja tipke
SENDHTTPREQUEST("/Skip");
Glasnoća Dimer

Glasnoća reproduktora — isključivanje dimera isključuje zvuk reproduktora umjesto da razinu postavi na nulu, a promjena se primjenjuje na sve reproduktore u grupi

numeric Jedinica: % dimmer

Glasnoća

Čitanje razine
var response := SENDHTTPREQUEST("/Volume");
PARSEXML(response.Content, "//volume") / 100;
Zapis razine
if St
	SENDHTTPREQUEST("/Volume?level=" + round(Le*100) + "&tell_slaves=1");
else
	SENDHTTPREQUEST("/Volume?mute=1&tell_slaves=1");
end
Nasumična reprodukcija Sklopka

Stanje nasumične reprodukcije reda — stanje se čita iz vrijednosti /Status pohranjene u modulu, a upisuje se preko HTTP-a

boolean switch
Vrijednosti / stanja: ${shuffle} · ${noShuffle}

Nasumična reprodukcija

Čitanje stanja sklopke
shuffle
Zapis stanja sklopke
var response := SENDHTTPREQUEST("/Shuffle?state=" + St);
shuffle := PARSEXML(response.Content, "//playlist/@shuffle");
Ponavljanje Prekidač s više vrijednosti

Način ponavljanja — bez ponavljanja, ponavljanje jedne pjesme ili ponavljanje cijelog reda za reprodukciju

enum multi-value
Vrijednosti / stanja: Bez ponavljanja · Ponovi jednu · Ponovi sve

Ponavljanje

Čitanje stanja sklopke
switch(repeat,0,2,1,1,0)
Zapis stanja sklopke
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 Tipkalo

Prebacuje između pauze i reprodukcije — ponovni pritisak gumba nastavlja reprodukciju

button push

Pauza

Zapis stanja tipke
SENDHTTPREQUEST("/Pause?toggle=1");
Prethodna pjesma Tipkalo

Ponovno pokreće trenutačnu pjesmu ako svira dulje od četiri sekunde, a inače se vraća na prethodnu pjesmu u redu

button push

Prethodna pjesma

Zapis stanja tipke
SENDHTTPREQUEST("/Back");
Reproduciraj Tipkalo

Pokreće reprodukciju trenutačnog izvora zvuka — nastavlja reprodukciju pauziranog reproduktora, ali ne i zaustavljenog

button push

Reproduciraj

Zapis stanja tipke
SENDHTTPREQUEST("/Play");
Preset Prekidač s više vrijednosti

Učitava preset spremljen na reproduktoru (radijsku postaju, popis za reprodukciju ili ulaz). Preseti se izrađuju samo u aplikaciji BluOS Controller. Služi samo za upis, pa sklopka ne prikazuje koji preset svira

enum multi-value

Preset

Zapis stanja sklopke
SENDHTTPREQUEST("/Preset?id=" + Mu);
Primjer - Jungle Tipkalo

Demonstracija streaminga s URL-a, ne funkcija reproduktora — zaustavlja reprodukciju, prazni red za reprodukciju i reproducira jednu audiodatoteku s postavljenog URL-a

button push
Varijabla: encodedURL — Postotno kodirana adresa audiostreama koji reproducira ovaj gumb. Isporučena zadana vrijednost pokazuje na poslužitelj s primjerima treće strane i treba je zamijeniti

Primjer - Jungle

Zapis stanja tipke
SENDHTTPREQUEST("/Stop");
SENDHTTPREQUEST("/Clear");
SENDHTTPREQUEST("/Play?url=" + encodedURL);
Primjer - Isključivanje Tipkalo

Druga demonstracija streaminga s URL-a — zaustavlja reprodukciju, prazni red za reprodukciju i reproducira jednu audiodatoteku s postavljenog URL-a

button push
Varijabla: encodedURL — Postotno kodirana adresa audiostreama koji reproducira ovaj gumb

Primjer - Isključivanje

Zapis stanja tipke
SENDHTTPREQUEST("/Stop");
SENDHTTPREQUEST("/Clear");
SENDHTTPREQUEST("/Play?url=" + encodedURL);
Grupiraj s reproduktorom Sklopka

Priključuje drugi reproduktor BluOS kao podređenog člana grupe — reproduktor kojim upravlja TapHome postaje glavni član grupe i prosljeđuje svoj zvuk ostalim reproduktorima. Nakon uvoza treba upisati IP adresu drugog reproduktora

boolean switch
Vrijednosti / stanja: ON · OFF
Varijabla: IP — IP adresa reproduktora BluOS koji se priključuje kao podređeni član grupe. Isporučena vrijednost 192.168.x.x je rezervirano mjesto i mora se zamijeniti, inače sklopka stalno ostaje isključena

Grupiraj s reproduktorom

Čitanje stanja sklopke
var response := SENDHTTPREQUEST("/SyncStatus");
var slaves := PARSEXML(response.Content, "//SyncStatus/slave/@id");
indexof(slaves, IP) >= 0
Zapis stanja sklopke
if St
	SENDHTTPREQUEST("/AddSlave?slave=" + IP + "&ports=11000");
else
	SENDHTTPREQUEST("/RemoveSlave?slave=" + IP + "&ports=11000");
end
Zaustavi Tipkalo

Zaustavlja reprodukciju — za razliku od pauze, reprodukcija na zaustavljenom reproduktoru ne može se nastaviti gumbom Reproduciraj

button push

Zaustavi

Zapis stanja tipke
SENDHTTPREQUEST("/Stop");
Povezivanje: Packet Parser → HTTP • Naziv računala (hostname): {MODEL}-{MAC4}.local
Moguća poboljšanja (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.

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu