Logo BluOSAPI Entegrasyon Pèsonalize

Kontni kache
1 API Entegrasyon Pèsonalize T 778
2 Règleman sou Itilizasyon API
3 Entwodiksyon
4 Demann sou Eta a
5 Kontwòl Volim
6 Kontwòl lèktur
7 Jesyon Fil Jwe
8 Prereglaj
9 Navigasyon ak rechèch kontni
10 Gwoupman Jwè yo
11 Rekòmanse jwè a
12 Kloti pòt
13 Antre dirèk
14 Bluetooth
15 Apendis
16 Dokiman / Resous
16.1 Referans

API Entegrasyon Pèsonalize T 778

Enfòmasyon ki nan manyèl sa a se pwopriyete Lenbrook Industries.
Li fèt sèlman pou itilizasyon pwofesyonèl. Lenbrook Industries pa pran okenn responsablite pou presizyon pwotokòl la. Pwotokòl la bay "jan l ye a", ak tout defo yo epi san okenn garanti, kit se eksprime oswa enplisit.

Règleman sou Itilizasyon API

Lè w jwenn aksè nan API yo, ou dakò ak Règleman Itilizasyon API sa a ("Règleman an") ak Kondisyon nou yo. Nou bay API sa yo pou pèmèt konpayi yo ak moun yo devlope epi benefisye de Sèvis nou an lè yo kreye lojisyèl, sèvis, oswa modil ki konekte ak platfòm nou an oswa ki gen aksè a done ki nan platfòm nou an atravè API nou yo (yon "Entegrasyon"). Règleman sa a se epi li pral trete kòm yon pati nan Kondisyon nou yo.
Lojisyèl la bay "JAN L YE A", san okenn garanti, eksprime oswa enplisit, ki gen ladan men ki pa limite a garanti sou macheabilite, kapasite pou yon objektif patikilye ak absans vyolasyon. Nan okenn ka otè yo oswa detantè dwa otè yo pap responsab pou okenn reklamasyon, domaj, oswa lòt responsablite, kit se nan yon aksyon kontra, Tort oswa otreman, ki rive akoz, soti nan oswa an koneksyon avèk lojisyèl la oswa itilizasyon oswa lòt tranzaksyon nan lojisyèl la.
Itilizasyon otorize
Ou pa gen dwa itilize API a pou voye spam oswa pou pran okenn aksyon ki vyole Règleman Itilizasyon Akseptab nou an ak Kondisyon Itilizasyon Estanda nou yo. Ou dwe konfòme w avèk tout lwa ki aplikab yo (tankou lwa sou vi prive ak lwa sou kontwòl ekspòtasyon Etazini, GPR ak règleman Ewopeyen yo ak lwa ak règleman sou sanksyon ekonomik yo). Ou dwe swiv tout dokiman nou bay pou API yo. Ou pa pral eseye pirate oswa chanje fason Sèvis la fonksyone. Nou ka kontwole fason w ap itilize API yo pou w konfòm avèk règ sa yo, epi nou ka refize w aksè nan API a si w vyole Règleman sa a.
Konfidansyalite
Ou Entegrasyon an dwe montre yon règleman sou enfòmasyon prive pou itilizatè yo ki detaye enfòmasyon w ap kolekte nan men yo lè y ap itilize Entegrasyon an. Ou pral sèlman jwenn aksè a done yon itilizatè nan limit itilizatè a pèmèt epi ki eksplike nan règleman sou enfòmasyon prive ou a. Ou dwe efase done yon itilizatè imedyatman si itilizatè a mande pou yo efase l oswa si li fèmen kont li avèk ou.
Sekirite
Ou pral aplike epi kenbe mezi sekirite teknik ak òganizasyonèl ki apwopriye pou pwoteje epi prezève sekirite, entegrite ak konfidansyalite done yo. Mezi sekirite sa yo dwe anpeche aksè san otorizasyon oswa divilgasyon done pèsonèl oswa konfidansyèl ke w ap trete yo.
Pwopriyetè
Nou posede tout dwa, tit, ak enterè nan Sèvis la ak API yo, ki gen ladan tout dwa pwopriyete entelektyèl, mak, kòd, ak karakteristik. Ou pa pral vyole, fè enjenyè envès, oswa kopye kòd nou an, konsepsyon, oswa kontni nou an. Ou pa pral jwenn aksè nan API nou yo pou fè konpetisyon ak Sèvis nou an. Nenpòt dwa ki pa akòde eksplisitman nan Règleman sa a pa otorize, kidonk si ou pa wè li isit la, Lè sa a, se pa yon dwa nou ba ou.
Itilizasyon Mak yo
Ou pa gen dwa itilize non nou ak mak nou yo (sa vle di logo nou yo, mak nou yo, ak imaj ki gen dwa otè) nan okenn fason. Ou pa gen dwa modifye oswa retire okenn avi pwopriyetè nan mak nou yo. Ou pa pral itilize non nou oswa mak nou yo nan non oswa logo Entegrasyon ou an, oswa nan okenn fason ki vle di yon andòsman pa nou.
Itilizasyon Pratik Mak yo
Gid sa yo eksplike kijan ou dwe itilize non, mak ak byen mak nou yo nan tout tan. Itilizasyon ou endike ou aksepte gid sa yo, epi ou konprann ke itilizasyon ou an vyolasyon gid sa yo ap lakòz otomatikman revokasyon pèmisyon ou pou itilize non, mak ak byen mak nou yo.

  • Itilizasyon non nou, mak nou yo ak byen mak nou yo dwe otorize ekspresman alekri.
  • Pa chanje, modifye, defòme, kopye, oswa imite Byen Mak nou yo nan okenn fason, tankou chanje koulè, wotasyon ak/oswa etannman. Nan lòt mo, Byen Mak nou yo dwe rete nan fòm orijinal yo.
  • Pa bay non nou, mak nou yo ak byen mak nou yo twòp enpòtans parapò ak non ak logo pa ou.
  • Pa montre non nou, mak nou yo, ak byen mak nou yo akote, oswa nan okenn fòm maketing konpetitif, san konsantman eksprime nou an.
  • Itilizasyon ou pa dwe twonpe konsomatè yo konsènan parennaj nou, afilyasyon nou avèk oswa andòsman nou pou konpayi ou an oswa pwodwi oswa sèvis ou yo.
  • Non nou, mak nou yo ak byen mak nou yo se pwopriyete eksklizif nou. Tout bòn volonte ki soti nan itilizasyon ou an ap sèlman pou benefis nou. Ou p ap pran okenn aksyon ki kontredi dwa nou oswa pwopriyetè nou.
  • Non nou, mak nou yo ak byen mak nou yo dwe itilize avèk respè epi yo pa dwe itilize nan yon fason ki fè nou mal, pwodwi nou yo, oswa sèvis nou yo mal, oswa nan yon fason ki, nan opinyon nou, diminye oswa domaje repitasyon nou oswa bon repitasyon ki genyen nan non nou, mak nou yo ak byen mak nou yo. Nan lòt mo, tanpri pa asosye byen nou yo ak okenn aktivite ilegal oswa itilize yo nan yon fason ki twonpe oswa danjere.

Exampmwens itilizasyon akseptab:
"[NON PWODWI OU A] (konpatib ak / fonksyone ak BluOS)"
Exampmwens itilizasyon ki pa akseptab
"[NON PWODWI OU A] – BluOS"
"BluOS – [NON PWODWI OU A]"
"[NON PWODWI OU A] – Mache ak BluOS"
Maketing ak Kominike pou laprès
Apre yo fin apwouve aplikasyon w lan, li ka parèt sou sit nou an. web pwopriyete yo. Anjeneral, nou p ap ko-pibliye kominike laprès oswa kontribye nan ko-maketing aplikasyon w lan.
Anvan ou distribye yon kominike pou laprès sou aplikasyon w lan, asire w ou kontakte nou nan [EMAIL]. Si w ap mansyone BluOS, n ap bezwen re-view kominike a. Nou rekòmande pou kontakte nou pou voye dènye kominike laprès ou a pi vit posib.
Limit responsabilite nou
Nan limit maksimòm lalwa pèmèt la, nou bay API yo jan yo ye a. Sa vle di nou pa bay okenn garanti, ni eksprime ni enplisit, tankou, men pa limite a, sou macheabilite ak kapasite pou yon objektif patikilye.
Mizajou
Nou ka mete ajou oswa modifye API yo ak Règleman sa a detanzantan lè nou pibliye chanjman yo sou sit sa a oswa lè nou avize w pa imèl. Chanjman sa yo ka afekte fason w ap itilize API yo oswa fason Entegrasyon w lan kominike avèk API a. Si nou fè yon chanjman ki pa akseptab pou ou, ou ta dwe sispann itilize API yo.
Konfidansyalite
Ou ka gen aksè a enfòmasyon konfidansyèl, propriétaires, ak enfòmasyon ki pa piblik espesifik pou API yo ("Enfòmasyon Konfidansyèl"). Ou ka itilize enfòmasyon sa a sèlman pou konstwi avèk API yo. Ou p ap divilge Enfòmasyon Konfidansyèl yo bay pèsonn san konsantman ekri nou, epi w ap pwoteje Enfòmasyon Konfidansyèl yo kont itilizasyon ak divilgasyon san otorizasyon menm jan ou ta pwoteje pwòp enfòmasyon konfidansyèl ou yo.
Endemnizasyon
Ou pral dedomaje epi pwoteje nou menm ak Ekip nou an kont nenpòt pèt (ki gen ladan frè avoka) ki soti nan reklamasyon twazyèm pati ki gen rapò ak itilizasyon API a ou fè.
Rès la
Règleman sa a pa kreye oswa enplike okenn patenarya, ajans, oswa antrepriz konjwen. Règleman sa a ap aplike toutotan w ap itilize API yo oswa jiskaske li fini an akò avèk Kondisyon nou yo. Nan ka ta gen yon konfli ant Règleman sa a ak Kondisyon Itilizasyon Estanda yo, Kondisyon Itilizasyon Estanda yo va gen priyorite.
©2025 LENBROOK INDUSTRIES LIMITED
633 Granite Court, Pickering, Ontario, Kanada L1W 3K1
Tout dwa rezève
Yo pa otorize repwodui, estoke oswa transmèt okenn pati nan piblikasyon sa a nan okenn fòm san pèmisyon alekri Lenbrook Industries Limited. Malgre tout efò yo te fè pou asire kontni an egzak nan moman piblikasyon an, karakteristik ak espesifikasyon yo ka chanje san avètisman.

Istwa revizyon
Version Dat Deskripsyon
1.0 6/17/2019 Premye lage
1.2 01/12/2022 Te ajoute yon redémarrage dou, yon sonèt pòt, volim monte/diminye, deplase tras nan fil datant, ak kòmandman pou antre dirèk. Te ajoute yon nòt nan Apendis LSDP.
1.4 04/26/2022 Te ajoute kòmandman mute; modifye kòmandman antre dirèk pou HUB; mete ajou kòmandman Play pou jwe odyo pèsonalize an difizyon.
1.5 07/18/2022 Te ajoute kòmand Bluetooth; Mizajou LSDP pou ajoute klas 5 a 8; Te ajoute "Itilizasyon Pratik Mak yo" nan Règleman Itilizasyon API a.
1.6 03/13/2024 Te ajoute yon nòt pou /Estati pou jwè gwoupe nan seksyon 2; Te ajoute
/Jwe?chèche=segond se=trackid nan seksyon 4.1;
1.7 04/09/2025 Seksyon 8.3 ansyen mete ajouample; Te ajoute yon demann navigasyon meni kontèks anliy exampnan seksyon 7.1; Ajoute yon nouvo kòmand seleksyon dirèk nan seksyon 11.2; Mizajou seksyon 6.1 pou ajoute atribi "imaj" pou prereglaj; Ajoute kòmantè "followRedirects=1" pou tout atribi imaj; Mizajou eksplikasyon atribi jwe yoURL epi ajoute kounye a nan seksyon 7.1

Entwodiksyon

BluOS™ se yon sistèm operasyon avanse ak yon lojisyèl jesyon mizik ki pèmèt ou jwenn aksè epi difize mizik san pèt jiska 24-bit/192kHz nan chak chanm lè w ap itilize rezo lakay ou. Ou ka jwenn BluOS nan pwodwi Bluesound, NAD Electronics, DALI Loudspeakers ak lòt moun.
Dokiman sa a te kreye pou ede devlopè ak entegratè sistèm k ap travay nan mache entegrasyon pèsonalize (CI) la. Li gen ladan l yon sou-ansanm demann API ki dokimante nan Pwotokòl Kontwòl API BluOS konplè a.
Tout demann ki dekri nan dokiman sa a voye kòm demann HTTP GET. Paramèt yo se yon estanda URL pè non/valè kode. Lektè BluOS yo resevwa kòmand sa yo epi reponn ak done XML kode UTF-8.
Tout demann yo sou fòm http:// : / kote:

  • player_ip se adrès IP jwè BluOS la (pa egzanp, 192.168.1.100)
  • pò a se pò TC ki itilize pou kominikasyon yo. Pò 11000 la itilize pou tout lektè BluOS yo, eksepte CI580 la. CI580 la gen kat nœud difizè nan yon sèl chasi, kote nœud 1 itilize pò 11000, nœud 2 itilize pò 11010, nœud 3 itilize pò 11020, epi nœud 4 itilize pò 11030. Yo ta dwe dekouvri pò reyèl pou itilize a lè yo itilize pwotokòl MDNS la avèk sèvis musc.tcp ak musp.tcp yo.
  • demann lan se kòmandman oswa demann BluOS aktyèl la (pa egzanp, Jwe)

Nòt: Dokiman sa a pral itilize http://192.168.1.100:11000 kòm IP jwè ak pò nan tout ansyenamples.

Demann sou Eta a

Yo itilize demann estati pou poze kesyon sou yon jwè BluOS.
BluOS bay de mekanis pou fè rechèch sou estati; sondaj regilye ak sondaj long. Sondaj regilye a retounen rezilta rechèch la imedyatman. Sondaj long la kenbe yon koneksyon pou yon tan espesifik, epi li sèlman retounen yon rezilta rechèch lè enfòmasyon an chanje oswa lè delè a ekspire. Sondaj long la ka diminye anpil kantite apèl pou yon jwè.
Lè yo pa itilize sondaj long, kliyan yo ta dwe limite vitès sondaj yo a yon sèl demann chak 30 segonn, pa plis. Lè yo itilize sondaj long, yon kliyan pa dwe fè de demann youn apre lòt pou menm resous la ak mwens pase yon segonn diferans, menm si premye demann lan retounen nan mwens pase yon segonn.
Demann sondaj long yo pran de paramèt: timeout ak etag. timeout se dire demann long-poll la epi etag li pran nan repons anvan an (yon atribi nan eleman rasin repons lan).
An jeneral, li sèlman nesesè pou gen yon long-poll aktif pou youn nan /Status oswa /SyncStatus. Repons /Status la gen ladan yon eleman ( ) ki endike si /SyncStatus chanje. Yo ta dwe sonde /SyncStatus si se sèlman non, volim ak estati gwoupman yon jwè ki enterese. Yo ta dwe sonde /Status si yo bezwen estati lekti aktyèl la.
Lè jwè yo gwoupe, jwè prensipal la se jwè prensipal nan gwoup la. Jwè segondè yo atache ak jwè prensipal la. /Status repons jwè segondè yo se kopi sa jwè prensipal la. /SyncStatus long polling nesesè pou swiv volim chak jwè segondè.
2.1 Estati Lektur
Deskripsyon
Pwen final /Status la mande enfòmasyon sou volim ak lekti. Demann sa a retounen plizyè atribi repons,
Gen kèk ladan yo ki pa aplikab pou dokiman sa a. Repons ki pa gen dokiman yo ta dwe inyore.
Mande
/Estati?delè=segond&etag=etag-valè

Paramèt Deskripsyon
 delè Paramèt opsyonèl ki itilize ak sondaj long. Entèval sondaj rekòmande a se 100 segonn epi li ta dwe limite a yon vitès apeprè 60 segonn epi pa janm pi rapid pase 10 segonn.
etag Paramèt opsyonèl yo itilize ak long polling. Sa a se e latag atribi ki soti nan la
Paramèt Deskripsyon
repons apèl /estati anvan an.

Repons
<status etag=”4e266c9fbfba6d13d1a4d6ff4bd2e1e6″>
÷ (De Luxe)
Ed Sheeran
vre
1
159
Deezer:142986206
/Travay atistik?sèvis=Deezer&songid=Deezer%3A142986206
0
187
1
Pafè
1054
0
320000
2
Deezer
/Sous/imaj/DeezerIcon.png
0
8

19
poz
MP3 320 kb/s
5
Pafè
Ed Sheeran
÷ (De Luxe)
263
4
35

REMAK: Se pa tout atribi repons yo ki nan lis nan tablo ki anba a. Gen lòt eleman ki ka prezan epi yo ta dwe inyore yo.

Atribi Repons Deskripsyon
etag Atribi eleman rasin repons lan. Valè opak ki itilize ak long-polling pou detekte chanjman nan repons yo. Si valè a pa chanje depi repons anvan an, repons lan garanti pou l pa chanje (men gade tou seksyon ki anba yo).
segonn alam ki rete yo Si lekti a se rezilta yon alam, alò sa a se konbyen segonn anvan li pral sispann.
aksyon Gade seksyon Aksyon pou Estasyon Radyo an Difizyon pou yon deskripsyon.
album Non albòm tras aktif aktyèl la. Gade tou atribi tit1 la.
atis Non atis ki sou tras aktif la kounye a. Gade tou atribi tit1 la.
batri Montre si jwè a gen yon pake batri. Gen ladan l atribi:
· nivo – eta chaj, pousantaj
· ap chaje – 1 si l ap chaje kounye a
· ikòn – URL imaj jwè a ki endike eta chaj aktyèl la
 

kapabDeplaseLèkti

 Li vre si li posib pou deplase kontni k ap jwe kounye a oswa kontni ki an poz la sou yon lòt jwè.
 

kapabChèche

 Si li egal a 1, li posib pou defile nan tras aktyèl la, nan entèval 0..totlen, lè w sèvi ak paramèt rechèch la pou /Play. Pa egzanp.ample: /Jwe?chache=34.
db Nivo volim an dB.
Non gwoup la Non gwoup la. Jwè a dwe jwè prensipal nan gwoup la.
Volim gwoup Nivo volim gwoup la. Jwè a dwe jwè prensipal nan gwoup la.
imaj URL imaj ki asosye avèk odyo aktyèl la (albòm, estasyon, antre, elatriye). Si
Atribi Repons Deskripsyon
la URL kòmanse ak /Artwork li ka lakòz redireksyon. Ajoute yon paramèt/kle swivRedireksyon=1 lè w ap rekipere imaj la ka evite redireksyon.
bèbè Eta silans. Mete sou 1 si volim nan silans.
muteDb Si jwè a gen son an sou silans, sa a genyen volim ki pa gen son an an dB.
Volim silans Si li sou silans, sa a gen ladan l nivo volim ki pa sou silans lan. Valè yo soti nan 0 rive nan 100.
non Tit tras odyo k ap jwe kounye a. Gade tou atribi tit1 la.
avizeurl URL pou yon notifikasyon pop-up.
id Id inik keu lekti a. Li koresponn ak atribi id repons /Playlist la. Si yo chanje keu lekti a, nimewo sa a ap chanje.
debarase m Id inik predefini an. Li koresponn ak atribi prid ki nan repons /Presets la. Si yo chanje yon predefini, nimewo sa a ap chanje, sa vle di nenpòt repons ki nan kach pou /Presets yo ta dwe efase.
bon jan kalite Kalite odyo sous la k ap jwe a:
· cd – odyo san pèt nan kalite CD
· hd – odyo san pèt ak pi gwo rezolisyon pase kalite CD oubyen sampvitès 88200 sampmwens/s oswa plis
· dolbyAudio – DolbyDigital oswa AC3
· mqa – valab odyo MQA dekode
· mqaAuthored – odyo MQA-Authored valab dekode
Yon valè nimerik se to debi apwoksimatif yon sous odyo konprese ki gen bon jan kalite. file.
 

repete

 0, 1, oubyen 2. 0 vle di repetisyon nan fil datant, 1 vle di repetisyon yon track, epi 2 vle di repetisyon etenn.
secs Kantite segonn depi tras odyo aktyèl la te jwe. Valè sa a pa itilize nan kalkil e a.tag Epi pwogrè a pa pral poukont li lakòz yon retou nan yon apèl sondaj ki dire lontan. Kliyan yo oblije ogmante pozisyon lekti a, lè eta a se jwe oswa difize, ki baze sou entèval ki pase depi repons lan.
sèvis Idantifikasyon sèvis odyo aktyèl la. Sa a se pa yon valè pou montre nan yon koòdone itilizatè, paske
Atribi Repons Deskripsyon
chèn reyèl la ka diferan de non sèvis ofisyèl la.
Ikòn sèvis URL ikòn sèvis aktyèl la.
melanje 0 oubyen 1. 0 vle di lekti aleatwa a pa fonksyone epi 1 vle di lekti aleatwa a aktive.
dòmi Minit ki rete anvan revèy pou dòmi an aktive.
chante Pozisyon tras aktyèl la nan fil lekti a. Gade tou kouranUrl.
eta Eta aktyèl jwè a. Li kapab jwe, pran yon poz, kanpe, difize, konekte, elatriye.
Ou ka itilize /Play pou rekòmanse lè jwèt la an poz, men ou pa ka itilize li lè li an arè.
Yo ta dwe konsidere jwe ak kouran tankou gen menm siyifikasyon. Gade tou kouranUrl.
 

Imaj estasyon

 URL Pou imaj yon estasyon radyo, si odyo aktyèl la se yon estasyon radyo, pa egzanp, radyo Deezer. Li ka menm bagay ak imaj la.
Fòma kouran Fòma odyo a.
kouranUrl Prezans eleman sa a ta dwe trete kòm yon drapo epi kontni li kòm yon valè opak. Si li prezan, li endike:
· keu lekti a pa sous odyo aktyèl la (mizik la pa enpòtan)
· Ale nan mòd ak repete pa enpòtan epi yo ta dwe retire yo nan nenpòt koòdone itilizatè si sa posib
· pwochen ak anvan yo pa disponib (men gade tou aksyon yo)
senkronizasyon Id inik la pou endike nenpòt chanjman nan repons /SyncStatus la. Li koresponn ak atribi syncStat repons /SyncStatus la. Li chanje chak fwa gen yon chanjman nan Estati Senkronizasyon an.
tit1 Premye liy enfòmasyon ki dekri odyo aktyèl la. tit1, tit2 ak tit3
DWE itilize kòm tèks nenpòt koòdone itilizatè ki montre twa liy metadone k ap jwe kounye a. Pa itilize valè tankou albòm, atis ak non.
tit2 Dezyèm liy enfòmasyon an k ap dekri odyo aktyèl la.
tit3 Twazyèm liy enfòmasyon an ki dekri odyo aktyèl la.
totalèn Longè total tras aktyèl la, an segonn.
tit_de_liy1 Premye nan de liy ki dekri odyo aktyèl la. twoline_title1 ak twoline_title2, si yo la, DWE itilize kòm tèks nenpòt koòdone itilizatè ki montre de
Atribi Repons Deskripsyon
liy metadone k ap jwe kounye a.
tit_de_liy2 Dezyèm nan de liy ki dekri odyo aktyèl la.
volim Nivo volim jwè a an pousantajtage; -1 vle di volim jwè a fiks.
secs Kantite segonn depi tras odyo aktyèl la ap jwe.

Example
http://192.168.1.100:11000/Status
Jwenn estati lekti jwè a.
http://192.168.1.100:11000/Status?delè=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Jwenn estati lekti jwè a lè l sèvi avèk long-polling. Yon rezilta retounen sèlman anvan delè 100 segonn lan si estati jwè a chanje. Sinon, rezilta a retounen apre 100 segonn.
2.2 Eta senkronizasyon jwè ak gwoup
Deskripsyon
Rechèch SyncStatus la retounen enfòmasyon sou jwè yo ak enfòmasyon sou gwoupman jwè yo. Rechèch sa a retounen anpil atribi repons, kèk ladan yo pa aplikab nan dokiman sa a. Repons ki pa dokimante yo ta dwe inyore.
Mande
/EstatiSenkronizasyon?delè=segond&etag=etag-valè

Paramèt Deskripsyon
 delè Paramèt opsyonèl ki itilize ak sondaj long. Se entèval sondaj la an segonn. Entèval sondaj rekòmande a se 180 segonn.
 etag Paramèt opsyonèl yo itilize ak long polling. Sa a se e latag atribi ki soti nan repons apèl /SyncStatus anvan an.

Repons
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″ brand=”Bluesound” etag="23" nivo deyò="-62.9" schemaVersion="25" inisyalize="vre" gwoup="PULSE-0278 + 2" syncStat="23" id="192.168.1.100:11000" mac="90:56:82:9F:02:78"> 192.168.1.100


…..

REMAK: Se pa tout atribi repons yo ki nan lis nan tablo ki anba la a. Gen lòt eleman ki ka prezan epi ou ta dwe inyore yo.

Atribi Repons Deskripsyon
batri Montre si jwè a gen yon pake batri. Gen ladan l atribi:
· nivo – eta chaj, pousantaj
· ap chaje – 1 si l ap chaje kounye a
· ikòn – URL imaj jwè a ki endike eta chaj aktyèl la
mak Non mak jwè a.
db Nivo volim an dB.
etag Tag nan repons /SyncStatus la, ki itilize pou sondaj long.
gwoup Non gwoup la.
icon URL ki gen imaj ikòn jwè a.
id Adrès IP ak pò jwè a.
inisyalize Vrè vle di jwè a deja configuré, fo vle di jwè a bezwen konfigirasyon. Jwè a dwe configuré ak aplikasyon BluOS Controller la.
mac Idantifikasyon inik jwè a pou koòdone rezo a. Li kapab yon adrès MAC.
mèt Adrès IP jwè prensipal la. Prezante sèlman si yon jwè se yon jwè segondè nan yon gwoup. Atribi:
· pò – nimewo pò.
· rekoneksyon – vre si w ap eseye rekonekte ak jwè prensipal la
modèl Idantifikasyon modèl jwè a.
modelName Non modèl jwè a.
bèbè Mete sou 1 si volim nan pa sonnen.
muteDb Si jwè a gen son an sourd, sa a se nivo volim ki pa gen son an an dB.
Atribi Repons Deskripsyon
Volim silans Si jwè a pa gen son, sa a se nivo volim ki pa gen son an (0..100).
non Non jwè a.
Vèsyon chema Vèsyon schèma lojisyèl la.
esklav Adrès IP jwè segondè yo. Prezante sèlman si jwè a se jwè prensipal nan yon gwoup. Ka gen plizyè jwè segondè. Atribi:
· id – adrès IP
· pò – nimewo pò
 

senkronizasyon

 id estati senkronizasyon an. Li chanje chak fwa nenpòt atik nan repons /SyncStatus la chanje. Koresponn ak eleman nan /Status repons.
volim Nivo volim sou yon echèl 0..100. -1 vle di volim fiks.
zòn Non gwoup fiks la.
Mèt zòn Si jwè a se jwè prensipal la nan yon gwoup fiks, sa a mete sou vre.
zònEsklav Si jwè a se yon jwè segondè nan yon gwoup fiks, sa a mete sou vre.

Example
http://192.168.1.100:11000/SyncStatus
Jwenn estati jwè a ak gwoup jwè a.
http://192.168.1.100:11000/SyncStatus?delè=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Jwenn estati jwè a ak gwoup jwè a lè l sèvi avèk long-polling. Yon rezilta retounen sèlman anvan delè 100 segonn lan si estati jwè a chanje. Sinon, rezilta a retounen nan 100 segonn.

Kontwòl Volim

Ajiste nivo volim yon jwè. Yo itilize li tou pou mete yon jwè sou silans.
3.1 Mete Volim
Deskripsyon
Demann sa a poze kesyon oswa fikse volim jwè a.
Tout varyant kòmand yo, kit se lè l sèvi avèk nivo 0..100, dB absoli oswa paramèt dB relatif, yo limite a valè ki lakòz yon nivo nan seri volim ki disponib la, ki tipikman se -80..0. Ou ka ajiste seri volim nan lè l sèvi avèk aplikasyon BluOS Controller la, sou paj Anviwònman -> Jwè -> Odyo.
Rechèch la sipòte sondaj long (pa ilistre anba a).
Mande
/Volim
/Volim?nivo=nivo&di_esklav=on_off
/Volim?mute=on_off&tell_slaves=on_off
/Volim?abs_db=db&di_esklav=on_off
/Volim?db=delta-db&di_esklav=aktive_etenn

Paramèt Deskripsyon
nivo Fikse nivo volim absoli jwè a. Li se yon nonb antye relatif ant 0 ak 100.
 di_esklav yo Aplike pou jwè ki gwoupe yo. Si li mete sou 0, se sèlman jwè ki chwazi kounye a ki chanje volim. Si li mete sou 1, tout jwè ki nan gwoup la chanje volim.
bèbè Si li mete sou 0, jwè a ap sou silans. Si li mete sou 1, jwè a ap aktive son an.
abs_db Ajiste volim nan avèk yon echèl dB.
 db Fè yon chanjman volim relatif lè l sèvi avèk yon echèl volim dB. db kapab yon nonb pozitif oswa negatif.

Repons
<volume db=”-49.9″ mute=”0″ offsetDb=”0″ etag=”6213593a6132887e23fe0476b9ab2cba”>15</volume>

Atribi Repons Deskripsyon
Atribi Repons Deskripsyon
db Nivo volim an dB.
bèbè 1 si jwè a pa sou silans, 0 si jwè a pa sou silans.
muteDb Si jwè a gen son an sourd, sa a se nivo volim ki pa gen son an an dB.
Volim silans Si jwè a pa gen son, sa a se nivo volim ki pa gen son an (0..100).
volim Nivo volim aktyèl la: 0..100 oubyen -1 pou volim fiks.

Example
http://192.168.1.100:11000/Volume?level=15
Mete nivo volim jwè a sou 15 (sou 100).
http://192.168.1.100:11000/Volume? tell_slaves=1&db=2
Ogmante volim jwè prensipal 192.168.1.100 la, ak tout jwè segondè yo nan gwoup sa a, pa 2 dB.
http://192.168.1.100:11000/Volume?mute=1
Mete jwè a sou silans.
3.2 Volim monte
Deskripsyon
Demann sa a ogmante volim nan pa sèten dB (valè tipik la se 2dB).
Mande
/Volim?db=valè_db

Paramèt Deskripsyon
db Ogmantasyon volim an dB (valè tipik 2dB)

Repons
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>

Atribi Repons Deskripsyon
db Nivo volim an dB.
bèbè 1 si jwè a sou silans, 0 si jwè a pa sou silans
Atribi Repons Deskripsyon
offsetDb
etag

Example
http://192.168.1.100:11000/Volume?db=2
Ogmante volim nan pa 2dB.
3.3 Volim desann
Deskripsyon
Demann sa a diminye volim nan pa sèten dB (valè tipik la se -2dB).
Mande
/Volim?db=-db_value

Paramèt Deskripsyon
db Ogmantasyon volim an dB (valè tipik -2dB)

Repons
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>

Atribi Repons Deskripsyon
db Nivo volim an dB
bèbè 1 si jwè a sou silans, 0 si jwè a pa sou silans
offsetDb
etag

Example
http://192.168.1.100:11000/Volume?db=-2
Diminye volim nan pa 2dB.
3.4 Silans Aktive
Deskripsyon
Mande
/Volim?mute=1

Paramèt Deskripsyon
bèbè Mete sou 1 pou mete jwè a sou silans

Repons
<volume muteDb=”-43.1″ db=”100″
Volim mute="11"
silans="1"
offsetDb="0"
etag=”2105bed56563d9da46942a696cfadd63″>0</volume
>

Atribi Repons Deskripsyon
muteDb Nivo volim an dB anvan silans
db Nivo volim an dB
Volim silans Nivo volim an pousantaj anvan silans
bèbè 1 vle di jwè a pa sonnen.
offsetDb
etag

Example
http://192.168.1.100:11000/Volume?mute=1
3.5 Silans Off
Deskripsyon
Demann sa a pèmèt jwè a debloke son an.
Mande
/Volim?mute=0

Paramèt Deskripsyon
bèbè Mete sou 0 pou aktive son jwè a

Repons
<volume db=”-43.1″ mute=”0″ offsetDb=”0″ etag=”e72d53db17baa526ebb5ee9c26060b1f”>11</volume>

Atribi Repons Deskripsyon
db Nivo volim an dB
bèbè 0 vle di jwè a pa sou silans
offsetDb
etag

Example
http://192.168.1.100:11000/Volume?mute=0

Kontwòl lèktur

Kòmand sa yo itilize pou kontwòl debaz lekti. Kòmand yo enkli jwe, poz, sispann, sote, retounen, melanje, ak repete.
4.1 Jwe
Deskripsyon
Kòmanse lekti sous odyo aktyèl la. Paramèt opsyonèl yo pèmèt yon so nan tras odyo yo, epi yo ka chwazi yon antre, anvan yo kòmanse lekti odyo a.
Mande
/Jwe
/Jwe?chache=segond
/Jwe?chache=segond&id=id tras
/Jwe?url=kodeDireksyonURL

Paramèt Deskripsyon
 chache Ale nan yon pozisyon espesifik nan tras aktyèl la. Se sèlman valab si repons /Status la gen ladan l Pa ka itilize avèk paramèt inputType ak index.
Kouran kodeURL URL nan odyo pèsonalize difize. Li dwe URL kode.

Repons
jwe
kouran

Atribi Repons Deskripsyon
 

eta

 Eta a apre egzekisyon kòmand lan. Gade atribi eta repons /Status la pou plis detay.

Example
http://192.168.1.100:11000/Play
Kòmanse lekti odyo tras aktyèl la.
http://192.168.1.100:11000/Play?seek=55
Kòmanse lekti odyo a nan 55 segonn nan kòmansman kòmansman track aktyèl la.
http://192.168.1.100:11000/Play?seek=55&id=4
Kòmanse lekti odyo a nan 55 segonn nan kòmansman senkyèm tras la nan fil datant lan.
192.168.1.125:11000/Jwe?url=https%3A%2F%2Fwww%2Esoundhelix%2Ecom%2Fexamples%2Fmp3%
2FSoundHelix-Chanson-1%2Emp3
Kòmanse lekti odyo yon dosye mp3 sou entènèt.
4.2 Pòz
Deskripsyon
Mete odyo k ap jwe kounye a sou poz.
Si yon alam ap sonnen, epi li gen yon delè, delè alam lan anile.
Mande
/Poz
/Pòz?bay/bay=1

Paramèt Deskripsyon
baskile Si li mete sou 1, eta poz aktyèl la ap chanje.

Repons
poz

Atribi Repons Deskripsyon
eta Eta a apre egzekisyon kòmand lan. Gade atribi eta repons /Status la pou plis detay.

Example
http://192.168.1.100:11000/Pause
Mete odyo k ap jwe kounye a sou poz.
4.3 Sispann
Deskripsyon
Sispann odyo k ap jwe kounye a. Si yon alam ap jwe, epi li gen yon delè, delè alam lan anile. Demann
/Sispann

Paramèt Deskripsyon
Okenn

Repons
rete

Atribi Repons Deskripsyon
eta "Stop" vle di odyo aktyèl la sispann.

Example
http://192.168.1.100:11000/Stop
Li sispann odyo k ap jwe kounye a.
4.4 Sote
Deskripsyon
Ale nan pwochen tras odyo nan keu lekti a
Lè w ap jwe apati keu lekti a, li pral sote pou ale nan pwochen track nan keu a. Si track aktyèl la se dènye a nan keu a, lè w rele /Skip, li pral ale nan premye track nan keu a. Li pral sote pou ale nan pwochen oswa premye track nan keu a kèlkeswa eta paramèt repetisyon an.
Pou detèmine si w ap itilize fil lekti a, verifye ke pa gen okennUrl> antre nan repons /Status la.
Apre sa, ou ka itilize kòmandman /Skip la.
Ou kapab tou sote tras pou kèk estasyon radyo an difizyon. Ou ka jere sa ak kòmandman /Action an.
Gen kèk sous tankou TuneIn ak Optical Input ki pa sipòte yon opsyon sote. Sous sa yo pral gen yonURL> antre men pa gen non aksyon sote nan repons /Status la.
Mande
/ Sote

Paramèt Deskripsyon
Okenn

Repons
21

Atribi Repons Deskripsyon
id Id tras la apre yo fin egzekite kòmandman sote a. Gade atribi chante repons /Status la pou plis detay.

Example
http://192.168.1.100:11000/Skip
Ale nan pwochen track la.
4.5 Retounen
Deskripsyon
Si yon mizik ap jwe epi li gen plis pase kat segonn depi l ap jwe, lè sa a bouton "back" la ap retounen nan kòmansman mizik la.
Sinon, kòmandman "back" la ap ale nan chante anvan an nan lis lekti aktyèl la. Si li sou premye chante nan lis lekti a, lè w rele "back" la, li pral ale nan dènye chante a. Li pral ale nan premye chante anvan an oswa nan premye chante nan fil la kèlkeswa eta paramèt repetisyon an.
Pou detèmine si w ap itilize fil lekti a, verifye ke pa gen okennUrl> eleman nan repons /Status la.
Apre sa, ou ka itilize kòmandman /Back la.
Ou kapab tou retounen nan tras anvan pou kèk estasyon radyo an dirèk. Ou ka jere sa ak kòmandman /Action an.
Gen kèk sous tankou TuneIn ak Optical Input ki pa sipòte yon opsyon pou dèyè. Sous sa yo ap gen yonUrl> eleman men pa gen non aksyon sote nan repons /Status la.
Mande
/ Retounen

Paramèt Deskripsyon
Okenn

Repons
19

Atribi Repons Deskripsyon
id Id tras la apre yo fin egzekite kòmandman "back" la. Gade atribi chante repons /Status la pou plis detay.

4.6 Shuffle
Deskripsyon
Kòmand shuffle la kreye yon nouvo fil lè li melanje fil aktyèl la. Fil orijinal la (ki pa melanje) konsève pou restorasyon lè shuffle enfim.
Mande
/Melanje?eta=0|1

Paramèt Deskripsyon
eta · 0 pou dezaktive lekti alejabl la
· 1 pou aktive lekti melanje. Pa gen okenn efè si keu a deja nan eta melanje. Gade repons /Status la eleman.

Repons

Atribi Repons Deskripsyon
modifye 1 vle di ke fil la te modifye depi li te chaje. 0 vle di non.
longè Kantite total tras ki nan fil datant aktyèl la.
melanje Eta melanj lan. 1 vle di keu aktyèl la ap melanje. 0 vle di keu aktyèl la pa melanje.
id Idantifikasyon fil aktyèl la. Li chanje chak fwa yo modifye fil lekti a.

Example
http://192.168.1.100:11000/Shuffle?state=1
Melanje lis jwèt aktyèl la.
4.7 Repete
Deskripsyon
Fikse opsyon repetisyon yo. Repetisyon an gen twa eta; 0 vle di repete keu aktyèl la, 1 vle di repete tras aktyèl la epi 2 vle di pa repete. Tout repetisyon yo endefini, sa vle di, yo pa sispann.
Mande
/Repete?eta=0|1|2

Paramèt Deskripsyon
eta · 0 pou repete tout lis lekti a
· 1 pou repete tras aktyèl la
· 2 pou fèmen repetisyon an

Repons

Atribi Repons Deskripsyon
longè Kantite total mizik ki nan lis lekti aktyèl la.
id Idantifikasyon fil aktyèl la. Li chanje chak fwa yo modifye fil lekti a.
repete Eta repetisyon aktyèl la.

Example
http://192.168.1.100:11000/Repeat?state=1
Repete tras k ap jwe kounye a la.
4.8 Aksyon pou difizyon estasyon radyo
Deskripsyon
Aksyon yo pèmèt ou sote pi devan, retounen, renmen epi entèdi mizik sou sèten estasyon radyo an difizyon, tankou Slacker oubyen Radio Paradise oubyen Amazon Music Prime Stations. Estasyon radyo an difizyon pa chaje mizik nan fil lekti a. Okontrè, yo bay yon URL ke ou ka itilize pou akonpli fonksyon ou vle a.
"Sote" ap ale nan pwochen mizik la. "Retounen" ap ale nan mizik anvan an. "Love" ap make mizik la kòm like nan sèvis mizik la. "Ban" ap sote nan pwochen mizik la epi make mizik la kòm pa like nan sèvis mizik la.
Si gen yonUrl> antre nan repons /Status la, ak yon aksyon ki apwopriye, ou ka fè fonksyon sa yo. Aksyon an ap genyen ladan l URL ki itilize pou egzekite aksyon an.
Isit la se yon ansyenampsoti nan repons /Status yon jwè k ap jwe radyo Slacker:


<action name=”skip” url=”/Aksyon?sèvis=Slacker&sote=4799148″/>
<action icon=”/images/loveban/love.png” name=”love” notification=”Track marked as favorite” state=”1″ text=”Love” url=”/Aksyon?sèvis=Slacker&lanmou=4799148″/>
<action icon=”/images/loveban/ban.png” name=”ban” notification=”Track banned from this
estasyon” eta =”-1″ tèks =”Entèdiksyon” url=”/Aksyon?sèvis=Slacker&ban=4799148″/>

Nan ansyen sa aample, back pa disponib, men sote, renmen ak entèdi posib.
Mande
/Aksyon?sèvis=non-sèvis&aksyon=aksyon-URL
Nòt: Detay espesifik demann lan (pwen final ak paramèt) yo bay pa respektif la. eleman. Kòmandman ki nan Ex laampSeksyon ki anba a tout itilize /Action men nenpòt URI posib.

Paramèt Deskripsyon
Bay nan eleman.

Repons
Pou repons lan, ou resevwa yon akize resepsyon aksyon. Pou sote epi retounen, ou resevwa:


Pou lanmou ou resevwa:
1
Pou entèdiksyon an ou resevwa:
0

Atribi Repons Deskripsyon
repons Si eleman rasin repons lan se Lè sa a, nœd tèks la se yon notifikasyon pou montre itilizatè a. Si yo retounen yon eleman rasin altènatif epi te enkli yon atribi notifikasyon, lè sa a notifikasyon sa a ta dwe parèt.

Example
http://192.168.1.100:11000/Action?service=Slacker&skip=10965139
Sote nan pwochen tras radyo Slacker la.
http://192.168.1.100:11000/Action?service=Slacker&ban=33332284
Entèdi tras radyo Slacker k ap jwe kounye a epi sote nan pwochen tras la.

 Jesyon Fil Jwe

Yon mòd operasyon yon jwè se chaje mizik nan yon lis lekti, epi answit jwe mizik ki soti nan lis lekti sa a. Kòmand sa yo pèmèt ou view epi jere keu jwèt la.
5.1 Lis Pista
Deskripsyon
Swa retounen estati keu lekti a, oswa retounen enfòmasyon sou tout tracks ki nan keu lekti a.
Li pa rekòmande pou itilize rechèch sa a san paramèt longè a oswa paramèt kòmansman ak fen yo, paske sinon li ka pwodui yon repons ki twò long.
Mande
/Lis lekti
/Lis lekti?longè=1
/Lis lekti?kòmanse=premye&fen=dènye (rekipere yon pati nan fil la, anjeneral pou pajinasyon)

Paramèt Deskripsyon
longè=1 Retounen sèlman atribi nivo siperyè yo epi pa gen okenn detay sou tras la.
kòmanse Premye antre nan fil datant lan pou enkli nan repons lan, kòmanse depi 0.
fini Dènye antre nan fil datant lan pou enkli nan repons lan.

Repons
Pou yon estati nan fil datant pou jwe:

13
243

1

Pou yon lis moun ki nan fil datant pou jwe:


2002
Anne-Marie
2002
Deezer:487381362

Atribi Repons Deskripsyon
non Non keu jwèt aktyèl la.
modifye 0 vle di keu a pa te modifye depi li te chaje. 1 vle di keu a te modifye depi li te chaje.
longè kantite total tras nan fil aktyèl la
id id inik pou eta aktyèl keu a (pa egzanp, 1054). Li menm jan ak nan /Repons estati.
chante Yon chante konpoze de plizyè sou-eleman:
· id album = id albòm kote mizik la ye a
· sèvis = sèvis mizik nan tras la
· id atis la = id atis mizik la
· songid = id chante
· id = pozisyon track la nan fil aktyèl la. Si track la chwazi kounye a, id track la se menm ak nan /Repons estati.
· tit = non tras la
· atizay = non atis
· albòm = non albòm

Example
http://192.168.1.100:11000/Playlist
Lis tout mizik ki nan lis lekti a.
http://192.168.1.100:11000/Playlist?length=1
5.2 Efase yon tras
Deskripsyon
Retire yon mizik nan lis lekti aktyèl la.
Mande
/Efase?id=pozisyon

Paramèt Deskripsyon
id Idantifikasyon tras tras ki pral efase nan lis lekti aktyèl la.

Repons
9

Atribi Repons Deskripsyon
efase Pozisyon nan lis la kote yo pral retire tras la.

Example
http://192.168.1.100:11000/Delete?id=9
Retire tras la nan pozisyon 9 nan keu lekti a.
5.3 Deplase yon tras
Deskripsyon
Deplase yon tras nan lis lekti aktyèl la.
Mande
/Deplase?nouvo=destinasyon&ansyen=orijin

Paramèt Deskripsyon
nouvo Nouvo pozisyon sou ray la y ap deplase a.
fin vye granmoun Ansyen pozisyon ray tren y ap deplase a.

Repons
deplase

Atribi Repons Deskripsyon
deplase Endike ke yo te deplase tras la.

Example
http://192.168.1.100:11000/Move?new=8&old=2
Deplase tras la nan pozisyon 2 pou mete l nan pozisyon 8 nan lis lekti a.
5.4 Vide fil datant lan
Deskripsyon
Efase tout mizik yo nan lis lekti aktyèl la
Mande
/Klè

Paramèt Deskripsyon
Okenn

Repons

Atribi Repons Deskripsyon
modifye 0 vle di keu a pa modifye depi li te chaje, 1 vle di keu a modifye depi li te chaje.
longè Kantite total tras ki nan fil datant aktyèl la.
id Idantifikasyon inik pou fil aktyèl la.

Example
http://192.168.1.100:11000/Clear
Sa retire tout mizik yo nan keu lekti a.
5.5 Sove keu a
Deskripsyon
Sove lis mizik la kòm yon lis mizik BluOS ki gen non.
Mande
/Save?name=non_list_playlist

Paramèt Deskripsyon
non Non keu jwèt ki sove a.

Repons

126

Atribi Repons Deskripsyon
antre Kantite total mizik ki nan lis lekti ki sove a.

Example
http://192.168.1.100:11000/Save?name=Dinner+Music
Sa sove keu lekti a kòm "Mizik Dine".

Prereglaj

Demann predefinisyon pèmèt ou lis tout predefinisyon yon jwè, chaje yon predefinisyon, epi ogmante/desann predefinisyon yo. Ou dwe ajoute epi efase predefinisyon yo lè l sèvi avèk aplikasyon BluOS Controller la. Predefinisyon yo ka gen ladan estasyon radyo, lis mizik ak antre (pa egzanp
Bluetooth, analòg, optik, HDMI ARC).
6.1 Lis Prereglaj
Deskripsyon
Lis tout prereglaj ki sou jwè BluOS aktyèl la.
Mande
/Prekonfigirasyon

Paramèt Deskripsyon
Okenn

Repons

<preset id=”6″ name=”Serenity” url=”RadioParadise:/42:4/Serenite”
image=”https://img.radioparadise.com/channels/0/42/cover_512x512/0.jpg”/>
<preset id=”7″ name=”1980s Alternative Rock Classics” url=”/Chaje?sèvis=Mare&amp;id=fd3f797e-
a3e9-4de9-a1e2-b5adb6a57cc7″ image=”/Artwork?service=Tidal&amp;playlistimage=afacfc12-24034caf-a5c5-a2af28d811c8″/> </presets>

Atribi Repons Deskripsyon
fyète Yon idantifikasyon inik pou predefinisyon jwè a. Li menm jan ak nan /Repons estati.
non Non predefini an.
id Idantifikasyon predefini an.
url Prereglaj la URLSe sous predefini an. URL itilize pou chaje prereglaj la.
imaj Imaj URL nan predefini an. Si la URL kòmanse ak /Artwork li ka lakòz redireksyon. Ajoute yon paramèt/kle swivRedireksyon=1 lè w ap rekipere imaj la ka evite redireksyon.

Example
http://192.168.1.100:11000/Presets
Lis tout prereglaj ki sou jwè a.
6.2 Chaje yon Predefinisyon
Deskripsyon
Kòmanse jwe yon predefinisyon. Ou ka chwazi yon nimewo predefinisyon espesifik, ansanm ak predefinisyon kap vini an oswa anvan an. Nimewo predefinisyon yo pa oblije youn apre lòt, sa vle di, ou ka gen predefinisyon 1, 2, 3, 5, 7 ak 8. Predefinisyon yo boukle soti anwo jouk anba epi soti anba jouk anwo.
Mande
/Predefini?id=predefiniId|-1|+1

Paramèt Deskripsyon
id Nimewo idantifikasyon predefinisyon ki pral chaje a. Ou ka jwenn lis idantifikasyon predefinisyon ki disponib yo avèk kòmandman Montre Predefinisyon yo.
Si id predefinisyon an se +1, l ap chaje pwochen predefinisyon an. Si id predefinisyon an se -1, l ap chaje predefinisyon anvan an.

Repons
Si prereglaj la se yon lis track, li retounen kantite track nan prereglaj la ki chaje a.

60

Si prereglaj la se yon radyo, li retounen eta difizyon an.
kouran

Atribi Repons Deskripsyon
sèvis non sèvis predefini ki chaje a
antre nimewo tras predefini ki chaje a

Example
http://192.168.1.100:11000/Preset?id=4
Chaje predefinisyon an ak id predefinisyon 4 la.
http://192.168.1.100:11000/Preset?id=+1

Navigasyon ak rechèch kontni

Seksyon sa a dekri kòmand pou navige ak rechèch kontni sèvis mizik.
7.1 Navige Kontni Mizik
Deskripsyon
Navige nan sous mizik ki disponib yo, ansanm ak antre ak lis mizik yo.
Eleman rasin pou repons yo se sof si gen yon repons erè. Pifò rezilta yo se yon sekans de Nan kèk ka, rezilta a se yon sekans , chak ladan yo gen yon sekans si Tout valè yo bay avèk atribi. Pa gen okenn nœuds tèks.
Rezilta yon apèl /Browse kapab yon erè ki antoure nan yon eleman rasin lan. Detay erè a bay nan youn ak zewo oubyen plis nœuds tèks.
Mande
/Browse?key=kle-valè
/Browse?key=kle-valè&withContextMenuItems=1

Paramèt Deskripsyon
kle Paramèt opsyonèl. Absans paramèt sa a ap lakòz yon navigasyon nan nivo siperyè. Retounen enfòmasyon pou lòt nivo apa de nivo siperyè /Browse. Itilize valè ki soti nan yon valè atribi "browseKey", "nextKey", "parentKey", oswa "contextMenuKey" nan yon repons pi bonè.
Nòt: kle-valè dwe URL kode
ak Atik Meni Kontèks Paramèt opsyonèl. Valè a toujou 1.
Paramèt sa a itilize pou jwenn yon meni kontèks anliy lè w ap jwenn rezilta navigasyon pou lis mizik, albòm, mizik, estasyon mizik, atis, elatriye.

Repons
Repons navigasyon nivo siperyè:



<item image=”/images/InputIcon.png” text=”Optical Input”
jweURL=”/Jwe?url=Capture%3Ahw%3A1%2C0%2F1%2F25%2F2%2Finput1″ inputType=”spdif”
tip="odyo"/>




Lòt nivo repons navigasyon:
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
sèvis="Deezer" searchKey="Deezer:Rechèch" kalite="meni">
atik browseKey="/Lis Mizik?sèvis=Deezer&genre=0&category=toplist" tèks="Lis Mizik Popilè"
tip="lyen"/>

tip="lyen"/>

tip="lyen"/>
atik browseKey="/Songs?service=Deezer&genre=0&category=toplist" tèks="Mizik Popilè"
tip="lyen"/>

Atribi Repons Deskripsyon
Gade tablo eleman/atribi ki anba yo

Example
REMAK: tout paramèt kle yo dwe kode an UTF-8.
http://192.168.1.100:11000/Browse
Èske yon navigasyon nivo siperyè.
http://192.168.1.100:11000/Browse?key=Tidal%3A
Èske yon dezyèm nivo navigasyon, ki retounen kategori Tidal yo.
http://192.168.1.100:11000/Browse?key=Tidal%3AmenuGroup%2F3
Èske yon twazyèm nivo navigasyon retounen sou-kategori Tidal Masters (Gwoup 3) yo?
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters
Èske yon katriyèm nivo navigasyon retounen premye seri albòm Tidal Masters yo.
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters%26 start%3D30%26end%3D79
Èske yon lòt katriyèm nivo navigasyon an retounen dezyèm seri albòm Tidal Masters yo.

Eleman Atribi (ak valè) Deskripsyon
Ikòn sèvis URI pou yon ikòn pou sèvis y ap navige kounye a.
serviceName Non sèvis y ap navige kounye a, pou itilizatè a ka wè l.
kle rechèch Yon valè pou itilize kòm yon paramèt kle nan yon demann /Browse pou chèche sèvis aktyèl la (oswa yon pati ki pi fon nan yerachi a). Anplis de sa, demann lan dwe gen yon paramèt q ki gen tèm rechèch la.
pwochenKle Yon valè pou itilize pou yon paramèt kle nan yon demann /Browse pou jwenn pwochen paj atik yo pou paj aktyèl la. viewGwosè moso pajinasyon an pa anba kontwòl itilizatè API a epi ou pa ta dwe fè okenn tantativ pou analize oswa manipile paramèt rechèch valè sa a.
Kle paran Yon valè pou itilize pou yon paramèt kle nan yon demann /Browse pou navige tounen nan yerachi a si navigasyon tounen pa defo a ta dwe ranplase.
kalite meni Yon nœd navigasyon ki ta ka genyen yon melanj nenpòt kalite atik. Pi souvan, li pral genyen sèlman lyen oswa atik odyo.
Meni kontèks Yon lis atik ki nan kalite espesifye a.
atis
Eleman Atribi (ak valè) Deskripsyon
konpozitè
albòm
lis mizik
tras
jan yo
seksyon yo Seksyon alfabetik.
atik yo Lis rezilta jenerik. Pi souvan yon melanj de nœuds meni (type="link") ak atik radyo (type="audio").
dosye Ka gen ladan antre nan sou-dosye, mizik ak lis mizik.
tèks Tit pou kategori a.
pwochenKle Yon valè pou itilize pou yon paramèt kle nan yon demann /Browse pou jwenn pwochen paj atik pou kategori a.
Kle paran Yon valè pou itilize pou yon paramèt kle nan yon demann /Browse pou navige tounen nan yerachi a si navigasyon tounen pa defo a ta dwe ranplase.
kalite lyen Yon ne jenerik nan yerachi navigasyon an ki mennen nan plis ne.
odyo Yon ne ki ka jwe dirèkteman
atis Yon atik ki reprezante yon atis
Eleman Atribi (ak valè) Deskripsyon
konpozitè Yon atik ki reprezante yon konpozitè
album Yon atik ki reprezante yon albòm oswa yon koleksyon menm jan an
playlist Yon atik ki reprezante yon lis lekti oswa yon koleksyon menm jan an
tras Yon atik ki reprezante yon sèl tras
tèks Yon ne tèks senp.
seksyon Yon seksyon alfabetik.
katab Yon dosye nan yon navigasyon dosye.
tèks Liy prensipal oswa premye liy deskripsyon atik la
tèks2 Dezyèm liy
imaj Yon ikòn oswa yon travay atistik pou atik la. Si imaj la kòmanse ak

/Travay atistik sa ka lakòz yon redireksyon. Ajoute yon paramèt/kle swivRedireksyon=1 lè w ap rekipere imaj la ka evite redireksyon.
Kle Navigasyon Yon valè pou itilize pou yon paramèt kle nan yon demann /Browse ki vin apre pou desann nan yerachi a.
jweURL Yon URI ki ka envoke dirèkteman pou envoke aksyon jwe pa defo pou atik an kesyon an. Anjeneral, sa a se pou efase fil la epi kòmanse jwe li.
jwe otomatikURL Yon URI ki ka envoke dirèkteman pou ajoute yon tras nan fil la epi jwe li epi ajoute tras ki vin apre yo soti nan objè ki genyen l lan (tankou yon albòm) nan ranpli otomatik la.
Eleman Atribi (ak valè) Deskripsyon
seksyon nan keu jwèt la.
KleMeniKontèks Yon valè pou itilize pou yon paramèt kle nan yon demann /Browse pou jwenn yon rezilta ki se yon meni kontèks aksyon ki gen rapò ak atik la.
aksyonURL Yon URI ki ka envoke dirèkteman pou fè aksyon espesifye a.

Atik meni kontèks yo ka gen valè sa yo pou atribi type la.

Atribi
Deskripsyon
pi renmen -ajoute Ajoute atik la kòm yon favori (oswa ekivalan)
-efase Retire atik la nan favoris itilizatè a
ajoute Ajoute nan fil jwèt la
ajoute -kounye a Ajoute nan fil lekti a apre tras aktyèl la epi jwe kounye a
-pwochen Ajoute nan fil lekti a apre tras aktyèl la
dènye Ajoute nan fen keu jwèt la
ajouteTout -kounye a Ajoute objè milti-pist nan fil lekti a epi jwe kounye a
-pwochen Ajoute objè milti-pist nan fil lekti a apre tras aktyèl la oswa objè milti-pist la
dènye Ajoute objè milti-pist nan fen keu lekti a
jweRadyo Jwe yon estasyon radyo ki gen rapò ak atik la
efase Efase objè a (anjeneral yon lis lekti). Yo ta dwe mande konfimasyon itilizatè a.

Lè w ap navige avèk paramèt "withContextMenuItem=1", rezilta a ap genyen yon meni kontèks anndan liy.
Example
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26genre%3D0%26category %3Dtoplist&withContextMenuItems=1
Èske yon demann Deezer => What's Hot => Albòm Popilè ak yon meni kontèks entegre.
Repons
Repons lan genyen ladan l anliy pou chak atik.

<item text=”Essonne History X” contextMenuKey=”Deezer:contextMenu/Album?albumid=693798541″
jweURL="/Ajoute?sèvis=Deezer&albumid=693798541&jwekounye=1" imaj="/Travay atistik?sèvis=Deezer&albumid=693798541"
browseKey="Deezer:Albòm?atis=Ziak&album=Istwa%Essonne%20X&albumid=693798541" tèks2="Ziak" kalite="albòm">
<item text=”Favorite” type=”favourite-add” actionURL="/AddFavourite?service=Deezer&albumid=693798541″/>
<item text=”Play now” type=”add-now”
aksyonURL="/Ajoute?sèvis=Deezer&playnow=1&clear=0&shuffle=0&where=nextAlbum&albumid=693798541"/>
<item text=”Shuffle” type=”add-shuffle”
aksyonURL="/Ajoute?sèvis=Deezer&shuffle=1&playnow=1&kote=nextAlbum&albumid=693798541"/>
<item text=”Add next” type=”addAll-next” actionURL="/Ajoute?sèvis=Deezer&jwekounye=-1&kote=pwochenAlbòm&midalbum=693798541"/>
<item text=”Add last” type=”addAll-last” actionURL="/Ajoute?sèvis=Deezer&playnow=-1&kote=dènye&albumid=693798541"/>


...

Nòt ak Konsèy sou Aplikasyon
Atribi kalite yon atik yo bay kòm yon endis ki ka fasilite diferan opsyon ekspozisyon.
Prezans yon atribi browseKey endike kapasite pou browse kontni yon atik. Prezans yon atribi play endike kapasite pou jwe yon atik (an antye).URL (epi petèt tou oto-jweURL). Yon atik ka genyen tou de yon atribi browseKey ak yon atribi playURL atribi.
Lè tou de ap jweURL ak oto-jweURL Si atribi yo disponib, itilizatè a ta dwe deside kilès pou itilize kòm opsyon jwèt pa default la.
Valè URI yo jeneralman se URI relatif ak yon eleman chemen absoli. URI relatif yo rezoud an URI absoli dapre RFC 3986.
Valè atribi browseKey, contextMenuKey ak searchKey yo dwe toujou kode nan URI (pousantaj chape) lè yo itilize kòm valè yon paramèt kle nan yon demann /Browse, menm jan ak nenpòt lòt paramèt demann.
Lè w ap desann yerachi navigasyon an, li ka itil pou antet paj koòdone itilizatè a montre yon kalite fil d'Ariane(s), pwobableman lè l sèvi avèk tit (tèks) nœuds paran ak granparan yo.
Li ka itil pou rann meni kontèks la disponib pou paran an lè y ap gade pitit li yo.
Li ka itil pou konsidere kalite paran an lè w ap deside kijan pou montre pitit li yo.
7.2 Chèche Kontni Mizik
Deskripsyon
Kòmand pou chèche nan yon sèvis.
Mande
/Browse?key=kle-valè&q=rechèchTèks

Paramèt Deskripsyon
kle Valè ki soti nan yon valè atribi "searchKey" ki soti nan yon repons pi bonè.
 q Chèn rechèch la. Fè yon rechèch nan kontèks espesifye pa paramèt kle a (pran nan yon atribi searchKey nan yon repons). Si pa gen yon paramèt kle, fè yon rechèch nan nivo siperyè.

Repons
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
sèvis="Deezer" searchKey="Deezer:Rechèch" kalite="meni">





Retounen premye nivo rezilta rechèch la. Pou plis rezilta rechèch sou Atis, Albòm, Mizik, oswa Lis lekti, yon kòmandman browse ak "browseKey" kòm kle a nesesè.
Pou egzanpampPou wè rezilta rechèch Albòm yo, voye kòmand sa a:
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26expr%3Dmichael
Repons lan ap menm jan ak repons lan pou kòmandman nòmal /Browse la.

Atribi Repons Deskripsyon
Gade tablo eleman/atribi yo nan kòmandman Browse a.

Example
http://192.168.1.100:11000/Browse?key=Deezer:Search&q=michael Chèche pou "Michael" nan sèvis mizik Deezer la.

Gwoupman Jwè yo

Seksyon sa a dekri kòmand pou gwoupman ak degwoupman jwè pa defo. BluOS sipòte tou gwoupman fiks, ki pa nan kad dokiman sa a.
BluOS itilize tèminoloji jwè prensipal ak jwè segondè. Jwè prensipal la se jwè prensipal nan gwoup la. Jwè prensipal la itilize pou chwazi sous mizik la. Gen yon sèl jwè prensipal. Yon jwè segondè tache ak jwè prensipal la. Ka gen plizyè jwè segondè.
Si yon jwè se yon jwè segondè, alò anpil demann, si yo dirije bay jwè segondè a, yo voye bay jwè prensipal la anndan. Sa yo enkli /Estati, Kontwòl Lekti, Jesyon Fil Dat Lekti ak demann pou Navigasyon ak Rechèch Kontni.
8.1 Jwè Gwoup De
Deskripsyon
Gwoupe yon jwè segondè ak yon jwè prensipal.
Mande
/AjouteEsklav?esklav=IPJwèSegondè&pò=PòJwèSegondè&gwoup=NonGwoup

Paramèt Deskripsyon
esklav Adrès IP jwè segondè a.
 pò Nimewo pò jwè segondè a. Nimewo pò pa defo a se 11000. Jwè tankou NAD CI580 la, ki gen kat jwè ak yon sèl IP, itilize plizyè pò.
 gwoup OPSYONÈL, non gwoup la. Si ou pa bay li, BluOS ap bay yon non gwoup pa defo.

Repons


Atribi Repons Deskripsyon
pò esklav Nimewo pò jwè segondè ki fèk gwoupe a.
Id ID jwè segondè ki fèk gwoupe a.

Example
http://192.168.1.100:11000/AddSlave?slave=192.168.1.153&port=11000
Sa gwoupe jwè 192.168.1.153 ak jwè 192.168.1.100. Jwè 192.168.1.100 se jwè prensipal la.
8.2 Ajoute plizyè jwè nan yon gwoup
Deskripsyon
Gwoupe de jwè oswa plis nan yon jwè prensipal.
Mande
/AjouteEsklav?esklav=IPJwèSegondè&pò=PòJwèSegondè

Paramèt Deskripsyon
 esklav Adrès IP jwè segondè yo ki pral ajoute nan jwè prensipal la. Adrès IP yo separe ak virgil.
 pò Pò jwè segondè yo pou ajoute nan jwè prensipal la. Nimewo pò yo separe pa virgil.

Repons



Atribi Repons Deskripsyon
pò Pò jwè segondè ki te gwoupe a.
Id Idantifikasyon jwè segondè ki te gwoupe a.

Example
http://192.168.1.100:11000/AddSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Gwoupe jwè segondè 192.168.1.153 ak 192.168.1.120 yo ak jwè prensipal 192.168.1.100.
8.3 Retire yon jwè nan yon gwoup
Retire yon jwè nan yon gwoup. Si w ap retire yon jwè segondè nan yon gwoup, jwè segondè a pa nan gwoup la. Si w ap retire jwè prensipal la nan yon gwoup 3 jwè oswa plis, jwè prensipal la pa nan gwoup la epi jwè segondè ki rete yo fòme yon nouvo gwoup.
Mande
/RetireEsklav?esklav=IPJwèSegondè&pò=PòJwèSegondè

Paramèt Deskripsyon
esklav IP jwè a (segondè) pou ajoute nan yon lòt jwè (prensipal).
pò Pò jwè a (segondè) pou ajoute nan yon lòt jwè (prensipal).

Repons
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″
mak = "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″>

Atribi Repons Deskripsyon
Gade /SyncStatus pou plis detay.

Example
http://192.168.1.100:11000/RemoveSlave?slave=192.168.1.153&port=11000
Degroupe jwè 192.168.1.153 nan gwoup ki gen jwè prensipal 192.168.1.100 la.
8.4 Retire plizyè jwè nan yon gwoup
Deskripsyon
Retire de jwè oswa plis nan yon gwoup.
Mande
/RetireEsklav?esklav=IPJwèSegondè&pò=PòJwèSegondè

Paramèt Deskripsyon
 esklav Adrès IP jwè segondè yo pou retire nan jwè prensipal la. Adrès IP yo separe ak virgil.
Paramèt Deskripsyon
 pò Pò jwè segondè yo pou retire nan jwè prensipal la. Nimewo pò yo separe pa virgil.

Repons
<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>

Atribi Repons Deskripsyon
Gade /SyncStatus pou plis detay.

Example
http://192.168.1.100:11000/RemoveSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Retire jwè 192.168.1.153 ak 192.168.1.120 yo nan gwoup ki gen jwè prensipal 192.168.1.100 la.

Rekòmanse jwè a

Seksyon sa a dekri kòmand pou redémarrer jwè a fasilman.
9.1 Rekòmanse yon jwè
Deskripsyon
Redémarre yon jwè dousman.
Mande
Kòmand POST /reboot ak paramèt wi (nenpòt valè)

Paramèt Deskripsyon
wi Nenpòt valè (pa egzanp 1).

Repons
Paramèt yo mete ajou
Ap redemare. Tanpri fèmen fenèt sa a.
Tanpri tann...
Example
curl -d wi=1 192.168.1.100/rekòmanse

Kloti pòt

Seksyon sa a dekri kòmand pou sonèt pòt jwè a.
10.1 Kloti Sonèt Pòt
Deskripsyon
Aktive sonèt pòt la.
Mande
http://PLAYERIP:PORT/Doorbell?play=1

Paramèt Deskripsyon
jwe Jwe sonèt pòt la (toujou 1)

Repons

Atribi Repons Deskripsyon
pèmèt Endike sonèt la
volim Chime volim
sone Odyo sonnen

Example
http://192.168.1.100:11000/Doorbell?play=1 play doorbell chime

Antre dirèk

Seksyon sa a dekri kòmand pou seleksyon dirèk sous opinyon.
11.1 Seleksyon Antre Aktif
Deskripsyon
Seleksyon sous antre aktif. Kòmand sa a fonksyone pou antre aktif ki parèt nan repons pou /RadioBrowse?service=Capture. Seleksyon antre BluOS HUB la sèlman sipòte pa kòmand sa a.
Mande
/Jwe?url=URLvalè

Paramèt Deskripsyon
url La URL atribi ki soti nan repons lan pou /RadioBrowse?service=Capture

Repons
kouran

Atribi Repons Deskripsyon
eta Endike ke antre a ap jwe

Example
Etap 1. Jwenn la URL_valè pou paramèt la url
Demann: http://192.168.1.100:11000/RadioBrowse?service=Capture
Repons:

<item playerName=”Tick
Make yon ti kwa” tèks=”Bluetooth” kalite antre=”bluetooth” id=”antre2″ URL="Kaptire%3Abluez%3Abluetooth" imaj=" /imaj/BluetoothIcon.png" kalite="odyo"/>
<item playerName=”Tick Tick” text=”Analog
Antre" inputType="analog" 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
Antre" inputType="spdif" id="input1" URL=”Capture%3Ahw%3Aimxspdif%2C0%2F1%2F25%2F2%3Fid%
3Dinput1″ imaj="/imaj/kaptire/ic_opticalinput.png" kalite="odyo"/>
<item playerName=”Tick
Make yon ti kwa” tèks=”Spotify” id=”Spotify” URL="Spotify%3Aplay" imaj="/Sous/imaj/SpotifyIcon.png" sèvis
Kalite="CloudService" kalite="odyo"/>

<remoteitem playerName=”Test Hub” text=”Analog Input” inputType=”analog” id=”hub192168114911000input0″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput0″
imaj="/imaj/kaptire/mwen
c_analoginput.png”
tip="odyo"/>
<remoteitem playerName=”Test Hub” text=”Coaxial Input” inputType=”spdif” id=”hub192168114911000input3″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput3″
imaj="/imaj/kaptire/ic
"_optikantre.png"
tip="odyo"/>
<remoteitem playerName=”Test Hub” text=”HDMI ARC” inputType=”arc” id=”hub192168114911000input4″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput4″
imaj="/imaj/kaptire/ic
_tv.png”
tip="odyo"/>
<remoteitem playerName=”Test Hub” text=”Optical Input” inputType=”spdif” id=”hub192168114911000input2″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput2″
imaj="/imaj/kaptire/ic
"_optikantre.png"
tip="odyo"/>
<remoteitem playerName=”Test Hub” text=”Phono Input” inputType=”phono” id=”hub192168114911000input1″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput1″
imaj="/imaj/kaptire/ic
_vinil.png”
tip="odyo"/>


Etap 2. Jwe Antre Analòg sou jwè a
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
Nòt: Asire w ke sous yo konekte epi yo pa kache.
11.2 Seleksyon Antre Ekstèn
Deskripsyon
Seleksyon sous antre ekstèn. Pafwa, antre ekstèn inaktif yo ka pa parèt nan repons lan.
/RadioBrowse?service=Capture. Kòmand sa a fonksyone pou seleksyon antre aktif ak inaktif. Li rekòmande pou seleksyon antre ekstèn CI.
Demann (firmwèr BluOS ki pi resan pase v3.8.0 epi ki pi ansyen pase v4.2.0)
/Jwe?inputIndex=IdEndèks

Paramèt Deskripsyon
 Endèks Antre Endèks la (kòmanse ak 1) nan antre ki parèt nan repons pou /Settings?id=capture&shcemaVersion=32 (32 se dènye vèsyon chema a) nan lòd nimerik. Bluetooth eskli.

Repons
kouran

Atribi Repons Deskripsyon
eta Endike ke antre a ap jwe

Example
Etap 1. Jwenn valè inputIndex la
Demann: http://192.168.1.100:11000/Settings?id=capture&schemaVersion=32
Repons:

<menuGroup icon=”/images/settings/ic_capture.png” url="/anviwònman" id="kaptire"
displayName="Pèsonalize sous yo">
<setting icon=”/images/settings/ic_bluetooth.png” refresh=”true” url=”/odyomòd”
id="bluetooth" displayName="Bluetooth" value="3" name="bluetoothAutoplay" description="Disabled" explanation="Mòd manyèl la pèmèt ou chanje ant sous yo nan tiwa navigasyon an. Mòd otomatik la chanje sou sous Bluetooth la lè yon aparèy Bluetooth konekte kòmanse jwe odyo. Apre sa, ou ka chanje ant sous yo nan tiwa navigasyon an. Mòd envite a chanje sou sous Bluetooth la lè yon aparèy Bluetooth konekte kòmanse jwe odyo. Si ou chanje sou yon lòt sous, Bluetooth la ap dekonekte. Sous Bluetooth la pa parèt nan tiwa navigasyon an. "Disabled" retire sous la nan tiwa navigasyon an, epi li pa pèmèt yon lòt aparèy konekte ak jwè a kòm yon Bluetooth
sous.” klas="lis">
...

<menuGroup icon=”/images/capture/ic_analoginput.png” url="/anviwònman" id="kaptireantre0"
ekspozisyonNon="Analòg
Antre">

<menuGroup icon=”/images/capture/ic_opticalinput.png” url="/anviwònman" id="kaptire-antre1"
displayName="Antre Optik">


Repons lan montre Bluetooth, Antre Analòg, ak Antre Optik. Bluetooth eskli, kidonk valè inputIndex la se 1 pou Antre Analòg, epi valè inputIndex la se 2 pou Antre Optik.
Etap 2. Jwe Optical Input sou jwè a.
http://192.168.1.100:11000/Play?InputId=2
Demann (firmwèr BluOS v4.2.0 oswa pi resan)
/Jwe?inputTypeIndex=$typeIndex

Paramèt Deskripsyon
  Endèks Kalite Antre typeIndex gen fòma sa a endèks tip yon antre. Men lis antre yo kalite:
spdif (Antre Optik)
analòg (Antre analòg, Antre liy) koaksyal (Antre koaksyal) bluetooth
ark (HDMI ARC)
earc (HDMI eARC) phono (Vinyl) òdinatè
aesebu (AES/EBU) balanse (Balanced In)
mikwofòn (Antre Mikwofòn)
La endèks kòmanse depi 1. Lè gen plis pase yon antre menm kalite a, antre 1 genyen endèks 1, antre 2 genyen endèks 2, ak sou sa.

Repons
kouran

Atribi Repons Deskripsyon
eta Endike ke antre a ap jwe

Example
Demann: http://192.168.1.100:11000/Play?inputTypeIndex=spdif-2 pou chwazi Antre Optik 2
Repons: kouran

Bluetooth

Seksyon sa a dekri kòmand pou chanje mòd Bluetooth la.
12.1 Chanje Mòd Bluetooth la
Deskripsyon
Chanje mòd Bluetooth: Manyèl, Otomatik, Envite, Enfim.
Mande
/odyomòd?bluetoothAutoplay=valè

Paramèt Deskripsyon
 

Bluetooth Oto-jwe

 Bluetooth mòd valè 0 vle di Manyèl, 1 vle di Otomatik, 2 vle di Envite, 3 vle di Enfim.

Pa gen repons
Example
Demann: http://192.168.1.100:11000/audiomodes?bluetoothAutoplay=3 pou dezaktive bluetooth la

Apendis

13.1 Pwotokòl Dekouvèt Sèvis Lenbrook
Entwodiksyon
Metòd dekouvèt popilè tankou mDNS ak SSDP itilize epi konte sou kominikasyon multicast UDP. Pifò pwodwi Lenbrook aktyèl yo itilize mDNS pou dekouvèt. Malerezman, nou te jwenn ke yon kantite siyifikatif nan kliyan nou yo gen rezo lakay kote trafik multicast pa fonksyone byen epi aparèy nou yo pa ka dekouvri yon fason fyab. Sa a lakòz anpil retounen pwodwi ak plent nan men distribitè nou yo.
Pou rezoud pwoblèm sa a, nou kreye yon pwotokòl dekouvèt pèsonalize yo rele LSDP ki itilize difizyon UDP. Tès inisyal yo montre ke sa a pi fyab pase dekouvèt ki baze sou mDNS.
Pwotokòl finiview
Youn nan objektif pwotokòl sa a se pou l relativman senp. Li ka itilize nan aparèy entegre ki gen memwa trè limite.
Pwotokòl la itilize tout pakè difizyon UDP k ap soti nan pò UDP 11430 la. Pò sa a te anrejistre ak IANA a epi li te plase bay Lenbrook pou itilizasyon LSDP apati 27 mas 2014.
Nan eta estab, chak ne ki gen yon sèvis pou fè piblisite difize yon mesaj Anons apeprè chak minit.
Nan demaraj la epi lè lis sèvis yo oswa paramèt rezo a chanje, sèt pake dwe difize ak entèval kout pou pèmèt premye dekouvèt la epi chanjman yo gaye pi vit. Pou ne k ap fè piblisite pou sèvis, sèt pake inisyal sa yo dwe gen ladan yon mesaj Anons. Pou ne k ap eseye dekouvri sèvis, sèt pake inisyal yo dwe gen ladan yon mesaj Rechèch. Pou sèvis ki pa disponib ankò, sèt pake yo dwe gen ladan yon mesaj Efase.
Premye pakè sa yo voye sèt fwa akòz nati fyab pakè UDP yo. Nan ka ki pa posib la kote tout sèt pakè yo echwe, sèvis yo ap toujou dekouvri apre yon ti tan apati mesaj Anons peryodik yon minit yo.
Si yon ne resevwa yon mesaj Query pou yon klas sèvis l ap fè piblisite, li dwe reponn ak yon mesaj Announce apre yon ti reta o aza epi retabli delè Announce aktyèl li a.
Antèt pake a ak tout blòk mesaj yo gen ladan yo chan longè. Sa bay plis fleksibilite epi pèmèt chanjman konpatib ak vèsyon anvan yo ka fèt alavni. Nou ka ajoute lòt chan oswa kalite mesaj alavni ke ansyen aplikasyon yo ka sote lè y ap analize done yo. Si nou deside fè yon chanjman ki pa konpatib ak vèsyon anvan yo, genyen tou yon chan vèsyon nan antèt pake a ke nou ka ogmante.
Pwotokòl la pèmèt tou pou anrejistreman TXT yo dwe enkli ak piblisite sèvis menm jan ak anrejistreman TXT yo itilize.
ak mDNS. Sa bay anpil fleksibilite pou plis metadone abitrè ki ka enkli ak sèvis la
piblisite san chanje pwotokòl la.
Detay Pwotokòl
Distribisyon
Tout pakè yo voye yo ta dwe pwograme ak yon tan oswa reta o aza pou ede evite kolizyon.

  • Tan pou Demaraj Pakè: 7 Pakè nan menm moman an = [0, 1, 2, 3, 5, 7, 10s] + (0 a 250ms o aza). Sa yo se tan absoli, pa reta. Tout 7 pakè yo ta dwe voye nan apeprè 10 segonn.
  • Peryòd Anons Prensipal: 57s + (0 a 6s o aza)
  • Reta Repons Rechèch: (0 a 750ms o aza)

ID ID
Chak ne dwe gen yon ID inik ki ka itilize pou idantifye ne a. ID inik la enkli nan mesaj Anons ak Sipresyon. Kliyan yo ka itilize valè sa a kòm yon kle prensipal lè y ap estoke valè yo nan kach epi pou idantifye yon ne yon fason inik. ID inik sa a kapab yon adrès MAC men li ta dwe menm pou chak koòdone si yon ne gen plizyè koòdone kote l ap fè piblisite.
Estrikti pake
Chak pake kòmanse ak yon header pake ki swiv pa yon kantite blòk mesaj abitrè. Chak blòk mesaj kòmanse ak yon chan longè pou mesaj ki pa rekonèt yo ka sote. Sòf si yo presize otreman, tout valè nimewo milti-okte yo dwe estoke big endian (okte ki pi enpòtan yo an premye). Sòf si yo presize otreman, tout nimewo yo se valè san siy. Pa egzanpampYon longè yon okte ka gen valè ant 0 ak 255.
Pake Header

Jaden Bytes Deskripsyon
Longè 1 Longè total header la ki gen ladan chan sa a.
Mo majik 4 Chan sa a pral kat okte ASCII "LSDP" la. Sa ede nou idantifye pakè yo kòm pakè ki fèt pou itilizasyon pou nou pa bezwen eseye analize done o aza ki soti nan yon sous inatandi.
Pwotokòl Version 1 Vèsyon pwotokòl la. Si yo fè chanjman nan pwotokòl la nan lavni ki pa konpatib ak vèsyon anvan yo, vèsyon sa a
Jaden Bytes Deskripsyon
pral chanje. Vèsyon aktyèl la se 1.

Mesaj Rechèch

Jaden
Bytes Deskripsyon
Longè 1 Longè total mesaj la ki gen ladan chan sa a.
Kalite mesaj 1 "Q" = 0x51: Demann estanda pou repons difizyon. "R" = 0x52: Demann pou repons unicast.
Konte 1 Kantite klas pou fè rechèch.
Klas 1 2 Idantifyan klas 16 bit (2 okte).
... Repete jaden anvan an pou chak klas anplis.

Anons Mesaj
Anons Antèt

Jaden
Bytes Deskripsyon
Longè 1 Longè total mesaj la ki gen ladan l tout header anons la ak anrejistreman anons yo.
Kalite mesaj 1 "A" = 0x41
Longè ID Nœd 1 Longè chan ID nœud la.
ID ID Varyab ID inik nœud k ap voye anons la. Sa a se anjeneral adrès MAC youn nan koòdone nœud yo.
Longè Adrès 1 Longè chan Adrès la. Pou IPv4 sa dwe 4.
Jaden
Bytes Deskripsyon
Adrès Varyab Adrès IP ne a.
Konte 1 Kantite dosye anons ki pral swiv.

Anonse Dosye

Jaden Bytes Deskripsyon
Klas 2 Idantifyan klas 16 bit (2 okte).
 

Kantite TXT

  

1

 Kantite anrejistreman TXT ki pral swiv. Si li egal a zewo, chan sa yo pa pral swiv.
Longè Kle 1 1 Longè non kle a.
Kle 1 Varyab Non kle.
Valè 1 Longè 1 Longè tèks valè a.
Valè 1 Varyab Tèks valè.
 

...

 Repete 4 chan anvan yo pou chak lòt anrejistreman TXT.

Efase mesaj

Jaden
Bytes Deskripsyon
Longè 1 Longè total mesaj la ki gen ladan chan sa a.
Kalite mesaj 1 "D" = 0x44
Longè ID Nœd 1 Longè chan ID nœud la.
ID ID Varyab ID inik nœud k ap voye mesaj la. Sa a se anjeneral adrès MAC youn nan nœud yo.
Jaden
Bytes Deskripsyon
interfaces.
Konte 1 Kantite kou pou swiv.
Klas 1 2 Idantifyan klas 16 bit (2 okte).
... Repete jaden anvan an pou chak klas anplis.

Atribisyon ID Klas

ID klas la Deskripsyon Ekivalan mDNS
0x0001 Jwè BluOS _misk._tcp
0x0002 Sèvè BluOS _muss._tcp
0x0003 BluOS Player (segondè nan jwè milti-zòn tankou CI580 la) _musp._tcp
0x0004 sovi-mfg itilize pou tès fabrikasyon. _sovi-mfg._tcp
0x0005 klavye sovi _sovi-klavye._tcp
0x0006 BluOS Player (esklav pè) _musz._tcp
0x0007 Remote Web Aplikasyon (AVR OSD) Web paj) _a distans-web-ui._tcp
0x0008 Sant BluOS _mush._tcp
0xFFFF Tout klas yo – Ka itilize avèk mesaj rechèch la.

Nòt 1:
Yo bezwen trete pake LSDP a an jeneral kòm done binè.
Nòt 2:
Si yon Mesaj Anons pa ka kenbe tout enfòmasyon nœuds yo (sitou CI580), li pral divize an 2 oswa plis Mesaj Anons kote chak Mesaj gen yon Antèt ak yon Anrejistreman epi chak Mesaj gen tout enfòmasyon nœud(yo).

Logo BluOSAPI Entegrasyon Pèsonalize BluOS Vèsyon 1.7

Dokiman / Resous

API Entegrasyon Pèsonalize BluOS T 778 [pdfManyèl Itilizatè
T 778, API Entegrasyon Pèsonalize T 778, T 778, API Entegrasyon Pèsonalize, API Entegrasyon, API

Referans

Kite yon kòmantè

Adrès imel ou p ap pibliye. Jaden obligatwa yo make *