
A Bluesound egy multiroom audio termékcsalád, amely a BluOS rendszerre épül — ez a Lenbrook streaming platformja veszteségmentes hanghoz, akár 24 bit/192 kHz felbontásig. Minden BluOS lejátszó elérhetővé teszi a helyi hálózaton a BluOS Custom Integration API-t: egyszerű HTTP GET kérések a 11000-es TCP porton, UTF-8 XML válaszok, hitelesítés és felhőfiók nélkül. A TapHome közvetlenül a helyi hálózaton kommunikál a lejátszóval.
A sablon nem modellfüggő — nem tartalmaz modell- vagy gyártókötést, és kizárólag a HTTP API-t használja, így a teljes aktuális termékcsaládra érvényes (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 és HUB), valamint a korábbi generációkra is. Mivel BluOS rendszert szállít a NAD Electronics, a DALI, a PSB Speakers, a Monitor Audio, a Roksan, a Cyrus és a Peachtree is, ezeknek a márkáknak a lejátszói ugyanezt az API-t kínálják, és ugyanazokra a kérésekre válaszolnak.
Hálózati kapcsolat
Nincs semmilyen bekötési munka. A BluOS lejátszó a BluOS Controller alkalmazás beállítási varázslójával csatlakozik az otthoni hálózathoz Etherneten vagy Wi-Fin, a TapHome pedig ezután HTTP-n éri el. Az egyetlen feltétel, hogy a TapHome vezérlőegység és a lejátszó ugyanabban a hálózati szegmensben legyen, és a 11000-es port nyitva legyen közöttük.
A 11000-es port minden BluOS lejátszóra érvényes, egyetlen dokumentált kivétellel: a NAD CI580 négy streamer csomópontot tartalmaz egy házban, a 11000 / 11010 / 11020 / 11030 portokon. A sablon kizárólag a 11000-es portot szólítja meg, így CI580-on az 1-es csomópontot vezérli.
Konfiguráció
A lejátszó IP-címének kiderítése
A cím a BluOS Controller alkalmazás Diagnostics képernyőjén látható:
- Android / iOS — Players fül → válaszd ki a lejátszót → Home fül → Settings → a Help & Support szakaszban koppints a Diagnostics elemre.
- Windows / macOS — Player Drawer → válaszd ki a lejátszót → bal oldali Navigation Drawer → Help → Diagnostics.
Ugyanez a képernyő az Other Players alatt a hálózat többi lejátszójának címét is felsorolja. Alkalmazás nélkül a http://<lejatszo_ip>:11000/SyncStatus cím böngészőben való megnyitása visszaadja a lejátszó id attribútumát (cím és port) a mac attribútumával együtt.
A cím állandósítása
A sablon IP-cím alapján szólítja meg a lejátszót, így egy megváltozott DHCP-bérlet észrevétlenül leállítja az integrációt. A Lenbrook kifejezetten a routeren beállított DHCP-foglalást ajánlja a lejátszón konfigurált statikus cím helyett:
- Nyisd meg a router adminisztrációs felületét, és keresd meg a DHCP / LAN foglalási beállításokat.
- Add meg a lejátszó MAC-címét — a
/SyncStatusválasz tartalmazza, így alkalmazás nélkül, HTTP-n is kiolvasható. - Rendeld hozzá azt a címet, amelyet a lejátszónak meg kell tartania, majd mentsd el.
- Indítsd újra a lejátszót, hogy megújítsa a bérletét, majd ellenőrizd, hogy a foglalt címet vette-e fel.
A sablon importálása
A sablonnak egyetlen importálási paramétere van, az IpAddress (helykitöltő értéke 192.168.0.1). Add meg a lejátszó címét; a 11000-es port és a kérések formátuma már a sablon része.
Kötelező beállítás importálás után — Csoportosítás lejátszóval
A Csoportosítás lejátszóval kapcsoló IP változója gyárilag a szó szerinti 192.168.x.x helykitöltőre van állítva. Ez nem működő alapérték — amíg le nem cseréled, az olvasó szkript a 192.168.x.x értéket keresi a másodlagos lejátszók között, sosem találja meg, és a kapcsoló tartósan kikapcsolva marad.
A sablon importálása után nyisd meg a Csoportosítás lejátszóval eszközt a TapHome alkalmazásban, és állítsd be az IP értékét annak a lejátszónak a címére, amelyet másodlagosként kell a csoporthoz csatolni. Használd a fent leírt Diagnostics képernyőt (az Other Players pontosan ezeket a címeket sorolja fel), vagy olvasd ki a /SyncStatus végpontot a hálózat bármelyik lejátszóján.
A sablon összes többi eszköze azonnal működik, amint az IpAddress ki van töltve. A Csoportosítás lejátszóval az egyetlen eszköz, amely importálás után egy második értéket is igényel — ha a
192.168.x.xa helyén marad, a kapcsoló hibásnak fog tűnni ahelyett, hogy hibát jelezne.
Eszközfunkciók
Lejátszásvezérlés
Öt nyomógomb vezérli a lejátszást:
- Play — elindítja az aktuális hangforrást. A szüneteltetett lejátszót folytatja, a leállítottat azonban nem indítja újra.
- Szünet — átkapcsolást küld, így ugyanaz a gomb szünetelteti a szóló lejátszót, és folytatja a szüneteltetettet. Ha időkorláttal rendelkező ébresztő szól, a szüneteltetés ezt az időkorlátot is megszünteti.
- Stop — leállítja a lejátszást. A szünettel ellentétben a leállított lejátszó a Play gombbal nem folytatható. A leállítás szintén megszünteti a futó ébresztő időkorlátját.
- Következő szám — előrelép a lejátszási sorban, a sor végén pedig az első számra vált, függetlenül az ismétlési beállítástól.
- Előző szám — ha az aktuális szám négy másodpercnél régebb óta szól, újraindítja, egyébként az előző számra lép vissza.
Ezek a gombok a lejátszási sorra hatnak. Ha a lejátszó rádióadást streamel vagy fizikai bemenetről szól, a sor nem a hangforrás, és az előre-, illetve visszalépés nem érhető el — az API erre az esetre külön végpontot kínál, amelyet a sablon nem használ.
Hangerő
A Hangerő egy dimmer. Kiolvassa a lejátszó szintjét (0–100), és a 0,0–1,0 dimmer-tartományra skálázza; íráskor egész százalékként küldi vissza az értéket. A dimmer kikapcsolása némítási parancsot küld a 0-s hangerő helyett, így a lejátszó saját szintje megmarad, és a némítás feloldásakor visszaáll.
Mindkét írás tartalmazza a tell_slaves=1 paramétert, ami a BluOS Controller alkalmazás csoportos hangerőszabályzójának felel meg: ha a lejátszó a csoport elsődleges tagja, a csoport összes lejátszójának hangereje együtt változik, nem csak a megszólítotté.
A használható hangerő-tartományt a BluOS Controller alkalmazásban a Settings → Player → Audio oldalon lehet beállítani, és jellemzően −80…0 dB. Minden szint ebbe a tartományba illeszkedik, így a 100 %-on álló TapHome dimmer nem feltétlenül jelent 0 dB-t. A fix vonalszintű kimenettel rendelkező lejátszók egyáltalán nem jeleznek használható hangerőt, és a dimmer ilyenkor értelmetlen szintet mutat hibaüzenet helyett.
A hangerő dimmer 2,5 másodpercenként kérdezi le a lejátszót, miközben a BluOS API a long polling nélküli integrációktól legfeljebb 30 másodpercenként egy kérést vár el. Egyetlen lejátszónál ez percenként néhány apró kérés, egy lejátszókkal teli házban azonban összeadódik — érdemes ezt terhelt Wi-Fi mellett szem előtt tartani, és ahol a hálózat foglalt, ott a vezetékes lejátszókat előnyben részesíteni.
Véletlenszerű lejátszás és ismétlés
A Véletlenszerű lejátszás be- és kikapcsolja a sor megkeverését. A keverés újraépíti a sort; kikapcsoláskor az eredeti sorrend visszaáll.
Az Ismétlés háromállású kapcsoló — Nincs ismétlés, Egy szám ismétlése és Összes ismétlése. A TapHome ezeket a helyeket az API-hoz képest fordított sorrendben rendezi, és a sablon ugyanazt az átfordítást alkalmazza olvasáskor és íráskor is, így mindkét irány konzisztens marad.
Mindkét eszköz abból az értékből olvassa az állapotát, amelyet a modul a saját 30 másodperces állapotlekérdezésekor eltárol, ahelyett hogy saját kéréseket küldene. Ez alacsonyan tartja a hálózati forgalmat, cserébe akár 30 másodpercbe is telhet, mire a BluOS alkalmazásban végzett változtatás megjelenik a TapHome-ban.
Előbeállítások
Az Előbeállítás betölti a lejátszón tárolt előbeállítást — rádióállomást, lejátszási listát vagy bemenetet. Az előbeállítások kizárólag a BluOS Controller alkalmazásban hozhatók létre és törölhetők; az API csak betölteni tudja őket.
Az eszköz csak írható: elküldi az előbeállítás parancsát, de sosem olvassa vissza, melyik előbeállítás szól, így a kapcsoló nem tükrözi a lejátszó tényleges állapotát.
Az 1–9 előbeállítás-helyeket használd. A 0-s hely 0 helyett a 64-es előbeállítás-azonosítót küldi, ami inkább ottfelejtett helykitöltőnek tűnik, mint valódi előbeállításnak. Az előbeállítás-azonosítóknak ráadásul nem kell folytonosnak lenniük — egy lejátszón lehetnek az 1, 2, 3, 5, 7 és 8 azonosítójú előbeállítások —, ezért a BluOS Controller alkalmazásban ellenőrizd, mely azonosítók léteznek ténylegesen, mielőtt egy helyet jelenetbe kötnél.
Multiroom csoportosítás
A Csoportosítás lejátszóval egy második BluOS lejátszót csatol ehhez. A TapHome által megszólított lejátszó lesz az elsődleges: ő választja ki a zeneforrást és osztja szét a hangját, míg az IP változóban megnevezett lejátszó másodlagosként csatlakozik. Az eszköz kikapcsolása eltávolítja ezt a lejátszót a csoportból. Az állapot a csatolt másodlagos lejátszók listájából olvasódik vissza, így a BluOS alkalmazásból végzett csoportosítás is megjelenik a TapHome-ban.
A BluOS csoportosítás működéséből két következmény adódik:
- A csoport többi tagjához csak az elsődleges lejátszóra kötött külső bemenetek jutnak el. Ha a tévé hangját optikai vagy HDMI bemenetről mindenhol szólnia kell, a TapHome-nak azt a lejátszót kell megszólítania, amelyre az adott bemenet csatlakozik.
- A BluOS Controller alkalmazás legfeljebb nyolc, egyenként nyolc lejátszóból álló csoportot kezel, vagy négy, egyenként tizenhat lejátszósat. Egy TapHome kapcsoló egy elsődleges–másodlagos párt kezel, így egy háromtagú csoporthoz második kapcsoló kell.
A csoportosítási kérések olyan paraméterírásmódot használnak, amely keveri az API egyes és többes számú alakját. A gyakorlatban ez működik, mert a 11000-es port a dokumentált alapérték, de érdemes tudni róla, ha egy csoportosítási parancs valaha váratlanul viselkedne.
Mintagombok — bemutatók, nem lejátszófunkciók
A sablon két gombot tartalmaz Minta – Jungle és Minta – Leállítás néven. Ezek az URL-streamelés bemutatói, nem a lejátszó képességei: mindkettő leállítja a lejátszást, kiüríti a lejátszási sort, és lejátszik egyetlen hangfájlt az eszköz változójában tárolt címről.
Szerkesztésre vagy törlésre valók. A Jungle minta egy külső, a TapHome hatókörén kívüli mintaszerverre mutat, és mindig elromlik, amikor az az oldal megváltozik. A Leállítás minta egy TapHome által tárolt MP3-ra mutat, és jól használható minta ajtócsengő- vagy bemondáshanghoz, ha a címet sajátra cseréled — vedd figyelembe, hogy a címnek százalékos kódolásúnak kell lennie, mert változtatás nélkül kerül át a lejátszóhoz.
Hibaelhárítás
A lejátszó nem válaszol
- Nyisd meg böngészőben a
http://<lejatszo_ip>:11000/SyncStatuscímet — az XML válasz azt jelenti, hogy a lejátszó elérhető, és az API él. - Ha nem válaszol, ellenőrizd a címet a BluOS Controller alkalmazás Diagnostics képernyőjén; egy DHCP-megújítás elmozdíthatta. Állítsd be a fent leírt DHCP-foglalást, hogy ez ne fordulhasson elő újra.
- Próbáld az IP-cím helyett a lejátszó mDNS gépnevét.
- Ellenőrizd, hogy a TapHome vezérlőegység és a lejátszó ugyanazon a hálózaton / VLAN-on van-e, és hogy semmi nem zárja-e le közöttük a 11000-es portot.
A csoportosítás kapcsoló sosem kapcsol be
A Csoportosítás lejátszóval eszköz IP változója még mindig a 192.168.x.x helykitöltő, vagy olyan címet tartalmaz, amely nem BluOS lejátszóé. Állítsd be a másodlagos lejátszó valódi címére — lásd fentebb az importálás utáni beállítást.
Egy előbeállítás nem csinál semmit
Vagy nincs előbeállítás az adott hely mögött ezen a lejátszón, vagy a 0-s helyet használtad. Nyisd meg a BluOS Controller alkalmazást, ellenőrizd, mely előbeállítás-azonosítók vannak ténylegesen a lejátszón, és rendeld a TapHome helyeket ezekhez az azonosítókhoz. Az előbeállításokat előbb az alkalmazásban kell létrehozni — a sablon nem tudja őket létrehozni.
A Következő / Előző nem csinál semmit
A lejátszó nem a saját sorából játszik le. A rádióadások és a fizikai bemenetek nem sor alapúak, az előre- és visszalépés rájuk nem vonatkozik. Indítsd a lejátszást lejátszási listáról, albumról vagy a sorból, és a gombok újra működni fognak.
A BluOS alkalmazásban végzett változtatások késve jelennek meg
A véletlenszerű lejátszás és az ismétlés a modul eltárolt állapotából olvasódik, amely 30 másodpercenként frissül. A hangerőt gyakrabban kérdezi le a rendszer. A lejátszásvezérlő gombok és az Előbeállítás csak írhatók, és a külső változásokat egyáltalán nem tükrözik.
A lejátszó néma, a TapHome mégis szintet mutat
A némítás a hangerő dimmer kikapcsolásakor íródik ki, a némítási állapotot azonban a rendszer sosem olvassa vissza. A BluOS Controller alkalmazásból vagy a távirányítóról elnémított lejátszó a TapHome-ban továbbra is a korábbi dimmer-szintjét mutatja. Kapcsold ki, majd újra be a dimmert, hogy a kettő ismét összhangba kerüljön.
