Kohandatud integratsiooni API
T 778 kohandatud integratsiooni API
Selles kasutusjuhendis sisalduv teave on Lenbrook Industries'i omand.
See on mõeldud üksnes professionaalseks kasutamiseks. Lenbrook Industries ei vastuta protokolli täpsuse eest. Protokoll pakutakse olemasoleval kujul koos kõigi vigadega ja ilma igasuguse otsese või kaudse garantiita.
API kasutamise eeskirjad
API-dele juurde pääsedes nõustute käesoleva API kasutuspoliitikaga („poliitika“) ja meie tingimustega. Pakume neid API-sid, et ettevõtted ja üksikisikud saaksid meie teenusele tugineda ja sellest kasu saada, luues tarkvara, teenuseid või mooduleid, mis ühenduvad meie platvormiga või millel on juurdepääs meie platvormil olevatele andmetele meie API-de kaudu („integratsioon“). Käesolevat poliitikat käsitletakse ja käsitletakse osana meie tingimustest.
Tarkvara pakutakse „NAGU ON“, ilma igasuguse otsese või kaudse garantiita, sealhulgas, kuid mitte ainult, müügikõlblikkuse, konkreetseks otstarbeks sobivuse ja õiguste mitterikkumise garantiideta. Autorid ega autoriõiguste omanikud ei vastuta mingil juhul nõuete, kahjude ega muu kohustuse eest, olenemata sellest, kas see on lepinguline, deliktne või muul viisil seotud, mis tuleneb tarkvarast või selle kasutamisest või muudest toimingutest.
Lubatud kasutamine
Te ei tohi API-t kasutada rämpsposti saatmiseks ega muudeks toiminguteks, mis rikuvad meie vastuvõetava kasutamise eeskirja ja standardseid kasutustingimusi. Te järgite kõiki kohaldatavaid seadusi (sealhulgas privaatsusseadusi ja Ameerika Ühendriikide ekspordikontrolli seadusi, Euroopa üldist kaubandusmäärust ja -eeskirju ning majandussanktsioonide seadusi ja eeskirju). Te järgite kogu API-de kohta esitatud dokumentatsiooni. Te ei tohi proovida häkkida ega muuta teenuse toimimist. Me võime jälgida teie API-de kasutamist nende reeglite järgimise osas ja kui te rikute seda eeskirja, võime keelata teile juurdepääsu API-le.
Privaatsus
Sinu Integratsioon peab kasutajatele kuvama privaatsuspoliitika, milles on üksikasjalikult kirjeldatud teavet, mida te neilt integratsiooni kasutamisel kogute. Kasutaja andmetele pääsete ligi ainult kasutaja poolt lubatud ja privaatsuspoliitikas selgitatud ulatuses. Kui kasutaja taotleb kustutamist või lõpetab oma konto teie juures, peate kasutaja andmed viivitamatult kustutama.
Turvalisus
Te rakendate ja säilitate asjakohaseid tehnilisi ja korralduslikke turvameetmeid andmete kaitsmiseks ja turvalisuse, terviklikkuse ja konfidentsiaalsuse säilitamiseks. Need turvameetmed peavad takistama volitamata juurdepääsu teie töödeldavatele isiku- või konfidentsiaalsetele andmetele või nende avalikustamist.
Omandiõigus
Meile kuuluvad kõik õigused, omandiõigused ja huvid Teenuse ja API-de suhtes, sealhulgas kõik intellektuaalomandi õigused, kaubamärgid, kood ja funktsioonid. Te ei tohi meie koodi, disaini ega sisu rikkuda, pöördprojekteerida ega kopeerida. Te ei tohi meie API-dele ligi pääseda meie Teenusega konkureerimiseks. Kõik õigused, mida käesolevad eeskirjad sõnaselgelt ei anna, jäävad kehtima, seega kui te seda siin ei näe, siis ei ole see õigus, mida me teile anname.
Kaubamärkide kasutamine
Te ei tohi meie nime ega kaubamärke (st meie logosid, kaubamärke ja autoriõigustega kaitstud pilte) mingil viisil kasutada. Te ei tohi meie kaubamärkides olevaid omandiõiguse teateid muuta ega eemaldada. Te ei tohi meie nime ega kaubamärke kasutada oma Integratsiooni nimes või logos ega ühelgi viisil, mis viitab meiepoolsele toetusele.
Kaubamärkide praktiline kasutamine
Need juhised selgitavad, kuidas te peate meie nime, kaubamärke ja kaubamärgi varasid praktiliselt igal ajal kasutama. Teie kasutamine näitab teie nõusolekut nende juhistega ning te mõistate, et nende juhiste rikkumine toob kaasa teie loa meie nime, kaubamärkide ja kaubamärgi varade kasutamiseks automaatse lõpetamise.
- Meie nime, kaubamärkide ja kaubamärgi varade kasutamiseks peab olema selgesõnaline kirjalik luba.
- Ärge muutke, modifitseerige, kopeerige ega jäljendage meie brändivarasid mingil viisil, sealhulgas ärge muutke värvi, pöörake ja/või venitage neid. Teisisõnu, meie brändivarad tuleb säilitada algsel kujul.
- Ärge andke meie nimele, kaubamärkidele ja kaubamärgi varadele liigset esiletõstmist võrreldes teie nime ja logoga.
- Ärge kuvage meie nime, kaubamärke ja kaubamärgi objekte konkureeriva turunduse kõrval ega ühelgi teisel kujul ilma meie selgesõnalise nõusolekuta.
- Teie kasutus ei tohi tarbijaid eksitada meiepoolse sponsorluse, seotuse või toetuse osas teie ettevõttele või teie toodetele või teenustele.
- Meie nimi, kaubamärgid ja brändi varad on meie ainuomand. Kogu teiepoolne hea tahe on üksnes meie hüvanguks. Te ei tohi võtta ette mingeid samme, mis on vastuolus meie õiguste või omandiõigusega.
- Meie nime, kaubamärke ja kaubamärgi varasid tuleb kasutada lugupidaval viisil ning neid ei tohi kasutada viisil, mis kahjustab meid, meie tooteid või teenuseid või mis meie arvates vähendab või muul viisil kahjustab meie mainet või meie nime, kaubamärkide ja kaubamärgi varade firmaväärtust. Teisisõnu, palun ärge seostage meie varasid ebaseadusliku tegevusega ega kasutage neid petlikul või kahjulikul viisil.
Exampvastuvõetava kasutamise korral:
„[TEIE TOOTE NIMI] (ühildub / töötab BluOS-iga)”
Exampvastuvõetamatu kasutamise korral
„[TEIE TOOTE NIMI] – BluOS”
„BluOS – [TEIE TOOTE NIMI]”
„[TEIE TOOTE NIMI] – BluOS-iga”
Turundus ja pressiteated
Pärast teie taotluse heakskiitmist võidakse see meie lehel kuvada. web omadused. Üldiselt me ei avalda pressiteateid koos teiega ega panusta teie rakenduse ühisturundusse.
Enne kui levitate oma rakenduse kohta pressiteadet, võtke meiega kindlasti ühendust aadressil [EMAIL]. Kui mainite BluOS-i, peame teid uuesti teavitama.view pressiteade. Soovitame teil oma lõpliku pressiteatega võimalikult kiiresti ühendust võtta.
Vastutusest loobumine
Seadusega lubatud maksimaalses ulatuses pakume API-sid olemasoleval kujul. See tähendab, et me ei anna mingeid otseseid ega kaudseid garantiisid, sealhulgas, kuid mitte ainult, müügikõlblikkuse ja konkreetseks otstarbeks sobivuse osas.
Värskendused
Meil on õigus API-sid ja käesolevat poliitikat aeg-ajalt uuendada või muuta, postitades muudatused sellele saidile või teavitades teid e-posti teel. Need muudatused võivad mõjutada teie API-de kasutamist või teie integratsiooni suhtlemist API-ga. Kui teeme teile vastuvõetamatu muudatuse, peaksite API-de kasutamise lõpetama.
Konfidentsiaalsus
Teil võib olla juurdepääs API-dega seotud konfidentsiaalsele, ärisaladuse alla kuuluvale ja mitteavalikule teabele („konfidentsiaalne teave“). Võite seda teavet kasutada ainult API-dega loomiseks. Te ei avalda konfidentsiaalset teavet kellelegi ilma meie kirjaliku nõusolekuta ning kaitsete konfidentsiaalset teavet volitamata kasutamise ja avalikustamise eest samamoodi nagu oma konfidentsiaalset teavet.
Hüvitis
Te hüvitate meile ja meie meeskonnale kõik kahjud (sh advokaaditasud), mis tulenevad kolmandate isikute nõuetest seoses teiepoolse API kasutamisega.
Ülejäänud
Käesolev poliitika ei loo ega tähenda partnerlust, esindussuhet ega ühisettevõtet. Käesolev poliitika kehtib seni, kuni te API-sid kasutate või kuni see lõpetatakse vastavalt meie tingimustele. Käesoleva poliitika ja standardsete kasutustingimuste vastuolu korral on ülimuslikud standardsed kasutustingimused.
©2025 LENBROOK INDUSTRIES LIMITED
633 Granite Court, Pickering, Ontario, Kanada L1W 3K1
Kõik õigused kaitstud
Selle väljaande ühtegi osa ei tohi ilma Lenbrook Industries Limited kirjaliku loata mingil kujul reprodutseerida, salvestada ega edastada. Kuigi on tehtud kõik endast olenev, et sisu oleks avaldamise ajal täpne, võivad omadused ja spetsifikatsioonid muutuda ette teatamata.
| Läbivaatamise ajalugu | ||
| Versioon | Kuupäev | Kirjeldus |
| 1.0 | 6 | Esimene väljalase |
| 1.2 | 01 | Lisatud pehme taaskäivitus, uksekella helin, helitugevuse suurendamine/vähendamine, loo teisaldamine järjekorras ja otsesisestuskäsklused. Lisatud märkus LSDP lisale. |
| 1.4 | 04 | Lisatud vaigistuskäsk; muudetud otsesisestuse käske HUB-i jaoks; värskendatud esituskäsku voogesitatud kohandatud heli esitamiseks. |
| 1.5 | 07 | Lisatud Bluetoothi käsk; uuendatud LSDP, et lisada klass 5 klassile 8; lisatud API kasutuspoliitikasse „Kaubamärkide praktiline kasutamine”. |
| 1.6 | 03 | Lisatud märkus 2. jaotises rühmitatud mängijate oleku kohta; Lisatud /Play?seek=seconds is=trackid jaotises 4.1; |
| 1.7 | 04 | Värskendatud punkt 8.3 exampLisatud tekstisisese kontekstimenüü sirvimispäringu näideample jaotises 7.1; lisatud uus otsesisendi valiku käsk jaotises 11.2; uuendatud jaotist 6.1, et lisada eelseadetele atribuut „image”; lisatud kommentaar „followRedirects=1” kõigi pildi atribuutide jaoks; uuendatud atribuutide esitamise selgitustURL ja lisa nüüd jaotises 7.1 |
Sissejuhatus
BluOS™ on täiustatud operatsioonisüsteem ja muusikahaldustarkvara, mis võimaldab teil koduvõrgu kaudu igasse ruumi juurde pääseda ja voogesitada kadudeta muusikat kuni 24-bitise/192 kHz resolutsiooniga. BluOS-i leidub Bluesoundi, NAD Electronicsi, DALI kõlarite ja teiste toodetes.
See dokument loodi kohandatud integratsiooni (CI) turul töötavate arendajate ja süsteemiintegraatorite abistamiseks. See sisaldab API-päringute alamhulka, mis on dokumenteeritud täielikus BluOS API juhtimisprotokollis.
Kõik selles dokumendis kirjeldatud päringud saadetakse HTTP GET-päringutena. Parameetrid on standardsed. URL kodeeritud nime/väärtuse paar. BluOS-i mängijad saavad need käsud ja vastavad seejärel UTF-8 kodeeritud XML-andmetega.
Kõik päringud on kujul http:// : / kus:
- player_ip on BluOS-mängija IP-aadress (nt 192.168.1.100)
- port on kommunikatsiooniks kasutatav TC-port. Porti 11000 kasutavad kõik BluOS-mängijad, välja arvatud CI580. CI580-l on ühes korpuses neli striimerisõlme, kus sõlm 1 kasutab porti 11000, sõlm 2 kasutab porti 11010, sõlm 3 kasutab porti 11020 ja sõlm 4 kasutab porti 11030. Tegelik kasutatav port tuleks leida MDNS-protokolli abil teenuste musc.tcp ja musp.tcp abil.
- päring on tegelik BluOS-i käsk või päring (nt Esita)
Märkus. See dokument kasutab http://192.168.1.100:11000 mängija IP ja pordina kõigis eksampvähem.
Staatuse päringud
Olekupäringuid kasutatakse BluOS-mängija päringute tegemiseks.
BluOS pakub olekupäringute tegemiseks kahte mehhanismi: tavalist küsitlust ja pikka küsitlust. Tavaline küsitlus tagastab päringu tulemuse kohe. Pikk küsitlus hoiab ühendust määratud aja ja tagastab päringu tulemuse ainult siis, kui teave on muutunud või ajalõpp. Pikk küsitlus võib oluliselt vähendada mängijale tehtavate kõnede arvu.
Kui pikka küsitlust ei kasutata, peaksid kliendid piirama oma küsitlussagedust maksimaalselt ühe päringuga iga 30 sekundi järel. Pikka küsitlust kasutades ei tohi klient teha sama ressursi kohta kahte järjestikust päringut vähem kui ühe sekundilise vahega, isegi kui esimene päring vastab vähem kui ühe sekundi pärast.
Pikad küsitluspäringud võtavad kaks parameetrit: ajalõpp ja etag. timeout on pika küsitluse kestus ja etag võetakse eelmisest vastusest (vastuse juurelemendi atribuut).
Üldiselt on vaja, et pikaajaline küsitlus oleks aktiivne ainult ühe jaoks: /Status või /SyncStatus. /Status vastus sisaldab elementi ( ), mis näitab, kas /SyncStatus on muutunud. /SyncStatus tuleks küsida, kui oluline on ainult mängija nimi, helitugevus ja grupeerimise olek. /Status tuleks küsida, kui on vaja praegust taasesituse olekut.
Kui mängijad on rühmitatud, on esmane mängija grupi põhimängija. Teisese mängijaga liidetakse teisejärgulised mängijad. Teisese mängija olekuvastus on koopia esmase mängija vastusest. Seejärel on iga teisese mängija helitugevuse jälgimiseks vajalik pikk küsitlus /SyncStatus.
2.1 Taasesituse olek
Kirjeldus
Lõpp-punkt /Status pärib helitugevuse ja taasesituse teavet. See päring tagastab palju vastuse atribuute,
millest mõned ei ole käesoleva dokumendi puhul kohaldatavad. Dokumenteerimata vastuseid tuleks ignoreerida.
Taotlus
/Status?timeout=sekundid&etag=etag- väärtus
| Parameetrid | Kirjeldus |
| ajalõpp | Valikuline parameeter, mida kasutatakse pika küsitluse korral. Soovitatav küsitlusintervall on 100 sekundit ja see peaks olema piiratud umbes 60 sekundiga ning mitte kunagi kiirem kui 10 sekundit. |
| etag | Valikuline parameeter, mida kasutatakse pika küsitluse korral. See on etag atribuut alates |
| Parameetrid | Kirjeldus |
| eelmise /Status kõne vastus. |
Vastus
<status etag=”4e266c9fbfba6d13d1a4d6ff4bd2e1e6″>
÷ (Luksuslik)
Ed Sheeran
tõsi
1
159
Deezer:142986206
/Artwork?service=Deezer&songid=Deezer%3A142986206
0
187
1
Täiuslik
1054
0
320000
2
Deezer
/Allikad/pildid/DeezerIcon.png
0
8
19
paus
MP3 320 kb/s
5
Täiuslik
Ed Sheeran
÷ (Luksuslik)
263
4
35
MÄRKUS. Järgmises tabelis pole loetletud kõiki vastuse atribuute. Võivad esineda ka muud elemendid, mida tuleks ignoreerida.
| Vastuse atribuudid | Kirjeldus |
| etag | Vastuse juurelemendi atribuut. Läbipaistmatu väärtus, mida kasutatakse pika küsitluse korral vastuse muutuste tuvastamiseks. Kui väärtus pole eelmisest vastusest saadik muutunud, siis on garanteeritud, et vastus pole muutunud (kuid vt ka allpool olevaid sektsioone). |
| äratussekundid alles | Kui taasesitus on alarmi tulemus, siis see näitab, mitu sekundit enne taasesituse peatumist möödub. |
| tegevust | Kirjelduse leiate jaotisest Raadiojaamade voogesituse toimingud. |
| album | Praeguse aktiivse loo albumi nimi. Vaata ka atribuuti title1. |
| kunstnik | Praeguse aktiivse loo esitaja nimi. Vaata ka atribuuti title1. |
| aku | Kuvatakse, kui mängijal on aku. Sisaldab atribuute: · tase – laetuse tase, protsent · laadimine – 1, kui laeb parasjagu · ikoon – URL mängija pildist, mis näitab praegust laadimisolekut |
|
canMovePlayback |
On tõene, kui praegu esitatavat või peatatud sisu on võimalik teisele pleierile teisaldada. |
|
canSeek |
Kui 1, siis on võimalik praegust rada sirvida vahemikus 0..totlen, kasutades seek-parameetrit käsule /Play. Näiteksample: /Esita?otsing=34. |
| db | Helitugevuse tase dB-des. |
| grupi nimi | Grupi nimi. Mängija peab olema grupi peamine mängija. |
| grupi maht | Grupi helitugevus. Mängija peab olema grupi peamine mängija. |
| pilt | URL praeguse heliga (album, jaam, sisend jne) seotud pildist. Kui |
| Vastuse atribuudid | Kirjeldus |
| a URL algab /Artwork-iga, võib see põhjustada ümbersuunamise. Parameetri/võtme lisamine järgige ümbersuunamisi=1 pildi toomisel saab ümbersuunamist vältida. | |
| vaigista | Vaigistatud olek. Määrake väärtuseks 1, kui heli on vaigistatud. |
| muteDb | Kui mängija on vaigistatud, siis see sisaldab vaigistamata helitugevust detsibellides. |
| vaigista helitugevus | Kui heli on vaigistatud, siis see sisaldab vaigistamata helitugevuse taset. Väärtused on vahemikus 0 kuni 100. |
| nimi | Praegu esitatava heliriba pealkiri. Vaata ka atribuuti title1. |
| teatamaurl | URL hüpikteate jaoks. |
| id | Unikaalne esitusjärjekorra ID. See vastab /Playlist vastuse ID atribuudile. Kui esitusjärjekorda muudetakse, muutub ka see number. |
| vabaneda | Unikaalne eelseadistuse ID. See vastab /Presets vastuses olevale prid-atribuudile. Eelseadistuse muutmisel muutub see number, mis näitab, et kõik vahemällu salvestatud vastused /Presetsile tuleks kustutada. |
| kvaliteet | Esitava allika heli kvaliteet: · cd – kadudeta heli CD-kvaliteediga · hd – kadudeta heli, mille eraldusvõime on kõrgem kui CD-kvaliteedil või sample- kiirus 88200 samples/s või rohkem · dolbyAudio – DolbyDigital või AC3 · mqa – kehtiv MQA heli dekodeeritud · mqaAuthored – kehtiv MQA-autoriseeritud heli dekodeerimine Numbriline väärtus on tihendatud heliallika kvaliteedi ligikaudne bitikiirus. file. |
|
korda |
0, 1 või 2. 0 tähendab kordusesituse järjekorda, 1 tähendab loo kordamist ja 2 tähendab korduse väljalülitamist. |
| sek | Praeguse heliriba esitamise kestus sekundites. Seda väärtust ei kasutata e arvutamisel.tag Ja edenemine iseenesest ei põhjusta pika küsitluskõne tulemust. Kliendid peavad taasesituse positsiooni suurendama, kui olek on esitamine või voogesitus, vastavalt vastusest möödunud intervallile. |
| teenust | Praeguse heli teenuse ID. See ei ole kasutajaliideses kuvatav väärtus, kuna |
| Vastuse atribuudid | Kirjeldus |
| Tegelik string võib erineda ametlikust teenuse nimest. | |
| teenuseikoon | URL praeguse teenuse ikooni. |
| segada | 0 või 1. 0 tähendab juhusliku esituse väljalülitamist ja 1 juhusliku esituse sisselülitamist. |
| magama | Unetaimeri aktiveerumiseni jäänud minutid. |
| laul | Praeguse loo asukoht esitusjärjekorras. Vaata ka voogu.Url. |
| olek | Praegune mängija olek. See võib olla esitamine, paus, stopp, voogesitus, ühenduse loomine jne. Käsku /Play saab kasutada jätkamiseks pausi ajal, aga mitte stop-olekus. Sõnu „esitus“ ja „voog“ tuleks pidada samaks. Vaata ka „voog“Url. |
|
jaamapilt |
URL raadiojaama pildi puhul, kui praegune heli on raadiojaam, nt Deezeri raadio. See võib olla sama mis pilt. |
| voo vorming | Helifaili vorming. |
| ojaUrl | Selle elemendi olemasolu tuleks käsitleda lipuna ja selle sisu läbipaistmatu väärtusena. Kui see on olemas, näitab see: · esitusjärjekord ei ole praeguse heli allikas (lugu pole oluline) · juhuslik ja korduv esitamine ei ole asjakohased ja tuleks võimalusel kasutajaliidesest eemaldada · Järgmine ja eelmine pole saadaval (kuid vaata ka toiminguid) |
| sünkroniseerimineStat | Unikaalne ID, mis tähistab /SyncStatus vastuse muudatusi. See vastab /SyncStatus vastuse syncStat atribuudile. See muutub iga kord, kui sünkroonimisolekus toimub muutus. |
| pealkiri1 | Praegust heli kirjeldav esimene teaberida. pealkiri1, pealkiri2 ja pealkiri3 PEAB olema iga kasutajaliidese tekstiks, mis kuvab kolm rida praegu esitatava metaandmeid. Ärge kasutage selliseid väärtusi nagu album, esitaja ja nimi. |
| pealkiri2 | Teine teaberida, mis kirjeldab praegust heli. |
| pealkiri3 | Kolmas teaberida, mis kirjeldab praegust heli. |
| Totlen | Praeguse loo kogupikkus sekundites. |
| kaherealine_pealkiri1 | Esimene kahest reast, mis kirjeldavad praegust heli. twoline_title1 ja twoline_title2, kui need on olemas, PEAVAD olema iga kasutajaliidese tekstiks, mis kuvab kahte |
| Vastuse atribuudid | Kirjeldus |
| praegu mängivate metaandmete read. | |
| kaherealine_pealkiri2 | Teine kahest reast, mis kirjeldab praegust heli. |
| maht | Mängija helitugevuse tase protsentidestage; -1 tähendab, et mängija helitugevus on fikseeritud. |
| sek | Praeguse heliriba esitamise kestus sekundites. |
Example
http://192.168.1.100:11000/Status
Saab teada pleieri taasesituse oleku.
http://192.168.1.100:11000/Status?timeout=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Hangib mängija taasesituse oleku pika küsitluse abil. Tulemus tagastatakse enne 100-sekundilise aegumise möödumist ainult siis, kui mängija olek on muutunud. Vastasel juhul tagastatakse tulemus 100 sekundi pärast.
2.2 Mängija ja grupi sünkroonimise olek
Kirjeldus
Päring SyncStatus tagastab mängija ja mängijate grupeerimise teabe. See päring tagastab palju vastuse atribuute, millest mõned ei ole selle dokumendi puhul rakendatavad. Dokumenteerimata vastuseid tuleks ignoreerida.
Taotlus
/SyncStatus?timeout=sekundid&etag=etag- väärtus
| Parameetrid | Kirjeldus |
| ajalõpp | Valikuline parameeter, mida kasutatakse pika küsitluse korral. See on küsitlusintervall sekundites. Soovitatav küsitlusintervall on 180 sekundit. |
| etag | Valikuline parameeter, mida kasutatakse pika küsitluse korral. See on etag atribuut eelmisest /SyncStatus kutse vastusest. |
Vastus
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″ brand=”Bluesound” etag=”23″ väljundtase=”-62.9″ schemaVersion=”25″ initsialiseeritud=”true” group=”PULSE-0278 + 2″ syncStat=”23″ id=”192.168.1.100:11000″ mac=”90:56:82:9F:02:78″> 11000
…..
MÄRKUS: järgmises tabelis pole loetletud kõiki vastuse atribuute. Võivad esineda ka muud elemendid, mida tuleks ignoreerida.
| Vastuse atribuudid | Kirjeldus |
| aku | Kuvatakse, kui mängijal on aku. Sisaldab atribuute: · tase – laetuse tase, protsent · laadimine – 1, kui laeb parasjagu · ikoon – URL mängija pildist, mis näitab praegust laadimisolekut |
| kaubamärk | Mängija brändinimi. |
| db | Helitugevuse tase dB-des. |
| etag | Tag /SyncStatus vastusest, mida kasutatakse pika küsitluse jaoks. |
| rühm | Grupi nimi. |
| ikooni | URL mis sisaldab mängija ikooni pilti. |
| id | Mängija IP ja port. |
| initsialiseeritud | „True“ tähendab, et mängija on juba seadistatud, „false“ tähendab, et mängija vajab seadistamist. Mängija tuleb seadistada BluOS Controller rakendusega. |
| mac | Mängija unikaalne võrguliidese ID. Võib olla MAC-aadress. |
| meister | Peamängija IP-aadress. Kuvatakse ainult siis, kui mängija on grupis teisejärguline mängija. Atribuudid: · port – pordi number. · taasühendamine – tõene, kui proovite peamise mängijaga uuesti ühendust luua |
| mudel | Mängija mudeli ID. |
| mudeli nimi | Mängija mudeli nimi. |
| vaigista | Kui heli on vaigistatud, määrake väärtuseks 1. |
| muteDb | Kui mängija on vaigistatud, siis on see vaigistamata helitugevuse tase detsibellides. |
| Vastuse atribuudid | Kirjeldus |
| vaigista helitugevus | Kui mängija on vaigistatud, siis on see vaigistuseta helitugevuse tase (0..100). |
| nimi | Mängija nimi. |
| skeemiversioon | Tarkvara skeemi versioon. |
| ori | Teisese mängija(te) IP-aadressid. Esinevad ainult siis, kui mängija on grupi peamine mängija. Teisese mängijana võib olla mitu mängijat. Atribuudid: · id – IP-aadress · port – pordi number |
|
sünkroniseerimineStat |
sünkroonimisoleku ID. See muutub iga kord, kui mõni /SyncStatus vastuses olev üksus muutub. Sobib kokku element vastuses /Status. |
| maht | Helitugevuse tase skaalal 0..100. -1 tähendab fikseeritud helitugevust. |
| tsooni | Fikseeritud rühma nimi. |
| ZoneMaster | Kui mängija on fikseeritud grupi peamine mängija, määratakse see väärtuseks tõene. |
| tsooniori | Kui mängija on fikseeritud grupis teisejärguline mängija, määratakse selle väärtuseks „true“. |
Example
http://192.168.1.100:11000/SyncStatus
Hangib mängija ja mängija grupi staatuse.
http://192.168.1.100:11000/SyncStatus?timeout=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Hangib mängija ja mängija grupi staatuse pika küsitluse abil. Tulemus tagastatakse enne 100-sekundilise aegumise möödumist ainult siis, kui mängija staatus on muutunud. Vastasel juhul tagastatakse tulemus 100 sekundi möödudes.
Helitugevuse juhtimine
Reguleerib mängija helitugevust. Kasutatakse ka mängija vaigistamiseks.
3.1 Helitugevuse määramine
Kirjeldus
See päring pärib või määrab mängija helitugevuse.
Kõik käsuvariandid, olenemata sellest, kas kasutatakse taseme parameetreid 0..100, absoluutset dB või suhtelist dB, on piiratud väärtustega, mis viivad tasemeni konfigureeritud saadaolevas helitugevuse vahemikus, mis on tavaliselt -80..0. Helitugevuse vahemikku saab reguleerida BluOS Controller rakenduse abil lehel Seaded -> Mängija -> Heli.
Päring toetab pikka küsitlust (pole allpool illustreeritud).
Taotlus
/ Köide
/Helitugevus?tase=tase&tell_slaves=on_off
/Helitugevus?vaigista=on_off&tell_slaves=on_off
/Helitugevus?abs_db=db&tell_slaves=on_off
/Helitugevus?db=delta-db&tell_slaves=on_off
| Parameetrid | Kirjeldus |
| tasemel | Määrake pleieri absoluutne helitugevus. See on täisarv vahemikus 0–100. |
| tell_slaves | Kehtib grupis olevate mängijate kohta. Kui see on seatud väärtusele 0, muudab ainult hetkel valitud mängija helitugevust. Kui see on seatud väärtusele 1, muudavad helitugevust kõik grupi mängijad. |
| vaigista | Kui see on seatud väärtusele 0, on mängija vaigistatud. Kui see on seatud väärtusele 1, on mängija vaigistus tühistatud. |
| abs_db | Seadke helitugevus dB-skaala abil. |
| db | Arvutage suhteline helitugevuse muutus dB helitugevuse skaala abil. db võib olla positiivne või negatiivne arv. |
Vastus
<volume db=”-49.9″ mute=”0″ offsetDb=”0″ etag=”6213593a6132887e23fe0476b9ab2cba”>15</volume>
| Vastuse atribuudid | Kirjeldus |
| Vastuse atribuudid | Kirjeldus |
| db | Helitugevuse tase dB-des. |
| vaigista | 1, kui mängija on vaigistatud, 0, kui mängija vaigistus on tühistatud. |
| muteDb | Kui mängija on vaigistatud, siis on see vaigistamata helitugevuse tase detsibellides. |
| vaigista helitugevus | Kui mängija on vaigistatud, siis on see vaigistuseta helitugevuse tase (0..100). |
| maht | Praegune helitugevus: 0..100 või -1 fikseeritud helitugevuse korral. |
Example
http://192.168.1.100:11000/Volume?level=15
Määrab mängija helitugevuse tasemeks 15 (100-st).
http://192.168.1.100:11000/Volume? tell_slaves=1&db=2
Suurendab peamängija 192.168.1.100 ja kõigi selle grupi teiseste mängijate helitugevust 2 dB võrra.
http://192.168.1.100:11000/Volume?mute=1
Vaigistab mängija.
3.2 Helitugevuse suurendamine
Kirjeldus
See päring suurendab helitugevust teatud dB võrra (tüüpiline väärtus on 2 dB).
Taotlus
/Helitugevus?db=db_väärtus
| Parameetrid | Kirjeldus |
| db | Helitugevuse suurendamise sammud dB-des (tüüpiline väärtus 2dB) |
Vastus
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>
| Vastuse atribuudid | Kirjeldus |
| db | Helitugevuse tase dB-des. |
| vaigista | 1, kui mängija on vaigistatud, 0, kui mängija pole vaigistatud |
| Vastuse atribuudid | Kirjeldus |
| nihkedb | |
| etag |
Example
http://192.168.1.100:11000/Volume?db=2
Suurenda helitugevust 2 dB võrra.
3.3 Helitugevuse vähendamine
Kirjeldus
See päring vähendab helitugevust teatud dB võrra (tüüpiline väärtus on -2 dB).
Taotlus
/Helitugevus?db=-db_väärtus
| Parameetrid | Kirjeldus |
| db | Helitugevuse suurendamise sammud dB-des (tüüpiline väärtus -2dB) |
Vastus
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>
| Vastuse atribuudid | Kirjeldus |
| db | Helitugevuse tase dB-des |
| vaigista | 1, kui mängija on vaigistatud, 0, kui mängija pole vaigistatud |
| nihkedb | |
| etag |
Example
http://192.168.1.100:11000/Volume?db=-2
Vähendage helitugevust 2 dB võrra.
3.4 Vaigistus sees
Kirjeldus
Taotlus
/Helitugevus?vaigista=1
| Parameetrid | Kirjeldus |
| vaigista | Mängija vaigistamiseks määrake väärtuseks 1 |
Vastus
<volume muteDb=”-43.1″ db=”100″
muteVolume=”11”
vaigista = ”1”
offsetDb=”0”
etag=”2105bed56563d9da46942a696cfadd63″>0</volume
>
| Vastuse atribuudid | Kirjeldus |
| muteDb | Helitugevuse tase dB-des enne vaigistamist |
| db | Helitugevuse tase dB-des |
| vaigista helitugevus | Helitugevuse tase protsentides enne vaigistamist |
| vaigista | 1 tähendab, et mängija on vaigistatud |
| nihkedb | |
| etag |
Example
http://192.168.1.100:11000/Volume?mute=1
3.5 Vaigistus väljas
Kirjeldus
See päring lülitab mängija vaigistuse välja.
Taotlus
/Helitugevus?vaigista=0
| Parameetrid | Kirjeldus |
| vaigista | Mängija vaigistuse tühistamiseks määrake väärtuseks 0 |
Vastus
<volume db=”-43.1″ mute=”0″ offsetDb=”0″ etag=”e72d53db17baa526ebb5ee9c26060b1f”>11</volume>
| Vastuse atribuudid | Kirjeldus |
| db | Helitugevuse tase dB-des |
| vaigista | 0 tähendab, et mängija pole vaigistatud |
| nihkedb | |
| etag |
Example
http://192.168.1.100:11000/Volume?mute=0
Taasesituse juhtimine
Neid käske kasutatakse taasesituse põhijuhtimiseks. Käskude hulka kuuluvad esitamine, paus, stopp, vahelejätmine, tagasikerimine, juhuesitamine ja kordamine.
4.1 Mängi
Kirjeldus
Alusta praeguse heliallika taasesitust. Valikulised parameetrid võimaldavad enne heli taasesituse alustamist hüpata heliradadele ja valida sisendi.
Taotlus
/Esita
/Esita?otsing=sekundit
/Esita?otsing=sekundid&id=rajaid
/Mängima?url=kodeeritudVoogURL
| Parameetrid | Kirjeldus |
| otsima | Hüppa praeguse loo määratud positsioonile. Kehtib ainult siis, kui /Status vastus sisaldab Ei saa kasutada koos inputType ja index parameetritega. |
| kodeeritud voogURL | URL voogedastusega kohandatud helist. See peab olema URL kodeeritud. |
Vastus
mäng
oja
| Vastuse atribuudid | Kirjeldus |
|
olek |
Käsu täitmisjärgne olek. Lisateavet leiate vastuse oleku atribuudilt /Status. |
Example
http://192.168.1.100:11000/Play
Alusta praeguse loo heli taasesitust.
http://192.168.1.100:11000/Play?seek=55
Alusta heli taasesitust praeguse loo 55. sekundist.
http://192.168.1.100:11000/Play?seek=55&id=4
Alusta heli taasesitust järjekorras oleva loo number 55 5 sekundist.
192.168.1.125:11000/Mängi?url=https%3A%2F%2Fwww%2Esoundhelix%2Ecom%2Fexamples%2Fmp3%
2FSoundHelix-Song-1%2Emp3
Alusta veebipõhise mp3-heli taasesitust.
4.2 Paus
Kirjeldus
Praeguse esitatava heli peatamine.
Kui äratus mängib ja sellel on ajalõpp, siis äratuse ajalõpp tühistatakse.
Taotlus
/Paus
/Paus?lülita=1
| Parameetrid | Kirjeldus |
| lüliti | Kui see on seatud väärtusele 1, siis lülitatakse praegune pausi olek sisse/välja. |
Vastus
paus
| Vastuse atribuudid | Kirjeldus |
| olek | Käsu täitmisjärgne olek. Lisateavet leiate vastuse oleku atribuudilt /Status. |
Example
http://192.168.1.100:11000/Pause
Peatab hetkel esitatava heli.
4.3 Peatus
Kirjeldus
Peata praegune esitatav heli. Kui äratus mängib ja sellel on ajalõpp, siis äratuse ajalõpp tühistatakse. Taotlus
/Stopp
| Parameetrid | Kirjeldus |
| Mitte ühtegi |
Vastus
peatus
| Vastuse atribuudid | Kirjeldus |
| olek | „Stopp” tähendab, et praegune heli on peatatud. |
Example
http://192.168.1.100:11000/Stop
Peatab hetkel esitatava heli.
4.4 Jäta vahele
Kirjeldus
Liigu esitusjärjekorras järgmise heliraja juurde
Esitusjärjekorrast esitamisel hüppab seade järjekorras olevale järgmisele loole. Kui praegune lugu on järjekorras viimane, siis /Skip kutsumine liigub järjekorra esimesele loole. See hüppab järjekorras olevale järgmisele või esimesele loole olenemata kordusseade olekust.
Selleks, et teha kindlaks, kas kasutate esitusjärjekorda, veenduge, et seal poleks ühtegiUrl> kirje vastuses /Status.
Seejärel saate kasutada käsku /Skip.
Samuti saate mõnede voogedastusraadiojaamade lugusid vahele jätta. Seda saab teha käsuga /Action.
Mõned allikad, näiteks TuneIn ja optiline sisend, ei toeta vahelejätmise valikut. Nendel allikatel onURL> kirje, aga vastuses /Status puudub vahelejätmise toimingu nimi.
Taotlus
/Vahele jätma
| Parameetrid | Kirjeldus |
| Mitte ühtegi |
Vastus
21
| Vastuse atribuudid | Kirjeldus |
| id | Loo ID pärast vahelejätmiskäsu käivitamist. Üksikasju vaadake vastuse loo atribuudi /Status alt. |
Example
http://192.168.1.100:11000/Skip
Liikuge järgmise loo juurde.
4.5 Tagasi
Kirjeldus
Kui lugu mängib ja on mänginud kauem kui neli sekundit, siis naaseb süsteem loo algusesse.
Vastasel juhul liigub tagasi-käsklus praeguse esitusloendi eelmise loo juurde. Kui olete esitusloendi esimesel lool, liigub tagasikutsumine viimase loo juurde. See liigub järjekorras eelmise või esimese loo juurde olenemata kordusseade olekust.
Selleks, et teha kindlaks, kas kasutate esitusjärjekorda, veenduge, et seal poleks ühtegiUrl> element vastuses /Status.
Seejärel saate kasutada käsku /Back.
Samuti saate mõnede voogedastusraadiojaamade lugusid tagasi kerida. Seda saab teha käsuga /Action.
Mõned allikad, näiteks TuneIn ja optiline sisend, ei toeta tagasi-valikut. Nendel allikatel onUrl> element, aga /Status vastuses puudub vahelejätmise toimingu nimi.
Taotlus
/Tagasi
| Parameetrid | Kirjeldus |
| Mitte ühtegi |
Vastus
19
| Vastuse atribuudid | Kirjeldus |
| id | Loo ID pärast tagasi-käsu käivitamist. Üksikasju vaadake vastuse loo atribuudi /Status alt. |
4.6 Juhuesitus
Kirjeldus
Käsk shuffle loob uue järjekorra praeguse järjekorra segamise teel. Algne (mitte segatud) järjekord säilitatakse taastamiseks, kui segamine on keelatud.
Taotlus
/Shuffle?state=0|1
| Parameetrid | Kirjeldus |
| olek | · 0 juhuesituse keelamiseks · 1 segamisrežiimi lubamiseks. Sellel pole mingit mõju, kui järjekord on juba segamisrežiimis. Vaadake /Status vastust element. |
Vastus
| Vastuse atribuudid | Kirjeldus |
| muudetud | 1 tähendab, et järjekorda on pärast laadimist muudetud. 0 tähendab, et mitte. |
| pikkus | Praeguses järjekorras olevate lugude koguarv. |
| segada | Segamisolek. 1 tähendab, et praegust järjekorda segatakse. 0 tähendab, et praegust järjekorda ei segata. |
| id | Praeguse järjekorra ID. See muutub iga kord, kui esitusjärjekorda muudetakse. |
Example
http://192.168.1.100:11000/Shuffle?state=1
Segab praegust esitusjärjekorda.
4.7 Korda
Kirjeldus
Määrab kordusvalikud. Kordusel on kolm olekut; 0 tähendab praeguse järjekorra kordamist, 1 tähendab praeguse loo kordamist ja 2 tähendab kordamata jätmist. Kõik kordused on määramata pikkusega, st need ei lõpe.
Taotlus
/Korda?olek=0|1|2
| Parameetrid | Kirjeldus |
| olek | · 0 kogu esitusjärjekorra kordamiseks · 1 praeguse loo kordamiseks · 2 korduse väljalülitamiseks |
Vastus
| Vastuse atribuudid | Kirjeldus |
| pikkus | Praeguses esitusjärjekorras olevate lugude koguarv. |
| id | Praeguse järjekorra ID. See muutub iga kord, kui esitusjärjekorda muudetakse. |
| korda | Praegune korduse olek. |
Example
http://192.168.1.100:11000/Repeat?state=1
Kordab praegu esitatavat lugu.
4.8 Raadiojaamade voogesituse toimingud
Kirjeldus
Toimingud võimaldavad teil valitud voogedastusraadiojaamades, näiteks Slackeris, Radio Paradise'is või Amazon Music Prime Stationsis, lugusid edasi-tagasi hüpata, lemmikuks märkida ja keelata. Voogedastusraadiojaamad ei laadi lugusid esitusjärjekorda. Selle asemel pakuvad nad... URL mida saate kasutada soovitud funktsiooni täitmiseks.
Nupp „Skip” liigub järgmise loo juurde. Nupp „Back” liigub eelmise loo juurde. Nupp „Love” märgib loo muusikateenuses meeldivaks. Nupp „Ban” hüppab järgmise loo juurde ja märgib loo muusikateenuses mittemeeldivaks.
Kui on olemasUrl> kirje /Status vastuses ja sobiva toimingu abil saate neid funktsioone täita. Toiming sisaldab URL mida kasutatakse toimingu sooritamiseks.
Siin on endineampSlackeri raadiot mängiva mängija /Status vastuse fail:
<action name=”skip” url=”/Tegevus?teenus=Slacker&skip=4799148″/>
<action icon=”/images/loveban/love.png” name=”love” notification=”Track marked as favorite” state=”1″ text=”Love” url=”/Action?service=Slacker&love=4799148″/>
<action icon=”/images/loveban/ban.png” name=”ban” notification=”Track banned from this
jaam” olek = ”-1” tekst = ”Keeld” url=”/Tegevus?teenus=Slacker&keeld=4799148″/>
Selles eksampLe, tagasi pole saadaval, aga vahelejätmine, armastamine ja keelamine on võimalikud.
Taotlus
/Action?service=teenuse-nimi&action=action-URL
Märkus. Konkreetsed päringu üksikasjad (lõpp-punkt ja parameetrid) on antud vastavate element. Käsklused Ex-isampAllolev jaotis kasutab alati /Action, kuid võimalik on iga URI.
| Parameetrid | Kirjeldus |
| Pakutakse element. |
Vastus
Vastuse eest saate tegevuse kinnituse. Vahelejätmise ja tagasiliikumise eest saate:
Armastuse eest, mida sa saad:
1
Keelu eest saate:
1
| Vastuse atribuudid | Kirjeldus |
| vastuseks | Kui vastuse juurelement on siis on tekstisõlm kasutajale kuvatav teade. Kui tagastatakse alternatiivne juurelement ja kui see sisaldas teavituse atribuuti, peaks see teatis kuvatama. |
Example
http://192.168.1.100:11000/Action?service=Slacker&skip=10965139
Hüppab järgmise Slackeri raadio loo juurde.
http://192.168.1.100:11000/Action?service=Slacker&ban=33332284
Keelab hetkel mängiva Slackeri raadio loo ja hüppab järgmise loo juurde.
Mängujärjekorra haldamine
Üks mängija töörežiimidest on lugude laadimine esitusjärjekorda ja seejärel lugude esitamine sellest esitusjärjekorrast. Need käsud võimaldavad teil view ja halda esitusjärjekorda.
5.1 Lugude loend
Kirjeldus
Tagasta kas esitusjärjekorra olek või teave kõigi esitusjärjekorras olevate lugude kohta.
Seda päringut ei ole soovitatav kasutada ilma pikkuse või algus- ja lõppparameetriteta, kuna vastasel juhul võib tekkida väga pikk vastus.
Taotlus
/Esitusloend
/Esitusloendi?pikkus=1
/Playlist?start=first&end=last (otsib osa järjekorrast, tavaliselt lehekülgede nummerdamiseks)
| Parameetrid | Kirjeldus |
| pikkus=1 | Tagasta ainult tipptaseme atribuudid ja mitte loo üksikasju. |
| alustada | Esimene kirje järjekorras, mis vastusesse lisatakse, alates 0-st. |
| lõppu | Viimane kirje järjekorras, mis vastusesse lisatakse. |
Vastus
Esitusjärjekorra oleku jaoks:
13
243
1
Esitusjärjekorra loendi jaoks:
2002. aastal
Anne-Marie
2002. aastal
Deezer:487381362
| Vastuse atribuudid | Kirjeldus |
| nimi | Praeguse esitusjärjekorra nimi. |
| muudetud | 0 tähendab, et järjekorda pole pärast laadimist muudetud. 1 tähendab, et järjekorda on pärast laadimist muudetud. |
| pikkus | praeguses järjekorras olevate lugude koguarv |
| id | praeguse järjekorra oleku unikaalne ID (nt 1054). See on sama mis vastuses /Staatus. |
| laul | Laul koosneb mitmest alamelemendist: · albumid = albumi ID, millel lugu asub · teenus = loo muusikateenus · artistid = loo esitaja ID · laulu id = laulu id · id = loo positsioon praeguses järjekorras. Kui lugu on hetkel valitud, on loo ID sama, mis vastuses /Staatus. · pealkiri = loo nimi · kunst = kunstniku nimi · alb = albumi nimi |
Example
http://192.168.1.100:11000/Playlist
Loetleb kõik esitusjärjekorras olevad lood.
http://192.168.1.100:11000/Playlist?length=1
5.2 Raja kustutamine
Kirjeldus
Eemalda pala praegusest esitusjärjekorrast.
Taotlus
/Kustuta?id=positsioon
| Parameetrid | Kirjeldus |
| id | Praegusest esitusjärjekorrast kustutatava loo ID. |
Vastus
9
| Vastuse atribuudid | Kirjeldus |
| kustutatud | Eemaldatava loo positsioon järjekorras. |
Example
http://192.168.1.100:11000/Delete?id=9
Eemaldab loo esitusjärjekorra 9. positsioonilt.
5.3 Raja liigutamine
Kirjeldus
Liiguta lugu praeguses esitusjärjekorras.
Taotlus
/Move?new=sihtkoht&old=original
| Parameetrid | Kirjeldus |
| uus | Uus asukoht rajal teisaldatakse. |
| vana | Teisaldatava raja vana asukoht. |
Vastus
kolis
| Vastuse atribuudid | Kirjeldus |
| liigutatud | Näitab, et rada on liigutatud. |
Example
http://192.168.1.100:11000/Move?new=8&old=2
Liiguta lugu esitusjärjekorras positsioonilt 2 positsioonile 8.
5.4 Tühjenda järjekord
Kirjeldus
Tühjenda kõik lood praegusest esitusjärjekorrast
Taotlus
/Selge
| Parameetrid | Kirjeldus |
| Mitte ühtegi |
Vastus
| Vastuse atribuudid | Kirjeldus |
| muudetud | 0 tähendab, et järjekorda pole pärast laadimist muudetud, 1 tähendab, et järjekorda on pärast laadimist muudetud. |
| pikkus | Praeguses järjekorras olevate lugude koguarv. |
| id | Praeguse järjekorra unikaalne ID. |
Example
http://192.168.1.100:11000/Clear
See eemaldab kõik lood esitusjärjekorrast.
5.5 Salvesta järjekord
Kirjeldus
Salvesta esitusjärjekord nimega BluOS-i esitusloendina.
Taotlus
/Salvesta?nimi=esitusloendi_nimi
| Parameetrid | Kirjeldus |
| nimi | Salvestatud esitusjärjekorra nimi. |
Vastus
126
| Vastuse atribuudid | Kirjeldus |
| sissekanded | Salvestatud esitusjärjekorra lugude koguarv. |
Example
http://192.168.1.100:11000/Save?name=Dinner+Music
See salvestab esitusjärjekorra nimega „Õhtusöögimuusika”.
Eelseaded
Eelseadete päringud võimaldavad teil loetleda kõik pleieri eelseaded, laadida eelseadet ja eelseadete vahel liikuda. Eelseadeid tuleb lisada ja kustutada BluOS Controller rakenduse abil. Eelseaded võivad sisaldada raadiojaamu, esitusloendeid ja sisendeid (nt
Bluetooth, analoog, optiline, HDMI ARC).
6.1 Eelseadistuste loend
Kirjeldus
Loetle kõik praeguse BluOS-pleieri eelseadistused.
Taotlus
/Eelseadistused
| Parameetrid | Kirjeldus |
| Mitte ühtegi |
Vastus
<preset id=”6″ name=”Serenity” url=”RadioParadiis:/42:4/Rahu”
image=”https://img.radioparadise.com/channels/0/42/cover_512x512/0.jpg”/>
<preset id=”7″ name=”1980s Alternative Rock Classics” url=”/Laadi?teenus=Loode&id=fd3f797e-
a3e9-4de9-a1e2-b5adb6a57cc7″ image=”/Artwork?service=Tidal&playlistimage=afacfc12-24034caf-a5c5-a2af28d811c8″/> </presets>
| Vastuse atribuudid | Kirjeldus |
| uhkus | Mängija eelseadete unikaalne ID. See on sama mis vastuses /Staatus. |
| nimi | Eelseadistatud nimi. |
| id | Eelseadistatud ID. |
| url | Eelseade URLSee on eelseadistatud allikas. URL kasutatakse eelseadistuse laadimiseks. |
| pilt | Pilt URL eelseadistusest. Kui URL algab /Artwork-iga, võib see põhjustada ümbersuunamise. Parameetri/võtme lisamine järgige ümbersuunamisi=1 pildi toomisel saab ümbersuunamist vältida. |
Example
http://192.168.1.100:11000/Presets
Loetlege kõik pleieri eelseadistused.
6.2 Eelseadistuse laadimine
Kirjeldus
Alustab eelhäälestatud jaama esitamist. Saate valida konkreetse eelhäälestatud jaama numbri ning ka järgmise või eelmise eelhäälestatud jaama numbrid ei pea olema järjestikused, st teil võivad olla eelhäälestused 1,2,3, 5, 7, 8, XNUMX ja XNUMX. Eelhäälestused korduvad ülevalt alla ja alt üles.
Taotlus
/Eelseadistus?id=eelseadistuseId|-1|+1
| Parameetrid | Kirjeldus |
| id | Laaditava eelseadistuse ID-number. Saadaval olevate eelseadistuste ID-de loendi leiate käsuga „Kuva eelseadistused”. Kui eelseadistuse ID on +1, laaditakse järgmine eelseadistus. Kui eelseadistuse ID on -1, laaditakse eelmine eelseadistus. |
Vastus
Kui eelseadistus on lugude loend, tagastab see laaditud eelseadistuse lugude arvu.
60
Kui eelseadistus on raadio, tagastab see voogesituse oleku.
oja
| Vastuse atribuudid | Kirjeldus |
| teenust | laaditud eelseadistuse teenuse nimi |
| sissekanded | laaditud eelseadistuse lugude arv |
Example
http://192.168.1.100:11000/Preset?id=4
Laadige eelseadistus eelseadistuse ID-ga 4.
http://192.168.1.100:11000/Preset?id=+1
Sisu sirvimine ja otsimine
See jaotis kirjeldab muusikateenuste sisu sirvimise ja otsimise käske.
7.1 Muusikasisu sirvimine
Kirjeldus
Navigeerige saadaolevate muusikaallikate, sisendite ja esitusloendite vahel.
Vastuste juurelement on välja arvatud juhul, kui ilmneb veavastus. Enamik tulemusi on järjestikused Mõnel juhul on tulemuseks jada , millest igaüks sisaldab järjestust, kui Kõik väärtused on esitatud atribuutide abil. Tekstisõlmi pole.
/Browse-käsu tulemuseks võib olla viga, mis on ümbritsetud juurelement. Vea üksikasjad on esitatud ühes ja null või rohkem tekstisõlmed.
Taotlus
/Browse?key=võtme-väärtus
/Browse?key=võtme-väärtus&withContextMenuItems=1
| Parameetrid | Kirjeldus |
| võti | Valikuline parameeter. Selle parameetri puudumine toob kaasa ülataseme sirvimise. Tagastab teabe muude tasemete kohta peale ülataseme /Browse. Kasutab väärtust, mis on võetud varasema vastuse atribuudi „browseKey“, „nextKey“, „parentKey“ või „contextMenuKey“ väärtusest. Märkus: võtme väärtus peab olema URL kodeeritud |
| kontekstimenüü elementidega | Valikuline parameeter. Väärtus on alati 1. Seda parameetrit kasutatakse esitusloendite, albumite, lugude, jaamade, artistide jms sirvimistulemuste hankimisel tekstisisese kontekstimenüü saamiseks. |
Vastus
Ülemise taseme sirvimisvastus:
<item image=”/images/InputIcon.png” text=”Optical Input”
mängidaURL=”/Mängi?url=Capture%3Ahw%3A1%2C0%2F1%2F25%2F2%2Finput1″ inputType=”spdif”
tüüp = ”heli” />
Teise taseme sirvimisvastus:
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
teenus=”Deezer” otsinguvõti=”Deezer:Otsing” tüüp=”menüü”>
item browseKey=”/Playlists?service=Deezer&genre=0&category=toplist” text=”Populaarsed esitusloendid”
tüüp = ”link” />
tüüp = ”link” />
tüüp = ”link” />
item browseKey=”/Songs?service=Deezer&genre=0&category=toplist” text=”Populaarsed lood”
tüüp = ”link” />
| Vastuse atribuudid | Kirjeldus |
| Vaadake allolevaid elementide/atribuutide tabeleid |
Example
MÄRKUS. kõik võtmeparameetrid peavad olema UTF-8 kodeeringus.
http://192.168.1.100:11000/Browse
Kas teeb tipptasemel sirvimist.
http://192.168.1.100:11000/Browse?key=Tidal%3A
Teeb teise taseme sirvimise, tagastades loodete kategooriad.
http://192.168.1.100:11000/Browse?key=Tidal%3AmenuGroup%2F3
Teeb kolmanda taseme sirvimise, tagastades Tidal Mastersi (3. grupp) alamkategooriad.
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters
Teeb neljanda taseme sirvimise, tagastades Tidal Mastersi albumite esimese komplekti.
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters%26 start%3D30%26end%3D79
Teeb järjekordse neljanda taseme sirvimise, tagastades Tidal Mastersi albumite teise komplekti.
| Element | Atribuut (ja väärtused) | Kirjeldus | |
| teenuseikoon | Praegu sirvitava teenuse ikooni URI. | ||
| serviceName | Kasutajale kuvatav hetkel sirvitava teenuse nimi. | ||
| otsinguvõti | Väärtus, mida kasutatakse võtmeparameetrina päringule /Browse praeguse teenuse (või hierarhia sügavama osa) otsimiseks. Lisaks peab päring sisaldama parameeter aq, mis sisaldab otsinguterminit. | ||
| järgmineKey | Väärtus, mida kasutatakse võtmeparameetrina päringule /Browse, et saada praeguse toimingu järgmise lehe üksused. viewLehekülje tüki suurust ei saa API kasutaja kontrollida ja selle väärtuse päringuparameetreid ei tohiks proovida parsida ega manipuleerida. | ||
| vanemvõti | Väärtus, mida kasutatakse võtmeparameetrina päringule /Browse, et navigeerida hierarhias tagasi ülespoole, kui vaikimisi tagasinavigeerimine tuleks tühistada. | ||
| tüüp | menüü | Navigeerimissõlm, mis võib potentsiaalselt sisaldada mis tahes tüüpi elemente. Enamasti sisaldab see ainult linke või helielemente. | |
| kontekstimenüü | Määratud tüüpi üksuste loend. | ||
| kunstnikud | |||
| Element | Atribuut (ja väärtused) | Kirjeldus | |
| heliloojad | |||
| albumid | |||
| esitusloendid | |||
| rajad | |||
| žanrid | |||
| lõigud | Tähestikulises järjekorras jaotised. | ||
| esemed | Üldine tulemuste loend. Kõige sagedamini menüüpunktide (tüüp = ”link”) ja raadioüksuste (tüüp = ”audio”) segu. | ||
| kaustad | Võib sisaldada alamkaustu, lugusid ja esitusloendite kirjeid. | ||
| tekst | Kategooria suundumine. | ||
| järgmineKey | Väärtus, mida kasutatakse võtmeparameetrina päringule /Browse, et saada kategooria järgmise lehe üksused. | ||
| vanemvõti | Väärtus, mida kasutatakse võtmeparameetrina päringule /Browse, et navigeerida hierarhias tagasi ülespoole, kui vaikimisi tagasinavigeerimine tuleks tühistada. | ||
| tüüp | link | Sirvimishierarhias olev üldine sõlm, mis viib edasiste sõlmedeni | |
| heli | Sõlm, mida saab otse mängida | ||
| kunstnik | Kunstnikku esindav ese | ||
| Element | Atribuut (ja väärtused) | Kirjeldus | |
| helilooja | Heliloojat esindav ese | ||
| album | Albumit või sarnast kollektsiooni esindav objekt | ||
| esitusloend | Esitusloendit või sarnast kogumikku esindav üksus | ||
| rada | Üksiklugu esindav objekt | ||
| tekst | Lihtteksti sõlm. | ||
| osa | Tähestikuline jaotis. | ||
| kausta | Kaust kaustade sirvimisel. | ||
| tekst | Tootekirjelduse peamine või esimene rida | ||
| tekst2 | Teine rida | ||
| pilt | Üksuse ikoon või illustratsioon. Kui pilt algab
/Kunst võib põhjustada ümbersuunamise. Parameetri/võtme lisamine järgige ümbersuunamisi=1 pildi toomisel saab ümbersuunamist vältida. |
||
| sirvimisvõti | Väärtus, mida kasutatakse võtmeparameetrina järgneva /Browse päringu puhul hierarhias allapoole liikumiseks. | ||
| mängidaURL | URI, mida saab otse kutsuda kõnealuse üksuse vaikeesituse toimingu käivitamiseks. Tavaliselt on selleks järjekorra tühjendamine ja selle esitamise alustamine. | ||
| automaatesitusURL | URI, mida saab otse kutsuda loo lisamiseks järjekorda ja selle esitamiseks ning järgmiste lugude lisamiseks sisaldavast objektist (näiteks albumist) automaatse täitmise loendisse. | ||
| Element | Atribuut (ja väärtused) | Kirjeldus |
| esitusjärjekorra osa. | ||
| kontekstimenüü võti | Väärtus, mida kasutatakse päringu /Browse võtmeparameetrina, et saada tulemus, mis on üksusega seotud toimingute kontekstimenüü. | |
| tegevustURL | URI, mida saab määratud toimingu sooritamiseks otse kutsuda. |
Kontekstimenüü üksustel võivad atribuudi type väärtused olla järgmised.
| Atribuut | ||
| Kirjeldus | ||
| lemmik | -lisa | Lisa üksus lemmikute hulka (või samaväärsena) |
| -kustuta | Eemalda üksus kasutaja lemmikute hulgast | |
| lisada | Lisa esitusjärjekorda | |
| lisada | - nüüd | Lisa esitusjärjekorda praeguse loo järele ja esita kohe |
| -järgmine | Lisa esitusjärjekorda praeguse loo järele | |
| -viimane | Lisa esitusjärjekorra lõppu | |
| lisaKõik | - nüüd | Lisa mitme loo objekt esitusjärjekorda ja esita kohe |
| -järgmine | Lisa mitme loo objekt esitusjärjekorda pärast praegust lugu või mitme loo objekti | |
| -viimane | Lisa mitme loo objekt esitusjärjekorra lõppu | |
| playRadio | Esita esemega seotud raadiojaama | |
| kustutada | Kustuta objekt (tavaliselt esitusloend). Kasutajalt tuleks küsida kinnitust. |
Parameetriga „withContextMenuItem=1” sirvides kuvatakse tulemuses tekstisisest kontekstimenüüd.
Example
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26genre%3D0%26category %3Dtoplist&withContextMenuItems=1
Kas päring Deezer => Mis on kuum => Populaarsed albumid koos tekstisisese kontekstimenüüga.
Vastus
Vastus sisaldab tekstisisest iga eseme kohta.
<item text=”Essonne History X” contextMenuKey=”Deezer:contextMenu/Album?albumid=693798541″
mängidaURL=”/Lisa?teenus=Deezer&albumid=693798541&playnow=1″ pilt=”/Kunstiteos?teenus=Deezer&albumid=693798541″
browseKey=”Deezer:Album?artist=Ziak&album=Essonne%20History%20X&albumid=693798541″ text2=”Ziak” type=”album”>
<item text=”Favorite” type=”favourite-add” actionURL=”/AddFavourite?service=Deezer&albumid=693798541″/>
<item text=”Play now” type=”add-now”
tegevustURL=”/Lisa?teenus=Deezer&playnow=1&clear=0&shuffle=0&where=nextAlbum&albumid=693798541″/>
<item text=”Shuffle” type=”add-shuffle”
tegevustURL=”/Lisa?teenus=Deezer&shuffle=1&playnow=1&where=järgmineAlbum&albumid=693798541″/>
<item text=”Add next” type=”addAll-next” actionURL=”/Lisa?teenus=Deezer&playnow=-1&where=järgmineAlbum&albumid=693798541″/>
<item text=”Add last” type=”addAll-last” actionURL=”/Lisa?teenus=Deezer&playnow=-1&where=viimane&albumid=693798541″/>
…
Rakendamise märkmed ja näpunäited
Elemendi atribuut type on vihje, mis võib hõlbustada erinevate kuvamisvalikute kasutamist.
Objekti sisu sirvimise võimalust näitab browseKey atribuudi olemasolu. Objekti (kogu) esitamise võimalust näitab esitusakna olemasolu.URL (ja võimalik, et ka automaatne esitamineURL) atribuut. Üksusel võib olla nii atribuut „browseKey” kui ka atribuut „play”.URL atribuut.
Kui mõlemad mängivadURL ja automaatne esitamineURL Kui atribuudid on saadaval, peaks kasutaja eelistuse kohaselt valima, millist neist vaikimisi esitusvalikuna kasutada.
URI väärtused on üldiselt suhtelised URI-d absoluutse tee komponendiga. Suhtelised URI-d lahendatakse absoluutseteks URI-deks vastavalt RFC 3986-le.
Atribuutide browseKey, contextMenuKey ja searchKey väärtused peavad alati olema URI-kodeeringus (protsentides paostatud), kui neid kasutatakse päringu /Browse võtmeparameetri väärtusena, nagu ka kõik muud päringuparameetrid.
Sirvimishierarhias laskumisel võib olla kasulik, kui kasutajaliidese lehe päises kuvatakse mingisugune navigatsiooniriba, kasutades tõenäoliselt ülem- ja vanavanemsõlmede pealkirja (teksti).
Alemüksuste sirvimisel võib olla kasulik teha ülemüksusele kättesaadavaks kontekstimenüü.
Lapse kuvamise viisi otsustamisel võib olla kasulik arvestada vanema tüübiga.
7.2 Muusikasisu otsimine
Kirjeldus
Käsk teenuse sees otsimiseks.
Taotlus
/Sirvi?võti=võtme-väärtus&q=otsinguTekst
| Parameetrid | Kirjeldus |
| võti | Väärtus, mis on võetud varasema vastuse atribuudi „searchKey” väärtusest |
| q | Otsingusõna. Tehke otsing võtmeparameetriga määratud kontekstis (võetud vastuse searchKey atribuudist). Võtmeparameetri puudumisel tehke tipptaseme otsing. |
Vastus
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
teenus=”Deezer” otsinguvõti=”Deezer:Otsing” tüüp=”menüü”>
Tagasta otsingutulemuste kõrgeim tase. Artistide, albumite, lugude või esitusloendite edasiste otsingutulemuste saamiseks on vaja sirvimiskäsku, mille võtmeks on „browseKey”.
NäiteksampAlbumite otsingutulemuste nägemiseks saatke käsk:
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26expr%3Dmichael
Vastus on sama, mis tavalisele /Browse käsule.
| Vastuse atribuudid | Kirjeldus |
| Viita elementide/atribuutide tabelitele sirvimiskäsuga |
Example
http://192.168.1.100:11000/Browse?key=Deezer:Search&q=michael Otsi “michael” within the Deezer music service.
Mängijate rühmitamine
See osa kirjeldab käske mängijate vaikimisi grupeerimiseks ja grupeerimise lõpetamiseks. BluOS toetab ka fikseeritud grupeerimist, mis jääb selle dokumendi ulatusest välja.
BluOS kasutab termineid primaarne mängija ja sekundaarne mängija. Primaarne mängija on grupi peamine mängija. Primaarset mängijat kasutatakse muusikaallika valimiseks. Primaarseid mängijaid on ainult üks. Primaarse mängija külge on ühendatud sekundaarne mängija. Teiseseid mängijaid võib olla mitu.
Kui mängija on teisejärguline mängija, siis paljud päringud, mis on suunatud teisejärgulisele mängijale, suunatakse sisemiselt esmasele mängijale. Nende hulka kuuluvad /Status, taasesituse juhtimine, esitusjärjekorra haldus ning sisu sirvimine ja otsimine.
8.1 Teise grupi mängijad
Kirjeldus
Grupeeri üks teisejärguline mängija põhimängijaga.
Taotlus
/AddSlave?slave=teisemängijaIP&port=teisemängijaport&group=GrupiNimi
| Parameetrid | Kirjeldus |
| ori | Teisese mängija IP-aadress. |
| sadamasse | Teisese mängija pordi number. Vaikimisi on pordi number 11000. Mängijad, näiteks NAD CI580, millel on neli mängijat ühe IP-aadressiga, kasutavad mitut porti. |
| rühm | VALIKULINE, grupi nimi. Kui seda ei esitata, annab BluOS grupile vaikimisi nime. |
Vastus
| Vastuse atribuudid | Kirjeldus |
| orjaport | Äsja grupeeritud teisese mängija pordi number. |
| Id | Äsja gruppi lisatud teisese mängija ID. |
Example
http://192.168.1.100:11000/AddSlave?slave=192.168.1.153&port=11000
See rühmitab mängijad 192.168.1.153 ja 192.168.1.100. Mängija 192.168.1.100 on peamine mängija.
8.2 Mitme mängija lisamine gruppi
Kirjeldus
Grupeeri kaks või enam mängijat ühe põhimängija alla.
Taotlus
/Lisa ori?orid=teise mängija IP-d ja portid=teise mängija pordid
| Parameetrid | Kirjeldus |
| orjad | Põhimängijale lisatavate teiseste mängijate IP-aadressid. IP-aadressid on komadega eraldatud. |
| sadamad | Teisese mängija pordid, mis lisatakse põhimängijale. Portide numbrid on komadega eraldatud. |
Vastus
| Vastuse atribuudid | Kirjeldus |
| sadamasse | Teisese mängija port, mis gruppi lisati. |
| Id | Grupeeritud teisese mängija ID. |
Example
http://192.168.1.100:11000/AddSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Grupeerib teisejärgulised mängijad 192.168.1.153 ja 192.168.1.120 põhimängijaks 192.168.1.100.
8.3 Ühe mängija eemaldamine grupist
Mängija eemaldamine grupist. Teisejärgulise mängija eemaldamisel grupist tühistatakse teisejärgulise mängija grupp. Põhimängija eemaldamisel 3 või enama mängijaga grupist tühistatakse põhimängija grupp ja ülejäänud teisejärgulised mängijad moodustavad uue grupi.
Taotlus
/Eemalda slave?slave=teise mängija IP&port=teise mängija port
| Parameetrid | Kirjeldus |
| ori | Teisele mängijale (esmane) lisatava mängija (teisejärgulise) IP-aadress. |
| sadamasse | Mängija (teisene) port, mis lisatakse teisele mängijale (esmane). |
Vastus
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″
bränd = ”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″>
| Vastuse atribuudid | Kirjeldus |
| Lisateabe saamiseks vaadake /SyncStatus. |
Example
http://192.168.1.100:11000/RemoveSlave?slave=192.168.1.153&port=11000
Eemaldab mängija 192.168.1.153 grupist, mille peamine mängija on 192.168.1.100.
8.4 Mitme mängija eemaldamine grupist
Kirjeldus
Eemaldage grupist kaks või enam mängijat.
Taotlus
/Eemalda ori?orid=teisese mängija IP-d ja portid=teisese mängija pordid
| Parameetrid | Kirjeldus |
| orjad | Põhimängijast eemaldatavate teiseste mängijate IP-aadressid. IP-aadressid on komadega eraldatud. |
| Parameetrid | Kirjeldus |
| sadamad | Teisese mängija pordid, mis eemaldatakse peamisest mängijast. Portide numbrid on komadega eraldatud. |
Vastus
<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>
| Vastuse atribuudid | Kirjeldus |
| Lisateabe saamiseks vaadake /SyncStatus. |
Example
http://192.168.1.100:11000/RemoveSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Eemaldab mängijad 192.168.1.153 ja 192.168.1.120 grupist, mille peamine mängija on 192.168.1.100.
Mängija taaskäivitamine
See osa kirjeldab mängija pehme taaskäivituse käsku.
9.1 Mängija taaskäivitamine
Kirjeldus
Mängija pehme taaskäivitus.
Taotlus
POST-käsk /reboot parameetriga yes (mis tahes väärtus)
| Parameetrid | Kirjeldus |
| jah | Suvaline väärtus (nt 1). |
Vastus
Seaded on uuendatud
Taaskäivitamine. Palun sulgege see aken.
Palun oota…
Example
curl -d jah=1 192.168.1.100/taaskäivitus
Uksekella helinad
See osa kirjeldab mängija uksekella helina käske.
10.1 Uksekella helin
Kirjeldus
Aktiveeri uksekella helin.
Taotlus
http://PLAYERIP:PORT/Doorbell?play=1
| Parameetrid | Kirjeldus |
| mängida | Mängi uksekella (alati 1) |
Vastus
| Vastuse atribuudid | Kirjeldus |
| lubada | Märkige kellahelin |
| maht | Kella helitugevus |
| kellamäng | Kellahelina heli |
Example
http://192.168.1.100:11000/Doorbell?play=1 play doorbell chime
Otsesisend
Selles jaotises kirjeldatakse sisendallika otsese valimise käske.
11.1 Aktiivse sisendi valik
Kirjeldus
Aktiivse sisendallika valik. See käsk töötab aktiivsete sisendite puhul, mis kuvatakse vastuses käsule /RadioBrowse?service=Capture. BluOS HUB sisendite valikut toetab ainult see käsk.
Taotlus
/Mängima?url=URL_value
| Parameetrid | Kirjeldus |
| url | The URL atribuut vastusest funktsioonile /RadioBrowse?service=Capture |
Vastus
oja
| Vastuse atribuudid | Kirjeldus |
| olek | Näitab, et sisendit esitatakse |
Example
1. samm. Hankige URLparameetri _väärtus url
Päring: http://192.168.1.100:11000/RadioBrowse?service=Capture
Vastus:
<item playerName=”Tick
Märgi linnuke „tekst = „Bluetooth“ inputType = „bluetooth“ id = „sisend2“ URL=”Jäädvusta%3Abluetooth” pilt =” /images/BluetoothIcon.png” tüüp =”audio”/>
<item playerName=”Tick Tick” text=”Analog
Sisend” sisendi tüüp = ”analoog” id = ”sisend0” 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
Sisend” sisendi tüüp = ”spdif” id = ”sisend1” URL=”Capture%3Ahw%3Aimxspdif%2C0%2F1%2F25%2F2%3Fid%
3Dinput1″ pilt = ”/pildid/pildistamine/ic_opticalinput.png” tüüp = ”heli” />
<item playerName=”Tick
Märgi linnuke” tekst = ”Spotify” id = ”Spotify” URL=”Spotify%3Aplay” pilt =”/Allikad/pildid/SpotifyIcon.png” teenus
Tüüp = „Pilveteenus” tüüp = „heli”/>
<remoteitem playerName=”Test Hub” text=”Analog Input” inputType=”analog” id=”hub192168114911000input0″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput0″
pilt=”/pildid/jäädvustamine/i
c_analoginput.png”
tüüp = ”heli” />
<remoteitem playerName=”Test Hub” text=”Coaxial Input” inputType=”spdif” id=”hub192168114911000input3″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput3″
pilt=”/pildid/jäädvustamine/ic
_optiline sisend.png”
tüüp = ”heli” />
<remoteitem playerName=”Test Hub” text=”HDMI ARC” inputType=”arc” id=”hub192168114911000input4″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput4″
pilt=”/pildid/jäädvustamine/ic
_tv.png”
tüüp = ”heli” />
<remoteitem playerName=”Test Hub” text=”Optical Input” inputType=”spdif” id=”hub192168114911000input2″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput2″
pilt=”/pildid/jäädvustamine/ic
_optiline sisend.png”
tüüp = ”heli” />
<remoteitem playerName=”Test Hub” text=”Phono Input” inputType=”phono” id=”hub192168114911000input1″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput1″
pilt=”/pildid/jäädvustamine/ic
_vinüül.png”
tüüp = ”heli” />
2. samm. Esitage mängijal analoogsisendit
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
Märkus. Veenduge, et allikad on ühendatud ja pole peidetud.
11.2 Välise sisendi valik
Kirjeldus
Välise sisendallika valik. Mõnikord ei pruugi mitteaktiivsed välised sisendid vastusena kuvada.
/RadioBrowse?service=Capture. See käsk töötab nii aktiivse kui ka mitteaktiivse sisendi valimiseks. Seda soovitatakse CI välise sisendi valimiseks.
Päring (BluOS püsivara uuem kui v3.8.0 ja vanem kui v4.2.0)
/Esita?inputIndex=IndeksiId
| Parameetrid | Kirjeldus |
| sisendindeks | Sisendite indeks (algab 1-st) vastuses küsimusele /Settings?id=capture&shcemaVersion=32 (32 on uusim skeemi versioon) numbrilises järjekorras. Bluetooth on välja arvatud. |
Vastus
oja
| Vastuse atribuudid | Kirjeldus |
| olek | Näitab, et sisendit esitatakse |
Example
1. samm. Hankige sisendindeksi väärtus
Päring: http://192.168.1.100:11000/Settings?id=capture&schemaVersion=32
Vastus:
<menuGroup icon=”/images/settings/ic_capture.png” url=”/seade” id=”jäädvustamine”
displayName=”Allikate kohandamine”>
<setting icon=”/images/settings/ic_bluetooth.png” refresh=”true” url=”/helirežiimid”
id=”bluetooth” displayName=”Bluetooth” value=”3″ name=”bluetoothAutoplay” description=”Keelatud” explicit=”Manuaalrežiim võimaldab teil navigeerimissahtlis allikate vahel vahetada. Automaatrežiim lülitub Bluetooth-allikale, kui ühendatud Bluetooth-seade hakkab heli esitama. Seejärel saate navigeerimissahtlis allikate vahel vahetada. Külalisrežiim lülitub Bluetooth-allikale, kui ühendatud Bluetooth-seade hakkab heli esitama. Kui vahetate teisele allikale, katkestatakse Bluetooth-ühendus. Bluetooth-allikas ei kuvata navigeerimissahtlis. Keelatud olek eemaldab allika navigeerimissahtlist ega luba teisel seadmel pleieriga Bluetooth-seadmena ühendust luua.
allikas.” klass = ”nimekiri”>
…
<menuGroup icon=”/images/capture/ic_analoginput.png” url=”/seade” id=”hõive sisend0”
displayName=”Analoog”
Sisend”>
<menuGroup icon=”/images/capture/ic_opticalinput.png” url=”/seade” id=”hõive-sisend1”
displayName=”Optiline sisend”>
Vastus näitab Bluetoothi, analoogsisendit ja optilist sisendit. Bluetooth on välja jäetud, seega on analoogsisendi inputIndexi väärtus 1 ja optilise sisendi inputIndexi väärtus 2.
2. samm. Esitage mängijal optilist sisendit.
http://192.168.1.100:11000/Play?InputId=2
Päring (BluOS püsivara v4.2.0 või uuem)
/Esita?inputTypeIndex=$tüübiIndeks
| Parameetrid | Kirjeldus |
| sisenditüübi indeks | typeIndexi vorming on järgmine: tüübiindeks sisendist. Siin on sisendite loend tüüp: spdif (optiline sisend) analoog (analoogsisend, liinisisend) koaksiaalkaabel (koaksiaalsisend) bluetooth kaar (HDMI ARC) earc (HDMI eARC) phono (vinüül) arvuti aesebu (AES/EBU) tasakaalustatud (tasakaalustatud sisse) mikrofon (mikrofoni sisend) The indeks algab punktist 1. Kui sama tüüpi sisendeid on rohkem kui üks, on sisendil 1 indeks 1, sisendil 2 on indeks 2 ja nii edasi. |
Vastus
oja
| Vastuse atribuudid | Kirjeldus |
| olek | Näitab, et sisendit esitatakse |
Example
Päring: http://192.168.1.100:11000/Play?inputTypeIndex=spdif-2 optilise sisendi 2 valimiseks
Vastus: oja
Bluetooth
See jaotis kirjeldab Bluetooth-režiimi muutmise käsku.
12.1 Bluetoothi režiimi muutmine
Kirjeldus
Bluetoothi režiimi muutmine: käsitsi, automaatne, külalisrežiim, keelatud.
Taotlus
/audiorežiimid?bluetoothAutoplay=väärtus
| Parameetrid | Kirjeldus |
|
Bluetoothi automaatne esitamine |
Bluetooth-režiim väärtus 0 tähendab käsitsi, 1 tähendab automaatset, 2 tähendab külalisrežiimi, 3 tähendab keelatud. |
Ei mingit vastust
Example
Bluetoothi keelamiseks tehke päring: http://192.168.1.100:11000/audiomodes?bluetoothAutoplay=3
Lisa
13.1 Lenbrooki teenuse avastamise protokoll
Sissejuhatus
Populaarsed tuvastusmeetodid, näiteks mDNS ja SSDP, kasutavad ja tuginevad UDP multisaadete sidele. Enamik uusimaid Lenbrooki tooteid kasutab avastamiseks mDNS-i. Kahjuks oleme leidnud, et märkimisväärsel hulgal meie klientidel on koduvõrgud, kus multisaadete liiklus ei toimi korralikult ja meie seadmeid ei saa usaldusväärselt tuvastada. See on toonud kaasa palju toodete tagastamisi ja kaebusi meie edasimüüjatelt.
Selle probleemi lahendamiseks oleme loonud kohandatud tuvastusprotokolli nimega LSDP, mis kasutab UDP leviedastust. Esialgsed testid on näidanud, et see on palju usaldusväärsem kui mDNS-põhine tuvastus.
Protokoll läbiview
Selle protokolli üks eesmärk on olla suhteliselt lihtne. Seda saab kasutada väga piiratud mälumahuga manussüsteemides.
Protokoll kasutab kõiki UDP leviedastuspakette, mis suunduvad UDP porti 11430 ja sealt väljuvad. See port on registreeritud IANA-s ja määratud Lenbrookile LSDP kasutamiseks alates 27. märtsist 2014.
Püsiseisundis saadab iga reklaamimiseks mõeldud teenusega sõlm umbes iga minuti järel teadaande.
Käivitamisel ja teenuste loendi või võrguparameetrite muutumisel edastatakse lühikeste intervallidega seitse paketti, et võimaldada esialgset avastamist ja muudatuste kiiremat levikut. Teenuseid reklaamivate sõlmede puhul peavad need seitse esimest paketti sisaldama teadeteadet. Teenuseid otsivate sõlmede puhul peavad need seitse esimest paketti sisaldama päringuteadet. Teenuste puhul, mis enam ei ole saadaval, peaksid need seitse paketti sisaldama kustutusteadet.
UDP-pakettide ebausaldusväärse olemuse tõttu saadetakse neid esialgseid pakette seitse korda. Ebatõenäolisel juhul, kui kõik seitse paketti ebaõnnestuvad, avastatakse teenused mõne aja pärast ikkagi üheminutilise perioodilise Announce'i sõnumi abil.
Kui sõlm saab päringusõnumi teenuseklassi kohta, mida ta reklaamib, vastab ta lühikese juhusliku viivituse järel teavitussõnumiga ja lähtestab oma praeguse teavitusaja.
Paketi päis ja kõik sõnumiplokid sisaldavad pikkusvälju. See annab lisapaindlikkust ja võimaldab tulevikus teha tagasiühilduvaid muudatusi. Tulevikus võidakse lisada lisavälju või sõnumitüüpe, millest vanemad rakendused parsimisel mööda vaatavad. Kui otsustame teha tagasiühildumatu muudatuse, on paketi päises ka versiooniväli, mida saab suurendada.
Protokoll võimaldab TXT-kirjete lisamist ka teenusereklaamidele, mis on sarnased kasutatavate TXT-kirjetega.
mDNS-iga. See annab märkimisväärse paindlikkuse teenusele täiendavate suvaliste metaandmete lisamiseks.
reklaamid protokolli muutmata.
Protokolli üksikasjad
Ajastus
Kõik saadetavad paketid tuleks ajastada juhusliku ajastuse või viivitustega, et vältida kokkupõrkeid.
- Käivituspaketi ajastus: 7 paketti ajahetkel = [0, 1, 2, 3, 5, 7, 10s] + (0 kuni 250ms juhuslikult). Need on absoluutsed ajad, mitte viivitused. Kõik 7 paketti tuleks saata umbes 10 sekundi jooksul.
- Põhiteate periood: 57 sekundit + (0 kuni 6 sekundit juhuslikult)
- Päringu vastuse viivitus: (0 kuni 750 ms juhuslikult)
Sõlme ID
Igal sõlmel peab olema unikaalne ID, mida saab kasutada sõlme tuvastamiseks. Unikaalne ID lisatakse teadetesse „Announce“ ja „Delete“. Kliendid saavad seda väärtust kasutada primaarvõtmena väärtuste vahemällu salvestamisel ja sõlme unikaalseks tuvastamiseks. See unikaalne ID võib olla MAC-aadress, kuid see peaks olema iga liidese jaoks sama, kui sõlmel on mitu liidest, millel see reklaamib.
Paketi struktuur
Iga pakett algab paketi päisega, millele järgneb suvaline arv sõnumiplokke. Iga sõnumiplokk algab pikkuse väljaga, nii et tundmatud sõnumid saab vahele jätta. Kui pole teisiti täpsustatud, salvestatakse kõik mitmebaidised numbriväärtused big endianina (kõige olulisemad baidid esimesena). Kui pole teisiti täpsustatud, on kõik numbrid märgita väärtused. NäiteksampÜhe baidi pikkus võib olla vahemikus 0 kuni 255.
Paketi päis
| Väli | Baitid | Kirjeldus |
| Pikkus | 1 | Päise kogupikkus koos selle väljaga. |
| Võlusõna | 4 | See väli koosneb neljast ASCII baidist koosnevast "LSDP" koodist. See aitab meil tuvastada pakette, mis on mõeldud kasutamiseks, nii et me ei pea proovima ootamatust allikast pärit juhuslikke andmeid parsida. |
| Protokolliversioon | 1 | Protokolli versioon. Kui protokolli tulevikus muudetakse ja see versioon ei ole tagasiühilduv, |
| Väli | Baitid Kirjeldus | |
| muudetakse. Praegune versioon on 1. | ||
Päringusõnum
| Väli | ||
| Baitid | Kirjeldus | |
| Pikkus | 1 | Sõnumi kogupikkus koos selle väljaga. |
| Sõnumi tüüp | 1 | „Q” = 0x51: Standardpäring leviedastusvastuse saamiseks. „R” = 0x52: Päring üksiksaatevastuse saamiseks. |
| Count | 1 | Päringule kuuluvate klasside arv. |
| 1. klass | 2 | 16-bitine (2-baidine) klassi identifikaator. |
| … | Korda eelmist välja iga täiendava klassi jaoks. | |
Teata sõnum
Teadaande päis
| Väli | ||
| Baitid | Kirjeldus | |
| Pikkus | 1 | Sõnumi kogupikkus, sh täielik teadaande päis ja teadaandekirjed. |
| Sõnumi tüüp | 1 | „A” = 0x41 |
| Sõlme ID pikkus | 1 | Sõlme ID välja pikkus. |
| Sõlme ID | Muutuv | Teadet saatva sõlme unikaalne ID. See on tavaliselt ühe sõlme liidese MAC-aadress. |
| Aadressi pikkus | 1 | Aadressi pikkuse väli. IPv4 puhul on see 4. |
| Väli | ||
| Baitid | Kirjeldus | |
| Aadress | Muutuv | Sõlme IP-aadress. |
| Count | 1 | Järgitavate teadaannete arv. |
Teata rekord
| Väli | Baitid | Kirjeldus |
| Klass | 2 | 16-bitine (2-baidine) klassi identifikaator. |
|
Tekstisõnumite arv |
1 |
Järgitavate TXT-kirjete arv. Kui see on null, jäetakse järgmised väljad välja. |
| Võtme 1 pikkus | 1 | Võtme nime pikkus. |
| 1. võti | Muutuv | Võtme nimi. |
| Väärtus 1 Pikkus | 1 | Väärtusteksti pikkus. |
| Väärtus 1 | Muutuv | Väärtuse tekst. |
|
… |
Korda eelmisi nelja välja iga täiendava TXT-kirje jaoks. |
Kustuta sõnum
| Väli | ||
| Baitid | Kirjeldus | |
| Pikkus | 1 | Sõnumi kogupikkus koos selle väljaga. |
| Sõnumi tüüp | 1 | „D” = 0x44 |
| Sõlme ID pikkus | 1 | Sõlme ID välja pikkus. |
| Sõlme ID | Muutuv | Sõnumit saatva sõlme unikaalne sõlme ID. See on tavaliselt ühe sõlme MAC-aadress. |
| Väli | ||
| Baitid | Kirjeldus | |
| liidesed. | ||
| Count | 1 | Järgitavate tundide arv. |
| 1. klass | 2 | 16-bitine (2-baidine) klassi identifikaator. |
| … | Korda eelmist välja iga täiendava klassi jaoks. | |
Kursuse ID ülesanded
| Klassi ID | Kirjeldus | mDNS-i ekvivalent |
| 0x0001 | BluOS-mängija | _musc._tcp |
| 0x0002 | BluOS-server | _muss._tcp |
| 0x0003 | BluOS Player (teisene mitme tsooniga mängijates, näiteks CI580) | _musp._tcp |
| 0x0004 | sovi-mfg, mida kasutatakse tootmistestimiseks. | _sovi-mfg._tcp |
| 0x0005 | sovi-klaviatuur | _sovi-keypad._tcp |
| 0x0006 | BluOS Player (paaris-ori) | _musz._tcp |
| 0x0007 | Kaugjuhtimispult Web Rakendus (AVR OSD Web leht) | _kaug-web-ui._tcp |
| 0x0008 | BluOS Hub | _mush._tcp |
| 0xFFFF | Kõik klassid – saab kasutada päringusõnumiga. |
Märkus 1:
Kogu LSDP paketti tuleb käsitleda binaarandmetena.
Märkus 2:
Kui üks teadaanne ei mahuta kõigi sõlmede infot (eriti CI580), jaguneb see kaheks või enamaks teadaandeks, kusjuures iga sõnum sisaldab päist ja kirjet ning iga sõnum sisaldab terve(te) sõlme(de) infot.
BluOS-i kohandatud integratsiooni API versioon 1.7
Dokumendid / Ressursid
 |
BluOS T 778 kohandatud integratsiooni API [pdfKasutusjuhend T 778, T 778 kohandatud integratsiooni API, T 778, kohandatud integratsiooni API, integratsiooni API, API |