Sérsniðin samþættingar-API
T 778 Sérsniðin samþættingarforritaskil
Upplýsingarnar í þessari handbók eru eign Lenbrook Industries.
Þetta er eingöngu ætlað til faglegrar notkunar. Lenbrook Industries ber enga ábyrgð á nákvæmni samskiptareglnanna. Samskiptareglan er afhent „eins og hún er“, með öllum göllum og án nokkurrar ábyrgðar, hvorki skýrrar né óskýrrar.
Notkunarstefna API
Með því að fá aðgang að API-viðmótunum samþykkir þú þessa notkunarstefnu API-viðmótsins („stefnuna“) og skilmála okkar. Við bjóðum upp á þessi API-viðmót til að gera fyrirtækjum og einstaklingum kleift að byggja á og njóta góðs af þjónustu okkar með því að búa til hugbúnað, þjónustu eða einingar sem tengjast kerfi okkar eða hafa aðgang að gögnum innan kerfisins okkar í gegnum API-viðmótin okkar („Samþætting“). Þessi stefna er og verður meðhöndluð sem hluti af skilmálum okkar.
Hugbúnaðurinn er afhentur „Í NÚVERANDI ÁSTANDI“ án nokkurrar ábyrgðar, hvorki skýrrar né óskýrrar, þar með talið en ekki takmarkað við ábyrgð á söluhæfni, hentugleika til tiltekins tilgangs og að ekki sé brotið á höfundarrétti. Höfundar né höfundarréttarhafar bera í engum tilvikum ábyrgð á kröfum, tjóni eða annarri ábyrgð, hvort sem er vegna samnings, skaðabóta eða annars, sem stafar af, út af eða í tengslum við hugbúnaðinn eða notkun eða önnur viðskipti með hugbúnaðinn.
Leyfileg notkun
Þú mátt ekki nota API-ið til að senda ruslpóst eða grípa til aðgerða sem brjóta gegn stefnu okkar um ásættanlega notkun og stöðluðum notkunarskilmálum okkar. Þú munt fara að öllum gildandi lögum (þar á meðal persónuverndarlögum og lögum um útflutningseftirlit í Bandaríkjunum, evrópskum almennum persónuverndarreglum og reglugerðum og lögum og reglugerðum um efnahagsþvinganir). Þú munt fylgja öllum skjölum sem við veitum fyrir API-ið. Þú munt ekki reyna að tölvuþrjóta eða breyta því hvernig þjónustan virkar. Við gætum fylgst með notkun þinni á API-inu til að tryggja að þessar reglur séu í samræmi við þær og við gætum neitað þér aðgangi að API-inu ef þú brýtur gegn þessum reglum.
Persónuvernd
Þinn Samþætting verður að sýna persónuverndarstefnu fyrir notendur þar sem ítarlegar eru upplýsingar sem þú munt safna frá þeim þegar þeir nota samþættinguna. Þú munt aðeins fá aðgang að gögnum notanda að því marki sem notandinn leyfir og útskýrt er í persónuverndarstefnu þinni. Þú verður að eyða gögnum notanda tafarlaust ef notandinn óskar eftir eyðingu eða lokar aðgangi sínum hjá þér.
Öryggi
Þú munt innleiða og viðhalda viðeigandi tæknilegum og skipulagslegum öryggisráðstöfunum til að vernda og varðveita öryggi, heiðarleika og trúnað gagnanna. Þessar öryggisráðstafanir skulu koma í veg fyrir óheimilan aðgang eða uppljóstrun persónuupplýsinga eða trúnaðarupplýsinga sem þú vinnur úr.
Eignarhald
Við eigum öll réttindi, titla og hagsmuni í þjónustunni og forritaskilunum (API), þar á meðal öll hugverkaréttindi, vörumerki, kóða og eiginleika. Þú munt ekki brjóta gegn, bakverkfæra eða afrita kóða okkar, hönnun eða efni. Þú munt ekki nota forritaskilin okkar til að keppa við þjónustuna okkar. Öll réttindi sem ekki eru sérstaklega veitt með þessum reglum eru synjuð, svo ef þú sérð þau ekki hér, þá er það ekki réttur sem við veitum þér.
Notkun vörumerkja
Þú mátt ekki nota nafn okkar og vörumerki (þ.e. lógó okkar, vörumerki og höfundarréttarvarðar myndir) á nokkurn hátt. Þú mátt ekki breyta eða fjarlægja neinar eignarréttartilkynningar í vörumerkjum okkar. Þú mátt ekki nota nafn okkar eða vörumerki í samþættingarheiti þínu eða lógói, eða á nokkurn hátt sem gefur til kynna áritun okkar.
Hagnýt notkun merkja
Þessar leiðbeiningar útskýra hvernig þú skalt nota nafn okkar, vörumerki og vörumerkjaeignir í reynd ávallt. Notkun þín gefur til kynna samþykki þitt á þessum leiðbeiningum og þú skilur að notkun þín í bága við þessar leiðbeiningar mun sjálfkrafa leiða til þess að leyfi þitt til að nota nafn okkar, vörumerki og vörumerkjaeignir verður afturkallað.
- Notkun nafns okkar, vörumerkja og vörumerkjaeigna verður að vera sérstaklega heimiluð skriflega.
- Ekki má breyta, leiðrétta, afbaka, afrita eða herma eftir vörumerkjaeignum okkar á nokkurn hátt, þar með talið að breyta lit, snúa og/eða teygja. Með öðrum orðum, vörumerkjaeignir okkar verða að vera geymdar í upprunalegri mynd.
- Gefið ekki nafni okkar, vörumerkjum eða vörumerkjaeignum óhóflega áberandi í samanburði við nafn ykkar og lógó.
- Ekki birta nafn okkar, vörumerki eða vörumerkjaeignir við hliðina á eða í neinum formi samkeppnismarkaðssetningar án skýrs samþykkis okkar.
- Notkun þín má ekki afvegaleiða neytendur varðandi styrktaraðild okkar til, tengsl við eða áritun á fyrirtæki þitt eða vörur eða þjónustu.
- Nafn okkar, vörumerki og vörumerkjaeignir eru okkar eign. Öll viðskiptavild sem hlýst af notkun þinni verður eingöngu okkur í hag. Þú munt ekki grípa til neinna aðgerða sem stangast á við réttindi okkar eða eignarhald.
- Nafn okkar, vörumerki og vörumerkjaeignir verða að vera notaðar á virðulegan hátt og má ekki nota þær á þann hátt að þær skaði okkur, vörur okkar eða þjónustu, eða á þann hátt að þær, að okkar mati, rýri eða skaði á annan hátt orðspor okkar eða viðskiptavild sem fylgir nafni okkar, vörumerkjum og vörumerkjaeignum. Með öðrum orðum, vinsamlegast tengið ekki eignir okkar við neina ólöglega eða ólöglega starfsemi eða notið þær á blekkjandi eða skaðlegan hátt.
Exampminni notkunarmöguleikar:
„[VÖRUHEITIÐ ÞITT] (samhæft við / virkar með BluOS)“
Exampminni notkun
„[VÖRUHEITIÐ ÞITT] – BluOS“
„BluOS – [VÖRUHEITIÐ ÞITT]“
„[VÖRUHEITIÐ ÞITT] – Knúið af BluOS“
Markaðssetning og fréttatilkynningar
Eftir að umsókn þín hefur verið samþykkt gæti hún verið skráð á síðuna okkar web eiginleika. Við munum almennt ekki birta fréttatilkynningar saman eða leggja okkar af mörkum til sameiginlegrar markaðssetningar á umsókn þinni.
Áður en þú sendir út fréttatilkynningu um appið þitt skaltu hafa samband við okkur á [EMAIL]. Ef þú ætlar að nefna BluOS þurfum við að endurskoðaview fréttatilkynninguna. Við mælum með að þú sendir okkur lokafréttatilkynninguna eins fljótt og auðið er.
Fyrirvari
Að því marki sem lög leyfa, bjóðum við upp á API-viðmótin eins og þau eru. Það þýðir að við veitum engar ábyrgðir af neinu tagi, hvorki skýrar né óskýrar, þar með talið en ekki takmarkað við söluhæfni og hentugleika til tiltekins tilgangs.
Uppfærslur
Við gætum uppfært eða breytt API-viðmótunum og þessum reglum öðru hvoru með því að birta breytingarnar á þessari síðu eða tilkynna þér þær með tölvupósti. Þessar breytingar geta haft áhrif á notkun þína á API-viðmótunum eða hvernig samþætting þín hefur samskipti við API-viðmótið. Ef við gerum breytingar sem þú ósáttir við ættir þú að hætta að nota API-viðmótin.
Trúnaður
Þú gætir haft aðgang að trúnaðarupplýsingum, einkaleyfisvernduðum upplýsingum og upplýsingum sem ekki eru opinberar og eiga sérstaklega við um forritaskilin („trúnaðarupplýsingar“). Þú mátt aðeins nota þessar upplýsingar til að byggja upp með forritaskilunum. Þú munt ekki afhjúpa trúnaðarupplýsingarnar neinum án skriflegs samþykkis okkar og þú munt vernda trúnaðarupplýsingarnar gegn óheimilri notkun og birtingu á sama hátt og þú myndir vernda þínar eigin trúnaðarupplýsingar.
Skaðabætur
Þú munt bæta okkur og teymi okkar tjón af öllu tjóni (þar með talið lögmannskostnaði) sem hlýst af kröfum þriðja aðila sem tengjast notkun þinni á API.
Restin
Þessi stefna stofnar ekki til né gefur í skyn neins samstarfs, umboðs eða samreksturs. Þessi stefna gildir svo lengi sem þú notar API-viðmótin eða þar til þeim er sagt upp í samræmi við skilmála okkar. Ef upp kemur árekstur milli þessarar stefnu og staðlaðra notkunarskilmála skulu staðlaðir notkunarskilmálar gilda.
©2025 LENBROOK INDUSTRIES LIMITED
633 Granite Court, Pickering, Ontario, Kanada L1W 3K1
Allur réttur áskilinn
Ekki má afrita, geyma eða dreifa neinum hluta þessarar útgáfu á nokkurn hátt án skriflegs leyfis frá Lenbrook Industries Limited. Þótt allra ráða hafi verið gerðar til að tryggja að innihaldið sé rétt á útgáfutíma, geta eiginleikar og forskriftir breyst án fyrirvara.
| Endurskoðunarsaga | ||
| Útgáfa | Dagsetning | Lýsing |
| 1.0 | 6/17/2019 | Fyrsta útgáfan |
| 1.2 | 01/12/2022 | Bætt við mjúkri endurræsingu, dyrabjölluhljóði, hljóðstyrkshækkun/lækkun, færsla lags í biðröð og bein innsláttarskipanir. Athugasemd bætt við viðauka LSDP. |
| 1.4 | 04/26/2022 | Bætti við hljóðnemaskipun; breytti beinum inntaksskipunum fyrir HUB; uppfærði Play skipunina til að spila streymt sérsniðið hljóð. |
| 1.5 | 07/18/2022 | Bætt við Bluetooth skipun; Uppfært LSDP til að bæta við flokki 5 í 8; Bætt við „Hagnýt notkun vörumerkja“ í notkunarstefnu API. |
| 1.6 | 03/13/2024 | Bætti við athugasemd fyrir /Stöðu fyrir hópaða leikmenn í 2. kafla; Bætt við /Play?seek=sekúndur er=trackid í kafla 4.1; |
| 1.7 | 04/09/2025 | Uppfært kafla 8.3 fyrrv.ample; Bætti við beiðni um að skoða samhengisvalmyndina, t.d.ampí kafla 7.1; Bætt við nýrri skipun til að velja beint inntak í kafla 11.2; Uppfært kafla 6.1 til að bæta við eigindinni „image“ fyrir forstillingar; Bætt við athugasemdinni „followRedirects=1“ fyrir alla eiginleika myndar; Uppfært útskýringu á eigindaspilun.URL og bæta nú við í kafla 7.1 |
Inngangur
BluOS™ er háþróað stýrikerfi og tónlistarstjórnunarhugbúnaður sem gerir þér kleift að fá aðgang að og streyma taplausri tónlist allt að 24-bita/192kHz í öll herbergi með heimanetinu þínu. BluOS er að finna í vörum frá Bluesound, NAD Electronics, DALI hátalurum og fleirum.
Þetta skjal var búið til til að aðstoða forritara og kerfissamþættingaraðila sem starfa á markaði sérsniðinnar samþættingar (CI). Það inniheldur undirmengi af API-beiðnum sem eru skjalfestar í fullri BluOS API Control Protocol.
Allar beiðnir sem lýst er í þessu skjali eru sendar sem HTTP GET beiðnir. Færibreyturnar eru staðlaðar. URL Kóðað nafn/gildi par. BluOS spilarar taka við þessum skipunum og svara síðan með UTF-8 kóðuðum XML gögnum.
Allar beiðnir eru á formi http:// : / hvar:
- player_ip er IP-tala BluOS spilarans (t.d. 192.168.1.100)
- Tengið er TC tengið sem notað er fyrir samskipti. Tengið 11000 er notað fyrir alla BluOS spilara, að undanskildum CI580. CI580 hefur fjóra straumspilunarhnúta í einum kassa, þar sem hnútur 1 notar tengi 11000, hnútur 2 notar tengi 11010, hnútur 3 notar tengi 11020 og hnútur 4 notar tengi 11030. Raunverulegt tengi sem á að nota ætti að vera fundið með því að nota MDNS samskiptareglurnar með því að nota þjónusturnar musc.tcp og musp.tcp.
- beiðni er raunveruleg BluOS skipun eða fyrirspurn (t.d. Spila)
Athugið: Þetta skjal mun nota http://192.168.1.100:11000 sem IP-númer spilara og tengi í öllum týpumamples.
Stöðufyrirspurnir
Stöðufyrirspurnir eru notaðar til að spyrjast fyrir um BluOS spilara.
BluOS býður upp á tvær aðferðir til að framkvæma stöðufyrirspurnir; venjulegar kannanir og langar kannanir. Venjulegar kannanir skila niðurstöðu fyrirspurnar strax. Langar kannanir halda tengingu í ákveðinn tíma og skila aðeins niðurstöðu fyrirspurnar þegar upplýsingar hafa breyst eða tímamörk renna út. Langar kannanir geta dregið verulega úr fjölda símtala til spilara.
Þegar löng könnun er ekki notuð ættu viðskiptavinir að takmarka könnunartíðni sína við eina beiðni á 30 sekúndna fresti. Þegar löng könnun er notuð má viðskiptavinur ekki gera tvær samfelldar beiðnir fyrir sama úrræðið með innan við eina sekúndu millibili, jafnvel þótt fyrsta beiðnin skili sér innan við eina sekúndu.
Langar beiðnir um könnun taka tvær breytur: tímamörk og etag. tímamörk eru tímalengd beiðninnar um langa könnun og etag er tekið úr fyrra svari (eiginleiki í rótarstakinu í svarinu).
Almennt séð er aðeins nauðsynlegt að hafa virka langa könnun fyrir annað hvort /Status eða /SyncStatus. /Status svarið inniheldur þátt ( ) sem gefur til kynna hvort /SyncStatus hefur breyst. /SyncStatus ætti að vera kannað ef aðeins nafn, hljóðstyrkur og flokkunarstaða spilara er áhugi. /Status ætti að vera kannað ef núverandi spilunarstaða er nauðsynleg.
Þegar spilurum er skipt í hópa er aðalspilarinn aðalspilarinn í hópnum. Aukaspilararnir eru tengdir við aðalspilarann. /Statusvörun aukaspilaranna er afrit af svörum aðalspilarans. /SyncStatus löng könnun er þá nauðsynleg til að fylgjast með hljóðstyrk hvers aukaspilara.
2.1 Spilunarstaða
Lýsing
Endapunkturinn /Status leitar að upplýsingum um hljóðstyrk og spilun. Þessi fyrirspurn skilar mörgum svareiginleikum,
Sum þeirra eiga ekki við um þetta skjal. Óskjöluð svör ættu að vera hunsuð.
Beiðni
/Staða?tímalok=sekúndur&etag=etag-gildi
| Færibreytur | Lýsing |
| tímamörk | Valfrjáls breyta notuð með löngum könnunum. Ráðlagt könnunartímabil er 100 sekúndur og ætti að vera takmarkað við 60 sekúndur eða svo og aldrei hraðara en 10 sekúndur. |
| etag | Valfrjáls breyta notuð með löngum könnunum. Þetta er etag eiginleiki frá |
| Færibreytur | Lýsing |
| svar við fyrri /Stöðukalli. |
Svar
<status etag=”4e266c9fbfba6d13d1a4d6ff4bd2e1e6″>
÷ (Lúxus)
Ed Sheeran
satt
1
159
Deezer:142986206
/Listaverk?þjónusta=Deezer&songid=Deezer%3A142986206
0
187
1
Fullkomið
1054
0
320000
2
Deezer
/Heimildir/myndir/DeezerIcon.png
0
8
19 ára
hlé
MP3 320 kb/s
5
Fullkomið
Ed Sheeran
÷ (Lúxus)
263
4
35
ATH: Ekki eru allir eiginleikar svarsins taldir upp í eftirfarandi töflu. Aðrir þættir geta verið til staðar og ætti að hunsa þá.
| Eiginleikar svars | Lýsing |
| etag | Eiginleiki rótarþáttar svarsins. Ógegnsætt gildi notað með langri könnun til að greina breytingar á svörun. Ef gildið hefur ekki breyst frá síðasta svari þá er tryggt að svarið hafi ekki breyst (en sjá einnig kafla hér að neðan). |
| sekúndur eftir af viðvörun | Ef spilun er afleiðing viðvörunar, þá er þetta fjöldi sekúndna sem líða þar til hún stöðvast. |
| aðgerð | Sjá lýsingu í kaflanum Aðgerðir fyrir streymi útvarpsstöðva. |
| albúm | Nafn plötunnar á núverandi virka lagi. Sjá einnig title1 eiginleikann. |
| listamaður | Nafn listamanns á núverandi virka lagi. Sjá einnig title1 eiginleikann. |
| rafhlaða | Sýnt ef spilari er með rafhlöðupakka. Inniheldur eiginleika: · stig – hleðslustaða, prósenta · hleðsla – 1 ef í hleðslu · táknmynd – URL af mynd spilara sem sýnir núverandi hleðslustöðu |
|
getur fært spilun |
Er satt ef það er mögulegt að færa efni sem er í spilun eða í bið yfir á annan spilara. |
|
getur leitað |
Ef 1 þá er hægt að fletta í gegnum núverandi lag, á bilinu 0..totlen, með því að nota leitarbreytuna /Play. Til dæmisample: /Spila?leita=34. |
| db | Hljóðstyrkur í dB. |
| Nafn hóps | Nafn hópsins. Spilarinn verður að vera aðalspilarinn í hópnum. |
| hóprúmmál | Hljóðstyrkur hópsins. Spilarinn verður að vera aðalspilarinn í hópnum. |
| mynd | URL af mynd sem tengist núverandi hljóði (albúmi, stöð, inntaki o.s.frv.). Ef |
| Eiginleikar svars | Lýsing |
| the URL byrjar á /Artwork það gæti leitt til tilvísunar. Bætir við breytu/lykli fylgjaTilvísanir=1 Þegar myndin er sótt er hægt að forðast tilvísun. | |
| hljóðlaus | Hljóðlaus staða. Stilltu á 1 ef hljóðstyrkurinn er slökktur. |
| þaggaDb | Ef spilari er á hljóðlausu, þá inniheldur þetta óþaggaða hljóðstyrkinn í dB. |
| hljóðstyrkur | Ef hljóðið er slökkt á, þá inniheldur þetta óslökkt hljóðstyrksstig. Gildi eru frá 0 til 100. |
| nafn | Titill hljóðrásarinnar sem er í spilun. Sjá einnig title1 eigindinn. |
| tilkynnaurl | URL fyrir sprettigluggatilkynningu. |
| id | Einstakt auðkenni spilunarbiðröðarinnar. Það passar við auðkenni eigindarinnar /Playlist svarsins. Ef spilunarbiðröðinni er breytt mun þessi tala breytast. |
| losa | Einstakt auðkenni forstillingarinnar. Það passar við prid eigindina í /Presets svarinu. Ef forstillingu er breytt mun þessi tala breytast sem gefur til kynna að öll skyndiminnisvarandi svör við /Presets ættu að vera hreinsuð. |
| gæði | Gæði hljóðupptökunnar: · geisladiskur – taplaust hljóð í geisladiskgæðum · hd – taplaust hljóð með hærri upplausn en geisladiskagæði eða sample-hraði 88200 sekúndurampminna/s eða meira · dolbyAudio – DolbyDigital eða AC3 · mqa – gilt MQA hljóð afkóða · mqaAuthored – gilt MQA-Authored hljóð afkóðað Tölulegt gildi er áætlaður bitahraði þjappaðs hljóðgjafagæða file. |
|
endurtaka |
0, 1 eða 2. 0 þýðir endurtekna spilun í biðröð, 1 þýðir að lag sé endurtekið og 2 þýðir að endurtaka sé slökkt. |
| sek | Fjöldi sekúndna sem núverandi hljóðrás hefur verið spiluð. Þetta gildi er ekki notað við útreikning á etag og framvindan mun ekki í sjálfu sér valda endurkomu frá löngu könnunarkalli. Viðskiptavinir þurfa að auka spilunarstöðuna, þegar staðan er spilun eða straumspilun, byggt á tímabilinu frá svarinu. |
| þjónustu | Þjónustukenni núverandi hljóðs. Þetta er ekki gildi til að birta í notendaviðmóti, þar sem |
| Eiginleikar svars | Lýsing |
| Raunverulegur strengur gæti verið frábrugðinn opinbera nafni þjónustunnar. | |
| þjónustutákn | URL af núverandi þjónustutákni. |
| stokka | 0 eða 1. 0 þýðir að stokkun sé slökkt og 1 þýðir að stokkun sé virk. |
| sofa | Mínúturnar sem eftir eru áður en svefntímastillirinn virkjast. |
| lag | Staða núverandi lags í spilunarröðinni. Sjá einnig straumUrl. |
| ríki | Núverandi staða spilara. Það gæti verið spilun, hlé, stöðvun, streymi, tenging o.s.frv. Hægt er að nota /Play til að halda áfram þegar spilun er í biðstöðu en ekki þegar hún er stöðvuð. Leikur og straumur ættu að hafa sömu merkingu. Sjá einnig straumurUrl. |
|
stöðMynd |
URL fyrir mynd af útvarpsstöð, ef núverandi hljóð er útvarpsstöð, t.d. Deezer útvarp. Það gæti verið það sama og mynd. |
| straumsnið | Snið hljóðsins. |
| streymiUrl | Tilvist þessa þáttar ætti að meðhöndla sem fána og innihald þess sem ógegnsætt gildi. Ef það er til staðar gefur það til kynna: · spilunarröðin er ekki uppspretta núverandi hljóðs (lagið skiptir ekki máli) · stokkun og endurtekning skipta ekki máli og ætti að fjarlægja úr öllum notendaviðmótum ef mögulegt er · næst og fyrra eru ekki tiltæk (en sjá einnig aðgerðir) |
| syncStat | Einkvæmt auðkenni sem gefur til kynna allar breytingar á /SyncStatus svarinu. Það passar við syncStat eigindina í /SyncStatus svarinu. Það breytist í hvert skipti sem breyting verður á samstillingarstöðu. |
| titill1 | Fyrsta upplýsingalínan sem lýsir núverandi hljóðupptöku. titill1, titill2 og titill3 VERÐUR að vera notað sem texti í öllum notendaviðmótum sem sýna þrjár línur af spilunarlýsigögnum. Ekki nota gildi eins og albúm, flytjanda og nafn. |
| titill2 | Önnur upplýsingalínan sem lýsir núverandi hljóðupptöku. |
| titill3 | Þriðja upplýsingalínan sem lýsir núverandi hljóðupptöku. |
| tól | Heildarlengd núverandi lags, í sekúndum. |
| tvílínu_title1 | Fyrsta af tveimur línum sem lýsa núverandi hljóði. twoline_title1 og twoline_title2, ef til staðar, VERÐA að vera notaðir sem texti í öllum notendaviðmótum sem sýna tvær |
| Eiginleikar svars | Lýsing |
| línur af lýsigögnum sem eru í spilun. | |
| tvílínu_title2 | Önnur af tveimur línum sem lýsa núverandi hljóði. |
| bindi | Hljóðstyrkur spilara í prósentumtage; -1 þýðir að hljóðstyrkur spilara er fastur. |
| sek | Fjöldi sekúndna sem núverandi hljóðrás hefur verið spiluð. |
Example
http://192.168.1.100:11000/Status
Sækir spilunarstöðu spilarans.
http://192.168.1.100:11000/Status?tímalok=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Sækir spilunarstöðu spilarans með því að nota langtímakönnun. Niðurstaða er aðeins skilað fyrir 100 sekúndna tímamörk ef staða spilarans hefur breyst. Annars er niðurstaðan skilað eftir 100 sekúndur.
2.2 Staða samstillingar spilara og hópa
Lýsing
Fyrirspurnin SyncStatus skilar upplýsingum um spilara og hóp spilara. Þessi fyrirspurn skilar mörgum eiginleikum svars, en sum þeirra eiga ekki við um þetta skjal. Óskráð svör ættu að vera hunsuð.
Beiðni
/SyncStatus?timeout=sekúndur&etag=etag-gildi
| Færibreytur | Lýsing |
| tímamörk | Valfrjáls breyta notuð með löngum könnunum. Þetta er könnunartímabilið í sekúndum. Ráðlagt könnunartímabil er 180 sekúndur. |
| etag | Valfrjáls breyta notuð með löngum könnunum. Þetta er etag eigindi úr fyrra /SyncStatus kallsvarinu. |
Svar
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″ brand=”Bluesound” etag="23" outlevel="-62.9" schemaVersion="25" initialized="true" group="PULSE-0278 + 2" syncStat="23" id="192.168.1.100:11000" mac="90:56:82:9F:02:78"> 11000
…..
ATHUGIÐ: Ekki eru allir eiginleikar svarsins skráðir í eftirfarandi töflu. Aðrir þættir geta verið til staðar og ætti að hunsa þá.
| Eiginleikar svars | Lýsing |
| rafhlaða | Sýnt ef spilari er með rafhlöðupakka. Inniheldur eiginleika: · stig – hleðslustaða, prósenta · hleðsla – 1 ef í hleðslu · táknmynd – URL af mynd spilara sem sýnir núverandi hleðslustöðu |
| vörumerki | Vörumerki leikmanns. |
| db | Hljóðstyrkur í dB. |
| etag | Tag af /SyncStatus svarinu, notað fyrir langar kannanir. |
| hóp | Nafn hópsins. |
| táknmynd | URL sem inniheldur mynd af spilara tákninu. |
| id | IP-tala og tengi spilara |
| frumstillt | „True“ þýðir að spilarinn er þegar stilltur, „false“ þýðir að spilarinn þarfnast uppsetningar. Spilarinn verður að vera stilltur með BluOS Controller appinu. |
| mac | Einkvæmt auðkenni spilara fyrir netviðmót. Getur verið MAC-tala. |
| húsbóndi | IP-tala aðalspilara. Aðeins til staðar ef spilari er aukaspilari í hópi. Eiginleikar: · port – portnúmer. · endurtenging – satt ef reynt er að tengjast aftur við aðalspilarann |
| fyrirmynd | Leikmannaauðkenni. |
| ModelName | Nafn spilaralíkans. |
| hljóðlaus | Stilltu á 1 ef hljóðstyrkurinn er slökktur. |
| þaggaDb | Ef spilari er hljóðlaus, þá er þetta óhljóðlausa hljóðstyrkurinn í dB. |
| Eiginleikar svars | Lýsing |
| hljóðstyrkur | Ef spilari er hljóðlaus, þá er þetta hljóðstyrksstigið án hljóðlausnar (0..100). |
| nafn | Nafn leikmanns. |
| skemaútgáfa | Útgáfa hugbúnaðarskema. |
| þræll | IP-tölur aukaspilara. Aðeins til staðar ef spilari er aðalspilari hóps. Það geta verið margir aukaspilarar. Eiginleikar: · auðkenni – IP-tala · port – portnúmer |
|
syncStat |
Auðkenni samstillingarstöðu. Það breytist í hvert skipti sem einhverjum atriði í /SyncStatus svarinu er breytt. Samsvarar við þáttur í /Status svari. |
| bindi | Hljóðstyrkur á skalanum 0..100. -1 þýðir fastur hljóðstyrkur. |
| svæði | Nafn fasts hóps. |
| svæðismeistara | Ef spilarinn er aðalspilarinn í föstum hópi er þetta stillt á satt. |
| svæðisþræll | Ef spilari er aukaspilari í föstum hópi er þetta stillt á satt. |
Example
http://192.168.1.100:11000/SyncStatus
Sækir stöðu spilarans og hópsins.
http://192.168.1.100:11000/SyncStatus?tímalok=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Sækir stöðu spilara og hóps með því að nota langtímakönnun. Niðurstaða er aðeins skilað fyrir 100 sekúndna tímamörk ef staða spilara hefur breyst. Annars er niðurstaðan skilað eftir 100 sekúndur.
Hljóðstyrkstýring
Stillir hljóðstyrk spilara. Einnig notað til að þagga niður í spilara.
3.1 Stilla hljóðstyrk
Lýsing
Þessi beiðni sendir fyrirspurn eða stillir hljóðstyrk spilarans.
Allar skipanaafbrigði, hvort sem þau nota 0..100 stig, algild dB eða afstæð dB breytur, eru bundnar við gildi sem leiða til stigs innan stillts tiltæks hljóðstyrksbils, sem er venjulega -80..0. Hægt er að stilla hljóðstyrksbilið með BluOS Controller appinu, á Stillingar -> Spilari -> Hljóð síðunni.
Fyrirspurnin styður langar kannanir (ekki sýnt hér að neðan).
Beiðni
/Bind
/Hljóðstyrkur?stig=stig&tell_slaves=kveikt_af
/Hljóðstyrkur?þagna=óvirkt&tell_slaves=óvirkt
/Hljóðstyrkur?abs_db=db&tell_slaves=on_off
/Hljóðstyrkur?db=delta-db&tell_slaves=on_off
| Færibreytur | Lýsing |
| stigi | Stilltu algert hljóðstyrkstig spilarans. Það er heiltala frá 0 -100. |
| segja_þrælum | Á við um hópspilara. Ef stillt á 0 breytir aðeins sá spilari sem er valinn hljóðstyrk. Ef stillt á 1 breyta allir spilarar í hópnum hljóðstyrk. |
| hljóðlaus | Ef stillt á 0 er hljóðið á spilaranum hljóðlaust. Ef stillt á 1 er hljóðið ekki lengur á spilaranum. |
| abs_db | Stilltu hljóðstyrkinn með dB kvarða. |
| db | Gerðu hlutfallslega breytingu á hljóðstyrk með því að nota dB hljóðstyrkskvarða. dB getur verið jákvæð eða neikvæð tala. |
Svar
<volume db=”-49.9″ mute=”0″ offsetDb=”0″ etag=”6213593a6132887e23fe0476b9ab2cba”>15</volume>
| Eiginleikar svars | Lýsing |
| Eiginleikar svars | Lýsing |
| db | Hljóðstyrkur í dB. |
| hljóðlaus | 1 ef hljóðið er slökkt á spilaranum, 0 ef hljóðið er ekki slökkt á spilaranum. |
| þaggaDb | Ef spilari er hljóðlaus, þá er þetta óhljóðlausa hljóðstyrkurinn í dB. |
| hljóðstyrkur | Ef spilari er hljóðlaus, þá er þetta hljóðstyrksstigið án hljóðlausnar (0..100). |
| bindi | Núverandi hljóðstyrkur: 0..100 eða -1 fyrir fastan hljóðstyrk. |
Example
http://192.168.1.100:11000/Volume?level=15
Stillir hljóðstyrk spilarans á 15 (af 100).
http://192.168.1.100:11000/Volume? tell_slaves=1&db=2
Eykur hljóðstyrk aðalspilarans 192.168.1.100 og allra aukaspilara í þeim hópi um 2 dB.
http://192.168.1.100:11000/Volume?mute=1
Þaggar spilara.
3.2 Hljóðstyrkur upp
Lýsing
Þessi beiðni eykur hljóðstyrkinn um ákveðna dB (venjulegt gildi er 2dB).
Beiðni
/Rúmmál?db=db_gildi
| Færibreytur | Lýsing |
| db | Hljóðstyrkshækkunarskref í dB (dæmigert gildi 2dB) |
Svar
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>
| Eiginleikar svars | Lýsing |
| db | Hljóðstyrkur í dB. |
| hljóðlaus | 1 ef hljóðið á spilaranum er hljóðlaust, 0 ef hljóðið á spilaranum er ekki hljóðlaust |
| Eiginleikar svars | Lýsing |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?db=2
Auka hljóðstyrkinn um 2dB.
3.3 Bindi niður
Lýsing
Þessi beiðni lækkar hljóðstyrkinn um ákveðin dB (venjulegt gildi er -2dB).
Beiðni
/Bindi?db=-db_gildi
| Færibreytur | Lýsing |
| db | Hljóðstyrkshækkunarskref í dB (dæmigert gildi -2dB) |
Svar
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>
| Eiginleikar svars | Lýsing |
| db | Hljóðstyrkur í dB |
| hljóðlaus | 1 ef hljóðið á spilaranum er hljóðlaust, 0 ef hljóðið á spilaranum er ekki hljóðlaust |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?db=-2
Lækkaðu hljóðstyrkinn um 2dB.
3.4 Hljóðlausn á
Lýsing
Beiðni
/Hljóðstyrkur?þagga=1
| Færibreytur | Lýsing |
| hljóðlaus | Stilltu á 1 til að þagga spilara |
Svar
<volume muteDb=”-43.1″ db=”100″
þagnamagn = "11"
hljóðnemi = "1"
offsetDb=”0″
etag=”2105bed56563d9da46942a696cfadd63″>0</volume
>
| Eiginleikar svars | Lýsing |
| þaggaDb | Hljóðstyrkur í dB fyrir hljóðnema |
| db | Hljóðstyrkur í dB |
| hljóðstyrkur | Hljóðstyrkur í prósentum fyrir hljóðnema |
| hljóðlaus | 1 þýðir að spilari er hljóðlaus |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?mute=1
3.5 Hljóðnemi slökkt
Lýsing
Þessi beiðni setur spilara á hljóðgátt.
Beiðni
/Hljóðstyrkur?þagga=0
| Færibreytur | Lýsing |
| hljóðlaus | Stilltu á 0 til að taka hljóð af spilaranum |
Svar
<volume db=”-43.1″ mute=”0″ offsetDb=”0″ etag=”e72d53db17baa526ebb5ee9c26060b1f”>11</volume>
| Eiginleikar svars | Lýsing |
| db | Hljóðstyrkur í dB |
| hljóðlaus | 0 þýðir að spilari er ekki hljóðlaus |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?mute=0
Spilunarstýring
Þessar skipanir eru notaðar fyrir grunnspilunarstjórnun. Skipanirnar eru meðal annars spila, gera hlé, stöðva, sleppa, til baka, stokka og endurtaka.
4.1 Spila
Lýsing
Hefja spilun á núverandi hljóðgjafa. Valfrjálsar breytur leyfa að hoppa í hljóðrásirnar og velja inntak áður en hljóðspilun hefst.
Beiðni
/Spila
/Spila?leita=sekúndur
/Spila?leita=sekúndur&id=rekjaspor
/Spila?url=kóðaðurStraumurURL
| Færibreytur | Lýsing |
| leita | Hoppa á tilgreindan stað í núverandi lagi. Gildir aðeins ef /Status svarið inniheldur Ekki hægt að nota með inputType og index breytunum. |
| kóðaður straumurURL | URL af streymdu sérsniðnu hljóði. Það verður að vera URL kóðuð. |
Svar
spila
straumur
| Eiginleikar svars | Lýsing |
|
ríki |
Staðan eftir að skipunin hefur verið framkvæmd. Sjá /Status response state eigindina fyrir frekari upplýsingar. |
Example
http://192.168.1.100:11000/Play
Hefja hljóðspilun á núverandi lagi.
http://192.168.1.100:11000/Play?seek=55
Byrjaðu hljóðspilun eftir 55 sekúndur af núverandi lagi.
http://192.168.1.100:11000/Play?seek=55&id=4
Byrjaðu hljóðspilun 55 sekúndum eftir að lag númer 5 í biðröðinni er spilað.
192.168.1.125:11000/Spila?url=https%3A%2F%2Fwww%2Esoundhelix%2Ecom%2Fexamples%2Fmp3%
2FSoundHelix-Song-1%2Emp3
Byrjaðu spilun á mp3 hljóðskrá á netinu.
4.2 Hlé
Lýsing
Gera hlé á spilun hljóðs.
Ef vekjaraklukka er í gangi og hún hefur tímamörk, þá er tímamörkin aflýst.
Beiðni
/Hlé
/Pása?skipta=1
| Færibreytur | Lýsing |
| skipta | Ef stillt er á 1, þá er núverandi hléstaða skipt til og frá. |
Svar
hlé
| Eiginleikar svars | Lýsing |
| ríki | Staðan eftir að skipunin hefur verið framkvæmd. Sjá /Status response state eigindina fyrir frekari upplýsingar. |
Example
http://192.168.1.100:11000/Pause
Gerir hlé á hljóðinu sem er í spilun.
4.3 Hættu
Lýsing
Stöðva núverandi hljóðspilun. Ef vekjaraklukka er í gangi og hún hefur tímamörk, þá er tímamörkin aflýst. Beiðni
/Hættu
| Færibreytur | Lýsing |
| Engin |
Svar
hætta
| Eiginleikar svars | Lýsing |
| ríki | „Stoppa“ þýðir að núverandi hljóðupptaka er stöðvuð. |
Example
http://192.168.1.100:11000/Stop
Stöðvar hljóðið sem er í spilun.
4.4 Sleppa
Lýsing
Fara í næsta hljóðrás í spilunarröðinni
Þegar spilun er gerð úr spilunarröðinni verður næsta lag í röðinni hoppað yfir í. Ef núverandi lag er síðasta lagið í röðinni, þá fer /Skip í fyrsta lagið í röðinni. Það verður hoppað yfir í næsta eða fyrsta lagið í röðinni óháð endurtekningarstillingunni.
Til að ákvarða hvort þú ert að nota spilunarröðina skaltu ganga úr skugga um að það sé ekkertUrl> færsla í /Status svarinu.
Þá er hægt að nota /Skip skipunina.
Þú getur líka sleppt lögum fyrir sumar streymisútvarpsstöðvar. Þetta er meðhöndlað með /Action skipuninni.
Sumar heimildir eins og TuneIn og Optical Input styðja ekki sleppa möguleikanum. Þessar heimildir munu hafaURL> færsla en ekkert nafn á aðgerð til að sleppa henni í /Status svarinu.
Beiðni
/Sleppa
| Færibreytur | Lýsing |
| Engin |
Svar
21
| Eiginleikar svars | Lýsing |
| id | Auðkenni lagsins eftir að skipunarskipunin hefur verið framkvæmd. Sjá nánari upplýsingar í /Status svarseiginleikanum fyrir lag. |
Example
http://192.168.1.100:11000/Skip
Farðu í næsta lag.
4.5 Til baka
Lýsing
Ef lag er í spilun og hefur verið í spilun í meira en fjórar sekúndur þá fer aftur í upphaf lagsins.
Annars fer skipunin „back“ í fyrra lagið á núverandi spilunarlista. Ef skipunin er á fyrsta laginu á spilunarlistanum fer skipunin „back“ í síðasta lagið. Skipunin fer í fyrra eða fyrsta lagið í biðröðinni, óháð stöðu endurtekningarstillingarinnar.
Til að ákvarða hvort þú ert að nota spilunarröðina skaltu ganga úr skugga um að það sé ekkertUrl> þáttur í /Status svarinu.
Þá er hægt að nota /Back skipunina.
Þú getur líka farið aftur í tímann fyrir sumar streymandi útvarpsstöðvar. Þetta er meðhöndlað með /Action skipuninni.
Sumar heimildir eins og TuneIn og Optical Input styðja ekki bakstillingu. Þessar heimildir munu hafaUrl> element en ekkert nafn á sleppunaraðgerð í /Status svarinu.
Beiðni
/Til baka
| Færibreytur | Lýsing |
| Engin |
Svar
19
| Eiginleikar svars | Lýsing |
| id | Auðkenni lagsins eftir að skipunin „back“ hefur verið framkvæmd. Sjá nánari upplýsingar í svarseiginleikanum „/Status“. |
4.6 Uppstokkun
Lýsing
Skipunin „stokka“ býr til nýja biðröð með því að stokka núverandi biðröð. Upprunalega biðröðin (ekki stokkuð) er geymd til endurheimtar þegar stokkun er óvirk.
Beiðni
/Stokka?staða=0|1
| Færibreytur | Lýsing |
| ríki | · 0 til að slökkva á stokkun · 1 til að virkja stokkun. Hefur engin áhrif ef biðröðin er þegar í stokkunarstöðu. Sjá /Staða svar frumefni. |
Svar
| Eiginleikar svars | Lýsing |
| breytt | 1 þýðir að biðröðin hefur verið breytt síðan hún var hlaðin inn. 0 þýðir ekki. |
| lengd | Heildarfjöldi laga í núverandi biðröð. |
| stokka | Staða stokkunar. 1 þýðir að núverandi biðröð er stokkuð. 0 þýðir að núverandi biðröð er ekki stokkuð. |
| id | Núverandi biðröðarauðkenni. Það breytist í hvert skipti sem spilunarbiðröðinni er breytt. |
Example
http://192.168.1.100:11000/Shuffle?state=1
Stokka núverandi spilunarröð.
4.7 Endurtaktu
Lýsing
Stillir endurtekningarvalkosti. Endurtekning hefur þrjár stöður; 0 þýðir að endurtaka núverandi biðröð, 1 þýðir að endurtaka núverandi lag og 2 þýðir að endurtaka ekki. Allar endurtekningar eru ótímabundnar, það er að segja, þær hætta ekki.
Beiðni
/Endurtaka?staða=0|1|2
| Færibreytur | Lýsing |
| ríki | · 0 til að endurtaka alla spilunarröðina · 1 til að endurtaka núverandi lag · 2 til að slökkva á endurtekningu |
Svar
| Eiginleikar svars | Lýsing |
| lengd | Heildarfjöldi laga í núverandi spilunarröð. |
| id | Núverandi biðröðarauðkenni. Það breytist í hvert skipti sem spilunarbiðröðinni er breytt. |
| endurtaka | Núverandi endurtekningarstaða. |
Example
http://192.168.1.100:11000/Repeat?state=1
Endurtekur lagið sem er í spilun.
4.8 Aðgerðir fyrir streymi útvarpsstöðva
Lýsing
Aðgerðir gera þér kleift að hoppa áfram, fara aftur á bak, elska og banna lög á völdum streymisútvarpsstöðvum, eins og Slacker eða Radio Paradise eða Amazon Music Prime Stations. Streymisútvarpsstöðvar hlaða ekki lögum inn í spilunarröðina. Í staðinn bjóða þær upp á... URL sem þú getur notað til að framkvæma þá virkni sem þú vilt.
„Sleppa“ fer í næsta lag. „Til baka“ fer í fyrra lag. „Ástin“ merkir lagið sem „líkað“ innan tónlistarþjónustunnar. „Ban“ fer í næsta lag og merkir lagið sem „ólíkað“ innan tónlistarþjónustunnar.
Ef það er til staðarUrl> færslu í /Status svarinu og viðeigandi aðgerð, þá geturðu framkvæmt þessi föll. Aðgerðin mun innihalda URL sem er notað til að framkvæma aðgerðina.
Hér er fyrrverandiampfrá /Status svari spilara sem spilar Slacker útvarp:
<action name=”skip” url="/Aðgerð?þjónusta=Slacker&sleppa=4799148"/>
<action icon=”/images/loveban/love.png” name=”love” notification=”Track marked as favorite” state=”1″ text=”Love” url="/Aðgerð?þjónusta=Slacker&ást=4799148"/>
<action icon=”/images/loveban/ban.png” name=”ban” notification=”Track banned from this
stöð“ staða = ”-1″ texti = ”Bann“ url="/Aðgerð?þjónusta=Slacker&bann=4799148"/>
Í þessu frvampLe, bak er ekki í boði, en sleppa, elska og banna eru möguleg.
Beiðni
/Aðgerð?þjónusta=þjónustuheiti&aðgerð=aðgerð-URL
Athugið: Nákvæmar upplýsingar um beiðnina (endapunktur og breytur) eru gefnar af viðkomandi frumefni. Skipanirnar í dæminuampÍ hlutanum hér að neðan er /Action notað en hvaða URI sem er er mögulegt.
| Færibreytur | Lýsing |
| Veitt í frumefni. |
Svar
Fyrir svarið færðu staðfestingu á aðgerð. Fyrir að sleppa og fara til baka færðu:
Fyrir ástina færðu:
1
Fyrir bann færðu:
1
| Eiginleikar svars | Lýsing |
| svar | Ef rótarþáttur svarsins er þá er textahnútan tilkynning sem á að sýna notandanum. Ef annað rótarþáttur er skilað og Ef tilkynningareiginleiki er innifalinn ætti sú tilkynning að birtast. |
Example
http://192.168.1.100:11000/Action?service=Slacker&skip=10965139
Hoppa yfir í næsta lag á Slacker útvarpinu.
http://192.168.1.100:11000/Action?service=Slacker&ban=33332284
Bannar núverandi Slacker útvarpslag og hoppar yfir í næsta lag.
Stjórnun spilunarraða
Einn virknismáti spilara er að hlaða lögum inn í spilunarröð og spila síðan lögin úr þeirri spilunarröð. Þessar skipanir gera þér kleift að... view og stjórna spilunarröðinni.
5.1 Listi yfir lög
Lýsing
Annað hvort skila stöðu spilunarbiðröðarinnar eða upplýsingum um öll lög í spilunarbiðröðinni.
Ekki er mælt með því að nota þessa fyrirspurn án þess að nota annað hvort lengdar- eða upphafs- og endabreyturnar, því annars gæti svarið orðið mjög langt.
Beiðni
/Spilunarlisti
/Lengd lagalista=1
/Playlist?start=first&end=last (sækja hluta af biðröðinni, oftast til síðuskipta)
| Færibreytur | Lýsing |
| lengd=1 | Skila aðeins efstu eiginleikum og engum upplýsingum um lagið. |
| byrja | Fyrsta færsla í biðröðinni sem á að taka með í svarið, byrjandi frá 0. |
| enda | Síðasta færsla í biðröðinni sem á að taka með í svarið. |
Svar
Fyrir stöðu spilunarbiðröðar:
13
243
1
Fyrir lista yfir spilunarbiðröð:
2002
Anna-María
2002
Deezer:487381362
| Eiginleikar svars | Lýsing |
| nafn | Nafn núverandi spilunarröðar. |
| breytt | 0 þýðir að biðröðin hefur ekki verið breytt síðan hún var hlaðin inn. 1 þýðir að biðröðin hefur verið breytt síðan hún var hlaðin inn. |
| lengd | heildarfjöldi laga í núverandi biðröð |
| id | einstakt auðkenni fyrir núverandi biðröð (t.d. 1054). Það er það sama og í /Status svari. |
| lag | Lagið er samsett úr nokkrum undirþáttum: · albúmaauðkenni = auðkenni albúmsins þar sem lagið er · þjónusta = tónlistarþjónusta lagsins · artistid = auðkenni flytjanda lagsins · lagid = lagsauðkenni · auðkenni = staða lagsins í núverandi biðröð. Ef lagið er valið er auðkenni lagsins það sama og í /Staða svari. · titill = nafn lags · list = listamannsnafn · albúm = nafn albúms |
Example
http://192.168.1.100:11000/Playlist
Sýnir lista yfir öll lögin í spilunarröðinni.
http://192.168.1.100:11000/Playlist?length=1
5.2 Eyða lagi
Lýsing
Fjarlægja lag úr núverandi spilunarröð.
Beiðni
/Eyða?id=staða
| Færibreytur | Lýsing |
| id | Lagsauðkenni lagsins sem á að eyða úr núverandi spilunarröð. |
Svar
9
| Eiginleikar svars | Lýsing |
| eytt | Staðsetning lagsins í biðröðinni sem á að fjarlægja. |
Example
http://192.168.1.100:11000/Delete?id=9
Fjarlægir lagið í sæti 9 í spilunarröðinni.
5.3 Færa slóð
Lýsing
Færa lag innan núverandi spilunarröð.
Beiðni
/Færa?nýr=áfangastaður&gamall=uppruni
| Færibreytur | Lýsing |
| nýr | Ný staðsetning á brautinni sem verið er að færa. |
| gamall | Gömul staðsetning brautarinnar sem verið er að færa. |
Svar
flutti
| Eiginleikar svars | Lýsing |
| flutti | Gefur til kynna að brautin hafi verið færð. |
Example
http://192.168.1.100:11000/Move?new=8&old=2
Færðu lagið í sæti 2 í sæti 8 í spilunarröðinni.
5.4 Hreinsa biðröð
Lýsing
Hreinsa öll lög úr núverandi spilunarröð
Beiðni
/Hreint
| Færibreytur | Lýsing |
| Engin |
Svar
| Eiginleikar svars | Lýsing |
| breytt | 0 þýðir að biðröðin hefur ekki verið breytt síðan hún var hlaðin inn, 1 þýðir að biðröðin hefur verið breytt síðan hún var hlaðin inn. |
| lengd | Heildarfjöldi laga í núverandi biðröð. |
| id | Einkvæmt auðkenni fyrir núverandi biðröð. |
Example
http://192.168.1.100:11000/Clear
Þetta fjarlægir öll lög úr spilunarröðinni.
5.5 Vista biðröðina
Lýsing
Vistaðu spilunarröðina sem nefndan BluOS-lagalista.
Beiðni
/Vista?nafn=nafn_spilunarlista
| Færibreytur | Lýsing |
| nafn | Nafn vistaðrar spilunarröðar. |
Svar
126
| Eiginleikar svars | Lýsing |
| færslur | Heildarfjöldi laga í vistuðu spilunarröðinni. |
Example
http://192.168.1.100:11000/Save?name=Dinner+Music
Þetta vistar spilunarröðina sem „Kvöldverðartónlist“.
Forstillingar
Forstillingarbeiðnir gera þér kleift að lista upp allar forstillingar spilara, hlaða inn forstillingu og auka/minnka forstillingar. Forstillingar verða að bæta við og eyða með BluOS Controller appinu. Forstillingar geta innihaldið útvarpsstöðvar, spilunarlista og inntak (t.d.
Bluetooth, hliðrænt, ljósleiðandi, HDMI ARC).
6.1 Listi yfir forstillingar
Lýsing
Listi yfir allar forstillingar á núverandi BluOS spilara.
Beiðni
/Forstillingar
| Færibreytur | Lýsing |
| Engin |
Svar
<preset id=”6″ name=”Serenity” url="ÚtvarpsParadís:/42:4/Kyrrð"
image=”https://img.radioparadise.com/channels/0/42/cover_512x512/0.jpg”/>
<preset id=”7″ name=”1980s Alternative Rock Classics” url=”/Hlaða?þjónusta=Tidal&auðkenni=fd3f797e-
a3e9-4de9-a1e2-b5adb6a57cc7″ image=”/Artwork?service=Tidal&playlistimage=afacfc12-24034caf-a5c5-a2af28d811c8″/> </presets>
| Eiginleikar svars | Lýsing |
| stolt | Einkvæmt auðkenni forstillinga spilarans. Það er það sama og í /Staða svari. |
| nafn | Forstillta nafnið. |
| id | Forstillta auðkennið. |
| url | Forstillingin URLÞetta er forstillta uppspretta URL notað til að hlaða inn forstillingunni. |
| mynd | Mynd URL af forstillingunni. Ef URL byrjar á /Artwork það gæti leitt til tilvísunar. Bætir við breytu/lykli fylgjaTilvísanir=1 Þegar myndin er sótt er hægt að forðast tilvísun. |
Example
http://192.168.1.100:11000/Presets
Teldu upp allar forstillingar á spilaranum.
6.2 Hlaða inn forstillingu
Lýsing
Byrjar að spila forstillingu. Þú getur valið tiltekið forstillingarnúmer, sem og næstu eða fyrri forstillingu. Forstillingarnúmer þurfa ekki að vera raðbundin, það er að segja, þú getur haft forstillingar 1,2,3, 5, 7, 8, XNUMX og XNUMX. Forstillingar snúast um efsta lagið og botninn og efsta lagið.
Beiðni
/Forstillt?auðkenni=forstilltAuðkenni|-1|+1
| Færibreytur | Lýsing |
| id | Auðkenni forstillingarinnar sem á að hlaða inn. Listi yfir tiltæk auðkenni forstillinga er að finna með skipuninni Sýna forstillingar. Ef forstillingaauðkennið er +1, þá hleður það næstu forstillingu. Ef forstillingaauðkennið er -1, þá hleður það fyrri forstillingu. |
Svar
Ef forstillingin er listi af lögum skilar hún fjölda laga af forstillingunni sem hlaðin var inn.
60
Ef forstillingin er útvarp skilar hún straumstillingunni.
straumur
| Eiginleikar svars | Lýsing |
| þjónustu | þjónustuheiti hlaðinnar forstillingar |
| færslur | Fjöldi laga af forstillingunni sem hlaðið var inn |
Example
http://192.168.1.100:11000/Preset?id=4
Hlaða inn forstillingunni með forstillingarnúmerinu 4.
http://192.168.1.100:11000/Preset?id=+1
Efnisskoðun og leit
Þessi hluti lýsir skipunum fyrir að skoða og leita að efni í tónlistarþjónustu.
7.1 Að skoða tónlistarefni
Lýsing
Fletta í gegnum tiltækar tónlistarheimildir, sem og inntak og spilunarlista.
Rótþátturinn fyrir svör er nema villuviðbrögð komi fram. Flestar niðurstöður eru röð af Í sumum tilfellum er niðurstaðan röð af , sem hvert um sig inniheldur röð ef Öll gildi eru gefin upp með eigindum. Engir textahnútar eru til staðar.
Niðurstaða /Browse-kalls gæti verið villa innifalin í rótarþáttur. Nánari upplýsingar um villuna eru gefnar í einu og núll eða meira textahnútar.
Beiðni
/Browse?key=lykilgildi
/Browse?key=lykilgildi&withContextMenuItems=1
| Færibreytur | Lýsing |
| lykill | Valfrjáls breyta. Fjarvera þessarar breytu leiðir til vafra á efsta stigi. Skilar upplýsingum fyrir önnur stig en /Browse á efsta stigi. Notar gildið sem er tekið úr eigindagildi eins og „browseKey“, „nextKey“, „parentKey“ eða „contextMenuKey“ úr fyrra svari. Athugið: lykilgildi verður að vera URL kóðuð |
| meðSamhengisvalmyndaratriðum | Valfrjáls breyta. Gildið er alltaf 1. Þessi breyta er notuð til að fá innbyggða samhengisvalmynd þegar leitað er að niðurstöðum um lagalista, albúm, lög, stöðvar, listamenn o.s.frv. |
Svar
Svar við efsta stigi vafra:
<item image=”/images/InputIcon.png” text=”Optical Input”
spilaURL=”/Spila?url=Capture%3Ahw%3A1%2C0%2F1%2F25%2F2%2Finput1″ inputType=”spdif”
tegund = "hljóð" />
Svar við vafra á öðru stigi:
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
þjónusta = "Deezer" leitarlykill = "Deezer: Leita" tegund = "valmynd">
hlutur browseKey=”/Spilunarlistar?þjónusta=Deezer&genre=0&flokkur=toplisti” texti=”Vinsælir spilunarlistar”
tegund = "tengill" />
tegund = "tengill" />
tegund = "tengill" />
hlutur browseKey=”/Lög?service=Deezer&genre=0&category=toplist” text=”Vinsæl lög”
tegund = "tengill" />
| Eiginleikar svars | Lýsing |
| Vísað er til þátta-/eiginleikatöflunnar hér að neðan. |
Example
ATH: Allar lykilbreytur verða að vera UTF-8 kóðaðar.
http://192.168.1.100:11000/Browse
Gerir vafra á efsta stigi.
http://192.168.1.100:11000/Browse?key=Tidal%3A
Gerir leit á öðru stigi og skilar Tidal-flokkunum.
http://192.168.1.100:11000/Browse?key=Tidal%3AmenuGroup%2F3
Gerir þriðja stigs leit og skilar undirflokkunum Tidal Masters (hópur 3).
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters
Gerir fjórða stigs leit og skilar fyrsta settinu af Tidal Masters plötum.
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters%26 start%3D30%26end%3D79
Gerir aðra fjórða stigs leit og skilar öðru setti Tidal Masters albúmanna.
| Frumefni | Eiginleiki (og gildi) | Lýsing | |
| þjónustutákn | Vefslóðin (URI) fyrir tákn fyrir þjónustuna sem verið er að skoða. | ||
| þjónustunafn | Nafn þjónustunnar sem verið er að skoða núna, til birtingar fyrir notanda. | ||
| leitarlykill | Gildi sem á að nota sem lykilbreytu í /Browse beiðni til að leita í núverandi þjónustu (eða einhverjum dýpri hluta stigveldisins). Að auki skal beiðnin hafa aq breytu sem inniheldur leitarorðið. | ||
| nextKey | Gildi sem á að nota sem lykilbreytu í /Browse beiðni til að fá næstu síðu af atriðum fyrir núverandi viewStærð síðuskiptaklumpsins er ekki undir stjórn notanda API-sins og ekki ætti að reyna að greina eða breyta fyrirspurnarfæribreytum þessa gildis. | ||
| foreldralykill | Gildi sem á að nota sem lykilbreytu í /Browse beiðni um að fara aftur upp stigveldið ef sjálfgefna afturleiðsögn á að vera hnekkt. | ||
| gerð | matseðill | Leiðsöguhnútur sem gæti hugsanlega innihaldið blöndu af alls kyns hlutum. Algengast er að hann innihaldi aðeins tengla eða hljóðatriði. | |
| samhengisvalmynd | Listi yfir hluti af tilgreindri gerð. | ||
| listamenn | |||
| Frumefni | Eiginleiki (og gildi) | Lýsing | |
| tónskáld | |||
| plötur | |||
| spilunarlistar | |||
| lög | |||
| tegundir | |||
| köflum | Stafrófsröðuð kaflar. | ||
| atriði | Almennur niðurstöðulisti. Algengast er blanda af valmyndarhnútum (tegund = „tengill“) og útvarpsþáttum (tegund = „hljóð“). | ||
| möppur | Getur innihaldið undirmöppur, lög og færslur í spilunarlistum. | ||
| texta | Stefnir á flokkinn. | ||
| nextKey | Gildi sem á að nota sem lykilbreytu í /Browse beiðni til að fá næstu síðu með atriðum fyrir flokkinn. | ||
| foreldralykill | Gildi sem á að nota sem lykilbreytu í /Browse beiðni um að fara aftur upp stigveldið ef sjálfgefna afturleiðsögn á að vera hnekkt. | ||
| gerð | hlekkur | Almennur hnútur í vafrastigveldinu sem leiðir til frekari hnúta | |
| hljóð | Hnútur sem hægt er að spila beint | ||
| listamaður | Hlutur sem táknar listamann | ||
| Frumefni | Eiginleiki (og gildi) | Lýsing | |
| tónskáld | Hlutur sem táknar tónskáld | ||
| albúm | Hlutur sem táknar albúm eða svipað safn | ||
| lagalista | Atriði sem táknar spilunarlista eða svipað safn | ||
| lag | Atriði sem táknar eitt lag | ||
| texta | Einfaldur textahnútur. | ||
| kafla | Stafrófsröðuð kafli. | ||
| möppu | Mappa í möppuleit. | ||
| texta | Aðal- eða fyrsta lína vörulýsingar | ||
| texti2 | Önnur lína | ||
| mynd | Táknmynd eða myndverk fyrir hlutinn. Ef myndin byrjar á
/Gröftur það gæti leitt til tilvísunar. Bætir við breytu/lykli fylgjaTilvísanir=1 Þegar myndin er sótt er hægt að forðast tilvísun. |
||
| vafralykill | Gildi sem á að nota sem lykilbreytu í síðari /Browse beiðni um að fara niður stigveldið. | ||
| spilaURL | Vefslóð (URI) sem hægt er að kalla beint fram til að kalla fram sjálfgefna spilunaraðgerð fyrir viðkomandi hlut. Venjulega er þetta til að hreinsa biðröðina og hefja spilun hans. | ||
| sjálfvirk spilunURL | URI sem hægt er að kalla beint fram til að bæta lagi við biðröðina og spila það og bæta síðari lögum úr hlutnum sem inniheldur það (eins og plötu) við sjálfvirka útfyllinguna. | ||
| Frumefni | Eiginleiki (og gildi) | Lýsing |
| hluta spilunarröðarinnar. | ||
| samhengisvalmyndarlykill | Gildi sem á að nota sem lykilbreytu í /Browse beiðni til að fá niðurstöðu sem er samhengisvalmynd með aðgerðum sem tengjast hlutnum. | |
| aðgerðURL | URI sem hægt er að kalla beint fram til að framkvæma tilgreinda aðgerð. |
Atriði í samhengisvalmynd geta haft eftirfarandi gildi fyrir type eigindina.
| Eiginleiki | ||
| Lýsing | ||
| uppáhalds | -bæta við | Bæta við hlutnum sem uppáhalds (eða sambærilegt) |
| -eyða | Fjarlægja hlutinn úr uppáhaldslistum notandans | |
| bæta við | Bæta við spilunarröðina | |
| bæta við | -nú | Bæta við spilunarröðina eftir núverandi lag og spila núna |
| -næst | Bæta við spilunarröðina eftir núverandi lag | |
| -síðasta | Bæta við aftan á spilunarröðinni | |
| bæta við öllu | -nú | Bæta við fjölspora hlut í spilunarröðina og spila núna |
| -næst | Bæta við fjölsporahlut í spilunarröðina á eftir núverandi lagi eða fjölsporahlut | |
| -síðasta | Bæta við fjölsporahlut aftast í spilunarröðinni | |
| spilaútvarp | Spilaðu útvarpsstöð sem tengist hlutnum | |
| eyða | Eyða hlutnum (venjulega spilunarlista). Beiðni ætti um staðfestingu notanda. |
Þegar flett er með breytunni „withContextMenuItem=1“ mun niðurstaðan innihalda innlínaða samhengisvalmynd.
Example
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26genre%3D0%26category %3Dtoplist&withContextMenuItems=1
Gerir beiðni um Deezer => Hvað er vinsælt => Vinsælar plötur með innbyggðri samhengisvalmynd.
Svar
Svarið inniheldur innlínu fyrir hvern hlut.
<item text=”Essonne History X” contextMenuKey=”Deezer:contextMenu/Album?albumid=693798541″
spilaURL=”/Bæta við?service=Deezer&albumid=693798541&playnow=1″ mynd=”/Myndverk?service=Deezer&albumid=693798541″
browseKey=”Deezer:Album?artist=Ziak&album=Essonne%20History%20X&albumid=693798541″ text2=”Ziak” type=”albúm”>
<item text=”Favorite” type=”favourite-add” actionURL="/AddFavourite?service=Deezer&albumid=693798541″/>
<item text=”Play now” type=”add-now”
aðgerðURL=”/Bæta við?service=Deezer&playnow=1&clear=0&shuffle=0&where=nextAlbum&albumid=693798541″/>
<item text=”Shuffle” type=”add-shuffle”
aðgerðURL=”/Bæta við?service=Deezer&shuffle=1&playnow=1&where=nextAlbum&albumid=693798541″/>
<item text=”Add next” type=”addAll-next” actionURL=”/Bæta við?service=Deezer&spilaðu núna=-1&hvar=næsta albúm&albúmið=693798541″/>
<item text=”Add last” type=”addAll-last” actionURL=”/Bæta við?service=Deezer&playnow=-1&where=last&albumid=693798541″/>
…
Athugasemdir og ábendingar um framkvæmd
Tegundareiginleikinn fyrir hlut er gefinn sem vísbending sem getur auðveldað mismunandi birtingarvalkosti.
Möguleikinn á að skoða innihald hlutar er gefinn til kynna með tilvist browseKey eigindis. Möguleikinn á að spila (heilan) hlut er gefinn til kynna með tilvist spilunar eigindis.URL (og hugsanlega líka sjálfvirk spilunURL) eigindi. Hlutur getur haft bæði browseKey eigindi og play eigindiURL eiginleiki.
Þegar báðir spilaURL og sjálfvirk spilunURL Eiginleikar eru tiltækir, þá ætti notanda að ákveða hvaða valkostur á að nota sem sjálfgefinn spilunarvalkost.
URI gildi eru almennt afstæð URI með algerri slóðarþátt. Afstæð URI eru aðgreind í alger URI samkvæmt RFC 3986.
Eiginleikagildi browseKey, contextMenuKey og searchKey skulu alltaf vera URI-kóðuð (prósenta escape) þegar þau eru notuð sem gildi lykilbreytu í /Browse beiðni, eins og allar aðrar beiðnibreytur.
Þegar farið er niður í vafrastigalínunni getur verið gagnlegt að hausinn í notendaviðmótinu sýni einhvers konar brauðmylsnu, líklega með titli (texta) foreldra- og afa-hnúta.
Það gæti verið gagnlegt að gera samhengisvalmyndina aðgengilega fyrir foreldrið þegar það skoðar undirsíður þess.
Það getur verið gagnlegt að hafa í huga tegund foreldris þegar ákveðið er hvernig á að sýna börnin sín.
7.2 Leita að tónlistarefni
Lýsing
Skipun til að leita innan þjónustu.
Beiðni
/Vafra?lykill=lykilgildi&q=leitartexti
| Færibreytur | Lýsing |
| lykill | Gildi sem er tekið úr eigindinni „searchKey“ úr fyrra svari |
| q | Leitarstrengurinn. Framkvæma leit í samhenginu sem tilgreint er með lykilbreytunni (tekin úr searchKey eigindi úr svari). Ef lykilbreyta er ekki til staðar skal framkvæma leit á efsta stigi. |
Svar
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
þjónusta = "Deezer" leitarlykill = "Deezer: Leita" tegund = "valmynd">
Skila efsta stigi leitarniðurstöðunnar. Til að fá frekari leitarniðurstöður af listamönnum, plötum, lögum eða spilunarlistum þarf að nota „browse“ skipun með „browseKey“ sem lykil.
Til dæmisampTil að sjá leitarniðurstöður úr albúmum skaltu senda skipunina:
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26expr%3Dmichael
Svarið verður það sama og svarið við venjulega /Browse skipunina.
| Eiginleikar svars | Lýsing |
| Vísa í staka-/eigindatöflur í Browse skipuninni |
Example
http://192.168.1.100:11000/Browse?key=Deezer:Search&q=michael Leitaðu að „michael“ innan tónlistarþjónustunnar Deezer.
Leikmannahópur
Þessi hluti lýsir skipunum fyrir sjálfgefna flokkun og sundurliðun spilara. BluOS styður einnig fasta flokkun, sem fellur ekki undir gildissvið þessa skjals.
BluOS notar hugtökin aðalspilari og aukaspilari. Aðalspilarinn er aðalspilarinn í hópnum. Aðalspilarinn er notaður til að velja tónlistaruppsprettu. Það er aðeins einn aðalspilari. Aukaspilari er tengdur við aðalspilarann. Það geta verið margir aukaspilarar.
Ef spilari er aukaspilari þá eru margar beiðnir, ef þær eru beint til aukaspilarans, sendar innbyrðis til aðalspilarans. Þar á meðal eru beiðnir um /Staða, spilunarstýringu, stjórnun spilunarraðar og efnisskoðun og leit.
8.1 Leikmenn í öðrum hópi
Lýsing
Flokkaðu einn aukaleikmann í aðalleikmann.
Beiðni
/AddSlave?slave=aukaspilaraIP&port=aukaspilaraPort&group=Hópnafn
| Færibreytur | Lýsing |
| þræll | IP-tala aukaspilarans. |
| höfn | Tenginúmer aukaspilarans. Sjálfgefið tenginúmer er 11000. Spilarar eins og NAD CI580, sem hefur fjóra spilara með eina IP-tölu, nota margar tengi. |
| hóp | VALFRJÁLS, nafn hópsins. Ef það er ekki gefið upp mun BluOS gefa upp sjálfgefið hópnafn. |
Svar
| Eiginleikar svars | Lýsing |
| þrælahöfn | Tenginúmer aukaspilarans sem var rétt í þessu flokkaður. |
| Id | Auðkenni aukaspilarans sem var rétt í þessu flokkaður. |
Example
http://192.168.1.100:11000/AddSlave?slave=192.168.1.153&port=11000
Þetta flokkar spilara 192.168.1.153 í spilara 192.168.1.100. Spilari 192.168.1.100 er aðalspilarinn.
8.2 Bæta mörgum spilurum við hóp
Lýsing
Flokkaðu tvo eða fleiri leikmenn í aðalleikmann.
Beiðni
/Bæta viðÞræli?Þrælar=aukaspilaraIP-tölur&port=aukaspilaraPort
| Færibreytur | Lýsing |
| þrælar | IP-tölur aukaspilara sem bæta á við aðalspilarann. IP-tölur eru aðskildar með kommu. |
| hafnir | Tengi aukaspilaranna sem á að bæta við aðalspilarann. Tenginúmer eru aðskilin með kommu. |
Svar
| Eiginleikar svars | Lýsing |
| höfn | Tenging aukaspilarans sem var flokkaður. |
| Id | Auðkenni aukaspilarans sem var flokkaður. |
Example
http://192.168.1.100:11000/AddSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Flokkar aukaspilara 192.168.1.153 og 192.168.1.120 saman við aðalspilara 192.168.1.100.
8.3 Fjarlægja einn leikmann úr hópi
Fjarlægja leikmann úr hópi. Ef aukaleikmaður er fjarlægður úr hópi er aukaleikmaðurinn tekinn úr hópnum. Ef aðalleikmaðurinn er fjarlægður úr hópi með 3 eða fleiri leikmönnum er aðalleikmaðurinn tekinn úr hópnum og eftirstandandi aukaleikmenn mynda nýjan hóp.
Beiðni
/FjarlægjaÞræl?Þræll=aukaspilaraIP&port=aukaspilaraPort
| Færibreytur | Lýsing |
| þræll | IP-tala spilarans (auka) sem á að bæta við annan spilara (aðalspilara). |
| höfn | Tengi spilara (aukaspilara) sem á að bæta við annan spilara (aðalspilara). |
Svar
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″
vörumerki = „Bluesound“ etag=”25″ outlevel=”-62.9″ schemaVersion=”25″ initialized=”true” group=”PULSE-0278+POWERNODE-0A6A” syncStat=”25″ id=”192.168.1.100:11000″mac=”90:56:82:9F:02:78″>
| Eiginleikar svars | Lýsing |
| Sjá /SyncStatus fyrir nánari upplýsingar. |
Example
http://192.168.1.100:11000/RemoveSlave?slave=192.168.1.153&port=11000
Afflokkar spilara 192.168.1.153 úr hópnum sem hefur aðalspilara 192.168.1.100
8.4 Fjarlægja marga leikmenn úr hópi
Lýsing
Fjarlægja tvo eða fleiri leikmenn úr hópi.
Beiðni
/FjarlægjaÞræl?Þrælar=aukaspilaraIP-tölur&port=aukaspilaraPort
| Færibreytur | Lýsing |
| þrælar | IP-tölur aukaspilara sem á að fjarlægja úr aðalspilaranum. IP-tölur eru aðskildar með kommu. |
| Færibreytur | Lýsing |
| hafnir | Tengi aukaspilara sem á að fjarlægja úr aðalspilaranum. Tenginúmer eru aðskilin með kommu. |
Svar
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″ brand=”Bluesound” etag=”41″ outlevel=”-62.9″ schemaVersion=”25″ initialized=”true” syncStat=”41″ id=”192.168.1.100:11000″ mac=”90:56:82:9F:02:78″></SyncStatus>
| Eiginleikar svars | Lýsing |
| Sjá /SyncStatus fyrir nánari upplýsingar. |
Example
http://192.168.1.100:11000/RemoveSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Fjarlægir spilara 192.168.1.153 og 192.168.1.120 úr hópnum með aðalspilara 192.168.1.100.
Endurræsing spilara
Þessi hluti lýsir skipun fyrir mjúka endurræsingu spilara.
9.1 Endurræsa spilara
Lýsing
Endurræsa spilara mjúklega.
Beiðni
POST skipun /endurræsa með breytunni já (hvaða gildi sem er)
| Færibreytur | Lýsing |
| já | Hvaða gildi sem er (t.d. 1). |
Svar
Stillingar uppfærðar
Endurræsing. Vinsamlegast lokaðu þessum glugga.
Vinsamlegast bíddu…
Example
curl -d já=1 192.168.1.100/endurræsa
Dyrabjölluhljóð
Þessi hluti lýsir skipun fyrir dyrabjöllu spilara.
10.1 Dyrabjallahringingar
Lýsing
Virkjaðu dyrabjölluna.
Beiðni
http://PLAYERIP:PORT/Doorbell?play=1
| Færibreytur | Lýsing |
| spila | Spila dyrabjöllu (alltaf 1) |
Svar
| Eiginleikar svars | Lýsing |
| virkja | Gefðu til kynna bjölluna |
| bindi | Hljóðstyrkur bjalla |
| klukka | Hljóð frá bjöllu |
Example
http://192.168.1.100:11000/Doorbell?play=1 play doorbell chime
Beint inntak
Þessi hluti lýsir skipunum fyrir beint val á inntaksuppsprettu.
11.1 Val á virkum inntaki
Lýsing
Val á virkri inntaksuppsprettu. Þessi skipun virkar fyrir virk inntök sem birtast í svarinu við /RadioBrowse?service=Capture. Val á inntökum BluOS HUB er aðeins stutt af þessari skipun.
Beiðni
/Spila?url=URL_gildi
| Færibreytur | Lýsing |
| url | The URL eigindi úr svarinu við /RadioBrowse?service=Capture |
Svar
straumur
| Eiginleikar svars | Lýsing |
| ríki | Gefa til kynna að inntakið sé að spila |
Example
Skref 1. Fáðu URL_gildi fyrir breytu url
Beiðni: http://192.168.1.100:11000/RadioBrowse?service=Capture
Svar:
<item playerName=”Tick
Merktu við „texti = „Bluetooth“ inntaksgerð = „Bluetooth“ auðkenni = „inntak 2“ URL=”Handartaka%3Abluez%3Abluetooth” mynd=” /myndir/BluetoothIcon.png” tegund=”hljóð”/>
<item playerName=”Tick Tick” text=”Analog
Inntak“ inntaksgerð = „hliðrænt“ auðkenni = „inntak0“ URL=”Capture%3Aplughw%3Aimxnadadc%2C0%2F48000%2F 24%2F2%3Fid%3Dinput0″ image=”/images/capture/ic_analoginput.png” type=”audio”/>
<item playerName=”Tick Tick” text=”Optical
Inntak“ inntaksgerð = „spdif“ auðkenni = „inntak1“ URL=”Capture%3Ahw%3Aimxspdif%2C0%2F1%2F25%2F2%3Fid%
3Dinput1″ mynd = "/ myndir / handtaka / ic_opticalinput.png" tegund = "hljóð" />
<item playerName=”Tick
Merktu við texti = „Spotify“ auðkenni = „Spotify“ URL=”Spotify%3Aplay” mynd =”/Heimildir/myndir/SpotifyIcon.png” þjónusta
Tegund = "Skýjaþjónusta" tegund = "hljóð" />
<remoteitem playerName=”Test Hub” text=”Analog Input” inputType=”analog” id=”hub192168114911000input0″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput0″
mynd = "/ myndir / handtaka / ég
c_analoginput.png“
tegund = "hljóð" />
<remoteitem playerName=”Test Hub” text=”Coaxial Input” inputType=”spdif” id=”hub192168114911000input3″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput3″
mynd = "/ myndir / handtaka / ic
„_ljósleiðari.png“
tegund = "hljóð" />
<remoteitem playerName=”Test Hub” text=”HDMI ARC” inputType=”arc” id=”hub192168114911000input4″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput4″
mynd = "/ myndir / handtaka / ic
_sjónvarp.png“
tegund = "hljóð" />
<remoteitem playerName=”Test Hub” text=”Optical Input” inputType=”spdif” id=”hub192168114911000input2″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput2″
mynd = "/ myndir / handtaka / ic
„_ljósleiðari.png“
tegund = "hljóð" />
<remoteitem playerName=”Test Hub” text=”Phono Input” inputType=”phono” id=”hub192168114911000input1″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput1″
mynd = "/ myndir / handtaka / ic
_vínyl.png“
tegund = "hljóð" />
Skref 2. Spilaðu hliðrænt inntak á spilaranum
http://192.168.1.100:11000/Play?url=Capture%3Aplughw%3A2%2C0%2F48000%2F24%2F2%3Fid%3Dinput0 or play Analog Input of a HUB named “Test Hub”
http://192.168.1.100:11000/Play?url= Hub%3A%2F%2F192.168.1.149%3A11000%2Finput0
Athugið: Gakktu úr skugga um að heimildirnar séu tengdar og ekki faldar.
11.2 Val á ytri inntaki
Lýsing
Val á ytri inntaksgjafa. Stundum birtast óvirk ytri inntak ekki í svarinu við
/RadioBrowse?service=Capture. Þessi skipun virkar bæði fyrir virka og óvirka inntaksval. Hún er ráðlögð fyrir val á ytri CI inntaki.
Beiðni (BluOS vélbúnaðar nýrri en v3.8.0 og eldri en v4.2.0)
/Spila?inputIndex=Vísitalaauðkenni
| Færibreytur | Lýsing |
| inntaksvísitala | Vísitala (byrjar á 1) inntaks sem birtast í svarinu við /Settings?id=capture&shcemaVersion=32 (32 er nýjasta skemaútgáfan) í tölulegri röð. Bluetooth er undanskilið. |
Svar
straumur
| Eiginleikar svars | Lýsing |
| ríki | Gefa til kynna að inntakið sé að spila |
Example
Skref 1. Fáðu inputIndex gildið
Beiðni: http://192.168.1.100:11000/Settings?id=capture&schemaVersion=32
Svar:
<menuGroup icon=”/images/settings/ic_capture.png” url=”/stilling” auðkenni =”handtaka”
displayName="Sérsníða heimildir">
<setting icon=”/images/settings/ic_bluetooth.png” refresh=”true” url=”/hljóðstillingar”
id="bluetooth" displayName="Bluetooth" value="3" name="bluetoothAutoplay" description="Disabled" explanation="Handvirk stilling gerir þér kleift að skipta á milli uppspretta í flakkskúffunni. Sjálfvirk stilling skiptir yfir í Bluetooth-uppsprettu þegar tengt Bluetooth-tæki byrjar að spila hljóð. Þú getur síðan skipt á milli uppspretta í flakkskúffunni. Gestastilling skiptir yfir í Bluetooth-uppsprettu þegar tengt Bluetooth-tæki byrjar að spila hljóð. Ef þú skiptir yfir í aðra uppsprettu mun Bluetooth aftengjast. Bluetooth-uppsprettan birtist ekki í flakkskúffunni. Óvirk stilling fjarlægir uppsprettu úr flakkskúffunni og leyfir ekki öðru tæki að tengjast spilaranum sem Bluetooth-tæki.
uppspretta.“ class="listi">
…
<menuGroup icon=”/images/capture/ic_analoginput.png” url=”/stilling” auðkenni =”handtaka inntak0”
sýnaNafn = "Analog
Inntak
<menuGroup icon=”/images/capture/ic_opticalinput.png” url=”/stilling” auðkenni =”handtaka-inntak1”
sýnaNafn = "Ljósinntak">
Svarið sýnir Bluetooth, hliðrænt inntak og ljósleiðarainntak. Bluetooth er undanskilið, þannig að inputIndex gildið er 1 fyrir hliðrænt inntak og inputIndex gildið er 2 fyrir ljósleiðarainntak.
Skref 2. Spilaðu ljósleiðarainntak á spilaranum.
http://192.168.1.100:11000/Play?InputId=2
Beiðni (BluOS vélbúnaðarútgáfa 4.2.0 eða nýrri)
/Spila?inputTypeIndex=$typeIndex
| Færibreytur | Lýsing |
| inntaksgerðVísitala | typeIndex hefur sniðið tegundarvísitala af inntaki. Hér er listi yfir inntak gerð: spdif (sjónrænt inntak) hliðrænt (hliðrænt inntak, línuinntak) koax (samása inntak) Bluetooth bogi (HDMI ARC) earc (HDMI eARC) phono (Vinyl) tölva aesebu (AES/EBU) jafnvægi (Balanced In) Hljóðnemi (hljóðnemainntak) The vísitölu byrjar frá 1. Þegar fleiri en einn inntak af sömu gerð er til staðar, þá hefur inntak 1 vísitölu 1, inntak 2 hefur vísitölu 2, og svo framvegis. |
Svar
straumur
| Eiginleikar svars | Lýsing |
| ríki | Gefa til kynna að inntakið sé að spila |
Example
Beiðni: http://192.168.1.100:11000/Play?inputTypeIndex=spdif-2 til að velja ljósleiðarainntak 2
Svar: straumur
Bluetooth
Þessi hluti lýsir skipun til að breyta Bluetooth-stillingu.
12.1 Breyta Bluetooth-stillingu
Lýsing
Breyta Bluetooth-stillingu: Handvirkt, Sjálfvirkt, Gestur, Óvirkt.
Beiðni
/hljóðstillingar?bluetoothSjálfvirk spilun=gildi
| Færibreytur | Lýsing |
|
BluetoothSjálfvirk spilun |
Bluetooth-stilling gildi 0 þýðir Handvirkt, 1 þýðir Sjálfvirkt, 2 þýðir Gestir, 3 þýðir Óvirkt. |
Ekkert svar
Example
Beiðni: http://192.168.1.100:11000/audiomodes?bluetoothAutoplay=3 til að slökkva á Bluetooth
Viðauki
13.1 Lenbrook þjónustugreiningarsamskiptareglur
Inngangur
Vinsælar uppgötvunaraðferðir eins og mDNS og SSDP nota og reiða sig á UDP fjölvarpssamskipti. Flestar núverandi vörur frá Lenbrook nota mDNS til uppgötvunar. Því miður höfum við komist að því að umtalsverður fjöldi viðskiptavina okkar á heimanet þar sem fjölvarpsumferð virkar ekki rétt og ekki er hægt að finna tækin okkar áreiðanlega. Þetta hefur leitt til margra vöruskila og kvartana frá dreifingaraðilum okkar.
Til að takast á við þetta vandamál höfum við búið til sérsniðna uppgötvunarsamskiptareglu sem kallast LSDP og notar UDP útsendingu. Fyrstu prófanir hafa sýnt að þetta er mun áreiðanlegra en uppgötvun byggð á mDNS.
Bókun lokiðview
Eitt markmið þessarar samskiptareglu er að vera tiltölulega einföld. Hana má nota í innbyggðum tækjum með mjög takmarkað minni.
Samskiptareglurnar nota öll UDP útsendingarpakka til og frá UDP tengi 11430. Þessi tengi hefur verið skráð hjá IANA og er úthlutað Lenbrook fyrir LSDP notkun frá og með 27. mars 2014.
Í stöðugu ástandi sendir hver hnútur með þjónustu til að auglýsa út tilkynningarskilaboð á um það bil mínútu fresti.
Við ræsingu og þegar þjónustulisti eða netbreytur breytast skulu sjö pakkar sendir út með stuttu millibili til að leyfa upphaflegri uppgötvun og breytingar að berast hraðar. Fyrir hnúta sem auglýsa þjónustu skulu þessir sjö fyrstu pakkar innihalda tilkynningarskilaboð. Fyrir hnúta sem reyna að finna þjónustu skulu fyrstu sjö pakkarnir innihalda fyrirspurnarskilaboð. Fyrir þjónustur sem eru ekki lengur tiltækar ættu sjö pakkarnir að innihalda eyðingarskilaboð.
Þessir upphafspakkar eru sendir sjö sinnum vegna óáreiðanleika UDP-pakkana. Ef svo ólíklega vill að allir sjö pakkarnir mistakist, þá verða þjónustur samt sem áður uppgötvaðar eftir smá tíma úr eins mínútu reglubundnum tilkynningaskilaboðum.
Ef hnútur fær fyrirspurnarskilaboð fyrir þjónustuklasa sem hann auglýsir skal hann svara með tilkynningarskilaboðum eftir stutta handahófskennda töf og endurstilla núverandi tilkynningartímamörk.
Pakkahausinn og allir skilaboðablokkir innihalda lengdarreiti. Þetta gefur aukinn sveigjanleika og gerir kleift að gera afturábakssamhæfðar breytingar í framtíðinni. Auka reitir eða skilaboðategundir gætu verið bætt við í framtíðinni sem eldri útfærslur gætu sleppt við greiningu. Ef við ákveðum að gera afturábakssamhæfða breytingu er einnig útgáfureitur í pakkahausnum sem hægt er að auka.
Samskiptareglurnar leyfa einnig að TXT-færslur séu innifaldar í þjónustuauglýsingum, svipað og TXT-færslur sem notaðar eru
með mDNS. Þetta veitir verulegan sveigjanleika til að bæta við handahófskenndum lýsigögnum með þjónustunni.
auglýsingar án þess að breyta samskiptareglunum.
Upplýsingar um samskiptareglur
Tímasetning
Öllum pakka sem send eru ætti að vera tímasett með handahófskenndum tíma eða töfum til að koma í veg fyrir árekstra.
- Tímasetning ræsingarpakka: 7 pakkar á tíma = [0, 1, 2, 3, 5, 7, 10s] + (0 til 250ms af handahófi). Þetta eru algildir tímar, ekki tafir. Öll 7 pakkarnir ættu að vera sendir innan um 10 sekúndna.
- Aðaltilkynningartímabil: 57 sekúndur + (0 til 6 sekúndur af handahófi)
- Seinkun á svari við fyrirspurn: (0 til 750ms af handahófi)
Nótukenni
Hver hnútur skal hafa einstakt auðkenni sem hægt er að nota til að bera kennsl á hnútinn. Þetta einstaka auðkenni er að finna í tilkynningar- og eyðingarskilaboðum. Viðskiptavinir geta notað þetta gildi sem aðallyki þegar gildi eru geymd í skyndiminni og til að bera kennsl á hnút. Þetta einstaka auðkenni getur verið MAC-tala en ætti að vera það sama fyrir hvert viðmót ef hnútur hefur mörg viðmót sem hann auglýsir á.
Uppbygging pakka
Hvert pakka byrjar með pakkahaus og síðan handahófskenndum fjölda skilaboðablokka. Hvert skilaboðablokk byrjar með lengdarreit svo hægt sé að sleppa óþekktum skilaboðum. Nema annað sé tekið fram skulu öll fjölbæta tölugildi geymd á big endian (mikilvægustu bætin fyrst). Nema annað sé tekið fram eru allar tölur ómerktar. Til dæmisampLengd eins bætis getur verið á bilinu 0 til 255.
Pakkahaus
| Field | Bæti | Lýsing |
| Lengd | 1 | Heildarlengd haussins þar með talið þennan reit. |
| Töfraorð | 4 | Þessi reitur skal innihalda fjögur ASCII bæti af „LSDP“. Þetta hjálpar okkur að bera kennsl á pakka sem ætlaða til notkunar svo við þurfum ekki að reyna að greina handahófskennd gögn úr óvæntri uppsprettu. |
| Bókunarútgáfa | 1 | Útgáfa samskiptareglunnar. Ef breytingar verða gerðar á samskiptareglunni í framtíðinni sem eru ósamhæfar aftur á bak við þessa útgáfu |
| Field | Bæti Lýsing | |
| verður breytt. Núverandi útgáfa er 1. | ||
Fyrirspurnarskilaboð
| Field | ||
| Bæti | Lýsing | |
| Lengd | 1 | Heildarlengd skilaboða þar með talið þennan reit. |
| Tegund skilaboða | 1 | „Q“ = 0x51: Staðlað fyrirspurn um útsendingarsvar. „R“ = 0x52: Fyrirspurn um einsendingarsvar. |
| Telja | 1 | Fjöldi klasa til að leita í. |
| 1. flokkur | 2 | 16 bita (2 bæti) flokksauðkenni. |
| … | Endurtakið fyrri reit fyrir hvern viðbótarflokk. | |
Tilkynna skilaboð
Tilkynna haus
| Field | ||
| Bæti | Lýsing | |
| Lengd | 1 | Heildarlengd skilaboða, þar með talið tilkynningarhaus og tilkynningarfærslur. |
| Tegund skilaboða | 1 | „A“ = 0x41 |
| Lengd hnútaauðkennis | 1 | Lengd reitsins fyrir hnútaauðkenni. |
| Nótukenni | Breytilegt | Einkvæmt hnútaauðkenni hnútans sem sendir tilkynninguna. Þetta er venjulega MAC-tala eins af viðmótum hnútans. |
| Lengd heimilisfangs | 1 | Lengd heimilisfangsreitsins. Fyrir IPv4 skal þetta vera 4. |
| Field | ||
| Bæti | Lýsing | |
| Heimilisfang | Breytilegt | IP-tala hnúts. |
| Telja | 1 | Fjöldi tilkynningarfærslna sem fylgja skal. |
Tilkynna met
| Field | Bæti | Lýsing |
| bekk | 2 | 16 bita (2 bæti) flokksauðkenni. |
|
TXT-talning |
1 |
Fjöldi TXT-færslna sem á að fylgja. Ef núll eru eftirfarandi reitir sleppt. |
| Lengd lykils 1 | 1 | Lengd lykilheitis. |
| Lykill 1 | Breytilegt | Lykilheiti. |
| Gildi 1 Lengd | 1 | Lengd gildistexta. |
| Gildi 1 | Breytilegt | Gildistexti. |
|
… |
Endurtakið fyrri 4 reiti fyrir hverja viðbótar TXT-færslu. |
Eyða skilaboðum
| Field | ||
| Bæti | Lýsing | |
| Lengd | 1 | Heildarlengd skilaboða þar með talið þennan reit. |
| Tegund skilaboða | 1 | „D“ = 0x44 |
| Lengd hnútaauðkennis | 1 | Lengd reitsins fyrir hnútaauðkenni. |
| Nótukenni | Breytilegt | Einkvæmt hnútaauðkenni hnútans sem sendir skilaboðin. Þetta er venjulega MAC-tala eins af hnútunum. |
| Field | ||
| Bæti | Lýsing | |
| tengi. | ||
| Telja | 1 | Fjöldi námskeiða sem fylgja skal. |
| 1. flokkur | 2 | 16 bita (2 bæti) flokksauðkenni. |
| … | Endurtakið fyrri reit fyrir hvern viðbótarflokk. | |
Úthlutun bekkjarkenni
| Bekkjarauðkenni | Lýsing | mDNS jafngildi |
| 0x0001 | BluOS spilari | _musc._tcp |
| 0x0002 | BluOS netþjónn | _muss._tcp |
| 0x0003 | BluOS spilari (aukaþáttur í fjölsvæðisspilurum eins og CI580) | _musp._tcp |
| 0x0004 | sovi-mfg notað til framleiðsluprófana. | _sovi-framleiðslufyrirtæki_tcp |
| 0x0005 | sovi-lyklaborð | _sovi-lyklaborð._tcp |
| 0x0006 | BluOS spilari (paraður þjónn) | _musz._tcp |
| 0x0007 | Fjarstýring Web Forrit (AVR OSD Web Síða) | _fjarstýring-web-ui._tcp |
| 0x0008 | BluOS Hub | _sveppur._tcp |
| 0xFFFF | Allir flokkar – Hægt er að nota með fyrirspurnarskilaboðum. |
Athugasemd 1:
Heildar LSDP-pakkann þarf að meðhöndla sem tvíundagögn.
Athugasemd 2:
Ef ein tilkynningarskilaboð geta ekki innihaldið allar upplýsingar um hnúta (sérstaklega CI580), þá mun hún skiptast í tvö eða fleiri tilkynningarskilaboð þar sem hvert skilaboð inniheldur haus og færslu og hvert skilaboð inniheldur upplýsingar um allan hnúta/hnúta.
BluOS sérsniðin samþættingarforritaskil útgáfa 1.7
Skjöl / auðlindir
 |
BluOS T 778 Sérsniðin samþættingarforritaskil [pdfNotendahandbók T 778, T 778 Sérsniðin samþættingar-API, T 778, Sérsniðin samþættingar-API, Samþættingar-API, API |