Custom Integration API
T 778 Custom Integration API
Ang impormasyon nga anaa niini nga manwal mao ang kabtangan sa Lenbrook Industries.
Kini kinahanglan nga gituyo lamang alang sa propesyonal nga paggamit. Ang Lenbrook Industries walay responsibilidad alang sa katukma sa protocol. Ang protocol gihatag nga "as-is", nga adunay tanan nga mga sayup ug wala’y garantiya sa bisan unsang klase, gipahayag o gipasabut.
Patakaran sa Paggamit sa API
Pinaagi sa pag-access sa mga API, miuyon ka niini nga Patakaran sa Paggamit sa API (ang "Patakaran") ug sa among Mga Termino. Gihatag namo kini nga mga API aron tugotan ang mga kompanya ug mga tawo nga makatukod ug makabenepisyo gikan sa among Serbisyo pinaagi sa paghimo og software, mga serbisyo, o mga module nga nagkonektar sa among plataporma o adunay access sa datos sulod sa among plataporma pinaagi sa among mga API (usa ka "Integration"). Kini nga Polisiya kay ug pagatagdon isip kabahin sa among Mga Termino.
Ang software gihatag "AS IS", nga walay warranty sa bisan unsa nga matang, gipahayag o gipasabot, lakip na apan dili limitado sa mga warranty sa pagbaligya, kaangayan alang sa usa ka partikular nga katuyoan ug dili paglapas. Sa bisan unsa nga panghitabo ang mga tagsulat o mga naghupot sa copyright mahimong manubag sa bisan unsang pag-angkon, kadaot, o uban pang tulubagon, bisan sa usa ka aksyon sa kontrata, Tort o kung dili, nga naggikan, gikan sa o may kalabotan sa software o sa paggamit o uban pang mga deal sa software.
Gitugotan nga Paggamit
Mahimong dili nimo gamiton ang API sa pagpadala og spam o paghimo og bisan unsang mga aksyon nga makalapas sa among Madawat nga Patakaran sa Paggamit ug sa among Standard nga Termino sa Paggamit. Motuman ka sa tanang magamit nga mga balaod (lakip ang mga balaod sa pagkapribado ug mga balaod sa pagkontrol sa eksport sa Estados Unidos, European GPR ug mga regulasyon ug mga balaod ug regulasyon sa mga silot sa ekonomiya). Imong sundon ang tanang dokumentasyon nga among gihatag para sa mga API. Dili ka mosulay sa pag-hack o pag-usab sa paagi sa pag-obra sa Serbisyo. Mahimo namon nga bantayan ang imong paggamit sa mga API alang sa pagsunod sa kini nga mga lagda, ug mahimo namon nga dumilian ang imong pag-access sa API kung imong gilapas kini nga Patakaran.
Pagkapribado
Ang imong Kinahanglang magpakita ang Integration og polisiya sa pagkapribado para sa mga tiggamitan nga nagdetalye sa impormasyon nga imong makolekta gikan kanila sa dihang ilang gamiton ang Integration. Ma-access lang nimo ang data sa usa ka user sa gidak-on nga gitugot sa user ug gipatin-aw sa imong privacy policy. Kinahanglan nimo nga tangtangon dayon ang datos sa usa ka tiggamit kung ang tiggamit mohangyo nga tangtangon o tapuson ang ilang account kanimo.
Seguridad
Imong ipatuman ug ipadayon ang angay nga teknikal ug organisasyonal nga mga lakang sa seguridad aron mapanalipdan ug mapreserbar ang seguridad, integridad, ug kompidensyal sa datos. Kini nga mga lakang sa seguridad magpugong sa dili awtorisado nga pag-access o pagbutyag sa personal o kompidensyal nga datos nga imong giproseso.
Pagpanag-iya
Anaa namo ang tanang katungod, titulo, ug interes sa Serbisyo ug sa mga API, lakip ang tanang katungod sa intelektwal nga kabtangan, marka, code, ug feature. Dili nimo supakon, i-reverse engineer, o kopyahon ang among code, disenyo, o sulud. Dili nimo ma-access ang among mga API aron makigkompetensya sa among Serbisyo. Ang bisan unsang mga katungod nga dili dayag nga gihatag niini nga Polisiya gipugngan, busa kung dili nimo kini makita dinhi, nan kini dili usa ka katungod nga among gitugotan kanimo.
Paggamit sa mga Marka
Mahimong dili nimo gamiton ang among ngalan ug mga marka (nagpasabot sa among mga logo, brand, ug copyrighted nga mga hulagway) sa bisan unsang paagi. Mahimong dili nimo usbon o tangtangon ang bisan unsang proprietary notice sa among mga marka. Dili nimo gamiton ang among ngalan o mga marka sa imong ngalan o logo sa Integration, o sa bisan unsang paagi nga nagpasabot ug pag-endorso kanamo.
Praktikal nga Paggamit sa mga Marka
Kini nga mga giya nagpatin-aw kung giunsa nimo kinahanglan nga praktikal nga gamiton ang among ngalan, marka, ug mga kabtangan sa brand sa tanan nga oras. Ang imong paggamit nagpaila sa imong pagdawat niini nga mga giya, ug imong nasabtan nga ang imong paggamit sa paglapas niini nga mga giya moresulta sa awtomatikong pagtapos sa imong pagtugot sa paggamit sa among ngalan, mga marka, ug mga kabtangan sa brand.
- Ang paggamit sa among ngalan, mga marka ug mga kabtangan sa tatak kinahanglan nga dayag nga awtorisado sa pagsulat.
- Ayaw usba, usba, pagtuis, pagkopya, o pagsundog sa among Brand Assets sa bisan unsang paagi, lakip ang pagbag-o sa kolor, pag-rotate ug/o pag-inat. Sa laing pagkasulti, ang atong Brand Assets kinahanglang tipigan sa ilang orihinal nga mga porma.
- Ayaw paghatag sa among ngalan, mga marka ug mga kabtangan sa tatak nga dili angay nga prominente kung itandi sa imong ngalan ug logo.
- Ayaw ipakita ang among ngalan, mga marka, ug mga kabtangan sa brand sunod, o sa bisan unsang porma sa kompetisyon nga pagpamaligya, nga wala ang among dayag nga pagtugot.
- Ang imong paggamit kinahanglan dili makapahisalaag sa mga konsumidor sa among pag-sponsor sa, pagpasakop o pag-endorso sa imong kompanya o sa imong mga produkto o serbisyo.
- Ang among ngalan, marka ug mga kabtangan sa tatak mao ang among eksklusibo nga kabtangan. Ang tanang maayong kabubut-on nga resulta sa imong paggamit para ra sa among kaayohan. Dili ka mohimo ug bisan unsang aksyon nga supak sa among mga katungod o pagpanag-iya.
- Ang atong ngalan, mga marka ug mga kabtangan sa brand kinahanglang gamiton sa matinahuron nga paagi ug dili mahimong gamiton sa paagi nga makadaot kanato, sa atong mga produkto, o serbisyo, o sa paagi nga, sa atong opinyon, makapamenos o makadaut sa atong reputasyon o sa maayong kabubut-on sa atong ngalan, mga marka ug mga kabtangan sa brand. Sa laing pagkasulti, palihug ayaw i-asoy ang among mga kabtangan sa bisan unsang gidili o ilegal nga mga kalihokan o gamiton kini sa paagi nga malimbongon o makadaot.
Exampubos sa madawat nga paggamit:
“[YOUR PRODUCT NAME] (compatible with / work with BluOS)”
Examples sa dili madawat nga paggamit
“[IMO NGA NGALAN SA PRODUKTO] – BluOS”
“BluOS – [IMO NGA NGALAN SA PRODUKTO]”
“[YOUR PRODUCT NAME] – Powered with BluOS”
Marketing ug Press Releases
Human maaprobahan ang imong aplikasyon, mahimo kining ilista sa among web kabtangan. Kami sa kasagaran dili mag-co-publish sa mga press release o makatampo sa co-marketing sa imong aplikasyon.
Sa dili ka pa mo-apod-apod og press release bahin sa imong app, siguroha nga ikaw mokontak kanamo sa [EMAIL]. Kung maghisgot ka sa BluOS, kinahanglan namon nga usbonview ang pagpagawas. Ginarekomendar namon ang pagkontak sa imong katapusang press release sa labing dali nga panahon.
Disclaimer
Sa pinakataas nga gidak-on nga gitugot sa balaod, among gihatag ang mga API kung unsa man. Nagpasabut kana nga wala kami maghatag mga garantiya sa bisan unsang klase, bisan kung gipahayag o gipasabut, lakip apan dili limitado sa pagkabaligya ug kaarang alang sa usa ka partikular nga katuyoan.
Mga update
Mahimo namon nga i-update o usbon ang mga API ug kini nga Patakaran matag karon ug unya pinaagi sa pag-post sa mga pagbag-o sa kini nga site o pagpahibalo kanimo pinaagi sa email. Kini nga mga pagbag-o mahimong makaapekto sa imong paggamit sa mga API o sa paagi nga ang imong Integration nakig-uban sa API. Kung maghimo kami usa ka pagbag-o nga dili nimo madawat, kinahanglan nimong hunongon ang paggamit sa mga API.
Pagkakompidensyal
Mahimong adunay ka access sa confidential, proprietary, ug non-public nga impormasyon nga espesipiko sa APIs (“Confidential Information”). Mahimo nimong gamiton kini nga impormasyon sa paghimo lamang gamit ang mga API. Dili nimo ibutyag ang Kompidensyal nga Impormasyon kang bisan kinsa nga wala ang among sinulat nga pagtugot, ug panalipdan nimo ang Kompidensyal nga Impormasyon gikan sa dili awtorisado nga paggamit ug pagbutyag sa parehas nga paagi nga mapanalipdan nimo ang imong kaugalingon nga kompidensyal nga kasayuran.
Indemnification
Imong bayran ug huptan kami ug ang among Team nga dili makadaot sa bisan unsang mga kapildihan (lakip ang bayad sa abogado) nga resulta sa mga pag-angkon sa ikatulo nga partido nga may kalabotan sa imong paggamit sa API.
Ang Pahulay
Kini nga Polisiya wala magmugna o magpasabot sa bisan unsang panag-uban, ahensya, o hiniusang patigayon. Kini nga Patakaran magamit sa kadugayon nga imong gigamit ang mga API o hangtod nga matapos subay sa among Mga Termino. Kung adunay panagsumpaki tali niini nga Patakaran ug sa Standard Terms of Use, ang Standard Terms of Use ang magkontrol.
©2025 LENBROOK INDUSTRIES LIMITED
633 Granite Court, Pickering, Ontario, Canada L1W 3K1
Tanang katungod gigahin
Walay bahin niini nga publikasyon ang mahimong kopyahon, tipigan o ipasa sa bisan unsang porma nga walay sinulat nga pagtugot sa Lenbrook Industries Limited. Samtang gihimo ang matag paningkamot aron masiguro nga ang mga sulud tukma sa oras sa pagmantala, ang mga bahin ug mga detalye mahimo’g mabag-o nga wala’y pahibalo.
| Kasaysayan sa Pagbag-o | ||
| Bersyon | Petsa | Deskripsyon |
| 1.0 | 6/17/2019 | Unang pagpagawas |
| 1.2 | 01/12/2022 | Gidugang ang soft reboot, doorbell chime, volume up/down, move track sa queue, ug direct input commands. Gidugang nga nota sa Appendix LSDP. |
| 1.4 | 04/26/2022 | Gidugang nga mute command; giusab nga direktang input nga mga sugo alang sa HUB; gi-update nga Play command aron madula ang streamed custom audio. |
| 1.5 | 07/18/2022 | Gidugang Bluetooth nga sugo; Gi-update ang LSDP aron idugang ang klase 5 hangtod 8; Gidugang ang "Praktikal nga Paggamit sa mga Marka" sa Patakaran sa Paggamit sa API. |
| 1.6 | 03/13/2024 | Gidugang ang usa ka nota para sa /Status alang sa mga grupo nga mga magdudula sa sekta 2; Gidugang /Play?seek=seconds is=tracked sa sect 4.1; |
| 1.7 | 04/09/2025 | Gi-update nga seksyon 8.3 example; Gidugang ang inline nga menu sa konteksto sa pag-browse sa hangyo example sa seksyon 7.1; Gidugang bag-ong direct input selection command sa seksyon 11.2; Gi-update ang seksyon 6.1 aron idugang ang "larawan" nga hiyas alang sa mga preset; Gidugang ang "followRedirects = 1" nga komento alang sa tanan nga mga kinaiya sa imahe; Gi-update ang pagpatin-aw sa pagdula sa mga kinaiyaURL ug idugang-karon sa seksyon 7.1 |
Pasiuna
Ang BluOS ™ usa ka advanced operating system ug software sa pagdumala sa musika nga nagtugot kanimo sa pag-access ug pag-stream sa walay pagkawala nga musika hangtod sa 24-bit/192kHz sa matag kwarto gamit ang imong home network. Ang BluOS makita sa mga produkto gikan sa Bluesound, NAD Electronics, DALI Loudspeakers ug uban pa.
Kini nga dokumento gihimo aron matabangan ang mga developer ug system integrators nga nagtrabaho sa custom integration (CI) nga merkado. Naglangkob kini usa ka subset sa mga hangyo sa API nga nadokumento sa tibuuk nga BluOS API Control Protocol.
Ang tanan nga mga hangyo nga gihulagway niini nga dokumento gipadala isip HTTP GET nga mga hangyo. Ang mga parameter usa ka sumbanan URL gi-encode nga ngalan/pares sa bili. Ang mga magdudula sa BluOS makadawat niini nga mga sugo ug dayon motubag gamit ang UTF-8 nga naka-encode nga XML data.
Ang tanan nga mga hangyo anaa sa porma sa http:// : / diin:
- player_ip mao ang IP address sa BluOS player (pananglitan, 192.168.1.100)
- Ang pantalan mao ang TC nga pantalan nga gigamit alang sa komunikasyon. Ang Port 11000 gigamit alang sa tanan nga mga magdudula sa BluOS, gawas sa CI580. Ang CI580 adunay upat ka streamer nodes sa usa ka chassis, diin ang node 1 naggamit sa port 11000, ang node 2 naggamit sa port 11010, ang node 3 naggamit sa port 11020, ug ang node 4 naggamit sa port 11030. Ang aktwal nga port nga gamiton kinahanglan nga madiskobrehan pinaagi sa paggamit sa MDNS protocol gamit ang mga serbisyo musc.tccp ug musc.tccp
- Ang hangyo mao ang aktuwal nga sugo o pangutana sa BluOS (pananglitan, Play)
Mubo nga sulat: Kini nga dokumento gamiton http://192.168.1.100:11000 isip player IP ug port sa tanan examples.
Mga Pangutana sa Status
Ang mga pangutana sa status gigamit sa pagpangutana sa usa ka BluOS player.
Naghatag ang BluOS og duha ka mekanismo sa paghimo sa mga pangutana sa status; regular nga polling ug taas nga polling. Ang regular nga polling ibalik dayon ang resulta sa pangutana. Ang taas nga polling nagtipig og koneksyon sa usa ka piho nga oras, ug nagbalik lamang sa usa ka resulta sa pangutana kung ang impormasyon nausab o wala na. Ang taas nga polling makapakunhod pag-ayo sa gidaghanon sa mga tawag sa usa ka magdudula.
Kung wala gigamit ang dugay nga polling unya ang mga kliyente kinahanglan nga limitahan ang ilang rate sa pagboto sa labing taas nga usa ka hangyo matag 30 segundos. Kung ang dugay nga pagboto gigamit unya ang usa ka kliyente kinahanglan dili maghimo duha ka sunud-sunod nga hangyo alang sa parehas nga kapanguhaan nga wala’y usa ka segundo ang gilay-on, bisan kung ang una nga hangyo mobalik sa wala’y usa ka segundo.
Ang mga hangyo sa taas nga botohan adunay duha ka parameter: timeout ug etag. Ang timeout mao ang gidugayon sa taas nga hangyo sa poll ug etag gikuha gikan sa miaging tubag (usa ka hiyas sa gamut nga elemento sa tubag).
Sa kinatibuk-an, gikinahanglan lamang nga adunay dugay nga poll nga aktibo para sa usa sa /Status o /SyncStatus. Ang tubag sa /Status naglakip og elemento ( ) nga nagpakita kung ang /SyncStatus nausab. Ang /SyncStatus kinahanglan nga usisahon kung ang ngalan, gidaghanon ug status sa grupo sa usa ka magdudula ang interesado. /Status kinahanglan nga polled kon ang kasamtangan nga playback status gikinahanglan.
Kung ang mga magdudula gigrupo, ang panguna nga magdudula mao ang panguna nga magdudula sa grupo. Ang mga sekondaryang magdudula gilakip sa panguna nga magdudula. / Ang tubag sa status sa mga sekondaryang magdudula kay mga kopya sa sa nag-unang magdudula. /SyncStatus taas nga polling gikinahanglan aron masubay ang gidaghanon sa matag sekondaryang magdudula.
2.1 Kahimtang sa Playback
Deskripsyon
Ang /Status endpoint nangutana sa gidaghanon ug impormasyon sa playback. Kini nga pangutana nagbalik sa daghang mga kinaiya sa pagtubag,
ang uban niini dili magamit sa kini nga dokumento. Ang dili dokumentado nga mga tubag kinahanglang ibalewala.
Pangayo
/Status?timeout=segundos&etag=etag- bili
| Parameter | Deskripsyon |
| timeout | Opsyonal nga parameter nga gigamit sa taas nga polling. Ang girekomendar nga agwat sa botohan mao ang 100 ka segundos ug kinahanglang limitahan sa gikusgon nga 60 ka segundos o labaw pa ug dili molapas sa 10 ka segundos. |
| etag | Opsyonal nga parameter nga gigamit sa taas nga polling. Kini ang etag attribute gikan sa |
| Parameter | Deskripsyon |
| miagi/Status nga tubag sa tawag. |
tubag
<status etag=”4e266c9fbfba6d13d1a4d6ff4bd2e1e6″>
÷ (Deluxe)
Ed Sheeran
tinuod
1
159
Deezer: 142986206
/Artwork?service=Deezer&songid=Deezer%3A142986206
0
187
1
Hingpit
1054
0
320000
2
Deezer
/Sources/images/DeezerIcon.png
0
8
19
paghunong
MP3 320 kb/s
5
Hingpit
Ed Sheeran
÷ (Deluxe)
263
4
35
NOTA: dili tanan nga mga kinaiya sa tubag gilista sa mosunod nga tsart. Ang ubang mga elemento mahimong anaa ug kinahanglan nga ibaliwala.
| Mga Hiyas sa Pagtubag | Deskripsyon |
| etag | Hiyas sa tubag nga gamut nga elemento. Ang opaque nga kantidad nga gigamit sa taas nga polling aron mahibal-an ang mga pagbag-o sa tubag. Kung ang kantidad wala mausab sukad sa miaging tubag nan ang tubag gigarantiyahan nga dili mausab (apan tan-awa usab ang mga segundo sa ubos) |
| alarm segundos ang nahabilin | Kung ang playback mao ang resulta sa usa ka alarma, nan kini ang pila ka segundo sa dili pa kini mohunong. |
| aksyon | Tan-awa ang seksyon sa Mga Aksyon alang sa Streaming Radio Stations alang sa paghulagway. |
| album | Ngalan sa album sa kasamtangan nga aktibo nga track. Tan-awa usab ang title1 attribute. |
| artista | Ngalan sa artist sa kasamtangan nga aktibo nga track. Tan-awa usab ang title1 attribute. |
| baterya | Gipakita kung ang magdudula adunay baterya pack. Naglakip sa mga hiyas: · lebel – estado sa bayad, porsyento · pag-charge – 1 kung nag-charge karon · icon – URL sa hulagway sa player nga nagpakita sa kasamtangan nga kahimtang sa pag-charge |
|
mahimoMovePlayback |
Tinuod kung posible nga ibalhin ang kasamtangan nga pagdula o gihunong nga sulud sa lain nga magdudula. |
|
makapangita |
Kon 1 nan kini mao ang posible nga sa scrub pinaagi sa kasamtangan nga track, sa range 0..totlen, pinaagi sa paggamit sa pagpangita parameter sa / Play. Kay example: /Play?seek=34. |
| db | Ang lebel sa volume sa dB. |
| Ngalan sa grupo | Ngalan sa grupo. Ang magdudula kinahanglan nga ang panguna nga magdudula sa grupo. |
| Volume sa grupo | Ang lebel sa volume sa grupo. Ang magdudula kinahanglan nga ang panguna nga magdudula sa grupo. |
| hulagway | URL sa hulagway nga nalangkit sa kasamtangang audio (album, estasyon, input, ug uban pa). Kung |
| Mga Hiyas sa Pagtubag | Deskripsyon |
| ang URL nagsugod sa /Artwork mahimo kining moresulta sa pag-redirect. Pagdugang ug parameter/key followRedirects=1 kung ang pagkuha sa imahe makalikay sa pag-redirect. | |
| amang | Mute nga estado. Ibutang sa 1 kung ang volume gipahilom. |
| muteDb | kung ang magdudula gipahilom, nan kini naglangkob sa wala ma-mute nga volume sa dB. |
| muteVolume | Kung adunay mute, nan kini naglangkob sa wala ma-mute nga lebel sa volume. Ang mga kantidad gikan sa 0 hangtod 100. |
| ngalan | Ang titulo sa kasamtangan nga nagdula nga audio track. Tan-awa usab ang title1 attribute. |
| pahibal-aurl | URL alang sa usa ka pop up nga pahibalo. |
| id | Ang talagsaon nga play queue id. Nahiangay kini sa id nga hiyas sa tubag sa /Playlist. Kung ang play queue mausab kini nga numero mausab. |
| tangtangon | Ang talagsaon nga preset id. Nahiangay kini sa garbo nga hiyas sa tubag sa / Preset. Kung ang usa ka preset giusab kini nga numero mausab nga nagpakita nga ang bisan unsang cached nga tubag sa /Presets kinahanglan nga limpyohan. |
| kalidad | Kalidad sa nagdula nga tinubdan nga audio: · cd – walay pagkawala nga audio sa kalidad sa CD · hd – walay pagkawala nga audio nga adunay mas taas nga resolusyon nga kalidad sa CD o sample-rate nga 88200 sampubos/s o labaw pa · dolbyAudio – DolbyDigital o AC3 · mqa – balido nga MQA audio decoded · mqaAuthored – balido nga MQA-Authored audio decoded Ang numeric value mao ang gibana-bana nga bitrate sa usa ka compressed audio source nga kalidad sa file. |
|
subli |
Ang 0, 1, o 2. Ang 0 nagpasabut nga balik-balik nga play queue, ang 1 nagpasabut nga balik-balik ang usa ka track, ug ang 2 nagpasabut nga balik-balik nga wala. |
| sec | Gidaghanon sa mga segundo ang kasamtangang audio track nga gipatugtog. Kini nga kantidad wala gigamit sa pagkalkula sa etag ug ang pag-uswag dili sa iyang kaugalingon hinungdan sa pagbalik gikan sa usa ka taas nga tawag sa pagboto. Ang mga kliyente gikinahanglan nga dugangan ang posisyon sa playback, kung ang estado play o stream, base sa agwat sukad sa tubag. |
| serbisyo | Ang serbisyo id sa kasamtangan nga audio. Dili kini usa ka bili alang sa pagpakita sa usa ka UI, sama sa |
| Mga Hiyas sa Pagtubag | Deskripsyon |
| Ang aktuwal nga string mahimong lahi sa opisyal nga ngalan sa serbisyo. | |
| serbisyoIcon | URL sa kasamtangan nga icon sa serbisyo. |
| shuffle | 0 o 1. Ang 0 nagpasabot sa shuffle off ug ang 1 nagpasabot sa shuffle on. |
| matulog | Ang nahabilin nga mga minuto sa wala pa ma-aktibo ang timer sa pagkatulog. |
| kanta | Ang posisyon sa kasamtangan nga track sa play queue. Tan-awa usab ang sapaUrl. |
| estado | Ang kasamtangan nga kahimtang sa magdudula. Mahimo kini nga pagdula, paghunong, paghunong, pag-stream, pagkonektar, ug uban pa. /Play mahimong gamiton sa pagpadayon sa diha nga sa usa ka kahimtang sa paghunong apan dili sa diha nga sa paghunong nga kahimtang. ang dula ug sapa kinahanglan isipon nga adunay parehas nga kahulugan. Tan-awa usab ang sapaUrl. |
|
estasyonHulagway |
URL alang sa imahe sa usa ka estasyon sa radyo, kung ang karon nga audio usa ka estasyon sa radyo, pananglitan, Deezer radio. Mahimong parehas kini sa imahe. |
| streamFormat | Format sa audio. |
| sapaUrl | Ang presensya niini nga elemento kinahanglan isipon nga usa ka bandila ug ang mga sulod niini isip usa ka opaque nga bili. Kung anaa kini nagpakita: · Ang play queue dili ang gigikanan sa karon nga audio (kanta wala’y kalabotan) · Ang pag-shuffle ug pag-usab dili angay ug kinahanglan nga tangtangon sa bisan unsang UI kung mahimo · Ang sunod ug nauna dili magamit (apan tan-awa usab ang mga aksyon) |
| syncStat | Ang talagsaon nga id aron ipakita ang bisan unsang pagbag-o sa tubag sa /SyncStatus. Nahiangay kini sa syncStat attribute sa / SyncStatus nga tubag. Nagbag-o kini kung adunay pagbag-o sa Status sa Pag-sync. |
| titulo1 | Ang unang linya sa impormasyon nga naghulagway sa kasamtangan nga audio. titulo1, titulo2 ug titulo3 KINAHANGLANG gamiton isip teksto sa bisan unsang UI nga nagpakita sa tulo ka linya sa metadata nga nagdula karon. Ayaw gamita ang mga kantidad sama sa album, artist ug ngalan. |
| titulo2 | Ang ikaduhang linya sa impormasyon nga naghulagway sa kasamtangan nga audio. |
| titulo3 | Ang ikatulo nga linya sa impormasyon nga naghulagway sa kasamtangan nga audio. |
| totlen | Kinatibuk-ang gitas-on sa kasamtangan nga track, sa mga segundo. |
| twoline_title1 | Ang una sa duha ka linya nga naghulagway sa kasamtangan nga audio. twoline_title1 & twoline_title2, kung naa, KINAHANGLAN gamiton ingon nga teksto sa bisan unsang UI nga nagpakita sa duha |
| Mga Hiyas sa Pagtubag | Deskripsyon |
| mga linya sa karon nga nagdula nga metadata. | |
| twoline_title2 | Ang ikaduha sa duha ka linya nga naghulagway sa kasamtangan nga audio. |
| gidaghanon | Ang lebel sa gidaghanon sa magdudula sa porsyentotage; -1 nagpasabot nga ang gidaghanon sa magdudula naayo. |
| sec | Ang gidaghanon sa mga segundo nga ang kasamtangan nga audio track gipatokar. |
Example
http://192.168.1.100:11000/Status
Nakuha ang status sa playback sa player.
http://192.168.1.100:11000/Status?timeout=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Nakuha ang status sa playback sa player gamit ang long-polling. Ang resulta ibalik lang sa dili pa ang timeout nga 100 segundos kung nausab ang status sa player. Kung dili, ang resulta ibalik pagkahuman sa 100 segundos.
2.2 Status sa Pag-sync sa Player ug Grupo
Deskripsyon
Ang pangutana sa SyncStatus nagbalik sa impormasyon sa player ug sa impormasyon sa paggrupo sa magdudula. Kini nga pangutana nagbalik sa daghang mga hiyas sa pagtubag, ang uban niini dili magamit sa kini nga dokumento. Ang dili dokumentado nga mga tubag kinahanglang ibalewala.
Pangayo
/SyncStatus?timeout=segundos&etag=etag- bili
| Parameter | Deskripsyon |
| timeout | Opsyonal nga parameter nga gigamit sa taas nga polling. Kini ang agwat sa botohan sa mga segundo. Ang girekomendar nga agwat sa botohan mao ang 180 segundos. |
| etag | Opsyonal nga parameter nga gigamit sa taas nga polling. Kini ang etag attribute gikan sa miaging /SyncStatus nga tubag sa tawag. |
tubag
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″ brand=”Bluesound” etag=”23″ outlevel=”-62.9″ schemaVersion=”25″ initialized=”tinuod” nga grupo=”PULSE-0278 + 2″ syncStat=”23″id=”192.168.1.100:11000″:5″:11000″:92. 192.168.1.100
…..
PAHINUMDOM: dili tanan nga mga kinaiya sa pagtubag gilista sa mosunod nga tsart. Ang ubang mga elemento mahimong anaa ug kinahanglan nga ibaliwala.
| Mga Hiyas sa Pagtubag | Deskripsyon |
| baterya | Gipakita kung ang magdudula adunay baterya pack. Naglakip sa mga hiyas: · lebel – estado sa bayad, porsyento · pag-charge – 1 kung nag-charge karon · icon – URL sa hulagway sa player nga nagpakita sa kasamtangan nga kahimtang sa pag-charge |
| tatak | Ngalan sa brand sa player. |
| db | Ang lebel sa volume sa dB. |
| etag | Tag sa /SyncStatus nga tubag, gigamit alang sa taas nga polling. |
| grupo | Ang ngalan sa grupo. |
| icon | URL nga naglangkob sa imahe sa player icon. |
| id | Player IP ug port. |
| gisugdan | Ang tinuod nagpasabot nga ang magdudula na-setup na, ang bakak nagpasabot nga ang magdudula nagkinahanglan og setup. Ang player kinahanglan nga setup sa BluOS Controller app. |
| mac | Ang talagsaon nga id sa player alang sa interface sa network. Mahimong usa ka MAC address. |
| agalon | Master nga magdudula IP address. Anaa lamang kung ang usa ka magdudula usa ka ikaduha nga magdudula sa usa ka grupo. Mga hiyas: · port – numero sa pantalan. · reconnecting – tinuod kon mosulay sa pagkonektar pag-usab ngadto sa nag-unang player |
| modelo | Player model id. |
| modeloName | Ngalan sa modelo sa player. |
| amang | Ibutang sa 1 kung ang volume gipahilom. |
| muteDb | Kung ang magdudula gipahilom, nan kini ang wala ma-mute nga lebel sa volume sa dB. |
| Mga Hiyas sa Pagtubag | Deskripsyon |
| muteVolume | Kung ang magdudula gipahilom, nan kini ang wala ma-mute nga lebel sa volume (0..100). |
| ngalan | Ngalan sa player. |
| schemaVersion | Bersyon sa eskema sa software. |
| ulipon | Ikaduhang (mga) magdudula nga IP adres. Anaa ra kung ang magdudula mao ang panguna nga magdudula sa usa ka grupo. Mahimong adunay daghang mga sekondaryang magdudula. Mga hiyas: · id – IP adres · port – numero sa pantalan |
|
syncStat |
id sa kahimtang sa pag-sync. Giusab kini sa matag higayon nga ang bisan unsang butang sa /SyncStatus nga tubag mausab. Ipares sa elemento sa / Status nga tubag. |
| gidaghanon | Ang lebel sa volume sa usa ka 0..100 nga sukdanan. -1 nagpasabot sa fixed volume. |
| sona | Ngalan sa pirmi nga grupo. |
| zoneMaster | Kung ang magdudula mao ang nag-una nga magdudula sa usa ka piho nga grupo, kini gibutang sa tinuod. |
| zoneSlave | Kung ang magdudula usa ka sekondaryang magdudula sa usa ka piho nga grupo, kini gitakda sa tinuod. |
Example
http://192.168.1.100:11000/SyncStatus
Nakuha ang status sa player ug grupo sa player.
http://192.168.1.100:11000/SyncStatus?timeout=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Nakuha ang status sa player ug grupo sa player gamit ang long-polling. Ang resulta ibalik lang sa dili pa ang timeout nga 100 segundos kung nausab ang status sa player. Kung dili, ang resulta ibalik sa 100 segundos.
Pagkontrol sa Volume
I-adjust ang volume level sa usa ka player. Gigamit usab sa pagpamute sa usa ka magdudula.
3.1 Itakda ang Tomo
Deskripsyon
Kini nga hangyo nangutana o nagtakda sa gidaghanon sa player.
Ang tanan nga mga variant sa command, bisan gamit ang 0..100 nga lebel, hingpit nga dB o paryente nga mga parameter sa dB, gipugngan sa mga kantidad nga moresulta sa usa ka lebel sulod sa gi-configure nga magamit nga sakup sa volume, nga kasagaran -80..0. Ang gidaghanon sa gidaghanon mahimong ma-adjust gamit ang BluOS Controller app, sa Settings -> Player -> Audio page.
Ang pangutana nagsuporta sa taas nga polling (dili gihulagway sa ubos).
Pangayo
/Tomo
/Volume?level=level&tell_slaves=on_off
/Volume?mute=on_off&tell_slaves=on_off
/Volume?abs_db=db&tell_slaves=on_off
/Volume?db=delta-db&tell_slaves=on_off
| Parameter | Deskripsyon |
| lebel | Itakda ang hingpit nga lebel sa volume sa player. Kini usa ka integer gikan sa 0 -100. |
| sultihi_mga ulipon | Magamit sa grupo nga mga magdudula. Kung gitakda sa 0, ang napili nga magdudula lamang ang nagbag-o sa gidaghanon. Kung gibutang sa 1, nan ang tanan nga mga magdudula sa grupo magbag-o sa gidaghanon. |
| amang | Kung gibutang sa 0, ang magdudula gipahilom. Kung ibutang sa 1, ang magdudula dili mutingog. |
| abs_db | Itakda ang volume gamit ang dB scale. |
| db | Paghimo usa ka relatibong pagbag-o sa volume gamit ang usa ka sukod sa volume sa dB. Ang db mahimong positibo o negatibo nga numero. |
tubag
<volume db=”-49.9″ mute=”0″ offsetDb=”0″ etag=”6213593a6132887e23fe0476b9ab2cba”>15</volume>
| Mga Hiyas sa Pagtubag | Deskripsyon |
| Mga Hiyas sa Pagtubag | Deskripsyon |
| db | Ang lebel sa volume sa dB. |
| amang | 1 kung ang magdudula gipahilom, 0 kung ang magdudula wala’y tingog. |
| muteDb | Kung ang magdudula gipahilom, nan kini ang wala ma-mute nga lebel sa volume sa dB. |
| muteVolume | Kung ang magdudula gipahilom, nan kini ang wala ma-mute nga lebel sa volume (0..100). |
| gidaghanon | Ang kasamtangan nga lebel sa volume: 0..100 o -1 alang sa fixed volume. |
Example
http://192.168.1.100:11000/Volume?level=15
Nagtakda sa lebel sa gidaghanon sa magdudula ngadto sa 15 (gikan sa 100).
http://192.168.1.100:11000/Volume? tell_slaves=1&db=2
Nagpataas sa volume sa master player nga 192.168.1.100, ug ang tanan nga mga sekondaryang magdudula sa kana nga grupo, sa 2 dB.
http://192.168.1.100:11000/Volume?mute=1
Gipahilom ang magdudula.
3.2 Pagtaas sa Volume
Deskripsyon
Kini nga hangyo nagdugang sa gidaghanon sa piho nga dB (tipikal nga kantidad mao ang 2dB).
Pangayo
/Volume?db=db_value
| Parameter | Deskripsyon |
| db | Mga lakang sa pagtaas sa volume sa dB (tipikal nga kantidad 2dB) |
tubag
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>
| Mga Hiyas sa Pagtubag | Deskripsyon |
| db | Ang lebel sa volume sa dB. |
| amang | 1 kung ang magdudula gipahilom, 0 kung ang magdudula wala gipahilom |
| Mga Hiyas sa Pagtubag | Deskripsyon |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?db=2
Dugangi ang volume sa 2dB.
3.3 Pagpaubos sa Volume
Deskripsyon
Kini nga hangyo mokunhod sa gidaghanon sa pipila ka dB (tipikal nga bili kay -2dB).
Pangayo
/Volume?db=-db_value
| Parameter | Deskripsyon |
| db | Mga lakang sa pagtaas sa volume sa dB (tipikal nga kantidad -2dB) |
tubag
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>
| Mga Hiyas sa Pagtubag | Deskripsyon |
| db | Ang lebel sa volume sa dB |
| amang | 1 kung ang magdudula gipahilom, 0 kung ang magdudula wala gipahilom |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?db=-2
Bawasan ang volume sa 2dB.
3.4 Mute On
Deskripsyon
Pangayo
/Tomo?mute=1
| Parameter | Deskripsyon |
| amang | Ibutang sa 1 para mute ang player |
tubag
<volume muteDb=”-43.1″ db=”100″
muteVolume=”11″
mute=”1″
offsetDb="0"
etag=”2105bed56563d9da46942a696cfadd63″>0</volume
>
| Mga Hiyas sa Pagtubag | Deskripsyon |
| muteDb | Ang lebel sa volume sa dB sa wala pa mute |
| db | Ang lebel sa volume sa dB |
| muteVolume | Ang lebel sa volume sa porsyento sa wala pa mute |
| amang | Ang 1 nagpasabot nga ang magdudula gipahilom |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?mute=1
3.5 Mute Off
Deskripsyon
Kini nga hangyo nagbutang sa player sa pag-unmute.
Pangayo
/Tomo?mute=0
| Parameter | Deskripsyon |
| amang | Ibutang sa 0 aron i-unmute ang player |
tubag
<volume db=”-43.1″ mute=”0″ offsetDb=”0″ etag=”e72d53db17baa526ebb5ee9c26060b1f”>11</volume>
| Mga Hiyas sa Pagtubag | Deskripsyon |
| db | Ang lebel sa volume sa dB |
| amang | Ang 0 nagpasabot nga ang magdudula dili mute |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?mute=0
Pagkontrol sa Playback
Kini nga mga sugo gigamit alang sa batakang kontrol sa playback. Ang mga sugo naglakip sa pagdula, paghunong, paghunong, paglaktaw, pagbalik, pag-shuffle, ug pag-usab.
4.1 Pagdula
Deskripsyon
Sugdi ang playback sa kasamtangan nga tinubdan sa audio. Ang opsyonal nga mga parameter nagtugot sa paglukso ngadto sa mga audio track, ug usa ka input nga mapili, sa dili pa magsugod ang audio playback.
Pangayo
/Pagdula
/Play?seek=segundos
/Play?seek=seconds&id=trackid
/Pagdula?url=encodedStreamURL
| Parameter | Deskripsyon |
| pangitaa | Ambak ngadto sa piho nga posisyon sa kasamtangan nga track. Balido lang kung ang tubag sa / Status naglakip . Dili magamit sa inputType ug index parameters. |
| naka-encode ngaStreamURL | URL sa gi-stream nga custom nga audio. Kini kinahanglan nga URL gi-encode. |
tubag
pagdula
sapa
| Mga Hiyas sa Pagtubag | Deskripsyon |
|
estado |
Ang estado pagkahuman gipatuman ang mando. Tan-awa ang /Status response state attribute para sa dugang detalye. |
Example
http://192.168.1.100:11000/Play
Sugdi ang audio playback sa kasamtangang track.
http://192.168.1.100:11000/Play?seek=55
Pagsugod sa audio playback sa 55 segundos sa kasamtangan nga track.
http://192.168.1.100:11000/Play?seek=55&id=4
Sugdi ang audio playback sa 55 segundos ngadto sa track number 5 sa pila.
192.168.1.125:11000/Pagdula?url=https%3A%2F%2Fwww%2Esoundhelix%2Ecom%2Fexampubos%2Fmp3%
2FSoundHelix-Song-1%2Emp3
Pagsugod sa audio playback sa usa ka online nga mp3 audio.
4.2 Pag-undang
Deskripsyon
Ihunong ang kasamtangan nga pagpatugtog nga audio.
Kung ang usa ka alarma nagdula, ug kini adunay timeout, nan ang alarm timeout kanselahon.
Pangayo
/ Hunong
/Pause?toggle=1
| Parameter | Deskripsyon |
| toggle | Kung gibutang sa 1, nan ang kasamtangan nga kahimtang sa paghunong gi-toggle. |
tubag
paghunong
| Hugot nga Pagtubag | Deskripsyon |
| estado | Ang estado pagkahuman gipatuman ang mando. Tan-awa ang /Status response state attribute para sa dugang detalye. |
Example
http://192.168.1.100:11000/Pause
Gipahunong ang kasamtangang nagpatugtog nga audio.
4.3 Hunong
Deskripsyon
Hunonga ang kasamtangan nga pagpatugtog sa audio. Kung ang usa ka alarma nagdula, ug kini adunay usa ka timeout, nan ang alarm timeout kanselahon Paghangyo
/Hunong
| Parameter | Deskripsyon |
| Wala |
tubag
hunong
| Mga Hiyas sa Pagtubag | Deskripsyon |
| estado | Ang "hunong" nagpasabut nga ang karon nga audio gipahunong. |
Example
http://192.168.1.100:11000/Stop
Gipahunong ang kasamtangang nagpatugtog nga audio.
4.4 Laktawan
Deskripsyon
Laktaw ngadto sa sunod nga audio track sa play queue
Kung magdula gikan sa play queue, molaktaw kini sa sunod nga track sa pila. Kung ang kasamtangan nga track mao ang katapusan sa pila, ang pagtawag / Laktaw moadto sa una nga track sa pila. . Molaktaw kini sa sunod o una nga track sa pila bisan unsa pa ang kahimtang sa gibalikbalik nga setting.
Aron mahibal-an kung imong gigamit ang play queue, pamatud-i nga walaUrl> entry sa tubag sa /Status.
Dayon mahimo nimong gamiton ang /Skip command.
Mahimo usab nimong laktawan ang mga track alang sa pipila nga streaming nga mga estasyon sa radyo. Gidumala kini gamit ang /Action command.
Ang ubang mga tinubdan sama sa TuneIn ug Optical Input wala mosuporta sa opsyon sa paglaktaw. Kini nga mga tinubdan adunay aURL> entry apan walay laktaw nga ngalan sa aksyon sa tubag sa /Status.
Pangayo
/Lakaw
| Parameter | Deskripsyon |
| Wala |
tubag
21
| Mga Hiyas sa Pagtubag | Deskripsyon |
| id | Ang track id human ipatuman ang skip command. Tan-awa ang hiyas sa /Status response song para sa mga detalye. |
Example
http://192.168.1.100:11000/Skip
Laktaw sa sunod nga track.
4.5 Balik
Deskripsyon
Kung ang usa ka track nagdula ug nagdula na sa sobra sa upat ka segundo unya ang balik mobalik sa pagsugod sa track.
Kung dili ang back command moadto sa miaging kanta sa karon nga playlist. Kung sa una nga kanta sa playlist ang pagtawag balik moadto sa katapusan nga kanta. Moadto kini sa nauna o una nga track sa pila bisan unsa pa ang kahimtang sa gibalikbalik nga setting.
Aron mahibal-an kung imong gigamit ang play queue, pamatud-i nga walaUrl> elemento sa tubag sa /Status.
Dayon mahimo nimong gamiton ang /Back command.
Mahimo ka usab nga mobalik sa mga track alang sa pipila nga streaming nga mga estasyon sa radyo. Gidumala kini gamit ang /Action command.
Ang ubang mga tinubdan sama sa TuneIn ug Optical Input wala mosuporta sa back option. Kini nga mga tinubdan adunay aUrl> elemento apan walay laktaw nga ngalan sa aksyon sa tubag sa / Status.
Pangayo
/Balik
| Parameter | Deskripsyon |
| Wala |
tubag
19
| Mga Hiyas sa Pagtubag | Deskripsyon |
| id | Ang track id human ipatuman ang back command. Tan-awa ang hiyas sa /Status response song para sa mga detalye. |
4.6 Shuffle
Deskripsyon
Ang shuffle command nagmugna og bag-ong pila pinaagi sa pag-shuffle sa kasamtangan nga pila. Ang orihinal (dili gi-shuffle) nga pila gipabilin alang sa pag-uli kung ang shuffle na-disable.
Pangayo
/Shuffle?state=0|1
| Parameter | Deskripsyon |
| estado | · 0 aron ma-disable ang shuffle · 1 aron mahimo ang shuffle. Wala’y epekto kung ang pila naa na sa shuffled nga kahimtang. Tan-awa ang / Status tubag elemento. |
tubag
| Mga Hiyas sa Pagtubag | Deskripsyon |
| giusab | Ang 1 nagpasabot nga ang pila giusab sukad nga gikarga. 0 nagpasabot nga dili. |
| gitas-on | Kinatibuk-ang gidaghanon sa mga track sa kasamtangan nga pila. |
| shuffle | Ang estado sa shuffle. Ang 1 nagpasabot nga ang kasamtangang pila gi-shuffle. 0 nagpasabot nga ang kasamtangang pila wala gi-shuffle. |
| id | Ang kasamtangan nga queue id. Kini mausab sa matag higayon nga ang play queue giusab. |
Example
http://192.168.1.100:11000/Shuffle?state=1
Gi-shuffle ang kasamtangan nga pila sa dula.
4.7 Balika
Deskripsyon
Nagtakda sa mga kapilian sa pag-usab. Repeat adunay tulo ka mga estado; Ang 0 nagpasabot nga sublion ang kasamtangan nga pila, ang 1 nagpasabot nga sublion ang kasamtangan nga track ug ang 2 nagpasabot nga dili na balikon. Ang tanan nga mga pag-usab walay tino, nga mao, sila dili mohunong.
Pangayo
/Repeat?state=0|1|2
| Parameter | Deskripsyon |
| estado | · 0 aron masubli ang tibuok nga pila sa dula · 1 aron masubli ang kasamtangan nga track · 2 aron i-turn off |
tubag
| Mga Hiyas sa Pagtubag | Deskripsyon |
| gitas-on | Ang kinatibuk-ang gidaghanon sa mga track sa kasamtangan nga play queue. |
| id | Ang kasamtangan nga queue id. Kini mausab sa matag higayon nga ang play queue giusab. |
| subli | Ang kasamtangan nga kahimtang sa pagbalik-balik. |
Example
http://192.168.1.100:11000/Repeat?state=1
Gisubli ang kasamtangan nga track sa pagdula.
4.8 Mga Aksyon para sa Pag-stream sa mga Estasyon sa Radyo
Deskripsyon
Ang mga aksyon nagtugot kanimo sa paglaktaw sa unahan, pagbalik, paghigugma ug pagdili sa mga track sa pinili nga streaming nga mga estasyon sa radyo, sama sa Slacker o Radio Paradise o Amazon Music Prime Stations. Ang streaming nga mga estasyon sa radyo wala mag-load sa mga track ngadto sa play queue. Hinunoa, sila naghatag ug a URL nga imong magamit aron matuman ang gusto nga function.
Ang skip moadto sa sunod nga track. Balik moadto sa miaging track. Ang gugma mag-flag sa track nga gusto sa sulod sa serbisyo sa musika. Ang pagdili molaktaw sa sunod nga track ug i-flag ang track ingon nga dili gusto sulod sa serbisyo sa musika.
Kung adunay usa kaUrl> entry sa tubag sa /Status, ug usa ka angay nga aksyon, mahimo nimo kini nga mga gimbuhaton. Ang aksyon maglangkob sa URL nga gigamit sa pagpatuman sa aksyon.
Ania ang usa ka exampgikan sa tubag sa /Status sa usa ka magdudula nga nagdula sa radyo 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
station” state=”-1″ text=”Ban” url= ”/Action?service=Slacker&ban=4799148″/>
Niining example, back is not available, pero skip, love ug ban pwede.
Pangayo
/Action?service=service-name&action=action-URL
Mubo nga sulat: Ang piho nga mga detalye sa hangyo (katapusan nga punto ug mga parameter) gihatag sa tagsa-tagsa elemento. Ang mga sugo sa ExampAng seksyon sa ubos sa tanan nga paggamit /Aksyon apan ang bisan unsang URI posible.
| Parameter | Deskripsyon |
| Gihatag sa elemento. |
tubag
Alang sa tubag, makadawat ka og aksyon nga pag-ila. Alang sa paglaktaw ug pagbalik, makadawat ka:
Alang sa gugma nga imong nadawat:
1
Alang sa pagdili makadawat ka:
0
| Mga Hiyas sa Pagtubag | Deskripsyon |
| tubag | Kung ang gamut nga elemento sa tubag mao ang unya ang text node usa ka pahibalo nga ipakita sa tiggamit. Kung ang usa ka alternatibong elemento sa gamut ibalik ug ang gilakip ang usa ka hiyas sa pagpahibalo unya kana nga pahibalo kinahanglan ipakita. |
Example
http://192.168.1.100:11000/Action?service=Slacker&skip=10965139
Molaktaw sa sunod nga track sa radyo sa Slacker.
http://192.168.1.100:11000/Action?service=Slacker&ban=33332284
Gidili ang kasamtangan nga nagpatugtog nga track sa radyo nga Slacker ug molaktaw sa sunod nga track.
Pagdula sa Queue Management
Usa ka paagi sa operasyon sa usa ka magdudula mao ang pagkarga sa mga track ngadto sa usa ka play queue, ug dayon pagdula sa mga track gikan sa play queue. Kini nga mga sugo nagtugot kanimo sa view ug pagdumala sa play queue.
5.1 Ilista ang mga Track
Deskripsyon
Ibalik ang status sa play queue, o ibalik ang impormasyon sa tanang track sa play queue.
Dili girekomenda nga gamiton kini nga pangutana nga wala ang gitas-on o pagsugod ug katapusan nga mga parameter, tungod kay kung dili mahimo’g usa ka taas nga tubag.
Pangayo
/Playlist
/Playlist?length=1
/Playlist?start=first&end=last (kuhaa ang bahin sa pila, para sa pagination kasagaran)
| Parameter | Deskripsyon |
| gitas-on=1 | Ibalik lang ang top-level nga mga hiyas ug walay mga detalye sa track. |
| pagsugod | Unang entry sa pila nga iapil sa tubag, sugod sa 0. |
| katapusan | Katapusan nga entry sa pila nga iapil sa tubag. |
tubag
Para sa status sa play queue:
13
243
1
Para sa listahan sa play queue:
2002
Anne-Marie
2002
Deezer: 487381362
| Mga Hiyas sa Pagtubag | Deskripsyon |
| ngalan | Ang karon nga ngalan sa play queue. |
| giusab | 0 nagpasabot nga ang pila wala mausab sukad kini gikarga. Ang 1 nagpasabot nga ang pila giusab sukad kini gikarga. |
| gitas-on | kinatibuk-ang gidaghanon sa mga track sa kasamtangan nga pila |
| id | talagsaon nga id alang sa kasamtangan nga kahimtang sa pila (pananglitan, 1054). Parehas kini sa sa / Status tubag. |
| kanta | Ang kanta gilangkuban sa daghang mga sub-elemento: · albumid = id sa album diin naa ang track · serbisyo = serbisyo sa musika sa track · artistid = id sa track artist · songid = kanta id · id = posisyon sa track sa kasamtangan nga pila. Kung ang track karon gipili, ang track id parehas sa sa / Status tubag. · titulo = ngalan sa track · arte = ngalan sa artista · alb = ngalan sa album |
Example
http://192.168.1.100:11000/Playlist
Naglista sa tanang mga track sa play queue.
http://192.168.1.100:11000/Playlist?length=1
5.2 Pagtangtang sa usa ka Track
Deskripsyon
Kuhaa ang usa ka track gikan sa kasamtangan nga pila sa dula.
Pangayo
/Delete?id=position
| Parameter | Deskripsyon |
| id | Ang track id sa track nga mapapas gikan sa kasamtangan nga play queue. |
tubag
9
| Mga Hiyas sa Pagtubag | Deskripsyon |
| gipapas | Ang posisyon sa pila sa track nga tangtangon. |
Example
http://192.168.1.100:11000/Delete?id=9
Gitangtang ang track sa posisyon 9 sa play queue.
5.3 Pagbalhin Usa ka Track
Deskripsyon
Pagbalhin og track sulod sa kasamtangang pila sa dula.
Pangayo
/Move?new=destination&old=origin
| Parameter | Deskripsyon |
| bag-o | Bag-ong posisyon sa track nga gibalhin. |
| tigulang | Ang daan nga posisyon sa track nga gibalhin. |
tubag
mibalhin
| Mga Hiyas sa Pagtubag | Deskripsyon |
| mibalhin | Nagpakita nga ang track gibalhin. |
Example
http://192.168.1.100:11000/Move?new=8&old=2
Ibalhin ang track sa posisyon 2 ngadto sa posisyon 8 sa play queue.
5.4 Tin-aw nga Pila
Deskripsyon
Hawani ang tanang mga track gikan sa kasamtangang pila sa dula
Pangayo
/ Klaro
| Parameter | Deskripsyon |
| Wala |
tubag
| Mga Hiyas sa Pagtubag | Deskripsyon |
| giusab | Ang 0 nagpasabut nga ang pila wala gibag-o sukad gikarga, ang 1 nagpasabut nga ang pila giusab sukad gikarga. |
| gitas-on | Ang kinatibuk-ang gidaghanon sa mga track sa kasamtangan nga pila. |
| id | Ang talagsaon nga id alang sa kasamtangan nga pila. |
Example
http://192.168.1.100:11000/Clear
Gikuha niini ang tanang mga track gikan sa play queue.
5.5 I-save ang Pila
Deskripsyon
I-save ang play queue isip usa ka ngalan nga BluOS playlist.
Pangayo
/Save?name=playlist_name
| Parameter | Deskripsyon |
| ngalan | Ang gitipigan nga play queue ngalan. |
tubag
126
| Mga Hiyas sa Pagtubag | Deskripsyon |
| entries | Ang kinatibuk-ang gidaghanon sa mga track sa gitipigan nga play queue. |
Example
http://192.168.1.100:11000/Save?name=Dinner+Music
Kini nagluwas sa play queue isip "Dinner Music".
Preset
Gitugotan ka sa mga preset nga hangyo nga ilista ang tanan nga mga preset sa usa ka magdudula, pag-load sa usa ka preset, ug pagpataas / paubos nga mga preset. Ang mga preset kinahanglang idugang ug tangtangon gamit ang BluOS Controller app. Ang mga preset mahimong maglakip sa mga istasyon sa radyo, mga playlist ug mga input (eg
Bluetooth, analog, optical, HDMI ARC).
6.1 Ilista ang mga Preset
Deskripsyon
Ilista ang tanang preset sa kasamtangang BluOS player.
Pangayo
/Preset
| Parameter | Deskripsyon |
| Wala |
tubag
<preset id=”6″ name=”Serenity” url=”RadioParaiso:/42:4/Kalinaw”
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>
| Mga Hiyas sa Pagtubag | Deskripsyon |
| garbo | Usa ka talagsaon nga id sa mga preset sa player. Parehas kini sa sa / Status tubag. |
| ngalan | Ang preset nga ngalan. |
| id | Ang preset nga id. |
| url | Ang preset URL. Kini ang preset nga tinubdan URL gigamit sa pag-load sa preset. |
| hulagway | Hulagway URL sa preset. Kung ang URL nagsugod sa /Artwork mahimo kining moresulta sa pag-redirect. Pagdugang ug parameter/key followRedirects=1 kung ang pagkuha sa imahe makalikay sa pag-redirect. |
Example
http://192.168.1.100:11000/Presets
Ilista ang tanang preset sa player.
6.2 Pag-load sa usa ka Preset
Deskripsyon
Nagsugod sa pagdula og preset. Makapili ka ug espesipikong preset nga numero, maingon man sa sunod o miaging preset. Ang mga preset nga numero dili kinahanglan nga sunod-sunod, nga mao, mahimo kang adunay mga preset 1,2,3 5, 7 ug 8. Ang mga preset loop gikan sa ibabaw ngadto sa ubos ug sa ubos ngadto sa ibabaw.
Pangayo
/Preset?id=presetId|-1|+1
| Parameter | Deskripsyon |
| id | Ang id number sa preset nga i-load. Ang lista sa mga magamit nga preset id makit-an gamit ang Show Presets nga mando. Kung ang preset nga id kay +1, kini magkarga sa sunod nga preset. Kung ang preset id kay -1, kini magkarga sa miaging preset. |
tubag
Kung ang preset usa ka lista sa mga track ibalik niini ang gidaghanon sa mga track sa preset nga gikarga.
60
Kung ang preset usa ka radyo kini ibalik ang kahimtang sa sapa.
sapa
| Mga Hiyas sa Pagtubag | Deskripsyon |
| serbisyo | ngalan sa serbisyo sa gikarga nga preset |
| entries | ang gidaghanon sa mga track sa preset nga gikarga |
Example
http://192.168.1.100:11000/Preset?id=4
I-load ang preset gamit ang preset id 4.
http://192.168.1.100:11000/Preset?id=+1
Content Browsing ug Searching
Kini nga seksyon naghulagway sa mga sugo alang sa pag-browse ug pagpangita sa sulod sa serbisyo sa musika.
7.1 Pag-browse sa Sulud sa Musika
Deskripsyon
Pag-navigate sa mga magamit nga gigikanan sa musika, ingon man mga input ug mga playlist.
Ang gamut nga elemento alang sa mga tubag mao ang gawas kung adunay tubag sa sayup. Kadaghanan sa mga resulta usa ka han-ay sa . Sa pipila ka mga kaso ang resulta usa ka han-ay sa , ang matag usa niini adunay usa ka han-ay kung . Ang tanan nga mga kantidad gihatag gamit ang mga hiyas. Walay mga text node.
Ang resulta sa usa ka /Browse nga tawag mahimong usa ka sayup nga gilakip sa usa ka elemento sa ugat. Ang detalye sa sayup gihatag sa usa ug sero o labaw pa mga node sa teksto.
Pangayo
/Browse?key=key-value
/Browse?key=key-value&withContextMenuItems=1
| Parameter | Deskripsyon |
| yawe | Opsyonal nga parameter. Ang pagkawala niini nga parameter moresulta sa usa ka top-level nga pag-browse. Nagbalik sa impormasyon alang sa mga lebel gawas sa taas nga lebel /Pag-browse. Gigamit ang bili nga gikuha gikan sa usa ka "browseKey", "nextKey", "parentKey", o "contextMenuKey" attribute value gikan sa naunang tubag. Mubo nga sulat: key-value kinahanglan nga URL gi-encode |
| uban saContextMenuItems | Opsyonal nga parameter. Ang bili mao ang kanunay nga 1. Kini nga parameter gigamit aron makakuha og inline nga menu sa konteksto kung makuha ang resulta sa pag-browse sa mga playlist, album, track, istasyon, artista, ug uban pa. |
tubag
Taas nga lebel nga tubag sa pag-browse:
<item image=”/images/InputIcon.png” text=”Optical Input”
pagdulaURL=”/Pagdula?url=Capture%3Ahw%3A1%2C0%2F1%2F25%2F2%2Finput1″ inputType=”spdif”
type="audio"/>
Uban nga lebel sa pagtubag sa pag-browse:
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
service=”Deezer” searchKey=”Deezer:Pagpangita” type=”menu”>
item browseKey=”/Playlists?service=Deezer&genre=0&category=toplist” text=”Popular Playlists”
type=”link”/>
type=”link”/>
type=”link”/>
item browseKey=”/Songs?service=Deezer&genre=0&category=toplist” text=”Popular nga Kanta”
type=”link”/>
| Mga Hiyas sa Pagtubag | Deskripsyon |
| Tan-awa ang elemento/attribute tables sa ubos |
Example
NOTA: ang tanan nga yawe nga mga parameter kinahanglan nga UTF-8 gi-encode.
http://192.168.1.100:11000/Browse
Nag-browse sa taas nga lebel.
http://192.168.1.100:11000/Browse?key=Tidal%3A
Nag-browse sa ikaduhang lebel, nga nagbalik sa mga kategorya sa Tidal.
http://192.168.1.100:11000/Browse?key=Tidal%3AmenuGroup%2F3
Nag-browse sa ikatulo nga lebel, nagbalik sa mga sub-category sa Tidal Masters (Group 3).
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters
Naghimo usa ka ikaupat nga lebel nga pag-browse, nga gibalik ang una nga set sa mga album sa Tidal Masters.
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters%26 start%3D30%26end%3D79
Naghimo ba og laing ikaupat nga lebel sa pag-browse, nga nagbalik sa ikaduhang set sa mga album sa Tidal Masters.
| elemento | Hiyas (ug mga bili) | Deskripsyon | |
| serbisyoIcon | Ang URI alang sa usa ka icon alang sa serbisyo nga gi-browse karon. | ||
| Ngalan sa serbisyo | Ang ngalan sa serbisyo nga gi-browse karon, alang sa pagpakita sa tiggamit. | ||
| searchKey | Usa ka bili nga gamiton alang sa usa ka yawe nga parametro sa usa ka /Browse nga hangyo sa pagpangita sa kasamtangan nga serbisyo (o pipila ka mas lawom nga bahin sa hierarchy). Dugang pa, ang hangyo kinahanglan adunay aq parameter nga adunay sulud nga termino sa pagpangita. | ||
| sunod nga yawe | Usa ka bili nga gamiton alang sa usa ka yawe nga parametro sa usa ka /Browse nga hangyo aron makuha ang sunod nga panid sa mga butang alang sa kasamtangan view. Ang paging chunk nga gidak-on dili ubos sa kontrol sa API user ug walay pagsulay nga himoon sa pag-parse o pagmaniobra sa mga parameter sa pangutana niini nga bili. | ||
| parentKey | Usa ka bili nga gamiton alang sa usa ka yawe nga parametro sa usa ka /Browse nga hangyo sa pag-navigate balik sa hierarchy kung ang default back navigation kinahanglan nga ma-override. | ||
| tipo | menu | Usa ka node sa nabigasyon nga posibleng adunay sagol sa bisan unsang matang sa butang. Ang kasagarang maglangkob lang og link o audio nga mga butang. | |
| contextMenu | Usa ka lista sa mga butang sa piho nga tipo. | ||
| mga artista | |||
| elemento | Hiyas (ug mga bili) | Deskripsyon | |
| mga kompositor | |||
| mga album | |||
| mga playlist | |||
| mga track | |||
| mga genre | |||
| mga seksyon | Alpabetikong mga seksyon. | ||
| mga butang | Listahan sa generic nga resulta. Kasagaran ang usa ka pagsagol sa mga node sa menu (type = "link") ug mga butang sa radyo (type = "audio"). | ||
| mga folder | Mahimong adunay mga subfolder, track ug mga entry sa playlist. | ||
| text | Ulohan alang sa kategorya. | ||
| sunod nga yawe | Usa ka bili nga gamiton alang sa usa ka yawe nga parametro sa usa ka /Browse nga hangyo aron makuha ang sunod nga panid sa mga aytem para sa kategorya. | ||
| parentKey | Usa ka bili nga gamiton alang sa usa ka yawe nga parametro sa usa ka /Browse nga hangyo sa pag-navigate balik sa hierarchy kung ang default back navigation kinahanglan nga ma-override. | ||
| tipo | sumpay | Usa ka generic nga node sa browse hierarchy nga nagpadulong ngadto sa dugang nga mga node | |
| audio | Usa ka node nga mahimong direkta nga dulaon | ||
| artista | Usa ka butang nga nagrepresentar sa usa ka artista | ||
| elemento | Hiyas (ug mga bili) | Deskripsyon | |
| kompositor | Usa ka butang nga nagrepresentar sa usa ka kompositor | ||
| album | Usa ka butang nga nagrepresentar sa usa ka album o susama nga koleksyon | ||
| playlist | Usa ka butang nga nagrepresentar sa usa ka playlist o susama nga koleksyon | ||
| track | Usa ka butang nga nagrepresentar sa usa ka track | ||
| text | Usa ka yano nga node sa teksto. | ||
| seksyon | Usa ka alpabetikong seksyon. | ||
| folder | Usa ka folder sa usa ka folder browse. | ||
| text | Panguna o una nga linya sa paghulagway sa aytem | ||
| text2 | Ikaduhang linya | ||
| hulagway | Usa ka icon o artwork alang sa butang. Kung ang imahe magsugod sa
/Artwork mahimo kining moresulta sa pag-redirect. Pagdugang ug parameter/key followRedirects=1 kung ang pagkuha sa imahe makalikay sa pag-redirect. |
||
| browseKey | Usa ka bili nga gamiton alang sa usa ka yawe nga parametro ngadto sa sunod nga /Browse nga hangyo sa pagpaubos sa hierarchy. | ||
| pagdulaURL | Usa ka URI nga mahimong direktang tawagon aron gamiton ang default nga aksyon sa pagdula alang sa butang nga gipangutana. Kasagaran kini mao ang paghawan sa pila ug pagsugod sa pagdula niini. | ||
| autoplayURL | Usa ka URI nga mahimong direktang tawagon aron makadugang og track sa pila ug ipatugtog kini ug idugang ang sunod-sunod nga mga track gikan sa butang nga adunay sulod (sama sa usa ka album) ngadto sa auto-fill | ||
| elemento | Hiyas (ug mga bili) | Deskripsyon |
| seksyon sa play queue. | ||
| contextMenuKey | Usa ka bili nga gamiton alang sa usa ka yawe nga parametro sa usa ka /Browse nga hangyo aron makakuha og resulta nga konteksto-menu sa mga aksyon nga may kalabutan sa butang. | |
| aksyonURL | Usa ka URI nga mahimong direktang tawagon aron mahimo ang piho nga aksyon. |
Ang mga butang sa menu sa konteksto mahimong adunay mosunod nga mga kantidad alang sa tipo nga attribute.
| Hiyas | ||
| Deskripsyon | ||
| paborito | -dugang | Idugang ang aytem isip paborito (o katumbas) |
| -pagtangtang | Kuhaa ang butang gikan sa mga paborito sa user | |
| idugang | Idugang sa play queue | |
| idugang | -karon | Idugang sa play queue human sa kasamtangan nga track ug play karon |
| -sunod | Idugang sa play queue human sa kasamtangan nga track | |
| - katapusan | Idugang sa katapusan sa play queue | |
| idugang tanan | -karon | Idugang ang multi-track nga butang sa play queue ug play karon |
| -sunod | Idugang ang multi-track nga butang sa play queue human sa kasamtangan nga track o multi-track nga butang | |
| - katapusan | Idugang ang multi-track nga butang sa katapusan sa play queue | |
| playRadio | Pagdula og estasyon sa radyo nga may kalabutan sa butang | |
| tangtangon | Pagtangtang sa butang (kasagaran usa ka playlist). Kinahanglang pangayoon ang kumpirmasyon sa tiggamit |
Kung nag-browse gamit ang parameter "withContextMenuItem=1", ang resulta maglangkob sa in-line nga menu sa konteksto.
Example
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26genre%3D0%26category %3Dtoplist&withContextMenuItems=1
Naghangyo ba sa Deezer => Unsa'y Init => Popular nga mga Album nga adunay inline nga menu sa konteksto.
tubag
Ang tubag adunay inline alang sa matag butang.
<item text=”Essonne History X” contextMenuKey=”Deezer:contextMenu/Album?albumid=693798541″
pagdulaURL=”/Add?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”
aksyonURL=”/Add?service=Deezer&playnow=1&clear=0&shuffle=0&where=nextAlbum&albumid=693798541″/>
<item text=”Shuffle” type=”add-shuffle”
aksyonURL=”/Add?service=Deezer&shuffle=1&playnow=1&where=nextAlbum&albumid=693798541″/>
<item text=”Add next” type=”addAll-next” actionURL=”/Add?service=Deezer&playnow=-1&where=nextAlbum&albumid=693798541″/>
<item text=”Add last” type=”addAll-last” actionURL=”/Add?service=Deezer&playnow=-1&where=last&albumid=693798541″/>
…
Mga Nota sa Implementasyon ug Mga Sugyot
Ang tipo nga kinaiya sa usa ka butang gihatag ingon usa ka pahiwatig nga mahimong mapadali ang lainlaing mga kapilian sa pagpakita.
Ang abilidad sa pag-browse sa mga sulod sa usa ka butang gipakita pinaagi sa presensya sa usa ka browseKey attribute. Ang abilidad sa pagdula sa usa ka (tibuok) nga butang gipakita sa presensya sa usa ka dulaURL (ug posible usab nga autoplayURL) hiyas. Ang usa ka butang mahimong adunay usa ka browseKey nga hiyas ug usa ka dulaURL hiyas.
Sa dihang magduwa ang duhaURL ug autoplayURL anaa ang mga hiyas, diin ang usa nga gamiton isip default nga opsyon sa pagdula kinahanglan nga mahimong hilisgutan sa usa ka gusto sa user.
Ang mga kantidad sa URI sa kasagaran mga paryente nga URI nga adunay hingpit nga sangkap sa agianan. Ang mga paryente nga URI giresolba sa hingpit nga mga URI sumala sa RFC 3986.
Ang browseKey, contextMenuKey ug searchKey attribute values kinahanglang URI-encoded (porsiyento escaped) kon gamiton isip value sa key parameter sa usa ka /Browse request, sama sa uban nga request parameters.
Sa pagpaubos sa hierarchy sa pag-browse mahimo nga mapuslanon alang sa header sa panid sa UI nga magpakita sa usa ka matang sa (mga) breadcrumb, lagmit gamit ang titulo (teksto) sa mga node sa ginikanan ug apohan.
Mahimong mapuslanon ang paghimo nga magamit ang menu sa konteksto alang sa ginikanan kung nag-browse sa mga anak niini.
Mahimong mapuslanon ang pagkonsiderar sa matang sa ginikanan sa dihang magdesisyon kon unsaon pagpasundayag sa mga anak niini.
7.2 Pangitaa ang Sulud sa Musika
Deskripsyon
Sugo sa pagpangita sulod sa usa ka serbisyo.
Pangayo
/Browse?key=key-value&q=searchText
| Parameter | Deskripsyon |
| yawe | Ang bili nga gikuha gikan sa usa ka "searchKey" nga hiyas nga bili gikan sa usa ka sayo nga tubag |
| q | Ang search string. Paghimo usa ka pagpangita sa konteksto nga gipiho sa yawe nga parameter (gikuha gikan sa usa ka searchKey nga hiyas gikan sa usa ka tubag). Kung wala ang usa ka yawe nga parameter, paghimo usa ka taas nga lebel nga pagpangita. |
tubag
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
service=”Deezer” searchKey=”Deezer:Pagpangita” type=”menu”>
Ibalik ang pinakataas nga lebel sa resulta sa pagpangita. Para sa dugang nga resulta sa pagpangita sa mga Artist, Album, Kanta, o Playlist, usa ka sugo sa pag-browse nga adunay "browseKey" isip yawe ang gikinahanglan.
Kay example, aron makita ang resulta sa pagpangita sa Albums, ipadala ang sugo:
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26expr%3Dmichael
Ang tubag mahimong parehas sa tubag sa normal nga /Browse command.
| Mga Hiyas sa Pagtubag | Deskripsyon |
| Tan-awa ang elemento/attribute tables sa Browse command |
Example
http://192.168.1.100:11000/Browse?key=Deezer:Search&q=michael Pangitaa ang "michael" sulod sa serbisyo sa musika sa Deezer.
Paggrupo sa Manlalaro
Kini nga seksyon naghulagway sa mga sugo alang sa default nga player grouping ug ungrouping. Gisuportahan usab sa BluOS ang naayos nga paggrupo, nga wala’y sakup niini nga dokumento.
Gigamit sa BluOS ang terminolohiya nga panguna nga magdudula ug sekondaryang magdudula. Ang nag-unang magdudula mao ang nag-unang magdudula sa grupo. Ang panguna nga magdudula gigamit sa pagpili sa gigikanan sa musika. Adunay usa ra ka panguna nga magdudula. Usa ka sekondaryang magdudula ang gilakip sa nag-unang magdudula. Mahimong adunay daghang mga sekondaryang magdudula.
Kung ang usa ka magdudula usa ka sekondaryang magdudula unya daghang mga hangyo, kung gitumong sa sekondarya nga magdudula, ang internal nga proxy sa panguna nga magdudula. Kini naglakip sa /Status, Playback Control, Play Queue Management ug Content Browsing and Searching requests.
8.1 Grupo Duha ka Manlalaro
Deskripsyon
Paggrupo ang usa ka sekondaryang magdudula sa usa ka panguna nga magdudula.
Pangayo
/AddSlave?slave=secondaryPlayerIP&port=secondaryPlayerPort&group=GroupName
| Parameter | Deskripsyon |
| ulipon | IP address sa ikaduhang magdudula. |
| pantalan | Numero sa pantalan sa ikaduhang magdudula. Ang default port number mao ang 11000. Ang mga magdudula sama sa NAD CI580, nga adunay upat ka mga magdudula nga adunay usa ka IP, naggamit og daghang mga pantalan. |
| grupo | OPTIONAL, ngalan sa grupo. Kung dili gihatag, ang BluOS maghatag usa ka default nga ngalan sa grupo. |
tubag
| Mga Hiyas sa Pagtubag | Deskripsyon |
| ulipon nga pantalan | Numero sa pantalan sa ikaduhang magdudula nga bag-o lang gigrupo. |
| Id | ID sa secondary player nga bag-o lang gigrupo. |
Example
http://192.168.1.100:11000/AddSlave?slave=192.168.1.153&port=11000
Gigrupo niini ang player 192.168.1.153 ngadto sa player nga 192.168.1.100. Ang magdudula 192.168.1.100 mao ang nag-unang magdudula.
8.2 Pagdugang Daghang mga Manlalaro Sa Usa ka Grupo
Deskripsyon
Paggrupo ang duha o daghan pa nga mga magdudula sa usa ka panguna nga magdudula.
Pangayo
/AddSlave?slaves=secondaryPlayerIPs&ports=secondaryPlayerPorts
| Parameter | Deskripsyon |
| mga ulipon | Ang mga IP address sa mga sekondaryang magdudula idugang sa nag-unang magdudula. Ang mga IP address gibulag sa koma. |
| mga pantalan | Ang mga pantalan sa mga sekondaryang magdudula nga idugang sa panguna nga magdudula. Ang mga numero sa pantalan gibulag sa koma. |
tubag
| Mga Hiyas sa Pagtubag | Deskripsyon |
| pantalan | Ang pantalan sa ikaduhang magdudula nga gigrupo. |
| Id | Ang id sa sekondaryang magdudula nga gigrupo. |
Example
http://192.168.1.100:11000/AddSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Gigrupo ang mga sekondaryang magdudula 192.168.1.153 ug 192.168.1.120 sa panguna nga magdudula 192.168.1.100.
8.3 Pagtangtang sa Usa ka Manlalaro Gikan sa Usa ka Grupo
Pagtangtang sa usa ka magdudula gikan sa usa ka grupo. Kung tangtangon ang usa ka sekondaryang magdudula gikan sa usa ka grupo, ang sekondaryang magdudula dili ma-grupo. Kung tangtangon ang nag-unang magdudula gikan sa usa ka grupo sa 3 o labaw pa nga mga magdudula, ang panguna nga magdudula dili ma-grupo ug ang nahabilin nga mga sekondaryang magdudula magporma usa ka bag-ong grupo.
Pangayo
/RemoveSlave?slave=secondaryPlayerIP&port=secondaryPlayerPort
| Parameter | Deskripsyon |
| ulipon | IP sa player (secondary) nga idugang sa laing player (primary). |
| pantalan | Port sa player (secondary) nga idugang sa laing player (primary). |
tubag
<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″>
| Mga Hiyas sa Pagtubag | Deskripsyon |
| Tan-awa ang /SyncStatus para sa mga detalye. |
Example
http://192.168.1.100:11000/RemoveSlave?slave=192.168.1.153&port=11000
I-ungroup ang magdudula 192.168.1.153 gikan sa grupo nga adunay panguna nga magdudula 192.168.1.100
8.4 Pagtangtang sa Daghang Manlalaro Gikan sa Usa ka Grupo
Deskripsyon
Pagtangtang sa duha o daghang mga magdudula gikan sa usa ka grupo.
Pangayo
/RemoveSlave?slaves=secondaryPlayerIPs&ports=secondaryPlayerPorts
| Parameter | Deskripsyon |
| mga ulipon | Ang mga IP address sa mga sekondaryang magdudula nga tangtangon gikan sa panguna nga magdudula. Ang mga IP address gibulag sa koma. |
| Parameter | Deskripsyon |
| mga pantalan | Ang mga pantalan sa mga sekondaryang magdudula nga tangtangon gikan sa panguna nga magdudula. Ang mga numero sa pantalan gibulag sa koma. |
tubag
<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>
| Mga Hiyas sa Pagtubag | Deskripsyon |
| Tan-awa ang /SyncStatus para sa mga detalye. |
Example
http://192.168.1.100:11000/RemoveSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Gitangtang ang mga magdudula 192.168.1.153 ug 192.168.1.120 gikan sa grupo nga adunay panguna nga magdudula 192.168.1.100.
Pag-reboot sa Player
Kini nga seksyon naghulagway sa command alang sa player soft reboot.
9.1 I-reboot ang Usa ka Manlalaro
Deskripsyon
Soft reboot sa usa ka player.
Pangayo
POST command / reboot nga adunay parameter nga oo (bisan unsang kantidad)
| Parameter | Deskripsyon |
| oo | Bisan unsa nga bili (eg 1). |
tubag
Gi-update ang mga Setting
Pag-reboot. Palihug isira kini nga bintana.
Palihug paghulat…
Example
curl -d oo=1 192.168.1.100/reboot
Mga Tunog sa Doorbell
Kini nga seksyon naghulagway sa command alang sa player doorbell chime.
10.1 Mga Tunog sa Doorbell
Deskripsyon
I-aktibo ang mga huni sa doorbell.
Pangayo
http://PLAYERIP:PORT/Doorbell?play=1
| Parameter | Deskripsyon |
| pagdula | Pagdula sa doorbell (kanunay 1) |
tubag
| Mga Hiyas sa Pagtubag | Deskripsyon |
| makahimo | Itudlo ang huni |
| gidaghanon | Volume sa chime |
| huni | Audio nga chime |
Example
http://192.168.1.100:11000/Doorbell?play=1 play doorbell chime
Direktang Input
Kini nga seksyon naghulagway sa mga sugo alang sa direkta nga pagpili sa tinubdan sa input.
11.1 Aktibo nga Pagpili sa Input
Deskripsyon
Aktibo nga pagpili sa tinubdan sa input. Kini nga sugo magamit alang sa mga aktibong input nga makita sa tubag sa /RadioBrowse?service=Capture. Ang pagpili sa mga input sa BluOS HUB gisuportahan lamang niini nga sugo.
Pangayo
/Pagdula?url=URL_bili
| Parameter | Deskripsyon |
| url | Ang URL attribute gikan sa tubag sa /RadioBrowse?service=Capture |
tubag
sapa
| Mga Hiyas sa Pagtubag | Deskripsyon |
| estado | Ipakita nga ang input nagdula |
Example
Lakang 1. Kuhaa ang URL_value para sa parameter url
Hangyo: http://192.168.1.100:11000/RadioBrowse?service=Capture
tubag:
<item playerName=”Tick
I-tsek ang” text = “Bluetooth” inputType=”bluetooth” id=”input2″ URL=”Capture%3Abluez%3Abluetooth” image=” /images/BluetoothIcon.png” type=”audio”/>
<item playerName=”Tick Tick” text=”Analog
Input" 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
Input" inputType = "spdif" id = "input1" URL=”Capture%3Ahw%3Aimxspdif%2C0%2F1%2F25%2F2%3Fid%
3Dinput1″ imahe =”/images/capture/ic_opticalinput.png” type=”audio”/>
<item playerName=”Tick
I-tsek ang" text = "Spotify" id = "Spotify" URL=”Spotify%3Aplay” image =”/Sources/images/SpotifyIcon.png” nga serbisyo
Type=”CloudService” type=”audio”/>
<remoteitem playerName=”Test Hub” text=”Analog Input” inputType=”analog” id=”hub192168114911000input0″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput0″
hulagway =”/images/capture/i
c_analoginput.png”
type="audio"/>
<remoteitem playerName=”Test Hub” text=”Coaxial Input” inputType=”spdif” id=”hub192168114911000input3″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput3″
hulagway =”/images/capture/ic
_opticalinput.png”
type="audio"/>
<remoteitem playerName=”Test Hub” text=”HDMI ARC” inputType=”arc” id=”hub192168114911000input4″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput4″
hulagway =”/images/capture/ic
_tv.png”
type="audio"/>
<remoteitem playerName=”Test Hub” text=”Optical Input” inputType=”spdif” id=”hub192168114911000input2″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput2″
hulagway =”/images/capture/ic
_opticalinput.png”
type="audio"/>
<remoteitem playerName=”Test Hub” text=”Phono Input” inputType=”phono” id=”hub192168114911000input1″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput1″
hulagway =”/images/capture/ic
_vinyl.png”
type="audio"/>
Lakang 2. Pagdula Analog Input sa player
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
Mubo nga sulat: Siguroha nga ang mga tinubdan konektado ug dili gitago.
11.2 Pagpili sa External Input
Deskripsyon
Pagpili sa tinubdan sa gawas nga input. Usahay ang dili aktibo nga eksternal nga mga input mahimong dili makita sa tubag sa
/RadioBrowse?service=Pagkuha. Kini nga sugo nagtrabaho alang sa aktibo ug dili aktibo nga pagpili sa input. Girekomenda kini alang sa pagpili sa eksternal nga input sa CI.
Hangyo (BluOS firmware mas bag-o kay sa v3.8.0 ug mas tigulang kay sa v4.2.0)
/Play?inputIndex=IndexId
| Parameter | Deskripsyon |
| inputIndex | Ang indeks (nagsugod sa 1) sa mga input nga makita sa tubag sa /Settings?id=capture&shcemaVersion=32 (32 mao ang pinakabag-o nga bersyon sa schema) sa numerical order. Wala iapil ang Bluetooth. |
tubag
sapa
| Mga Hiyas sa Pagtubag | Deskripsyon |
| estado | Ipakita nga ang input nagdula |
Example
Lakang 1. Kuhaa ang inputIndex nga bili
Hangyo: http://192.168.1.100:11000/Settings?id=capture&schemaVersion=32
tubag:
<menuGroup icon=”/images/settings/ic_capture.png” url=”/setting” id=”pagkuha”
displayName = "Ipasibo ang mga tinubdan">
<setting icon=”/images/settings/ic_bluetooth.png” refresh=”true” url=”/audiomodes”
id=”bluetooth” displayName=”Bluetooth” value=”3″ name=”bluetoothAutoplay” description=”Disabled” explanation=”Manual mode nagtugot kanimo sa pagbalhin sa taliwala sa mga tinubdan sa navigation drawer. Ang awtomatikong mode mobalhin sa tinubdan sa Bluetooth kung ang konektado nga Bluetooth device magsugod sa pagpatugtog og audio. Mahimo ka dayon magbalhin-balhin tali sa mga gigikanan sa navigation drawer. Ang mode sa bisita mobalhin sa tinubdan sa Bluetooth kung ang konektado nga Bluetooth device magsugod sa pagpatugtog og audio. Kon mag-ilis ka sa laing tinubdan, ang Bluetooth madiskonekta. Ang tinubdan sa Bluetooth dili makita sa navigation drawer. Gikuha sa disabled ang tinubdan gikan sa navigation drawer, ug dili tugotan ang laing device nga makonektar sa Player isip Bluetooth
tinubdan.” class="listahan">
…
<menuGroup icon=”/images/capture/ic_analoginput.png” url=”/setting” id=”captureinput0″
displayName = "Analog
Input">
<menuGroup icon=”/images/capture/ic_opticalinput.png” url=”/setting” id=”capture-input1″
displayName = "Optical Input">
Ang tubag nagpakita sa Bluetooth, Analog Input, ug Optical Input. Wala iapil ang Bluetooth, busa ang bili sa inputIndex mao ang 1 alang sa Analog Input, ug ang bili sa inputIndex mao ang 2 alang sa Optical Input.'
Lakang 2. Play Optical Input sa player.
http://192.168.1.100:11000/Play?InputId=2
Paghangyo (BluOS firmware v4.2.0 o mas bag-o)
/Play?inputTypeIndex=$typeIndex
| Parameter | Deskripsyon |
| inputTypeIndex | typeIndex adunay format sa type-index sa usa ka input. Ania ang lista sa input tipo: spdif (Optical Input) analog (Analog Input, Line In) coax (Coaxial Input) bluetooth arko (HDMI ARC) earc (HDMI eARC) phono (Vinyl) nga kompyuter aesebu (AES/EBU) balanse (Balanse Sa) mikropono (Microphone Input) Ang indeks magsugod gikan sa 1. Kung adunay labaw pa sa usa ka input sa parehas nga tipo, ang input 1 adunay indeks 1, ang input 2 adunay indeks 2, ug uban pa. |
tubag
sapa
| Mga Hiyas sa Pagtubag | Deskripsyon |
| estado | Ipakita nga ang input nagdula |
Example
Hangyo: http://192.168.1.100:11000/Play?inputTypeIndex=spdif-2 aron mapili ang Optical Input 2
tubag: sapa
Bluetooth
Kini nga seksyon naghulagway sa sugo sa pag-usab sa Bluetooth mode.
12.1 Usba ang Bluetooth Mode
Deskripsyon
Usba ang Bluetooth mode: Manwal, Awtomatiko, Bisita, Nabaldado.
Pangayo
/audiomodes?bluetoothAutoplay=value
| Parameter | Deskripsyon |
|
bluetoothAutoplay |
Bluetooth mode bili Ang 0 nagpasabut nga Manwal, 1 nagpasabut nga Awtomatiko, 2 nagpasabut nga Bisita, 3 nagpasabut nga Baldado. |
Walay tubag
Example
Hangyo: http://192.168.1.100:11000/audiomodes?bluetoothAutoplay=3 aron ma-disable ang bluetooth
Apendise
13.1 Lenbrook Service Discovery Protocol
Pasiuna
Ang mga sikat nga pamaagi sa pagdiskobre sama sa mDNS ug SSDP naggamit ug nagsalig sa komunikasyon sa multicast sa UDP. Kadaghanan sa karon nga mga produkto sa Lenbrook naggamit sa mDNS alang sa pagkadiskobre. Ikasubo nga among nakit-an nga daghang mga kostumer ang adunay mga network sa balay diin ang trapiko sa multicast dili molihok sa husto ug ang among mga aparato dili madiskubre nga kasaligan. Nagresulta kini sa daghang mga pagbalik sa produkto ug mga reklamo gikan sa among mga distributor.
Aron matubag kini nga isyu naghimo kami usa ka naandan nga protocol sa pagdiskobre nga gitawag nga LSDP nga naggamit sa broadcast sa UDP. Gipakita sa inisyal nga pagsulay nga mas kasaligan kini kaysa pagdiskobre nga nakabase sa mDNS.
Natapos ang Protocolview
Usa ka tumong niini nga protocol mao nga medyo simple. Mahimo kini gamiton sa mga naka-embed nga aparato nga adunay limitado nga memorya.
Ang protocol naggamit sa tanang UDP broadcast packets paingon ug gikan sa UDP port 11430. Kini nga pantalan narehistro na sa IANA ug gi-assign sa Lenbrook para sa LSDP nga paggamit sukad sa Marso 27, 2014.
Sa makanunayon nga kahimtang ang matag node nga adunay serbisyo sa pag-anunsyo nagsibya usa ka Ipahibalo nga mensahe hapit matag minuto.
Sa pagsugod ug kung ang lista sa serbisyo o mga parameter sa network nagbag-o pito ka mga pakete kinahanglan nga i-broadcast sa mugbo nga mga agwat aron tugutan ang una nga pagdiskobre ug mga pagbag-o nga mokaylap sa mas paspas. Alang sa mga serbisyo sa advertising sa node kining inisyal nga pito ka mga pakete kinahanglan nga maglakip sa usa ka mensahe sa Pagpahibalo. Alang sa mga node nga naningkamot sa pagdiskubre sa mga serbisyo ang inisyal nga pito ka mga pakete maglakip sa usa ka mensahe sa Pangutana. Alang sa mga serbisyo nga wala na magamit ang pito ka mga pakete kinahanglan nga maglakip sa usa ka Delete nga mensahe.
Kini nga mga inisyal nga pakete gipadala pito ka beses tungod sa dili kasaligan nga kinaiya sa mga pakete sa UDP. Sa dili posible nga kaso ang tanan nga pito ka pakete nga napakyas nga mga serbisyo madiskubre gihapon pagkahuman sa usa ka minuto gikan sa usa ka minuto nga periodic Ipahibalo ang mga mensahe.
Kung ang usa ka node makadawat usa ka mensahe sa Pangutana alang sa usa ka klase sa serbisyo kini nag-anunsyo kini motubag sa usa ka mensahe sa Pagpahibalo pagkahuman sa usa ka mubo nga random nga paglangan sa oras ug i-reset ang karon nga oras sa Pagpahibalo.
Ang packet header ug ang tanan nga mga bloke sa mensahe naglakip sa gitas-on nga mga natad. Naghatag kini og dugang nga pagka-flexible ug nagtugot sa mga pagbag-o nga nahiuyon sa atras nga mahimo sa umaabot. Ang mga dugang nga natad o mga tipo sa mensahe mahimong idugang sa umaabot nga mahimo’g laktawan sa mga tigulang nga pagpatuman kung mag-parse. Kung nakahukom kami nga maghimo usa ka paatras nga dili magkatugma nga pagbag-o adunay usa usab nga natad sa bersyon sa header sa packet nga mahimong madugangan.
Gitugotan usab sa protocol ang mga rekord sa TXT nga maapil sa mga paanunsiyo sa serbisyo nga parehas sa gigamit nga mga rekord sa TXT
uban sa mDNS. Naghatag kini og mahinungdanong pagka-flexible alang sa dugang nga arbitraryong meta data nga iapil sa serbisyo
mga paanunsiyo nga wala usba ang protocol.
Mga Detalye sa Protocol
Tayming
Ang tanan nga mga pakete nga gipadala kinahanglan nga naka-iskedyul nga adunay random nga timing o mga paglangan aron makatabang nga malikayan ang pagbangga.
- Pagsugod sa Packet Timing: 7 Packet sa panahon = [0, 1, 2, 3, 5, 7, 10s] + (0 ngadto sa 250ms random). Kini mao ang hingpit nga mga panahon, dili mga paglangan. Ang tanang 7 ka pakete kinahanglang ipadala sulod sa mga 10 segundos.
- Panguna nga Panahon sa Pagpahibalo: 57s + (0 hangtod 6s random)
- Paglangan sa Tubag sa Pangutana: (0 hangtod 750ms random)
Node ID
Ang matag node kinahanglan adunay usa ka talagsaon nga ID nga magamit sa pag-ila sa node. Ang talagsaon nga ID gilakip sa Ipahibalo ug Pagtangtang sa mga mensahe. Mahimong gamiton sa mga kliyente kini nga kantidad isip panguna nga yawe kung nag-cache sa mga kantidad ug aron mailhan ang usa ka node. Kining talagsaon nga ID mahimong usa ka MAC address apan kinahanglan nga pareho sa matag interface kung ang usa ka node adunay daghang mga interface diin kini gi-advertise.
Istruktura sa Pakete
Ang matag pakete magsugod sa usa ka packet header nga gisundan sa usa ka arbitraryong gidaghanon sa mga bloke sa mensahe. Ang matag block sa mensahe magsugod sa usa ka gitas-on nga field aron ang dili mailhan nga mga mensahe mahimong laktawan. Gawas kung gipiho ang tanan nga mga kantidad sa multi-byte nga numero itago nga dako nga endian (una ang labing hinungdanon nga mga byte). Gawas kung gipiho ang tanan nga mga numero dili pirmahan nga mga kantidad. Kay exampAng usa ka byte nga gitas-on mahimong adunay mga kantidad nga 0 hangtod 255.
Packet Header
| Natad | Bytes | Deskripsyon |
| Gitas-on | 1 | Kinatibuk-ang gitas-on sa header lakip niini nga field. |
| Madyik nga Pulong | 4 | Kini nga field mao ang upat ka ASCII bytes sa "LSDP". Kini makatabang kanato sa pag-ila sa mga pakete ingon nga gituyo alang sa paggamit mao nga kita dili kinahanglan nga mosulay sa pag-parse random data gikan sa pipila ka wala damha nga tinubdan. |
| Bersyon sa Protocol | 1 | Bersyon sa protocol. Kung ang umaabot nga mga pagbag-o gihimo sa protocol nga pabalik nga dili tugma sa kini nga bersyon |
| Natad | Bytes Deskripsyon | |
| mausab. Ang kasamtangan nga bersyon mao ang 1. | ||
Mensahe sa Pangutana
| Natad | ||
| Bytes | Deskripsyon | |
| Gitas-on | 1 | Kinatibuk-ang gitas-on sa mensahe lakip niini nga field. |
| Type sa Mensahe | 1 | "Q" = 0x51: Standard nga pangutana alang sa tubag sa sibya. "R" = 0x52: Pangutana alang sa unicast nga tubag. |
| Ihap | 1 | Gidaghanon sa mga klase nga pangutan-on. |
| Klase 1 | 2 | 16 bit (2 byte) nga identifier sa klase. |
| … | Balika ang miaging field para sa matag dugang nga klase. | |
Ipahibalo ang Mensahe
Ipahibalo ang Header
| Natad | ||
| Bytes | Deskripsyon | |
| Gitas-on | 1 | Kinatibuk-ang gitas-on sa mensahe lakip ang kompletong announce header ug announce records. |
| Type sa Mensahe | 1 | “A” = 0x41 |
| Node ID Gitas-on | 1 | Ang gitas-on sa field sa Node ID. |
| Node ID | Variable | Talagsaon nga Node ID sa node nga nagpadala sa pahibalo. Kasagaran kini ang MAC address sa usa sa mga interface sa node. |
| Gitas-on sa Address | 1 | Gitas-on sa Address field. Alang sa IPv4 kini mahimong 4. |
| Natad | ||
| Bytes | Deskripsyon | |
| Address | Variable | IP address sa node. |
| Ihap | 1 | Gidaghanon sa mga rekord sa pagpahibalo nga sundon. |
Ipahibalo ang Rekord
| Natad | Bytes | Deskripsyon |
| Klase | 2 | 16 bit (2 byte) nga identifier sa klase. |
|
Ihap sa TXT |
1 |
Gidaghanon sa mga rekord sa TXT nga sundon. Kung sero ang mga musunod nga mga uma wala iapil. |
| Yawe 1 Gitas-on | 1 | Gitas-on sa yawe nga ngalan. |
| Yawe 1 | Variable | Ngalan sa yawe. |
| Bili 1 Gitas-on | 1 | Gitas-on sa bili nga teksto. |
| Bili 1 | Variable | Teksto sa bili. |
|
… |
Balika ang miaging 4 ka field para sa matag dugang nga TXT record. |
Pagtangtang sa Mensahe
| Natad | ||
| Bytes | Deskripsyon | |
| Gitas-on | 1 | Kinatibuk-ang gitas-on sa mensahe lakip niini nga field. |
| Type sa Mensahe | 1 | “D” = 0x44 |
| Node ID Gitas-on | 1 | Ang gitas-on sa field sa Node ID. |
| Node ID | Variable | Talagsaong Node ID sa node nga nagpadala sa mensahe. Kasagaran kini ang MAC address sa usa sa mga node |
| Natad | ||
| Bytes | Deskripsyon | |
| mga interface. | ||
| Ihap | 1 | Gidaghanon sa mga klase nga sundon. |
| Klase 1 | 2 | 16 bit (2 byte) nga identifier sa klase. |
| … | Balika ang miaging field para sa matag dugang nga klase. | |
Mga Assignment sa Class ID
| Class ID | Deskripsyon | Katumbas sa mDNS |
| 0x0001 | BluOS Player | _musc._tcp |
| 0x0002 | BluOS Server | _muss._tcp |
| 0x0003 | BluOS Player (secondary sa multi-zone players sama sa CI580) | _musp._tcp |
| 0x0004 | sovi-mfg gigamit alang sa manufacturing testing. | _sovi-mfg._tcp |
| 0x0005 | sovi-keypad | _sovi-keypad._tcp |
| 0x0006 | BluOS Player (pares nga ulipon) | _musz._tcp |
| 0x0007 | Hilit nga Web App (AVR OSD Web Panid) | _hilit nga-web-ui._tcp |
| 0x0008 | BluOS Hub | _mush._tcp |
| 0xFFFF | Tanan nga Klase - Mahimo gamiton sa Query Message. |
Nota 1:
Ang kinatibuk-ang pakete sa LSDP kinahanglan nga isipon nga binary data.
Nota 2:
Kung ang usa ka Mensahe sa Pagpahibalo dili makakupot sa tanan nga impormasyon sa mga node (labi na sa CI580), mabahin kini sa 2 o daghan pa nga Mga Mensahe sa Pagpahibalo sa matag Mensahe nga adunay sulud nga Header ug Record ug ang matag Mensahe adunay tibuuk nga (mga) impormasyon sa node.
BluOS Custom Integration API Bersyon 1.7
Mga Dokumento / Mga Kapanguhaan
![]() |
BluOS T 778 Custom Integration API [pdf] Manwal sa Gumagamit T 778, T 778 Custom Integration API, T 778, Custom Integration API, Integration API, API |
