Custom Integration API
T 778 Custom Integration API
Lintlha tse ka har'a bukana ena ke thepa ea Lenbrook Industries.
E lokela ho etsoa feela bakeng sa tšebeliso ea litsebi. Lenbrook Industries ha e nke boikarabello bakeng sa ho nepahala ha protocol. Protocol e fanoa "joalokaha e le", e nang le liphoso tsohle le ntle le tiisetso ea mofuta ofe kapa ofe, e ka hlahisoang kapa e boletsoeng.
Leano la Tšebeliso ea API
Ka ho sebelisa li-API, u lumellana le Leano lena la Tšebeliso ea API ("Leano") le Melaoana ea rona. Re fana ka li-API tsena ho lumella lik'hamphani le batho ho ikahela le ho rua molemo ho tsoa ho Ts'ebeletso ea rona ka ho theha software, lits'ebeletso, kapa limmojule tse hokahantsoeng le sethala sa rona kapa ho fumana lintlha tse ka har'a sethala sa rona ka li-API tsa rona ("Ho kopanya"). Leano lena le tla nkuoa e le karolo ea Melaoana ea rona.
Software e fanoa "KA JOALOKAHA", ntle le tiisetso ea mofuta ofe kapa ofe, e hlalosang kapa e boleloang, ho kenyeletsoa empa e sa felle feela ho litiisetso tsa thekiso, ho phela hantle bakeng sa morero o itseng le ho se tlōle molao. Ha ho ketsahalo eo bangoli kapa ba nang le litokelo tsa litokelo ba tla ikarabella bakeng sa tseko efe kapa efe, lits'enyehelo, kapa melato e meng, ebang ke ketso ea konteraka, Tort kapa ka tsela e 'ngoe, e hlahang, ho tsoa kapa mabapi le software kapa ts'ebeliso kapa litšebelisano tse ling ho software.
Tšebeliso e lumelletsoeng
U kanna oa se sebelise API ho romella spam kapa ho nka mehato efe kapa efe e tlolang Leano la rona le Amohelehang la Tšebeliso le Melaoana ea rona ea Ts'ebeliso e Tloaelehileng. U tla ipapisa le melao eohle e sebetsang (ho kenyeletsoa melao ea lekunutu le melao ea taolo ea thepa e romelloang United States, European GPR le melaoana le melaoana ea likotlo tsa moruo). U tla latela litokomane tsohle tseo re fanang ka tsona bakeng sa li-API. U ke ke ua leka ho senya kapa ho fetola tsela eo Tšebeletso e sebetsang ka eona. Re kanna ra beha leihlo tšebeliso ea hau ea li-API ho latela melao ena, 'me re kanna ra u hanela ho kena ho API haeba u tlola Leano lena.
Lekunutu
Hao Kopanyo e tlameha ho hlahisa leano la lekunutu bakeng sa basebelisi ba fanang ka lintlha tse qaqileng tseo u tla li bokella ho bona ha ba sebelisa Kopano. U tla fihlella data ea mosebelisi ho isa moo mosebelisi a lumelletsoeng le ho hlalositsoe leanong la hau la lekunutu. O tlameha ho hlakola data ea mosebelisi hang hang haeba mosebelisi a kopa ho hlakoloa kapa a hlakola ak'haonte ea hae le uena.
Tshireletso
U tla kenya ts'ebetsong le ho boloka mehato e nepahetseng ea ts'ireletso ea tekheniki le ea mokhatlo ho sireletsa le ho boloka ts'ireletso, botšepehi le lekunutu la data. Mehato ena ea ts'ireletso e tla thibela phihlello e sa lumelloeng kapa phatlalatso ea data ea hau kapa ea lekunutu eo u e sebetsang.
Borui
Re na le litokelo, litlotla, le lithahasello tsohle ho Ts'ebeletso le li-API, ho kenyeletsoa litokelo tsohle tsa thepa ea mahlale, matšoao, khoutu le likarolo. U ke ke ua hatakela, u khutlisetsa morao moenjiniere, kapa ua kopitsa khoutu, moralo kapa litaba tsa rona. U ke ke ua fihlella li-API tsa rona ho qothisana lehlokoa le Ts'ebeletso ea rona. Litokelo life kapa life tse sa fanoang ka kotloloho ke Leano lena lia haneloa, kahoo ha u sa e bone mona, ha se tokelo eo re u lumellang hore re u lumelle.
Tšebeliso ea Matšoao
U kanna oa se sebelise mabitso a rona le matšoao (e bolelang li-logo, mabitso le litšoantšo tse nang le litokelo tsa litokelo tsa molao) ka tsela efe kapa efe. O ka se fetole kapa oa tlosa ditsebiso tsa botho matshwaong a rona. U ke ke ua sebelisa mabitso a rona kapa matšoao lebitsong la hau la Kopano kapa logo, kapa ka tsela efe kapa efe e fanang ka maikutlo a tumello ea rona.
Tšebeliso e Molemo ea Matšoao
Litataiso tsena li hlalosa hore na u tlameha ho sebelisa lebitso la rona joang, matšoao le thepa ea lebitso ka linako tsohle. Tšebeliso ea hau e bontša hore u amohetse litataiso tsena, 'me u utloisisa hore tšebeliso ea hau e khahlanong le litataiso tsena e tla fella ka hore tumello ea hau ea ho sebelisa lebitso la rona, matšoao le thepa ea rona e felisoe.
- Tšebeliso ea mabitso a rona, matšoao le thepa ea lebitso e tlameha ho lumelloa ka mokhoa o hlakileng ka mongolo.
- Se ke oa fetola, oa fetola, oa khopamisa, oa kopitsa, kapa oa etsisa Matlotlo a Brand ka tsela efe kapa efe, ho kenyelletsa ho fetola 'mala, ho potoloha le/kapa ho otlolla. Ka mantsoe a mang, thepa ea rona ea Brand e tlameha ho bolokoa ka mefuta ea eona ea mantlha.
- Se ke oa fana ka mabitso a rona, matšoao le thepa ea rona botumo bo sa lokelang ha bo bapisoa le lebitso la hau le logo.
- Se ke oa hlahisa mabitso a rona, matšoao, le thepa ea rona haufi le, kapa ka mofuta ofe kapa ofe oa papatso ea tlholisano, ntle le tumello ea rona e hlakileng.
- Tšebeliso ea hau ha ea lokela ho khelosa bareki mabapi le tšehetso ea rona ea, kamano le kapa tumello ea k'hamphani ea hau kapa lihlahisoa kapa litšebeletso tsa hau.
- Lebitso la rona, matšoao le thepa ea rona ke thepa ea rona feela. Kamohelo eohle e tlisoang ke tšebeliso ea hau e tla ba molemong oa rona feela. U ke ke ua nka khato efe kapa efe e hananang le litokelo tsa rona kapa beng ba rona.
- Lebitso la rona, matshwao le thepa ya lebitso la rona e tlameha ho sebediswa ka tsela e hlomphehang mme e se ke ya sebediswa ka tsela e tla re lematsa, dihlahiswa kapa ditshebeletso, kapa ka tsela eo ho ya ka maikutlo a rona e fokotsang kapa e senyang botumo ba rona kapa molemo o teng lebitsong la rona, matshwao le matlotlo a rona. Ka mantsoe a mang, ka kōpo u se ke ua amahanya thepa ea rōna le mesebetsi leha e le efe e seng molaong kapa e seng molaong kapa ua e sebelisa ka tsela e thetsang kapa e kotsi.
Exampmelao-motheo ea tšebeliso e amohelehang:
“[LEBITSO LA HAO] (le lumellana le / le sebetsa le BluOS)”
Exampmefokolo ea tšebeliso e sa amoheleheng
“[LEBITSO LA HAO] – BluOS”
"BluOS - [LEBITSO LA HAO]"
“[LEBITSO LA HAO] – E tsamaisoa ka BluOS”
Papatso le Liphatlalatso tsa Khatiso
Kamora hore kopo ea hau e amoheloe, e kanna ea thathamisoa ho rona web thepa. Ka kakaretso re ka se phatlalatse litokollo tsa boralitaba kapa ra kenya letsoho ho bapatsa ka kopanelo ea kopo ea hau.
Pele o aba phatlalatso mabapi le sesebelisoa sa hau, etsa bonnete ba hore o ikopanya le rona ho [EMAIL]. Haeba u tla be u bua ka BluOS, joale re tla hloka ho boelaview tokollo. Re khothaletsa ho ikopanya le tokollo ea hau ea ho qetela ea boralitaba kapele kamoo ho ka khonehang.
Boithorollo
Ho isa boholeng bo lumelletsoeng ke molao, re fana ka li-API kamoo li leng ka teng. Seo se bolela hore ha re fane ka litiisetso tsa mofuta ofe kapa ofe, tse hlakileng kapa tse ka hlalosoang, ho kenyeletsoa, empa ho sa felle feela ka thekiso le ho itekanela molemong o itseng.
Lintlafatso
Re ka ntlafatsa kapa ra fetola li-API le Leano lena nako le nako ka ho beha liphetoho sebakeng sena sa marang-rang kapa ho u tsebisa ka lengolo-tsoibila. Liphetoho tsena li ka ama ts'ebeliso ea hau ea li-API kapa tsela eo Kopano ea hau e sebelisanang le API. Haeba re etsa phetoho e sa amoheleheng ho uena, u lokela ho khaotsa ho sebelisa li-API.
Lekunutu
O kanna oa ba le phihlello ea litaba tsa lekunutu, tsa botho, le tseo e seng tsa sechaba ka kotloloho ho li-API ("Lintlha tsa Lekunutu"). U ka sebelisa tlhahisoleseling ena feela ho haha ka li-API. U ke ke ua senola Boitsebiso ba Lekunutu ho mang kapa mang ntle le tumello ea rona e ngotsoeng, 'me u tla sireletsa Litaba tsa Lekunutu hore li se sebelisoe ntle ho tumello le ho li senola ka tsela e tšoanang le eo u neng u tla sireletsa boitsebiso ba hau ba lekunutu.
Tokollo
U tla re sireletsa le ho nka hore rona le Sehlopha sa rona ha re na kotsi ho tahlehelo leha e le efe (ho kenyeletsoa le litefiso tsa babuelli ba molao) tse hlahisoang ke liqoso tsa motho e mong tse amanang le tšebeliso ea hau ea API.
Tse ling
Leano lena ha le thehe kapa ho fana ka maikutlo a tšebelisano efe kapa efe, setsi, kapa khoebo e kopanetsoeng. Leano lena le tla sebetsa ha feela o sebelisa API kapa ho fihlela e felisoa ho latela Melaoana ea rona. Ha ho e-na le khohlano pakeng tsa Leano lena le Melao e Tloaelehileng ea Tšebeliso, Melao e Tloaelehileng ea Tšebeliso e tla laola.
©2025 LENBROOK INDUSTRIES LIMITED
633 Lekhotla la Granite, Pickering, Ontario, Canada L1W 3K1
Litokelo tsohle li sirelelitsoe
Ha ho karolo ea sengoliloeng sena e ka hlahisoang bocha, ho bolokoa kapa ho fetisoa ka mokhoa ofe kapa ofe ntle le tumello e ngotsoeng ea Lenbrook Industries Limited. Leha ho entsoe boiteko bo bong le bo bong ho netefatsa hore litaba li nepahetse nakong ea phatlalatso, likarolo le litlhaloso li ka fetoha ntle le tsebiso.
| Nalane ea Phetoho | ||
| Phetolelo | Letsatsi | Tlhaloso |
| 1.0 | 6/17/2019 | Tokollo ea pele |
| 1.2 | 01/12/2022 | E kentse lets'oao le bonolo, tšepe ea lemati, molumo oa holimo/tlase, tsamaisa pina e moleng, le ho kenya litaelo tse tobileng. Kekelitsoe molaetsa ho Sehlomathiso LSDP. |
| 1.4 | 04/26/2022 | E ekelitse taelo ea semumu; e fetotsoe litaelo tsa ho kenya ka kotloloho bakeng sa HUB; Taelo e nchafalitsoeng ea Play ea ho bapala molumo oa tloaelo o phatlalalitsoeng. |
| 1.5 | 07/18/2022 | E kentse taelo ea Bluetooth; LSDP e ntlafalitsoeng ho kenyelletsa sehlopha sa 5 ho isa ho 8; E kenyellelitse "ts'ebeliso e sebetsang ea matšoao" ho Leano la Tšebeliso ea API. |
| 1.6 | 03/13/2024 | E kentse molaetsa bakeng sa /Boemo ba libapali tse hlophisitsoeng sehlopheng sa 2; E kentsoe /Bapala?batla=metsotsoana e=tsatsisoa ka har'a sehlopha sa 4.1; |
| 1.7 | 04/09/2025 | Karolo e ntlafalitsoeng ea 8.3 example; Kopo ea ho bala ka har'a marang-rang e kentsoeng ke mohlalaample karolong ea 7.1; E kentse taelo e ncha ea khetho ea ho kenya ka ho toba karolong ea 11.2; Karolo e ntlafalitsoeng ea 6.1 ho kenya tšobotsi ea "setšoantšo" bakeng sa li-presets; E kentse maikutlo a "followRedirects=1" bakeng sa litšobotsi tsohle tsa setšoantšo; E ntlafalitse tlhaloso ea litšobotsi tsa papaliURL le ho eketsa hona joale karolong ea 7.1 |
Selelekela
BluOS™ ke sistimi e tsoetseng pele ea ts'ebetso le software ea taolo ea 'mino e o lumellang ho fihlella le ho tsamaisa mmino o sa lahleheloeng ho fihla ho 24-bit/192kHz kamoreng e' ngoe le e 'ngoe u sebelisa marang-rang a lapeng. BluOS e ka fumanoa lihlahisoa tse tsoang Bluesound, NAD Electronics, DALI Loudspeakers le tse ling.
Tokomane ena e etselitsoe ho thusa bahlahisi le bahokahanyi ba sistimi ba sebetsang 'marakeng oa kopanyo ea moetlo (CI). E na le karoloana ea likopo tsa API tse ngotsoeng ho BluOS API Control Protocol e felletseng.
Likopo tsohle tse hlalositsoeng tokomaneng ena li romelloa e le likopo tsa HTTP GET. Liparamente ke maemo URL lebitso la khouto/boleng para. Libapali tsa BluOS li fumana litaelo tsena ebe li araba ka data ea XML e kentsoeng ea UTF-8.
Likopo tsohle li ka mokhoa oa http:// : / moo:
- player_ip ke aterese ea IP ea sebapali sa BluOS (mohlala, 192.168.1.100)
- boema-kepe ke boema-kepe ba TC bo sebelisetsoang likhokahano. Port 11000 e sebelisoa bakeng sa libapali tsohle tsa BluOS, ntle le CI580. CI580 e na le li-streamers tse 'nè ka har'a mochine o le mong, moo node ea 1 e sebelisang port 11000, node 2 e sebelisa port 11010, node 3 e sebelisa port 11020, le node ea 4 e sebelisa port 11030. Kou ea sebele e lokelang ho sebelisoa e lokela ho fumanoa ka tšebeliso ea MDNS protocol e sebelisang litšebeletso le mussp.cp.cp.
- kopo ke taelo ea 'nete ea BluOS kapa potso (mohlala, Play)
Hlokomela: Tokomane ena e tla sebelisoa http://192.168.1.100:11000 joalo ka sebapali sa IP le boema-kepe ho tsohle tsa examples.
Lipotso tsa Boemo
Lipotso tsa boemo li sebelisoa ho botsa sebapali sa BluOS.
BluOS e fana ka mekhoa e 'meli ea ho etsa lipotso tsa boemo; khetho e tloaelehileng le khetho e telele. Ho khetha khafetsa ho khutlisa sephetho hanghang. Ho khetha nako e telele ho boloka khokahanyo ka nako e behiloeng, 'me e khutlisa sephetho sa potso feela ha tlhahisoleseling e fetohile kapa nako e felile. Ho khetha nako e telele ho ka fokotsa haholo palo ea mehala ho sebapali.
Ha likhetho tsa nako e telele li sa sebelisoe, bareki ba lokela ho fokotsa sekhahla sa khetho ea bona ho bonyane kopo e le 'ngoe metsotsoana e meng le e meng e 30. Ha ho ntse ho sebelisoa khetho ea nako e telele, moreki ha a tlameha ho etsa likopo tse peli tse latellanang bakeng sa sesebelisoa se le seng ka tlase ho motsotsoana o le mong, leha kopo ea pele e khutla ka nako e ka tlase ho motsotsoana.
Likopo tsa nako e telele tsa likhetho li nka mekhahlelo e 'meli: nako ea nako le etag. timeout ke nako ea kopo ea nako e telele ea likhetho le etag e nkiloe karabong e fetileng (semelo se karolong ea motso oa karabo).
Ka kakaretso, hoa hlokahala feela ho ba le poll ea nako e telele e sebetsang bakeng sa e 'ngoe ea /Status kapa /SyncStatus. Karabo ea /Boemo e kenyelletsa ntho e itseng ( ) e bontšang hore na /SyncStatus e fetohile. /SyncStatus e lokela ho botsoa ha feela lebitso, bophahamo ba modumo le boemo ba sehlopha sa sebapadi di kgahlisa. / Boemo bo lokela ho botsoa haeba boemo ba hajoale ba ho bapala bo hlokahala.
Ha libapali li hlophisoa, sebapali sa mantlha ke sebapali se ka sehloohong sehlopheng. Libapali tsa bobeli li khomaretsoe ho sebapali sa mathomo. /Karabelo ea boemo ba libapali tsa bobeli ke likopi tsa sebapali sa mantlha. /SyncStatus ho khetha nako e telele hoa hlokahala ho lekola molumo oa sebapali se seng le se seng sa bobeli.
2.1 Boemo ba ho Bapala
Tlhaloso
The /Status endpoint e botsa bophahamo ba modumo le tlhahisoleseding ya ho bapala. Potso ena e khutlisa likarolo tse ngata tsa likarabo,
tse ling tsa tsona ha li sebetse tokomaneng ena. Likarabo tse se nang litokomane li lokela ho hlokomolohuoa.
Kopa
/Boemo?timeout=metsotsoana&etag=etag- boleng
| Mekhahlelo | Tlhaloso |
| khefutso | Paramethara ea boikhethelo e sebelisoang ka likhetho tse telele. Nako e khothaletsoang ea ho khetha ke metsotsoana e 100 'me e lokela ho lekanyetsoa ho sekhahla sa metsotsoana e 60 kapa ho feta 'me e se be lebelo ho feta metsotsoana e 10. |
| etag | Paramethara ea boikhethelo e sebelisoang ka likhetho tse telele. Ena ke etag tšobotsi e tsoang ho |
| Mekhahlelo | Tlhaloso |
| e fetileng /Karabelo ea mohala oa boemo. |
Karabo
<status etag=”4e266c9fbfba6d13d1a4d6ff4bd2e1e6″>
÷ (Deluxe)
Ed Sheeran
'nete
1
159
Deezer:142986206
/Artwork?service=Deezer&songid=Deezer%3A142986206
0
187
1
E phethahetseng
1054
0
320000
2
Deezer
/Sources/images/DeezerIcon.png
0
8
19
kgefutsa
MP3 320 kb/s
5
E phethahetseng
Ed Sheeran
÷ (Deluxe)
263
4
35
HLOKOMELA: ha se litšobotsi tsohle tsa likarabo tse thathamisitsoeng chateng e latelang. Lintlha tse ling li ka ba teng 'me li lokela ho hlokomolohuoa.
| Litšobotsi tsa Karabelo | Tlhaloso |
| etag | Tšobotsi ea motsoako oa karabo. Boleng ba opaque bo sebelisitsoeng ka likhetho tse telele ho bona liphetoho tsa karabo. Haeba boleng ha bo so fetohe ho tloha karabong e fetileng, karabelo e tiisitsoe hore ha ea fetoha (empa bona le metsotsoana e ka tlase) |
| alamo metsotsoana e setseng | Haeba ho bapala hape ho bakoa ke alamo, joale ke metsotsoana e mengata pele e emisa. |
| ketso | Sheba karolo ea Actions for Phallela Radio Stations bakeng sa tlhaloso. |
| alebamo | Lebitso la alebamo la pina e ntseng e sebetsa. Hape bona sehlooho1 tšobotsi. |
| moetsi oa litšoantšo | Lebitso la sebini la pina e ntseng e tsoela pele. Hape bona sehlooho1 tšobotsi. |
| betri | E bonts'itsoe haeba sebapali se na le pakete ea betri. E kenyeletsa litšobotsi: · boemo – boemo ba tefiso, peresente · ho tjhaja – 1 haeba e ntse e tjhaja ha jwale · letšoao - URL sa setšoantšo sa sebapali se bontšang boemo ba hajoale ba tefiso |
|
canMovePlayback |
Ke 'nete haeba ho khonahala ho fetisetsa papali ea hajoale kapa litaba tse emisitsoeng ho sebapali se seng. |
|
canSeek |
Haeba 1 e ka khona ho phenya pina ea hona joale, sebakeng sa 0..totlen, ka ho sebelisa parameter ea ho batla ho /Play. Bakeng sa mohlalaample: /Bapala?batla=34. |
| db | Boemo ba molumo ho dB. |
| sehlopha Lebitso | Lebitso la sehlopha. Sebapali e tlameha ho ba sebapali sa mantlha sehlopheng. |
| sehlopha Bolumo | Boemo ba molumo oa sehlopha. Sebapali e tlameha ho ba sebapali sa mantlha sehlopheng. |
| setšoantšo | URL ea setšoantšo se amanang le molumo oa hajoale (albamo, seteishene, kenyeletso, joalo-joalo). Haeba |
| Litšobotsi tsa Karabelo | Tlhaloso |
| the URL e qala ka /Artwork e ka fella ka ho tsamaisa hape. Ho eketsa parameter/notlolo latelaRedirects=1 ha o khutlisa setšoantšo se ka qoba ho tsamaisoa hape. | |
| semumu | Boemo ba semumu. Beha 1 haeba molumo o khutsitsoe. |
| khutsaDb | haeba sebapali se khutsitsoe, joale sena se na le molumo o sa feto-fetohang ho dB. |
| semumuVolume | Haeba ther e koetsoe, joale sena se na le boemo ba molumo o sa fetotsoeng. Lintlha li tsoa ho 0 ho isa ho 100. |
| lebitso | Sehlooho sa pina ea molumo e ntseng e bapaloa hajoale. Hape bona sehlooho1 tšobotsi. |
| tsebisaurl | URL bakeng sa tsebiso e hlahang. |
| id | Id e ikhethang ea lethathamo la lipapali. E lumellana le tšobotsi ea id ea karabo ea /Playlist. Haeba lethathamo la lipapali le fetoloa, nomoro ena e tla fetoha. |
| tlosa | ID e ikhethang e setiloe. E lumellana le tšobotsi ea prid karabong ea /Presets. Haeba preset e fetotsoe nomoro ena e tla fetoha e bontšang hore karabo leha e le efe e bolokiloeng ho /Presets e lokela ho hloekisoa. |
| boleng | Boleng ba molumo oa mohloli oa ho bapala: · cd – audioless tahlehelo boleng ba CD · HD – lossless mamelwang ka qeto e phahameng hore CD boleng kapa sampLebelo la 88200 samples/s kapa ho feta · dolbyAudio - DolbyDigital kapa AC3 · mqa – modumo o nepahetseng wa MQA o hlakotswe · mqaAuthored – e nepahetseng MQA-Authored audio decoded Nomoro ea boleng ke khakanyo ea bitrate ea boleng ba mohloli oa molumo o hatisitsoeng oa file. |
|
pheta |
0, 1, kapa 2. 0 e bolela lethathamo la ho pheta-pheta, 1 e bolela ho pheta pina, 'me 2 e bolela ho pheta-pheta. |
| metsotsoana | Nomoro ea metsotsoana ha pina ea audio e ntse e bapaloa. Boleng bona ha bo sebelisoe palong ea etag mme tswelopele ka boyona e ke ke ya baka kgutliso ho tswa pitsong ya nako e telele ya dikgetho. Bareki ba kopuoa ho eketsa boemo ba ho bapala, ha boemo bo bapala kapa bo phalla, ho ipapisitsoe le nako ho tloha karabelo. |
| tshebeletso | ID ea tšebeletso ea molumo oa hona joale. Sena ha se boleng ba ho hlahisa ho UI, joalo ka |
| Litšobotsi tsa Karabelo | Tlhaloso |
| khoele ea sebele e ka fapana le lebitso la tšebeletso ea molao. | |
| serviceIcon | URL ea aekhone ea tšebeletso ea hajoale. |
| shuffle/ | 0 kapa 1. 0 e bolela ho sutha, mme 1 e bolela ho suthela. |
| robala | Metsotso e setseng pele sebali sa nako sa boroko se sebetsa. |
| pina | Boemo ba pina ea hajoale moleng oa papali. Hape sheba molapoUrl. |
| naha | Boemo ba hajoale ba sebapali. E ka ba ho bapala, ho khefutsa, ho emisa, ho phallela, ho hokahanya, joalo-joalo. /Bapala e ka sebelisoa ho qala hape ha o le boemong ba khefutso empa eseng ha o eme. papali le molapo li lokela ho nkoa li na le moelelo o tšoanang. Hape sheba molapoUrl. |
|
stationImage |
URL bakeng sa setšoantšo sa seteishene sa seea-le-moea, haeba molumo oa hona joale e le seteishene sa seea-le-moea, mohlala, Deezer radio. E ka 'na ea tšoana le setšoantšo. |
| streamFormat | Sebopeho sa molumo. |
| molapoUrl | Boteng ba ntho ena bo lokela ho nkoa e le folakha le likahare tsa eona e le boleng ba opaque. Haeba e teng, e bontša: · Letoto la ho bapala ha se mohloli oa molumo oa hona joale (pina ha e na thuso) · ho qhekella le ho pheta-pheta ha li na thuso 'me li lokela ho tlosoa ho UI efe kapa efe ha ho khonahala · tse latelang le tse fetileng ha li fumanehe (empa bona le liketso) |
| syncStat | ID e ikhethang e bonts'ang phetoho efe kapa efe ho /SyncStatus karabelo. E lumellana le tšobotsi ea syncStat ea karabelo ea /SyncStatus. E fetoha neng kapa neng ha ho na le phetoho Boemong ba Sync. |
| sehlooho1 | Mola oa pele oa tlhahisoleseling o hlalosang molumo oa hajoale. sehlooho1, sehlooho2 le sehlooho3 E LOKELA ho sebelisoa e le mongolo oa UI efe kapa efe e bonts'ang mela e meraro ea metadata e ntseng e bapaloa hona joale. Se ke oa sebelisa boleng joalo ka albamo, sebini le lebitso. |
| sehlooho2 | Mohala oa bobeli oa tlhahisoleseling o hlalosang molumo oa hajoale. |
| sehlooho3 | Mohala oa boraro oa tlhahisoleseling o hlalosang molumo oa hajoale. |
| totlen | Kakaretso ea bolelele ba pina ea hajoale, ka metsotsoana. |
| twoline_title1 | Ea pele ho mela e 'meli e hlalosang molumo oa hona joale. twoline_title1 & twoline_title2, ha e le teng, E TSHWANETSE ho sebediswa e le mongolo wa UI efe kapa efe e hlahisang tse pedi. |
| Litšobotsi tsa Karabelo | Tlhaloso |
| metadata e bapalang hona joale. | |
| twoline_title2 | Ea bobeli ho mela e 'meli e hlalosang molumo oa hona joale. |
| bophahamo ba modumo | Boemo ba molumo oa sebapali ka liperesentetage; -1 e bolela hore molumo oa sebapali o tsitsitse. |
| metsotsoana | Palo ea metsotsoana ea pina ea audio ea hajoale e bapalitsoe. |
Example
http://192.168.1.100:11000/Status
E fumana boemo ba ho bapala ba sebapali.
http://192.168.1.100:11000/Status?timeout=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
E fumana boemo ba ho bapala ha sebapali se sebelisa likhetho tse telele. Sephetho se khutlisoa pele ho nako ea metsotsoana e 100 haeba boemo ba sebapali bo fetohile. Ho seng joalo, sephetho se tla khutlisoa kamora metsotsoana e 100.
2.2 Boemo ba Sebapali le Sehlopha sa Khokahano
Tlhaloso
Potso ea SyncStatus e khutlisa tlhahisoleseling ea libapali le tlhaiso-leseling ea libapali. Potso ena e khutlisa likarolo tse ngata tsa likarabo, tseo tse ling tsa tsona li sa sebetseng tokomaneng ena. Likarabo tse se nang litokomane li lokela ho hlokomolohuoa.
Kopa
/SyncStatus?timeout=metsotsoana&etag=etag- boleng
| Mekhahlelo | Tlhaloso |
| khefutso | Paramethara ea boikhethelo e sebelisoang ka likhetho tse telele. Ke nako ea likhetho ka metsotsoana. Nako e khothaletsoang ea ho khetha ke metsotsoana e 180. |
| etag | Paramethara ea boikhethelo e sebelisoang ka likhetho tse telele. Ena ke etag tšobotsi ho tsoa ho karabelo ea mohala e fetileng /SyncStatus. |
Karabo
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″ brand=”Bluesound” etag=”23″ outlevel="-62.9″ schemaVersion=”25″ e qalileng=”nete” sehlopha=”PULSE-0278 + 2″ syncStat=”23″ id=”192.168.1.100:11000″ mac=”90:56:82:9F:02:78″> 192.168.1.100
…..
ELA HLOKO: ha se litšobotsi tsohle tsa likarabo tse thathamisitsoeng chateng e latelang. Lintlha tse ling li ka ba teng 'me li lokela ho hlokomolohuoa.
| Litšobotsi tsa Karabelo | Tlhaloso |
| betri | E bonts'itsoe haeba sebapali se na le pakete ea betri. E kenyeletsa litšobotsi: · boemo – boemo ba tefiso, peresente · ho tjhaja – 1 haeba e ntse e tjhaja ha jwale · letšoao - URL sa setšoantšo sa sebapali se bontšang boemo ba hajoale ba tefiso |
| letšoao | Lebitso la sebapali. |
| db | Boemo ba molumo ho dB. |
| etag | Tag karabelo ea /SyncStatus, e sebelisetsoang ho khetha nako e telele. |
| sehlopha | Lebitso la sehlopha. |
| letšoao | URL e nang le setšoantšo sa aekhone ea sebapali. |
| id | IP ea sebapali le boema-kepe. |
| qalisoa | 'Nete e bolela hore sebapali se se se ntse se hlophisoa,' nete e bolela hore sebapali se hloka ho seta. Sebapali se tlameha ho hlophisoa ka sesebelisoa sa BluOS Controller. |
| Mac | ID e ikhethang ea sebapali bakeng sa segokanyimmediamentsi sa marang-rang. E ka ba aterese ea MAC. |
| monghadi | Aterese ea IP ea sebapali se hloahloa. E teng feela ha sebapali e le sebapali sa bobeli sehlopheng. Litšobotsi: · koung - nomoro ea boema-kepe. · ho hokahanya hape - 'nete haeba u leka ho hokela sebapali sa mantlha |
| mohlala | ID ea mohlala oa sebapali. |
| ModelName | Lebitso la mohlala oa sebapali. |
| semumu | Beha 1 haeba molumo o khutsitsoe. |
| khutsaDb | Haeba sebapali se khutsitsoe, joale sena ke boemo ba molumo o sa fetoleheng ho dB. |
| Litšobotsi tsa Karabelo | Tlhaloso |
| semumuVolume | Haeba sebapali se koetsoe, joale sena ke boemo ba molumo o sa bueng (0..100). |
| lebitso | Lebitso la sebapali. |
| schemaVersion | Mofuta oa software ea schema. |
| lekgoba | Liaterese tsa IP tsa sebapali sa bobeli. E teng feela haeba sebapali e le sebapali sa mantlha sa sehlopha. Ho ka ba le libapali tse ngata tsa bobeli. Litšobotsi: · id – aterese ea IP · koung - nomoro ea boema-kepe |
|
syncStat |
id ea boemo ba sync. E fetoha neng kapa neng ha ntho efe kapa efe ho / SyncStatus karabelo e fetoloa. Bapisa le element in/Boemo ba karabo. |
| bophahamo ba modumo | Boemo ba molumo ka sekala sa 0..100. -1 e bolela molumo o tsitsitseng. |
| sebaka | Lebitso la sehlopha se tsitsitseng. |
| zoneMaster | Haeba sebapali e le sebapali sa mantlha sehlopheng se tsitsitseng, sena se behiloe ho 'nete. |
| zoneLekhoba | Haeba sebapali e le sebapali sa bobeli sehlopheng se tsitsitseng, sena se behiloe ho 'nete. |
Example
http://192.168.1.100:11000/SyncStatus
E fumana boemo ba sebapali le sehlopha sa sebapali.
http://192.168.1.100:11000/SyncStatus?timeout=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
E fumana sebapali le boemo ba sehlopha sa sebapali se sebelisa likhetho tse telele. Sephetho se khutlisoa pele ho nako ea metsotsoana e 100 haeba boemo ba sebapali bo fetohile. Ho seng joalo, sephetho se tla khutlisoa ka metsotsoana e 100.
Taolo ea Molumo
E fetola boemo ba molumo oa sebapali. E boetse e sebelisoa ho khutsisa sebapali.
3.1 Seta Bolumo
Tlhaloso
Kopo ena e botsa kapa e beha molumo oa sebapali.
Mefuta eohle ea litaelo, ho sa tsotellehe hore na e sebelisa boemo ba 0..100, absolute dB kapa li-parameter tsa dB tse amanang, li qobelloa ho latela litekanyetso tse hlahisang boemo ka har'a mefuta e hlophisitsoeng ea molumo e fumanehang, eo hangata e leng -80..0. Bophahamo ba molumo bo ka fetoloa ho sebelisoa sesebelisoa sa BluOS Controller, ho Litlhophiso -> Sebapali -> Leqephe la molumo.
Potso e ts'ehetsa likhetho tse telele (tse sa bonts'itsoeng ka tlase).
Kopa
/Molumo
/Volume?level=level&tell_slaves=on_off
/Moqolo?mute=ho tima&bolella_makhoba=ho tima
/Volume?abs_db=db&tell_slaves=on_off
/Volume?db=delta-db&tell_slaves=on_off
| Mekhahlelo | Tlhaloso |
| boemo | Beha boemo ba molumo o felletseng oa sebapali. Ke palo e felletseng ho tloha ho 0 -100. |
| bolella_makhoba | E sebetsa ho libapali tse hlophisitsoeng. Haeba e setetsoe ho 0, ke sebapali se khethiloeng hajoale feela se fetolang molumo. Haeba e setetsoe ho 1, libapali tsohle sehlopheng li fetola molumo. |
| semumu | Haeba e setetsoe ho 0, sebapali sea khutsisoa. Haeba e setetsoe ho 1, sebapali ha se bue. |
| abs_db | Beha molumo o sebelisa sekala sa dB. |
| db | Etsa phetoho ea molumo o lekanyelitsoeng u sebelisa sekala sa molumo oa dB. db e ka ba nomoro e nepahetseng kapa e mpe. |
Karabo
<volume db=”-49.9″ mute=”0″ offsetDb=”0″ etag=”6213593a6132887e23fe0476b9ab2cba”>15</volume>
| Litšobotsi tsa Karabelo | Tlhaloso |
| Litšobotsi tsa Karabelo | Tlhaloso |
| db | Boemo ba molumo ho dB. |
| semumu | 1 haeba sebapali se khutsisitsoe, 0 haeba sebapali se sa bue. |
| khutsaDb | Haeba sebapali se khutsitsoe, joale sena ke boemo ba molumo o sa fetoleheng ho dB. |
| semumuVolume | Haeba sebapali se koetsoe, joale sena ke boemo ba molumo o sa bueng (0..100). |
| bophahamo ba modumo | Boemo ba hona joale ba molumo: 0..100 kapa -1 bakeng sa molumo o tsitsitseng. |
Example
http://192.168.1.100:11000/Volume?level=15
E beha boemo ba molumo oa sebapali ho 15 (ho 100).
http://192.168.1.100:11000/Volume? tell_slaves=1&db=2
E eketsa molumo oa sebapali se hloahloa 192.168.1.100, le libapali tsohle tsa bobeli sehlopheng seo, ka 2 dB.
http://192.168.1.100:11000/Volume?mute=1
E khutsisa sebapali.
Buka ea 3.2 holimo
Tlhaloso
Kopo ena e eketsa molumo ka dB e itseng (boleng bo tloaelehileng ke 2dB).
Kopa
/Volume?db=db_value
| Mekhahlelo | Tlhaloso |
| db | Mehato ea ho eketsa molumo ho dB (boleng bo tloaelehileng 2dB) |
Karabo
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>
| Litšobotsi tsa Karabelo | Tlhaloso |
| db | Boemo ba molumo ho dB. |
| semumu | 1 haeba sebapali se khutsitsoe, 0 haeba sebapali se sa khutse |
| Litšobotsi tsa Karabelo | Tlhaloso |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?db=2
Eketsa molumo ka 2dB.
3.3 Buka e tlase
Tlhaloso
Kopo ena e fokotsa molumo ka dB e itseng (boleng bo tloaelehileng ke -2dB).
Kopa
/Volume?db=-db_boleng
| Mekhahlelo | Tlhaloso |
| db | Mehato ea ho eketsa molumo ho dB (boleng bo tloaelehileng -2dB) |
Karabo
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>
| Litšobotsi tsa Karabelo | Tlhaloso |
| db | Boemo ba molumo ho dB |
| semumu | 1 haeba sebapali se khutsitsoe, 0 haeba sebapali se sa khutse |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?db=-2
Fokotsa molumo ka 2dB.
3.4 Khutsa Bula
Tlhaloso
Kopa
/Molumo?mumu=1
| Mekhahlelo | Tlhaloso |
| semumu | Beha ho 1 ho khutsisa sebapali |
Karabo
<volume muteDb=”-43.1″ db=”100″
muteVolume=”11″
semumu=”1″
offsetDb=”0″
etag=”2105bed56563d9da46942a696cfadd63″>0</volume
>
| Litšobotsi tsa Karabelo | Tlhaloso |
| khutsaDb | Boemo ba molumo ho dB pele bo khutsa |
| db | Boemo ba molumo ho dB |
| semumuVolume | Boemo ba molumo ka liperesente pele bo khutsitse |
| semumu | 1 e bolela hore sebapali se khutsitsoe |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?mute=1
3.5 Khutsa
Tlhaloso
Kopo ena e etsa hore sebapali se khone ho khutsisa.
Kopa
/Molumo?mumu=0
| Mekhahlelo | Tlhaloso |
| semumu | E behe ho 0 ho khutsisa sebapali |
Karabo
<volume db=”-43.1″ mute=”0″ offsetDb=”0″ etag=”e72d53db17baa526ebb5ee9c26060b1f”>11</volume>
| Litšobotsi tsa Karabelo | Tlhaloso |
| db | Boemo ba molumo ho dB |
| semumu | 0 e bolela hore sebapali ha sea khutsa |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?mute=0
Taolo ea ho bapala
Litaelo tsena li sebelisoa bakeng sa taolo ea mantlha ea ho bapala. Litaelo li kenyelletsa ho bapala, khefutso, emisa, ho tlola, ho khutlela morao, ho sunya, le ho pheta.
4.1 Bapala
Tlhaloso
Qala ho bapala mohloli oa molumo oa hajoale. Mekhahlelo ea boikhethelo e lumella ho tlolela lipina tsa molumo, le ho kenya letsoho ho khethoa, pele o qala ho bapala molumo.
Kopa
/Bapala
/Bapala?batla=metsotsoana
/Bapala?batla=metsotsoana&id=trackid
/Bapala?url=encodedStreamURL
| Mekhahlelo | Tlhaloso |
| batla | Tlolela sebakeng se boletsoeng pina ea hajoale. E sebetsa ha feela /Karabelo ea boemo e kenyeletsa . Ha e khone ho sebelisoa le li-parameter tsa inputType le index. |
| encodedStreamURL | URL ea audio e tloaelehileng e tsamaisoang. E lokela hoba jwalo URL khouoe. |
Karabo
bapala
molapo
| Litšobotsi tsa Karabelo | Tlhaloso |
|
naha |
Naha ka mora ho phethahatsa taelo. Sheba /Boemo ba boemo ba karabo bakeng sa lintlha tse ling. |
Example
http://192.168.1.100:11000/Play
Qala ho bapala pina ea hajoale.
http://192.168.1.100:11000/Play?seek=55
Qala ho bapala molumo ka metsotsoana e 55 ho pina ea hajoale.
http://192.168.1.100:11000/Play?seek=55&id=4
Qala ho bapala ka molumo ka metsotsoana e 55 ho pina ea 5 moleng.
192.168.1.125:11000/Bapala?url=https%3A%2F%2Fwww%2Esoundhelix%2Ecom%2Fexampka tlase ho%2Fmp3%
2FSoundHelix-Pina-1%2Emp3
Qala ho bapala ka molumo oa audio mp3 inthaneteng.
Khefutsa
Tlhaloso
Emisa molumo o ntseng o bapala hona joale.
Haeba alamo e ntse e lla, 'me e na le nako, nako ea alamo e tla hlakoloa.
Kopa
/Emisa
/Emisa?toggle=1
| Mekhahlelo | Tlhaloso |
| toggle | Haeba e behiloe ho 1, boemo ba hona joale ba khefu bo tla fetoloa. |
Karabo
kgefutsa
| Sebopeho sa Karabelo | Tlhaloso |
| naha | Naha ka mora ho phethahatsa taelo. Sheba /Boemo ba boemo ba karabo bakeng sa lintlha tse ling. |
Example
http://192.168.1.100:11000/Pause
E emisa molumo o ntseng o bapaloa hajoale.
4.3 Ema
Tlhaloso
Emisa molumo o bapalang hajoale. Haeba alamo e ntse e letsa, mme e na le nako, nako ya alamo e hlakotswe
/Ema
| Mekhahlelo | Tlhaloso |
| Ha ho letho |
Karabo
Ema
| Litšobotsi tsa Karabelo | Tlhaloso |
| naha | "Emisa" ho bolela hore molumo oa hajoale o emisitsoe. |
Example
http://192.168.1.100:11000/Stop
E emisa molumo o ntseng o bapaloa hajoale.
4.4 Tlola
Tlhaloso
Tlolela pina e latelang ea molumo letotong la ho bapala
Ha e bapala ho tloha moleng oa papali, e tla tlolela pina e latelang moleng. Haeba pina ea hajoale e le ea ho qetela moleng, ho letsetsa /Skip ho tla ea pina ea pele moleng. . E tla tlolela pina e latelang kapa ea pele moleng ho sa natsoe boemo ba ho pheta-pheta.
Ho fumana hore na o sebelisa lethathamo la lipapali, netefatsa hore ha ho naUrl> ho kena ho /State karabelo.
Joale u ka sebelisa taelo ea /Skip.
U ka boela ua tlola lipina bakeng sa liteishene tse ling tsa radio tse phallelang. Tsena li sebetsoa ka taelo ea /Action.
Mehloli e meng e joalo ka TuneIn le Optical Input ha e tšehetse khetho ea ho tlola. Mehloli ena e tla ba le aURL> ho kena empa ha ho na ho tlola ketso lebitsong la karabo ea /Status.
Kopa
/Tloha
| Mekhahlelo | Tlhaloso |
| Ha ho letho |
Karabo
21
| Litšobotsi tsa Karabelo | Tlhaloso |
| id | Id ea pina ka mor'a ho phethahatsa taelo ea skip. Sheba tšobotsi ea pina ea /Status ho fumana lintlha. |
Example
http://192.168.1.100:11000/Skip
Tlolela pina e latelang.
4.5 Khutlela
Tlhaloso
Haeba pina e ntse e bapala 'me e se e ntse e bapala metsotsoana e fetang e mene, joale e tla khutlela qalong ea pina.
Ho seng joalo, taelo ea morao e tla ea pina e fetileng lenaneng la hona joale la lipina. Haeba pina ea pele lethathamong la lipina, ho letsa ho tla ea pina ea ho qetela. E tla ea pina e fetileng kapa ea pele moleng ho sa tsotellehe boemo ba ho pheta-pheta.
Ho fumana hore na o sebelisa lethathamo la lipapali, netefatsa hore ha ho naUrl> karolo ho karabo ea /Status.
Joale u ka sebelisa taelo ea /Back.
U ka boela ua khutlela morao lipina bakeng sa liteishene tse ling tsa radio tse phallelang. Tsena li sebetsoa ka taelo ea /Action.
Mehloli e meng e joalo ka TuneIn le Optical Input ha e tšehetse khetho ea morao. Mehloli ena e tla ba le aUrl> karolo empa ha ho na lebitso la ketso la ho tlola ho karabo ea /Status.
Kopa
/Ka morao
| Mekhahlelo | Tlhaloso |
| Ha ho letho |
Karabo
19
| Litšobotsi tsa Karabelo | Tlhaloso |
| id | Id ea pina ka mor'a ho phethahatsa taelo ea morao. Sheba tšobotsi ea pina ea /Status ho fumana lintlha. |
4.6 Hlakola
Tlhaloso
Taelo ea shuffle e etsa letoto le lecha ka ho sunya lethathama la hajoale. Letoto la mantlha (le sa ferekanngoa) le tla bolokoa bakeng sa ho khutlisoa ha shuffle e tiisitsoe.
Kopa
/Suffle?state=0|1
| Mekhahlelo | Tlhaloso |
| naha | · 0 ho tima shuffle · 1 ho etsa hore shuffle. Ha e sebetse haeba mokoloko o se o ntse o hlaka. Sheba /Boemo ba karabo element. |
Karabo
| Litšobotsi tsa Karabelo | Tlhaloso |
| fetotsoe | 1 e bolela hore lethathamo le fetotsoe ho tloha ha le laeloa. 0 bolela hore ha ho joalo. |
| bolelele | Kakaretso ea lipina tse moleng oa hajoale. |
| shuffle/ | Boemo ba shuffle. 1 e bolela hore letoto la hona joale lea hlaka. 0 e bolela hore letoto la hajwale ha lea hlophiswa. |
| id | Lethathamo la ID la hajoale. E fetoha neng kapa neng ha lethathamo la lipapali le fetoloa. |
Example
http://192.168.1.100:11000/Shuffle?state=1
E kopanya lethathamo la hona joale la papali.
4.7 Pheta
Tlhaloso
E beha likhetho tsa ho pheta-pheta. Pheta-pheta e na le linaha tse tharo; 0 e bolela ho pheta mokoloko oa hona joale, 1 e bolela ho pheta pina ea hona joale 'me 2 e bolela hore u se ke ua pheta. Liphetoho tsohle ha li na moeli, ke hore, ha li emise.
Kopa
/Repeat?state=0|1|2
| Mekhahlelo | Tlhaloso |
| naha | · 0 ho pheta tatellano eohle ea papali · 1 ho pheta pina ea hajoale · 2 ho tima pheta-pheta |
Karabo
| Litšobotsi tsa Karabelo | Tlhaloso |
| bolelele | Palo eohle ea lipina tse lethathamong la hajoale la papali. |
| id | Lethathamo la ID la hajoale. E fetoha neng kapa neng ha lethathamo la lipapali le fetoloa. |
| pheta | Boemo ba hona joale ba ho pheta-pheta. |
Example
http://192.168.1.100:11000/Repeat?state=1
E pheta pina e bapalang hona joale.
4.8 Liketso tsa ho Phalla Liteishene tsa seea-le-moea
Tlhaloso
Liketso li u lumella ho fetela pele, ho khutlela morao, ho rata le ho thibela lipina ho liteishene tsa seea-le-moea tse khethiloeng, tse kang Slacker kapa Radio Paradise kapa Amazon Music Prime Stations. Liteishene tsa seea-le-moea tse phallelang ha li kenye lipina letotong la ho bapala. Ho e-na le hoo, ba fana ka a URL eo u ka e sebelisang ho phethahatsa mosebetsi o lakatsehang.
Skip e tla ea pina e latelang. Morao tla ea pina e fetileng. Lerato le tla tšoaea pina ka tsela e ratileng ka har'a tšebeletso ea 'mino. Thibelo e tla tlolela pina e latelang ebe e tšoaea pina eo e sa e rateng ka har'a tšebeletso ea 'mino.
Haeba ho na le aUrl> ho kena karabelong ea /Status, le ketso e nepahetseng, o ka etsa mesebetsi ena. Ketso e tla ba le URL se sebedisoang ho phethahatsa ketso.
Ex ke enaample ho tsoa ho /State karabelo ea sebapali se bapalang seea-le-moea sa Slacker:
<action name=”skip” url=”/Action?service=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
seteishene” state="-1″ text="Thibelo" url=”/Action?service=Slacker&ban=4799148″/>
Ho sena mohlalaample, mokokotlo ha o fumanehe, empa ho tlola, lerato le thibelo lia khoneha.
Kopa
/Ketso?tšebeletso=lebitso-la tshebeletso&ketso=ketso-URL
Hlokomela: Lintlha tse tobileng tsa kopo (mafelo le liparamente) li fanoa ke ba amehang element. Litaelo tse ho Example karolo e ka tlase ho ts'ebeliso eohle / Ketso empa URI efe kapa efe ea khonahala.
| Mekhahlelo | Tlhaloso |
| E fanoe ka element. |
Karabo
Bakeng sa karabo, o fumana kananelo ea ketso. Bakeng sa ho tlola le ho khutla, o fumana:
Bakeng sa lerato u fumana:
1
Bakeng sa thibelo o fumana:
0
| Litšobotsi tsa Karabelo | Tlhaloso |
| karabo | Haeba motso oa motheo oa karabo ke ebe mongolo node ke tsebiso ho bontša ho mosebedisi. Haeba motsoako o mong oa metso o khutlisoa 'me the e kenyelelitse tšobotsi ea tsebiso joale tsebiso e lokela ho bontšoa. |
Example
http://192.168.1.100:11000/Action?service=Slacker&skip=10965139
E tlolela pina e latelang ea seea-le-moea sa Slacker.
http://192.168.1.100:11000/Action?service=Slacker&ban=33332284
E thibela pina ea seea-le-moea ea Slacker e ntseng e bapala hona joale ebe e tlolela pina e latelang.
Taolo ea Lethathamo la Bapala
Mokhoa o mong oa ts'ebetso ea sebapali ke ho kenya lipina moleng oa papali, ebe o bapala lipina tse tsoang moleng oo oa papali. Litaelo tsena li u lumella ho view le ho laola lethathamo la lipapali.
5.1 Lenane la lipina
Tlhaloso
Eka khutlisa boemo ba ho bapala, kapa khutlisetsa lintlha tsa lipina tsohle tse moleng oa papali.
Ha ho khothalletsoe ho sebelisa potso ena ntle le bolelele kapa liparamente tsa ho qala le ho qetela, kaha ho seng joalo karabo e telele haholo e ka hlahisoa.
Kopa
/Lenane la dipina
/Lenane la dipina?length=1
/Lenane la ho bapaloa?qala=pele&qetellong=ho qetela (khutlisa karolo ea mokoloko, bakeng sa pagination hangata)
| Mekhahlelo | Tlhaloso |
| bolelele=1 | Khutlisetsa litšoaneleho tsa boemo bo holimo feela 'me u se na lintlha tsa pina. |
| qala | Keno ea pele moleng oa ho kenyelletsa karabong, ho qala ho 0. |
| QETA | Keno ea ho qetela moleng oa ho kenyelletsa karabong. |
Karabo
Bakeng sa boemo ba mokoloko oa papali:
13
243
1
Bakeng sa lethathamo la lipapali:
2002
Anne-Marie
2002
Deezer:487381362
| Litšobotsi tsa Karabelo | Tlhaloso |
| lebitso | Lebitso la hona joale la lethathamo la lipapali. |
| fetotsoe | 0 e bolela hore letoto ha le so fetoloe ho tloha ha le kenngoa. 1 e bolela hore mokoloko o fetotsoe ho tloha ha o ne o kenngoa. |
| bolelele | palo eohle ea lipina tse moleng oa hajoale |
| id | id e ikhethang bakeng sa boemo ba hona joale ba mokoloko (mohlala, 1054). E tšoana le ea ho/karabelo ya boemo. |
| pina | Pina e entsoe ka likaroloana tse 'maloa: · albumid = id ea albamo eo pina e leng ho eona · tšebeletso = tšebeletso ea 'mino oa pina · artistid = id ea sebini sa pina · songid = id ea pina · id = boemo ba pina moleng oa hajoale. Haeba pina e khethiloe hajoale, id ea pina e tšoana le ho/karabelo ya boemo. · sehlooho = lebitso la pina · bonono = lebitso la moetsi · alb = lebitso la albamo |
Example
http://192.168.1.100:11000/Playlist
E thathamisa lipina tsohle tse moleng oa papali.
http://192.168.1.100:11000/Playlist?length=1
5.2 Hlakola Pina
Tlhaloso
Tlosa pina lethathamong la hona joale la ho bapala.
Kopa
/Hlakola?id=boemo
| Mekhahlelo | Tlhaloso |
| id | Id ea pina ea pina e tla hlakoloa letotong la ha joale la ho bapala. |
Karabo
9
| Litšobotsi tsa Karabelo | Tlhaloso |
| hlakotsoe | Boemo moleng oa pina e tlo tlosoa. |
Example
http://192.168.1.100:11000/Delete?id=9
E tlosa pina sebakeng sa 9 moleng oa papali.
5.3 Move A Track
Tlhaloso
Tsamaisa pina ka har'a lethathamo la hona joale la ho bapala.
Kopa
/Sutha?ncha=sebaka&khale=qalo
| Mekhahlelo | Tlhaloso |
| e ncha | Sebaka se secha pina e tsamaisoang. |
| khale | Boemo ba khale ba pina e tsamaisoang. |
Karabo
suthile
| Litšobotsi tsa Karabelo | Tlhaloso |
| suthile | E bontša hore pina e tsamaisitsoe. |
Example
http://192.168.1.100:11000/Move?new=8&old=2
Tsamaisa pina sebakeng sa 2 ho ea boemong ba 8 moleng oa papali.
5.4 Lethathamo le hlakileng
Tlhaloso
Hlakola lipina tsohle lethathamong la hona joale la ho bapala
Kopa
/Ho hlakile
| Mekhahlelo | Tlhaloso |
| Ha ho letho |
Karabo
| Litšobotsi tsa Karabelo | Tlhaloso |
| fetotsoe | 0 e bolela hore letoto ha lea fetoloa ho tloha ha le laetsoe, 1 e bolela hore mokoloko o fetotsoe ho tloha ha o laetse. |
| bolelele | Palo eohle ea lipina tse lethathamong la hajoale. |
| id | Id e ikhethang bakeng sa letoto la hajoale. |
Example
http://192.168.1.100:11000/Clear
Sena se tlosa lipina tsohle ho tsoa lethathamong la lipapali.
5.5 Boloka Lethathamo
Tlhaloso
Boloka lethathamo la lipapali e le lethathamo la lipina la BluOS.
Kopa
/Boloka?lebitso=lenane_lebitso
| Mekhahlelo | Tlhaloso |
| lebitso | Lebitso la lenane le bolokilweng. |
Karabo
126
| Litšobotsi tsa Karabelo | Tlhaloso |
| dikenyo | Palo eohle ea lipina tse moleng oa ho bapala o bolokiloeng. |
Example
http://192.168.1.100:11000/Save?name=Dinner+Music
Sena se boloka lethathamo la lipapali e le "Mmino oa Lijo tsa Mantsiboea".
Li-Presets
Likopo tse behiloeng esale pele li u lumella ho thathamisa li-sets'oants'o tsohle tsa sebapali, ho kenya li-presets, 'me u theohele holimo / tlase. Li-presets li tlameha ho eketsoa le ho hlakoloa ho sebelisoa sesebelisoa sa BluOS Controller. Li-presets li ka kenyelletsa liteishene tsa seea-le-moea, manane a bapaloang le tse kentsoeng (mohlala
Bluetooth, analog, optical, HDMI ARC).
6.1 List Presets
Tlhaloso
Etsa lethathamo la li-presets tsohle ho sebapali sa hajoale sa BluOS.
Kopa
/Presets
| Mekhahlelo | Tlhaloso |
| Ha ho letho |
Karabo
<preset id=”6″ name=”Serenity” url=”RadioParadise:/42:4/Serenity”
image=”https://img.radioparadise.com/channels/0/42/cover_512x512/0.jpg”/>
<preset id=”7″ name=”1980s Alternative Rock Classics” url=”/Load?service=Tidal&id=fd3f797e-
a3e9-4de9-a1e2-b5adb6a57cc7″ image=”/Artwork?service=Tidal&playlistimage=afacfc12-24034caf-a5c5-a2af28d811c8″/> </presets>
| Litšobotsi tsa Karabelo | Tlhaloso |
| boikgohomoso | Id e ikhethang ea li-presets tsa sebapali. E tšoana le ea ho/karabelo ya boemo. |
| lebitso | Lebitso le behiloeng esale pele. |
| id | ID e seng e setilwe. |
| url | Ho hlophisoa esale pele URL. Ke mohloli o seng o setiloe URL se sebedisoang ho kenya se seng. |
| setšoantšo | Setšoantšo URL ea sete-pele. Haeba e URL e qala ka /Artwork e ka fella ka ho tsamaisa hape. Ho eketsa parameter/notlolo latelaRedirects=1 ha o khutlisa setšoantšo se ka qoba ho tsamaisoa hape. |
Example
http://192.168.1.100:11000/Presets
Thathamisa litlhophiso tsohle tsa sebapali.
6.2 Laola Setulo sa Pele
Tlhaloso
E qala ho bapala preset. U ka khetha nomoro e itseng e seng e setiloe, hammoho le e latelang kapa e fetileng. Linomoro tse seng li setiloe ha lia tlameha ho ba ka tatellano, ke hore, u ka ba le li-presets 1,2,3 5, 7 le 8. Li-presets li pota-pota ho tloha holimo ho ea tlase le tlase ho ea holimo.
Kopa
/Preset?id=presetId|-1|+1
| Mekhahlelo | Tlhaloso |
| id | Nomoro ea id ea setaele se tlang ho kenngoa. Lenane la li-ID tse fumanehang esale pele le fumaneha ka taelo ea Show Presets. Haeba id e setang esale pele e le +1, e tla kenya setaele se latelang. Haeba id e setang esale pele e le -1, e tla kenya setaele se fetileng. |
Karabo
Haeba preset e le lethathamo la lipina, e khutlisa palo ea lipina tse kentsoeng esale pele.
60
Haeba seta esale pele ke seea-le-moea, se khutlisetsa boemo ba molapo.
molapo
| Litšobotsi tsa Karabelo | Tlhaloso |
| tshebeletso | lebitso la tshebeletso la setaele se jarollotsweng |
| dikenyo | palo ea lipina tsa setaele se kentsoeng |
Example
http://192.168.1.100:11000/Preset?id=4
Laela setaele ka id 4 e seng e setiloe.
http://192.168.1.100:11000/Preset?id=+1
Ho Batla Likahare le ho Batla
Karolo ena e hlalosa litaelo bakeng sa ho bala le ho batla litaba tsa litšebeletso tsa 'mino.
7.1 Ho bala Litaba tsa 'Mino
Tlhaloso
Tsamaea ka mehloli ea 'mino e fumanehang, hammoho le lintho tse kenang le manane a bapaloang.
Motso oa likarabo ke ntle le haeba ho na le karabelo ea phoso. Liphetho tse ngata ke tatellano ea . Maemong a mang sephetho ke tatellano ea , e 'ngoe le e 'ngoe ea tsona e na le tatellano haeba . Lintlha tsohle li fanoa ho sebelisoa litšoaneleho. Ha ho na li-node tsa mongolo.
Sephetho sa mohala oa /Browse e kanna ea ba phoso e kenyellelitsoeng ho motsoako oa metso. Lintlha tsa phoso li fanoe ho e 'ngoe le zero kapa ho feta li-node tsa mongolo.
Kopa
/Batla?senotlolo=boleng ba senotlolo
/Browse?key=key-value&withContextMenuItems=1
| Mekhahlelo | Tlhaloso |
| senotlolo | Khetho ea parameter. Ho ba sieo ha paramethara ena ho tla fella ka ho sheba maemo a holimo. E khutlisa litaba bakeng sa maemo a mang ntle le boemo bo holimo /Browse. E sebelisa boleng bo nkiloeng ho "browseKey", "nextKey", "parentKey", kapa "contextMenuKey" karabong ea pejana. Tlhokomeliso: bohlokoa-boleng bo tlameha ho ba URL khouoe |
| withContextMenuItems | Khetho ea parameter. Theko e lula e le 1. Paramethara ena e sebelisoa ho fumana menyu ea litaba tsa inline ha o fumana sephetho sa manane a bapaloang, lialbamo, lipina, liteishene, litaki, jj. |
Karabo
Karabo ea boemo bo holimo ea ho bala:
<item image=”/images/InputIcon.png” text=”Optical Input”
bapalaURL=”/Bapala?url=Capture%3Ahw%3A1%2C0%2F1%2F25%2F2%2Finput1″ inputType=”spdif”
mofuta=”molumo”/>
Likarabo tse ling tsa ho bala:
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
service=”Deezer” searchKey=”Deezer:Batla” type="menu">
ntho browseKey=”/Playlists?service=Deezer&genre=0&category=toplist” text=”Manane a Bapalwang a Tummeng”
mofuta=”link”/>
mofuta=”link”/>
mofuta=”link”/>
ntho browseKey=”/Songs?service=Deezer&genre=0&category=toplist” text=”Lipina Tse Ratoang”
mofuta=”link”/>
| Litšobotsi tsa Karabelo | Tlhaloso |
| Sheba litafole tsa elemente/ea tšobotsi ka tlase |
Example
HLOKOMELA: lintlha tsohle tsa bohlokoa li tlameha ho kenyeletsoa UTF-8.
http://192.168.1.100:11000/Browse
E sheba maemo a holimo.
http://192.168.1.100:11000/Browse?key=Tidal%3A
E ea ka boemo ba bobeli, e khutlisetsa mekhahlelo ea Tidal.
http://192.168.1.100:11000/Browse?key=Tidal%3AmenuGroup%2F3
Na boemo ba boraro bo sheba, bo khutlisetsa likaroloana tsa Tidal Masters (Sehlopha sa 3).
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters
E sheba boemo ba bone, e khutlisa sehlopha sa pele sa lialbamo tsa Tidal Masters.
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters%26 start%3D30%26end%3D79
Na boemo bo bong ba bone bo ntse bo bala, bo khutlisetsa sehlopha sa bobeli sa lialbamo tsa Tidal Masters.
| Element | Tšobotsi (le boleng) | Tlhaloso | |
| serviceIcon | URI ea aekhone bakeng sa ts'ebeletso e ntseng e batloa hajoale. | ||
| serviceName | Lebitso la ts'ebeletso e ntseng e lekoa hajoale, bakeng sa pontšo ea mosebelisi. | ||
| searchKey | Boleng bo ka sebelisoang bakeng sa paramethara ea bohlokoa ho / Browse kopo ea ho batla ts'ebeletso ea hajoale (kapa karolo e 'ngoe e tebileng ea bolaoli). Ho feta moo, kopo e tla ba le parameter ea aq e nang le lentsoe la ho batla. | ||
| nextKey | Boleng boo u ka bo sebelisang bakeng sa paramethara ea bohlokoa ho / Browse kopo ea ho fumana leqephe le latelang la lintho tsa hajoale view. Boholo ba paging chunk ha bo tlas'a taolo ea mosebelisi oa API 'me ha ho na teko e lokelang ho etsoa ho hlalosa kapa ho laola lintlha tsa potso ea boleng bona. | ||
| parentKey | Boleng boo u ka bo sebelisang bakeng sa paramethara ea bohlokoa ho / Browse kopo ea ho khutlela morao ka maemo haeba mokhoa oa ho khutlela morao o ka tlosoa. | ||
| mofuta | menu | Sebaka sa ho sesa se ka bang le motsoako oa mofuta ofe kapa ofe oa ntho. Hangata e tla ba le lihokelo kapa lintho tse mameloang feela. | |
| moeleloMenu | Lethathamo la lintho tsa mofuta o boletsoeng. | ||
| baetsi ba litšoantšo | |||
| Element | Tšobotsi (le boleng) | Tlhaloso | |
| baqapi | |||
| lialbamo | |||
| manane a bapalwang | |||
| litselana | |||
| mefuta | |||
| likarolo | Likarolo tsa alfabeta. | ||
| lintho | Lenane la liphetho tse akaretsang. Hangata ke motsoako oa li-menu nodes (mofuta = "link") le lintho tsa seea-le-moea (mofuta = "molumo"). | ||
| difoldara | E kanna ea ba le lifoldara, lipina le manane a bapaloang. | ||
| mongolo | Ke ea sehlopheng. | ||
| nextKey | Boleng boo u ka bo sebelisang bakeng sa paramethara ea bohlokoa ho / Browse kopo ea ho fumana leqephe le latelang la lintho tsa sehlopha. | ||
| parentKey | Boleng boo u ka bo sebelisang bakeng sa paramethara ea bohlokoa ho / Browse kopo ea ho khutlela morao ka maemo haeba mokhoa oa ho khutlela morao o ka tlosoa. | ||
| mofuta | sehokelo | Node e akaretsang lethathamong la maemo a holimo a lebisang ho li-node tse ling | |
| molumo | Node e ka bapaloang ka kotloloho | ||
| moetsi oa litšoantšo | Ntho e emelang motaki | ||
| Element | Tšobotsi (le boleng) | Tlhaloso | |
| moqapi | Ntho e emelang moqapi | ||
| alebamo | Ntho e emelang alebamo kapa pokello e ts'oanang | ||
| lenane la dipina | Ntho e emelang lenane la lipina kapa pokello e tšoanang | ||
| pina | Ntho e emelang pina e le 'ngoe | ||
| mongolo | Node e hlakileng ea mongolo. | ||
| karolo | Karolo ea alfabeta. | ||
| foldara | Sephutheli se foldareng se shebelle. | ||
| mongolo | Tlhaloso ea sehlooho kapa ea pele | ||
| mongolo2 | Mola oa bobeli | ||
| setšoantšo | Letšoao kapa mosebetsi oa bonono bakeng sa ntho eo. Haeba setšoantšo se qala ka
/Sets'oants'o se ka fella ka ho tsamaisa hape. Ho eketsa parameter/senotlolo latelaRedirects=1 ha o khutlisa setšoantšo se ka qoba ho tsamaisoa hape. |
||
| browseKey | Boleng bo lokelang ho sebelisoa bakeng sa paramethara ea bohlokoa ho tse latelang /Kopo ea ho sheba ho theola maemo. | ||
| bapalaURL | URI e ka koptjoang ka kotloloho ho kopa ketso ea kamehla ea ntho eo ho buuoang ka eona. Hangata sena ke ho hlakola queue le ho qala ho e bapala. | ||
| ho bapala ka boiketsetsoURL | URI e ka kop | ||
| Element | Tšobotsi (le boleng) | Tlhaloso |
| karolo ea letoto la lipapali. | ||
| contextMenuKey | Boleng boo u ka bo sebelisang bakeng sa paramethara ea bohlokoa ho / Browse kopo ea ho fumana sephetho e leng lenane la liketso tse amanang le ntho eo. | |
| ketsoURL | URI e ka koptjoang ka kotloloho ho etsa ketso e boletsoeng. |
Lintlha tsa lethathamo la litaba li kanna tsa ba le boleng bo latelang bakeng sa mofuta oa mofuta.
| Tšobotsi | ||
| Tlhaloso | ||
| thatohatsi | -eketsa | Kenya ntho eo u e ratang (kapa e lekanang) |
| -hlakola | Tlosa ntho eo mosebedisi a e ratang | |
| eketsa | Eketsa lethathamong la lipapali | |
| eketsa | -hona joale | Eketsa lethathamong la ho bapala ka mor'a pina ea hona joale 'me u bapale hona joale |
| -E 'ngoe | Eketsa letotong la ho bapala ka mor'a pina ea hona joale | |
| -ho qetela | Eketsa qetellong ea letoto la lipapali | |
| eketsaAll | -hona joale | Kenya ntho ea lipina tse ngata letotong la ho bapala 'me u bapale hona joale |
| -E 'ngoe | Kenya ntho e nang le lipina tse ngata moleng oa ho bapala ka mor'a pina ea hona joale kapa ntho ea lipina tse ngata | |
| -ho qetela | Kenya ntho ea lipina tse ngata qetellong ea mokoloko oa papali | |
| playRadio | Bapala seea-le-moea se amanang le ntho eo | |
| hlakola | Hlakola ntho (hangata lethathamo la lipina). Netefatso ea mosebelisi e tlameha ho kopuoa |
Ha u bala ka paramethara "withContextMenuItem=1", sephetho se tla ba le lethathamo la litaba tse kahare.
Example
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26genre%3D0%26category %3Dtoplist&withContextMenuItems=1
Na kopo Deezer => What's Hot => Li-albhamu tse tummeng tse nang le menu ea moelelo oa inline.
Karabo
Karabo e na le inline bakeng sa ntho ka 'ngoe.
<item text=”Essonne History X” contextMenuKey=”Deezer:contextMenu/Album?albumid=693798541″
bapalaURL=”/Eketsa?service=Deezer&albumid=693798541&playnow=1″ image=”/Artwork?service=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”
ketsoURL=”/Eketsa?service=Deezer&playnow=1&clear=0&shuffle=0&where=nextAlbum&albumid=693798541″/>
<item text=”Shuffle” type=”add-shuffle”
ketsoURL=”/Eketsa?service=Deezer&shuffle=1&playnow=1&where=nextAlbum&albumid=693798541″/>
<item text=”Add next” type=”addAll-next” actionURL=”/Eketsa?service=Deezer&playnow=-1&where=nextAlbum&albumid=693798541″/>
<item text=”Add last” type=”addAll-last” actionURL=”/Eketsa?service=Deezer&playnow=-1&where=last&albumid=693798541″/>
…
Lintlha tsa Phethahatso le Malebela
Mofuta oa mofuta oa ntho o fanoe e le leseli le ka thusang likhetho tse fapaneng tsa ponts'o.
Bokhoni ba ho bala likahare tsa ntho bo bontšoa ke boteng ba browseKey tšobotsi. Bokhoni ba ho bapala ntho (kaofela) bo bontšoa ke boteng ba papaliURL (mme mohlomong le ho bapala ka boiketsetsoURL) tšobotsi. Ntho e kanna ea ba le tšobotsi ea browseKey le papaliURL tšobotsi.
Ha bobeli ba bapalaURL le ho bapalaURL Litšoaneleho li teng, tseo motho a ka li sebelisang e le khetho ea kamehla ea ho bapala e lokela ho ba taba ea khetho ea mosebelisi.
Litefiso tsa URI hangata e tla ba li-URI tse amanang le karolo ea tsela e felletseng. Li-URI tse amanang li rarolloa ho ba li-URI tse felletseng ho latela RFC 3986.
browseKey, contextMenuKey le searchKey litšobotsi tsa boleng li tla lula li kentsoe URI (liperesente tse phonyohileng) ha li sebelisoa e le boleng ba paramethara ea bohlokoa ho / Browse kopo, joalo ka liparamente tse ling tsa kopo.
Ha o theoha lethathamong la marang-rang ho ka ba molemo hore sehlooho sa leqephe la UI se bonts'e mefuta e meng ea li-breadcrumb, mohlomong ka ho sebelisa sehlooho (sengoloa) sa motsoali le li-node tsa ntate-moholo.
Ho ka 'na ha e-ba molemo ho etsa hore motsoali a fumane menu ea moelelo ha a ntse a bala bana ba hae.
Ho ka ’na ha e-ba molemo ho nahana ka mofuta oa motsoali ha u etsa qeto ea ho bontša bana ba hae.
7.2 Batla Litaba tsa 'Mino
Tlhaloso
Laela ho batla ka har'a tšebeletso.
Kopa
/Browse?key=key-value&q=searchText
| Mekhahlelo | Tlhaloso |
| senotlolo | Boleng bo nkiloeng ho "searchKey" ho tsoa karabong ea pejana |
| q | Mohala oa ho batla. Batlisisa moelelo oa taba o boletsoeng ke paramethara ea bohlokoa (e nkiloeng ho searchKey tšobotsi ho tsoa karabong). Ha ho na parameter ea bohlokoa, etsa patlisiso ea boemo bo holimo. |
Karabo
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
service=”Deezer” searchKey=”Deezer:Batla” type="menu">
Khutlisetsa boemo bo holimo ba sephetho sa lipatlisiso. Bakeng sa sephetho sa lipatlisiso tse ling tsa Libini, Lialebamo, Lipina, kapa Manane a Bapala, taelo ea ho bala ka "browseKey" kaha senotlolo se hlokahala.
Bakeng sa mohlalaample, ho bona sephetho sa lipatlisiso tsa Albums, romella taelo:
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26expr%3Dmichael
Karabo e tla tšoana le karabelo ho taelo e tloaelehileng /Browse.
| Litšobotsi tsa Karabelo | Tlhaloso |
| Sheba litafole tsa element/ea tšobotsi ho Browse command |
Example
http://192.168.1.100:11000/Browse?key=Deezer:Search&q=michael Batla “michael” ka hare ho tshebeletso ya mmino ya Deezer.
Sehlopha sa libapali
Karolo ena e hlalosa litaelo tsa lihlopha tsa libapali tsa kamehla le ho arola. BluOS e boetse e ts'ehetsa lihlopha tse tsitsitseng, tse sieo sebakeng sa tokomane ena.
BluOS e sebelisa poleloana sebapali sa mantlha le sebapali sa bobeli. Sebapali sa mantlha ke sebapali se ka sehloohong sehlopheng. Sebapali sa mantlha se sebelisoa ho khetha mohloli oa 'mino. Ho na le sebapali se le seng feela sa mantlha. Sebapali sa bobeli se hokeletsoe ho sebapali sa mantlha. Ho ka ba le libapali tse ngata tsa bobeli.
Haeba sebapali e le sebapali sa bobeli, likopo tse ngata, haeba li lebisitsoe ho sebapali sa bobeli, li lebisitsoe ho sebapali sa mantlha. Tsena li kenyelletsa /Boemo, Taolo ea ho Bapala, Taolo ea Mela ea Bapala le Likopo tsa ho Batla le ho Batla.
8.1 Libapali tsa Sehlopha sa Bobeli
Tlhaloso
Kopanya sebapali se le seng ho ea ho sebapali sa mathomo.
Kopa
/AddSlave?slave=secondaryPlayerIP&port=secondaryPlayerPort&group=GroupName
| Mekhahlelo | Tlhaloso |
| lekgoba | Aterese ea IP ea sebapali sa bobeli. |
| boemakepe | Nomoro ea boema-kepe ea sebapali sa bobeli. Nomoro ea boema-kepe ea kamehla ke 11000. Libapali tse kang NAD CI580, e nang le libapali tse 'nè tse nang le IP e le' ngoe, li sebelisa likou tse ngata. |
| sehlopha | KGETHO, lebitso la sehlopha. Haeba e sa fanoe, BluOS e tla fana ka lebitso la sehlopha sa kamehla. |
Karabo
| Litšobotsi tsa Karabelo | Tlhaloso |
| boemakepe ba makhoba | Nomoro ea boema-kepe ea sebapali sa bobeli se sa tsoa hlophisoa. |
| Id | ID ea sebapali sa bobeli se sa tsoa hlophisoa. |
Example
http://192.168.1.100:11000/AddSlave?slave=192.168.1.153&port=11000
Sebapali sena sa lihlopha 192.168.1.153 ho sebapali 192.168.1.100. Sebapali 192.168.1.100 ke sebapali sa mantlha.
8.2 Eketsa libapali tse ngata sehlopheng
Tlhaloso
Kopanya libapali tse peli kapa ho feta ho sebapali sa mantlha.
Kopa
/AddSlave?slaves=secondaryPlayerIPs&ports=secondaryPlayerPorts
| Mekhahlelo | Tlhaloso |
| makhoba | Liaterese tsa IP tsa libapali tsa bobeli tse tla kengoa ho sebapali sa mantlha. Liaterese tsa IP li arotsoe ka koma. |
| likou | Likou tsa libapali tsa bobeli li tla eketsoa ho sebapali sa mantlha. Linomoro tsa boema-kepe li arotsoe ka koma. |
Karabo
| Litšobotsi tsa Karabelo | Tlhaloso |
| boemakepe | Boema-kepe ba sebapali sa bobeli se neng se hlophisoa. |
| Id | ID ea sebapali sa bobeli se neng se hlophisoa. |
Example
http://192.168.1.100:11000/AddSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Lihlopha tsa libapali tsa bobeli 192.168.1.153 le 192.168.1.120 ho sebapali sa mathomo 192.168.1.100.
8.3 Tlosa Sebapali se le Mong Sehlopheng
Tlosa sebapali sehlopheng. Haeba o tlosa sebapali sa bobeli sehlopheng, sebapali sa bobeli ha se arotsoe. Haeba ho tlosa sebapali sa mantlha ho sehlopha sa libapali tse 3 kapa ho feta, sebapali sa mantlha ha se arotsoe 'me libapali tse setseng tsa bobeli li theha sehlopha se secha.
Kopa
/RemoveSlave?slave=secondaryPlayerIP&port=secondaryPlayerPort
| Mekhahlelo | Tlhaloso |
| lekgoba | IP ea sebapali (ea bobeli) e lokelang ho eketsoa ho sebapali se seng (ea mantlha). |
| boemakepe | Boema-kepe ba sebapali (sa bobeli) bo tla eketsoa ho sebapali se seng (se qalang). |
Karabo
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″
brand=”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″>
| Litšobotsi tsa Karabelo | Tlhaloso |
| Sheba /SyncStatus bakeng sa lintlha. |
Example
http://192.168.1.100:11000/RemoveSlave?slave=192.168.1.153&port=11000
Tlosa libapali 192.168.1.153 ho tsoa sehlopheng se nang le sebapali sa mantlha 192.168.1.100
8.4 Tlosa libapali tse ngata ho tsoa sehlopheng
Tlhaloso
Tlosa libapali tse peli kapa ho feta sehlopheng.
Kopa
/RemoveLekhoba?slaves=secondaryPlayerIPs&ports=secondaryPlayerPorts
| Mekhahlelo | Tlhaloso |
| makhoba | Liaterese tsa IP tsa libapali tsa bobeli tse tla tlosoa ho sebapali sa mantlha. Liaterese tsa IP li arotsoe ka koma. |
| Mekhahlelo | Tlhaloso |
| likou | Likou tsa libapali tsa bobeli li tla tlosoa ho sebapali sa mantlha. Linomoro tsa boema-kepe li arotsoe ka koma. |
Karabo
<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>
| Litšobotsi tsa Karabelo | Tlhaloso |
| Sheba /SyncStatus bakeng sa lintlha. |
Example
http://192.168.1.100:11000/RemoveSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
E tlosa libapali 192.168.1.153 le 192.168.1.120 sehlopheng se nang le sebapali sa mantlha 192.168.1.100.
Sebapali Reboot
Karolo ena e hlalosa taelo bakeng sa player soft reboot.
9.1 Qala hape A Player
Tlhaloso
Soft reboot player.
Kopa
POST Taelo / qala hape ka paramente e (boleng bofe kapa bofe)
| Mekhahlelo | Tlhaloso |
| ho joalo | Boleng bofe kapa bofe (mohlala 1). |
Karabo
Litlhophiso li ntlafalitsoe
E qala hape. Ka kopo koala fensetere ena.
Ke kopa u eme…
Example
curl -d e = 1 192.168.1.100/reboot
Litšepe Tsa Lemati
Karolo ena e hlalosa taelo ea molumo oa tšepe ea monyako oa sebapali.
10.1 Litšepe Tsa Lemati
Tlhaloso
Kenya ts'ebetso ea litloloko tsa monyako.
Kopa
http://PLAYERIP:PORT/Doorbell?play=1
| Mekhahlelo | Tlhaloso |
| bapala | Bapala tšepe ea monyako (kamehla 1) |
Karabo
| Litšobotsi tsa Karabelo | Tlhaloso |
| nolofalletsa | Hlahisa molumo |
| bophahamo ba modumo | Bolumo ba lla |
| chime | Tlosa molumo |
Example
http://192.168.1.100:11000/Doorbell?play=1 play doorbell chime
Kenyo e Otlolohileng
Karolo ena e hlalosa litaelo tsa khetho ea mohloli o kenang ka kotloloho.
11.1 Kgetho ya Kenyo e Itseng
Tlhaloso
Khetho ea mohloli o sebetsang. Taelo ena e sebetsa bakeng sa likenyelletso tse sebetsang tse hlahang karabong ho /RadioBrowse?service=Capture. Khetho ea lisebelisoa tsa BluOS HUB e tšehetsoa feela ke taelo ena.
Kopa
/Bapala?url=URL_boleng
| Mekhahlelo | Tlhaloso |
| url | The URL tšobotsi ho tsoa karabong ea /RadioBrowse?service=Capture |
Karabo
molapo
| Litšobotsi tsa Karabelo | Tlhaloso |
| naha | Hlalosa hore sephetho sea bapala |
Example
Mohato oa 1. Fumana URL_value bakeng sa parameter url
Kopo: http://192.168.1.100:11000/RadioBrowse?service=Capture
Karabo:
<item playerName=”Tick
Tšoaea" mongolo = "Bluetooth" inputType="bluetooth" id="input2" URL=”Tšoara%3Abluez%3Abluetooth” setšoantšo=” /images/BluetoothIcon.png” type=”audio”/>
<item playerName=”Tick Tick” text=”Analog
Input" inputType="analoge" id="input0" 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
Input” inputType=”spdif” id=”input1″ URL=”Capture%3Ahw%3Aimxspdif%2C0%2F1%2F25%2F2%3Fid%
3Dinput1″ setšoantšo=”/images/capture/ic_opticalinput.png” type=”audio”/>
<item playerName=”Tick
Tšoaea" text="Spotify" id="Spotify" URL=”Spotify%3Aplay” setšoantšo="/Sources/images/SpotifyIcon.png” tshebeletso
Mofuta = "CloudService" mofuta = "audio"/>
<remoteitem playerName=”Test Hub” text=”Analog Input” inputType=”analog” id=”hub192168114911000input0″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput0″
setšoantšo=”/images/capture/i
c_analoginput.png”
mofuta=”molumo”/>
<remoteitem playerName=”Test Hub” text=”Coaxial Input” inputType=”spdif” id=”hub192168114911000input3″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput3″
setšoantšo=”/images/capture/ic
_opticalinput.png”
mofuta=”molumo”/>
<remoteitem playerName=”Test Hub” text=”HDMI ARC” inputType=”arc” id=”hub192168114911000input4″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput4″
setšoantšo=”/images/capture/ic
_tv.png”
mofuta=”molumo”/>
<remoteitem playerName=”Test Hub” text=”Optical Input” inputType=”spdif” id=”hub192168114911000input2″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput2″
setšoantšo=”/images/capture/ic
_opticalinput.png”
mofuta=”molumo”/>
<remoteitem playerName=”Test Hub” text=”Phono Input” inputType=”phono” id=”hub192168114911000input1″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput1″
setšoantšo=”/images/capture/ic
_vinyl.png”
mofuta=”molumo”/>
Mohato oa 2. Bapala Input ea Analog ho sebapali
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
Hlokomela: Etsa bonnete ba hore mehloli e hokahane 'me ha ea patoa.
11.2 Kgetho ya Kenyo e Ntle
Tlhaloso
Khetho ea mohloli oa kantle. Ka linako tse ling lintho tse kenang ka ntle tse sa sebetseng li kanna tsa se hlahe karabong ea
/RadioBrowse?service=Tshwara. Taelo ena e sebetsa bakeng sa khetho ea ho kenya e sebetsang le e sa sebetseng. E khothaletsoa bakeng sa khetho ea CI ea kantle.
Kopa (BluOS firmware e ncha ho feta v3.8.0 le ea khale ho feta v4.2.0)
/Bapala?inputIndex=IndexId
| Mekhahlelo | Tlhaloso |
| inputIndex | Lenane (le qala ka 1) la lintho tse kentsoeng tse hlahang karabong ea /Settings?id=capture&shcemaVersion=32 (32 ke mofuta oa morao-rao oa schema) ka tatellano ea linomoro. Bluetooth ha e akaretsoe. |
Karabo
molapo
| Litšobotsi tsa Karabelo | Tlhaloso |
| naha | Hlalosa hore sephetho sea bapala |
Example
Mohato oa 1. Fumana boleng ba inputIndex
Kopo: http://192.168.1.100:11000/Settings?id=capture&schemaVersion=32
Karabo:
<menuGroup icon=”/images/settings/ic_capture.png” url=”/setting” id=”capture”
displayName=”Iketsetse mehloli”>
<setting icon=”/images/settings/ic_bluetooth.png” refresh=”true” url=”/audiomodes”
id=”bluetooth” displayName=”Bluetooth” value=”3″ name=”bluetoothAutoplay” description=“Disable” explanation=”Mokhoa oa matsoho o o lumella ho chencha lipakeng tsa mehloli e ka har'a laeng ea ho tsamaea. Mokhoa oa othomathiki o fetohela mohloling oa Bluetooth ha sesebelisoa sa Bluetooth se hoketsoeng se qala ho bapala molumo. Joale o ka chencha lipakeng tsa mehloli e ka har'a lae ea ho tsamaea. Boemo ba moeti bo fetohela mohloling oa Bluetooth ha sesebelisoa sa Bluetooth se hoketsoeng se qala ho bapala molumo. Haeba u fetohela mohloling o mong, Bluetooth e tla hakolla. Mohloli oa Bluetooth ha o hlahe ka har'a drawer ea ho tsamaea. E holofalitsoeng e tlosa mohloli ho tswa ho laeng la ho tsamaea, 'me ha e lumelle sesebelisoa se seng ho hokela ho Sebapali joalo ka Bluetooth.
mohloli.” sehlopha=”lenane”>
…
<menuGroup icon=”/images/capture/ic_analoginput.png” url=”/setting” id=”captureinput0″
displayName=”Analog
Kenyeletso">
<menuGroup icon=”/images/capture/ic_opticalinput.png” url=”/setting” id=”capture-input1″
displayName=”Optical Input”>
Karabo e bonts'a Bluetooth, Input ea Analog, le Optical Input. Bluetooth ha e akaretsoe, kahoo inputIndex boleng ke 1 bakeng sa Input ea Analog, 'me inputIndex boleng ke 2 bakeng sa Optical Input.'
Mohato 2. Bapala Optical Input ho sebapali.
http://192.168.1.100:11000/Play?InputId=2
Kopa (BluOS firmware v4.2.0 kapa e ncha)
/Bapala?inputTypeIndex=$typeIndex
| Mekhahlelo | Tlhaloso |
| inputTypeIndex | typeIndex e na le sebopeho sa mofuta-index ya ho kenya letsoho. Lenane la lintho tse kentsoeng ke lena mofuta: spdif (Optical Input) analog (Kenyo ea Analog, Line In) coax (Coaxial Input) bluetooth arc (HDMI ARC) earc (HDMI eARC) phono (Vinyl) komporo aesebu (AES/EBU) e leka-lekaneng (E Balanced In) maekrofounu (Kenyo ya maekrofounu) The index e qala ho tloha ho 1. Ha ho na le lintho tse ngata tse kenang tsa mofuta o le mong, ho kenya 1 ho na le index 1, ho kenya 2 ho na le index 2, joalo-joalo. |
Karabo
molapo
| Litšobotsi tsa Karabelo | Tlhaloso |
| naha | Hlalosa hore sephetho sea bapala |
Example
Kopo: http://192.168.1.100:11000/Play?inputTypeIndex=spdif-2 ho khetha Optical Input 2
Karabo: molapo
bluetooth
Karolo ena e hlalosa taelo ea ho fetola mokhoa oa Bluetooth.
12.1 Fetola Mokhoa oa Bluetooth
Tlhaloso
Fetola mokhoa oa Bluetooth: Manual, Automatic, Moeti, Holofetse.
Kopa
/audiomodes?bluetoothAutoplay=value
| Mekhahlelo | Tlhaloso |
|
bluetoothAutoplay |
Mokgwa wa Bluetooth boleng 0 e bolela Bukana, 1 e bolela Boiketlo, 2 e bolela Moeti, 3 e bolela Ho Holofala. |
Ha ho karabo
Example
Kopo: http://192.168.1.100:11000/audiomodes?bluetoothAutoplay=3 ho tima bluetooth
Sehlomathiso
13.1 Lenbrook Service Discovery Protocol
Selelekela
Mekhoa e tsebahalang ea ho sibolla joalo ka mDNS le SSDP e sebelisa le ho itšetleha ka puisano ea multicast ea UDP. Lihlahisoa tse ngata tsa hajoale tsa Lenbrook li sebelisa mDNS bakeng sa ho sibolla. Ka bomalimabe re fumane hore palo e kholo ea bareki ba rona ba na le marang-rang a lapeng moo sephethephethe sa multicast se sa sebetseng hantle mme lisebelisoa tsa rona li ke ke tsa fumanoa ka ts'epo. Sena se entse hore lihlahisoa tse ngata li khutlisetsoe le litletlebo ho tsoa ho barekisi ba rona.
Ho rarolla bothata bona re thehile protocol ea tloaelo ea ho sibolla e bitsoang LSDP e sebelisang khaso ea UDP. Teko ea pele e bonts'itse sena se ts'epahala ho feta se sibolotsoeng se thehiloeng ho mDNS.
Protocol e Felletseview
Sepheo se seng sa protocol ena ke ho ba bonolo. E ka sebelisoa lisebelisoa tse kentsoeng tse nang le mohopolo o fokolang haholo.
Tsamaiso ena e sebelisa lipakete tsohle tsa khaso tsa UDP ho ea le ho tsoa boema-kepeng ba UDP 11430. Boema-kepe bona bo ngolisitsoe ho IANA 'me bo abetsoe Lenbrook bakeng sa tšebeliso ea LSDP ho tloha ka la 27 Hlakubele 2014.
Boemong bo tsitsitseng node ka 'ngoe e nang le ts'ebeletso ea ho bapatsa e phatlalatsa molaetsa oa Phatlalatso hoo e ka bang motsotso o mong le o mong.
Qalong le ha lenane la lits'ebeletso kapa liparamente tsa marang-rang li fetola lipakete tse supileng li tla phatlalatsoa ka nako e khuts'oane ho lumella ho sibolloa ha pele le liphetoho ho ata ka potlako. Bakeng sa lits'ebeletso tsa papatso ea li-node lipakete tsena tse supileng tsa pele li tla kenyelletsa molaetsa oa Phatlalatso. Bakeng sa li-node tse lekang ho fumana lits'ebeletso, lipakete tse supileng tsa pele li tla kenyelletsa molaetsa oa Potso. Bakeng sa lits'ebeletso tse seng li sa fumanehe lipakete tse supileng li lokela ho kenyelletsa molaetsa oa Tlosa.
Lipakete tsena tsa pele li romeloa ka makhetlo a supileng ka lebaka la tlhaho e sa tšepahaleng ea lipakete tsa UDP. Boemong bo sa lebelloang, lipakete tse supileng kaofela li sa atlehe lits'ebeletso li ntse li tla fumanoa kamora nakoana ho tloha melaetsa ea nako le nako ea Phatlalatsa.
Haeba node e amohela molaetsa oa Potso bakeng sa sehlopha sa litšebeletso seo e se bapatsang e tla araba ka molaetsa oa Phatlalatsa ka mor'a ho lieha ho honyenyane ka nako e sa reroang ebe e beha bocha nako ea eona ea hona joale ea Phatlalatso.
Sehlooho sa pakete le li-block tsa melaetsa kaofela li kenyelletsa likarolo tsa bolelele. Sena se fana ka maemo a eketsehileng 'me se lumella liphetoho tse lumellanang le morao hore li etsoe kamoso. Likarolo tse ling kapa mefuta ea melaetsa e ka eketsoa nakong e tlang eo lits'ebetso tsa khale li ka tlolang ha ho bapisoa. Haeba re entse qeto ea ho etsa phetoho e sa lumellaneng ka morao ho boetse ho na le tšimo ea phetolelo sehloohong sa pakete se ka eketsoang.
Protocol e boetse e lumella hore lirekoto tsa TXT li kenyellelitsoe lipapatsong tsa lits'ebeletso tse ts'oanang le lirekoto tsa TXT tse sebelisitsoeng
ka mDNS. Sena se fana ka phetoho e kholo bakeng sa data e eketsehileng ea meta e kenyellelitsoeng ts'ebeletso
lipapatso ntle le ho fetola protocol.
Lintlha tsa Protocol
Nako
Lipakete tsohle tse rometsoeng li lokela ho hlophisoa ka nako e sa reroang kapa tieho ho thusa ho qoba ho thulana.
- Nako ea ho Qala Pakete: Lipakete tse 7 ka nako = [0, 1, 2, 3, 5, 7, 10s] + (0 ho 250ms ka tšohanyetso). Tsena ke linako tse phethahetseng, eseng tieho. Lipakete tsohle tse 7 li lokela ho romelloa nakong ea metsotsoana e 10.
- Nako ea Phatlalatso e ka Sehloohong: 57s + (0 ho isa ho 6s ka tšohanyetso)
- Potso Ho Lieha Karabelo: (0 ho 750ms ka tšohanyetso)
Node ID
Node ka 'ngoe e tla ba le ID e ikhethang e ka sebelisoang ho khetholla node. ID e ikhethang e kenyelelitsoe ho Phatlalatsa le ho Hlakola melaetsa. Bareki ba ka sebelisa boleng bona e le senotlolo sa mantlha ha ba boloka boleng le ho khetholla node ka mokhoa o ikhethileng. ID ena e ikhethang e ka ba aterese ea MAC empa e lokela ho tšoana le sebopeho se seng le se seng haeba node e na le li-interface tse ngata tseo e bapatsang ho tsona.
Sebopeho sa Pakete
Pakete e 'ngoe le e' ngoe e qala ka hlooho ea pakete e lateloang ke palo e sa lekanyetsoang ea li-block tsa melaetsa. Sebaka se seng le se seng sa molaetsa se qala ka sebaka sa bolelele e le hore melaetsa e sa lemoheng e ka tloloa. Ntle le haeba ho boletsoe ka tsela e 'ngoe, boleng ba linomoro tsa multi-byte bo tla bolokoa endian e kholo (li-byte tsa bohlokoa haholo pele). Ntle le ha ho boletsoe ka tsela e 'ngoe linomoro tsohle ke boleng bo sa saenneng. Bakeng sa mohlalaample bolelele ba byte e le 'ngoe e ka ba le boleng ba 0 ho isa ho 255.
Sehlooho sa Pakete
| Tšimo | Li-byte | Tlhaloso |
| Bolelele | 1 | Kakaretso ea bolelele ba hlooho ho kenyeletsoa sebaka sena. |
| Lentsoe la boselamose | 4 | Sebaka sena e tla ba li-byte tse 'ne tsa ASCII tsa "LSDP". Sena se re thusa ho tseba hore liphutheloana li reretsoe ho sebelisoa, kahoo ha ho hlokahale hore re leke ho hlalosa lintlha tse tsoang mohloling o sa lebelloang. |
| Mofuta oa Protocol | 1 | Phetolelo ea protocol. Haeba liphetoho tse tlang li etsoa ho protocol e sa lumellaneng le mofuta ona |
| Tšimo | Li-byte Tlhaloso | |
| e tla fetoloa. Mofuta oa hajoale ke 1. | ||
Potso Molaetsa
| Tšimo | ||
| Li-byte | Tlhaloso | |
| Bolelele | 1 | Kakaretso ea bolelele ba molaetsa ho kenyeletsoa sebaka sena. |
| Mofuta oa Molaetsa | 1 | "Q" = 0x51: Potso e tloaelehileng bakeng sa karabo ea khaso. "R" = 0x52: Potso ea karabelo e sa tšoaneng. |
| Bala | 1 | Palo ea lihlopha tseo u ka li botsang. |
| Sehlopha sa 1 | 2 | 16 bit (2 byte) sekhetho sa sehlopha. |
| … | Pheta karolo e fetileng bakeng sa sehlopha ka seng sa tlatsetso. | |
Phatlalatsa Molaetsa
Phatlalatsa Sehlooho
| Tšimo | ||
| Li-byte | Tlhaloso | |
| Bolelele | 1 | Kakaretso ea bolelele ba molaetsa ho kenyelletsa sehlooho se felletseng sa phatlalatso le lirekoto tsa phatlalatso. |
| Mofuta oa Molaetsa | 1 | “A” = 0x41 |
| Bolelele ba ID ea Node | 1 | Bolelele ba sebaka sa Node ID. |
| Node ID | E fetohang | ID e ikhethang ea Node ea node e romellang phatlalatso. Hangata ena ke aterese ea MAC ea e 'ngoe ea li-interface tsa nodes. |
| Bolelele ba Aterese | 1 | Bolelele ba sebaka sa Aterese. Bakeng sa IPv4 sena e tla ba 4. |
| Tšimo | ||
| Li-byte | Tlhaloso | |
| Aterese | E fetohang | Aterese ea IP ea node. |
| Bala | 1 | Palo ea litlaleho tse tla latela. |
Phatlalatsa Tlaleho
| Tšimo | Li-byte | Tlhaloso |
| Sehlopha | 2 | 16 bit (2 byte) sekhetho sa sehlopha. |
|
TXT Palo |
1 |
Palo ea lirekoto tsa TXT tse lokelang ho lateloa. Haeba ho na le zero, likarolo tse latelang li siiloe. |
| Senotlolo sa 1 Bolelele | 1 | Bolelele ba lebitso la senotlolo. |
| Senotlolo sa 1 | E fetohang | Lebitso la sehlooho. |
| Boleng 1 Bolelele | 1 | Bolelele ba mongolo oa boleng. |
| Boleng 1 | E fetohang | Mongolo oa boleng. |
|
… |
Pheta likarolo tse 4 tse fetileng bakeng sa rekoto e 'ngoe le e' ngoe e eketsehileng ea TXT. |
Hlakola Molaetsa
| Tšimo | ||
| Li-byte | Tlhaloso | |
| Bolelele | 1 | Kakaretso ea bolelele ba molaetsa ho kenyeletsoa sebaka sena. |
| Mofuta oa Molaetsa | 1 | "D" = 0x44 |
| Bolelele ba ID ea Node | 1 | Bolelele ba sebaka sa Node ID. |
| Node ID | E fetohang | ID e ikhethang ea Node ea node e romellang molaetsa. Hangata ena ke aterese ea MAC ea e 'ngoe ea li-node |
| Tšimo | ||
| Li-byte | Tlhaloso | |
| likarolo. | ||
| Bala | 1 | Palo ea litlelase tse lokelang ho latela. |
| Sehlopha sa 1 | 2 | 16 bit (2 byte) sekhetho sa sehlopha. |
| … | Pheta karolo e fetileng bakeng sa sehlopha ka seng sa tlatsetso. | |
Likabelo tsa ID ea Sehlopha
| ID ea sehlopha | Tlhaloso | mDNS E lekanang |
| 0x0001 | Sebapali sa BluOS | _musc._tcp |
| 0x0002 | Seva ea BluOS | _muss._tcp |
| 0x0003 | BluOS Player (ea bobeli ho libapali tsa libaka tse ngata joalo ka CI580) | _musp._tcp |
| 0x0004 | sovi-mfg e sebelisetsoang liteko tsa tlhahiso. | _sovi-mfg._tcp |
| 0x0005 | sovi-keypad | _sovi-keypad._tcp |
| 0x0006 | BluOS Player (lekhoba le babeli) | _musz._tcp |
| 0x0007 | Hole Web Sesebelisoa (AVR OSD Web Leqephe) | _hole-web-ui._tcp |
| 0x0008 | BluOS Hub | _mush._tcp |
| 0xFFFF | Lihlopha tsohle - E ka sebelisoa le Query Message. |
Tlhokomeliso 1:
Pakete e akaretsang ea LSDP e hloka ho ts'oaroa joalo ka data ea binary.
Tlhokomeliso 2:
Haeba Molaetsa o le mong oa Phatlalatso o sa khone ho tšoara lintlha tsohle tsa li-node (haholo-holo CI580), o tla aroloa ka Melaetsa ea Phatlalatso e 2 kapa ho feta ka Molaetsa o mong le o mong o nang le Hlooho le Rekoto mme Molaetsa o mong le o mong o tšoere lintlha tsa node (s) kaofela.
BluOS Custom Integration API Version 1.7
Litokomane / Lisebelisoa
 |
BluOS T 778 Custom Integration API [pdf] Bukana ea Mosebelisi T 778, T 778 Custom Integration API, T 778, Custom Integration API, Integration API, API |