API Comhtháthaithe Saincheaptha
API Comhtháthaithe Saincheaptha T 778
Is le Lenbrook Industries an fhaisnéis atá sa lámhleabhar seo.
Tá sé beartaithe go heisiach le haghaidh úsáide gairmiúla. Ní ghlacann Lenbrook Industries aon fhreagracht as cruinneas an phrótacail. Cuirtear an prótacal ar fáil “mar atá”, leis na lochtanna go léir agus gan aon bharántas de chineál ar bith, bíodh sé sainráite ná intuigthe.
Polasaí Úsáide API
Trí rochtain a fháil ar na APIanna, aontaíonn tú leis an mBeartas Úsáide API seo (an “Beartas”) agus lenár dTéarmaí. Soláthraímid na APIanna seo chun ligean do chuideachtaí agus do dhaoine leas a bhaint as ár Seirbhís trí bhogearraí, seirbhísí nó modúil a chruthú a nascann lenár n-ardán nó a bhfuil rochtain acu ar na sonraí laistigh dár n-ardán trí ár n-APIanna (“Comhtháthú”). Is cuid dár dTéarmaí an Beartas seo agus déileálfar leis mar sin.
Cuirtear an bogearra ar fáil “MAR ATÁ”, gan aon bharántas de chineál ar bith, sainráite ná intuigthe, lena n-áirítear ach gan a bheith teoranta dóibh barántais indíoltachta, oiriúnachta chun críche áirithe agus neamhshárú. Ní bheidh na húdair ná sealbhóirí cóipchirt faoi dhliteanas in aon chás as aon éileamh, damáistí, nó dliteanas eile, bíodh sé i ngníomh conartha, Tort nó eile, a eascraíonn as, as nó i ndáil leis an mbogearra nó úsáid nó déileálacha eile sna bogearraí.
Úsáid Cheadaithe
Ní fhéadfaidh tú an API a úsáid chun turscar a sheoladh ná aon ghníomhartha a dhéanamh a sháraíonn ár mBeartas Úsáide Inghlactha agus ár dTéarmaí Caighdeánacha Úsáide. Comhlíonfaidh tú na dlíthe uile is infheidhme (lena n-áirítear dlíthe príobháideachta agus dlíthe rialaithe onnmhairí na Stát Aontaithe, GPR agus rialacháin Eorpacha agus dlíthe agus rialacháin smachtbhannaí eacnamaíocha). Leanfaidh tú an doiciméadacht uile a chuirimid ar fáil do na APInna. Ní dhéanfaidh tú iarracht an chaoi a bhfeidhmíonn an tSeirbhís a hackáil ná a athrú. Féadfaimid monatóireacht a dhéanamh ar d’úsáid de na APInna chun na rialacha seo a chomhlíonadh, agus féadfaimid rochtain ar an API a dhiúltú duit má sháraíonn tú an Beartas seo.
Príobháideacht
Do Ní mór don chomhtháthú polasaí príobháideachta a thaispeáint d’úsáideoirí ina sonraítear an fhaisnéis a bhaileoidh tú uathu nuair a úsáideann siad an Comhtháthú. Ní bheidh rochtain agat ar shonraí úsáideora ach a mhéid a cheadaíonn an t-úsáideoir agus a mhínítear i do pholasaí príobháideachta. Ní mór duit sonraí úsáideora a scriosadh láithreach má iarrann an t-úsáideoir scriosadh nó má fhoirceannann sé a gcuntas leat.
Slándáil
Cuirfidh tú bearta slándála teicniúla agus eagraíochtúla iomchuí i bhfeidhm agus coinneoidh tú iad chun slándáil, sláine agus rúndacht na sonraí a chosaint agus a chaomhnú. Cuirfidh na bearta slándála seo cosc ar rochtain neamhúdaraithe nó nochtadh sonraí pearsanta nó rúnda a phróiseálann tú.
Úinéireacht
Is linne na cearta, na teidil agus na leasanna uile sa tSeirbhís agus sna APIanna, lena n-áirítear na cearta maoine intleachtúla, na marcanna, an cód agus na gnéithe uile. Ní dhéanfaidh tú sárú, innealtóireacht droim ar ais, ná cóipeáil ar ár gcód, ár ndearadh ná ár n-ábhar. Ní bheidh rochtain agat ar ár APIanna chun dul san iomaíocht lenár Seirbhís. Coinnítear siar aon chearta nach ndeonaítear go sainráite leis an mBeartas seo, mar sin mura bhfeiceann tú anseo é, ní ceart é atáimid ag tabhairt duit.
Úsáid Marcanna
Ní fhéadfaidh tú ár n-ainm ná ár marcanna (is é sin ár lógónna, ár mbrandaí agus ár n-íomhánna cóipchirt) a úsáid ar aon bhealach. Ní fhéadfaidh tú aon fhógraí dílseánaigh inár marcanna a athrú ná a bhaint. Ní úsáidfidh tú ár n-ainm ná ár marcanna i d'ainm ná i lógó d'Idirghabhála, ná ar aon bhealach a thugann le fios go bhfuil formhuiniú againne ann.
Úsáid Phraiticiúil na Marcanna
Míníonn na treoirlínte seo conas ba chóir duit ár n-ainm, ár marcanna agus ár sócmhainní branda a úsáid go praiticiúil i gcónaí. Léiríonn d’úsáid go nglacann tú leis na treoirlínte seo, agus tuigeann tú go mbeidh deireadh uathoibríoch le do chead chun ár n-ainm, ár marcanna agus ár sócmhainní branda a úsáid mar thoradh ar d’úsáid a sháraíonn na treoirlínte seo.
- Ní mór úsáid ár n-ainm, ár marcanna agus ár sócmhainní branda a údarú go sainráite i scríbhinn.
- Ná hathraigh, ná modhnaigh, ná saobh, ná cóipeáil ná ná déan aithris ar ár Sócmhainní Branda ar aon bhealach, lena n-áirítear an dath a athrú, iad a rothlú agus/nó a shíneadh. Is é sin le rá, ní mór ár Sócmhainní Branda a choinneáil ina bhfoirmeacha bunaidh.
- Ná tabhair suntasacht mhíchuí dár n-ainm, dár marcanna ná dár sócmhainní branda i gcomparáid le d’ainm agus do lógó.
- Ná taispeáin ár n-ainm, ár marcanna, agus ár sócmhainní branda in aice le margaíocht iomaíoch, ná in aon chineál margaíochta iomaíoch, gan ár dtoiliú sainráite.
- Ní féidir le d’úsáid tomhaltóirí a chur amú maidir lenár n-urraíocht ar do chuideachta nó ar do tháirgí nó do sheirbhísí, lenár gcleamhnas nó lenár dtacaíocht dóibh.
- Is lenár maoin eisiach ár n-ainm, ár marcanna agus ár sócmhainní branda. Is chun ár leasa amháin a bheidh aon dea-thoil a eascraíonn as d’úsáid. Ní dhéanfaidh tú aon ghníomh atá contrártha lenár gcearta ná lenár n-úinéireacht.
- Ní mór ár n-ainm, ár marcanna agus ár sócmhainní branda a úsáid ar bhealach measúil agus ní fhéadfar iad a úsáid ar bhealach a dhéanann dochar dúinn féin, dár dtáirgí, nó dár seirbhísí, ná ar bhealach a laghdaíonn nó a dhéanann dochar eile, dar linne, dár gcáil nó don dea-thoil atá inár n-ainm, inár marcanna agus inár sócmhainní branda. Is é sin le rá, ná ceangail ár sócmhainní le haon ghníomhaíochtaí mídhleathacha nó mídhleathacha agus ná bain úsáid astu ar bhealach atá mealltach nó díobhálach.
Exampúsáid inghlactha:
“[AINM DO THÁIRGE] (comhoiriúnach le / oibríonn le BluOS)”
Exampúsáid neamhghlactha
“[AINM DO THÁIRGE] – BluOS”
“BluOS – [AINM DO THÁIRGE]”
“[AINM DO THÁIRGE] – Cumhachtaithe le BluOS”
Margaíocht agus Preasráitis
Tar éis d’iarratas a bheith ceadaithe, féadfar é a liostáil ar ár suíomh Gréasáin. web airíonna. Go ginearálta ní chomhfhoilseoimid preasráitis ná ní chuirfimid le comh-mhargaíocht d’iarratais.
Sula scaipeann tú preasráiteas faoi d’aip, déan cinnte go dtéann tú i dteagmháil linn ag [EMAIL]. Má tá tú ag lua BluOS, beidh orainn a athrá.view an preasráiteas. Molaimid duit teagmháil a dhéanamh linn le do phreasráiteas deiridh a luaithe is féidir.
Séanadh
A mhéid is a cheadaítear faoin dlí, soláthraímid na APIanna mar atá. Ciallaíonn sé sin nach dtugaimid barántais d'aon chineál, bíodh siad sainráite ná intuigthe, lena n-áirítear, ach gan a bheith teoranta dóibh, indíoltacht agus oiriúnacht chun críche áirithe.
Nuashonruithe
Féadfaimid na APIanna agus an Polasaí seo a nuashonrú nó a mhodhnú ó am go ham trí na hathruithe a phostáil ar an suíomh seo nó trí fhógra a thabhairt duit trí ríomhphost. Féadfaidh na hathruithe seo difear a dhéanamh d’úsáid na nAPIanna nó don chaoi a n-idirghníomhaíonn do Chomhtháthú leis an API. Má dhéanaimid athrú nach nglacann tú leis, ba chóir duit scor de na APIanna a úsáid.
Rúndacht
Féadfaidh rochtain a bheith agat ar fhaisnéis rúnda, dílseánaigh agus neamhphoiblí a bhaineann go sonrach leis na APIanna (“Faisnéis Rúnda”). Ní fhéadfaidh tú an fhaisnéis seo a úsáid ach amháin chun tógáil leis na APIanna. Ní nochtfaidh tú an Fhaisnéis Rúnda d’aon duine gan ár dtoiliú i scríbhinn, agus cosnóidh tú an Fhaisnéis Rúnda ó úsáid agus nochtadh neamhúdaraithe ar an mbealach céanna a chosnófá d’fhaisnéis rúnda féin.
Slánú
Tabharfaidh tú slánaíocht dúinn féin agus dár bhFoireann ó aon chaillteanais (lena n-áirítear táillí aturnae) a eascraíonn as éilimh tríú páirtí a bhaineann le d’úsáid den API.
An Chuid Eile
Ní chruthaíonn an Polasaí seo aon chomhpháirtíocht, gníomhaireacht ná comhfhiontar, ná ní thugann sé le fios go bhfuil aon chomhpháirtíocht, gníomhaireacht ná comhfhiontar ann. Beidh feidhm ag an Polasaí seo fad a úsáideann tú na APIanna nó go dtí go gcuirfear deireadh leis de réir ár dTéarmaí. I gcás coinbhleachta idir an Polasaí seo agus na Téarmaí Caighdeánacha Úsáide, beidh forlámhas ag na Téarmaí Caighdeánacha Úsáide.
©2025 LENBROOK INDUSTRIES TEORANTA
633 Granite Court, Pickering, Ontario, Ceanada L1W 3K1
Gach ceart ar cosaint
Ní fhéadfar aon chuid den fhoilseachán seo a atáirgeadh, a stóráil ná a tharchur in aon fhoirm gan cead i scríbhinn ó Lenbrook Industries Limited. Cé gur rinneadh gach iarracht a chinntiú go bhfuil an t-ábhar cruinn tráth a fhoilsithe, féadfaidh gnéithe agus sonraíochtaí a bheith faoi réir athraithe gan fógra.
| Stair Athbhreithnithe | ||
| Leagan | Dáta | Cur síos |
| 1.0 | 6/17/2019 | An chéad eisiúint |
| 1.2 | 01/12/2022 | Cuireadh atosú bog, cling clog dorais, toirt suas/síos, rian a bhogadh sa scuaine, agus orduithe ionchuir dhírigh leis. Cuireadh nóta leis an Aguisín LSDP. |
| 1.4 | 04/26/2022 | Cuireadh ordú balbhaithe leis; modhnaíodh orduithe ionchuir dhírigh don HUB; nuashonraíodh an t-ordú Seinn chun fuaim saincheaptha sruthaithe a sheinm. |
| 1.5 | 07/18/2022 | Cuireadh ordú Bluetooth leis; Nuashonraíodh LSDP chun rang 5 a chur le rang 8; Cuireadh “Úsáid Phraiticiúil Marcanna” leis i mBeartas Úsáide API. |
| 1.6 | 03/13/2024 | Cuireadh nóta leis le haghaidh /Stádas d'imreoirí grúpáilte i roinn 2; Cuireadh leis /Seinn?lorg=soicind is=trackid in alt 4.1; |
| 1.7 | 04/09/2025 | Roinn 8.3 nuashonraitheampCuireadh iarratas brabhsála roghchláir chomhthéacs inlíne leis exampi roinn 7.1; Cuireadh ordú nua roghnúcháin ionchuir dhírigh leis i roinn 11.2; Nuashonraíodh roinn 6.1 chun tréith “íomhá” a chur leis le haghaidh réamhshocruithe; Cuireadh trácht “followRedirects=1” leis do gach tréith íomhá; Nuashonraíodh an míniú ar imirt tréitheURL agus cuir leis anois i roinn 7.1 |
Réamhrá
Is córas oibriúcháin agus bogearraí bainistíochta ceoil chun cinn é BluOS™ a ligeann duit rochtain a fháil ar cheol gan chailliúint agus é a shruthú suas le 24-giotán/192kHz chuig gach seomra ag baint úsáide as do líonra baile. Is féidir BluOS a fháil i dtáirgí ó Bluesound, NAD Electronics, Cainteoirí DALI agus cinn eile.
Cruthaíodh an doiciméad seo chun cabhrú le forbróirí agus le comhtháthóirí córas atá ag obair i margadh an chomhtháthaithe saincheaptha (CI). Tá fo-thacar de na hiarratais API atá doiciméadaithe i bPrótacal Rialaithe API BluOS iomlán ann.
Seoltar na hiarratais uile a bhfuil cur síos orthu sa cháipéis seo mar iarratais HTTP GET. Is caighdeán iad na paraiméadair. URL péire ainm/luach ionchódaithe. Faigheann imreoirí BluOS na horduithe seo agus freagraíonn siad ansin le sonraí XML ionchódaithe UTF-8.
Tá gach iarratas i bhfoirm http:// : / cá háit:
- Is é player_ip seoladh IP an seinnteora BluOS (m.sh., 192.168.1.100)
- Is é an port an port TC a úsáidtear le haghaidh cumarsáide. Úsáidtear port 11000 do gach seinnteoir BluOS, seachas an CI580. Tá ceithre nód sruthlaitheora ag an CI580 i chassis amháin, áit a n-úsáideann nód 1 port 11000, úsáideann nód 2 port 11010, úsáideann nód 3 port 11020, agus úsáideann nód 4 port 11030. Ba cheart an port iarbhír atá le húsáid a aimsiú trí úsáid a bhaint as an bprótacal MDNS ag baint úsáide as na seirbhísí musc.tcp agus musp.tcp.
- is é an t-iarratas an t-ordú nó an fiosrúchán iarbhír de chuid BluOS (m.sh., Seinn)
Nóta: Úsáidfidh an doiciméad seo http://192.168.1.100:11000 mar IP agus port an imreora i ngach sean-amples.
Fiosrúcháin Stádais
Úsáidtear fiosrúcháin stádais chun fiosrúcháin a dhéanamh ar imreoir BluOS.
Cuireann BluOS dhá mheicníocht ar fáil chun fiosrúcháin stádais a dhéanamh; pobalbhreith rialta agus pobalbhreith fhada. Tugann pobalbhreith rialta toradh an fhiosrúcháin ar ais láithreach. Coinníonn pobalbhreith fhada nasc ar feadh tréimhse sonraithe, agus ní thugann sí toradh fiosrúcháin ar ais ach amháin nuair a athraíonn an fhaisnéis nó nuair a théann an t-am thart. Is féidir le pobalbhreith fhada líon na nglaonna chuig imreoir a laghdú go mór.
Nuair nach bhfuil painéalú fada in úsáid, ba cheart do chliaint a ráta painéalaithe a theorannú go dtí iarratas amháin ar a mhéad gach 30 soicind. Nuair a bhíonn painéalú fada in úsáid, ní mór do chliant dhá iarratas as a chéile a dhéanamh don acmhainn chéanna atá níos lú ná soicind amháin óna chéile, fiú má fhilleann an chéad iarratas i níos lú ná soicind amháin.
Glacann iarratais vótaíochta fada dhá pharaiméadar: am scoir agus etag. is é an teorainn ama fad an iarratais ar vótaíocht fhada agus etag tógtha ón bhfreagra roimhe seo (tréith i bhfréamh-eilimint an fhreagra).
Go ginearálta, ní gá ach poll fada a bheith gníomhach do cheann amháin de /Status nó /SyncStatus. Cuimsíonn an freagra /Status eilimint ( ) a léiríonn an bhfuil /SyncStatus athraithe. Ba chóir /SyncStatus a fhiosrú mura bhfuil suim ach in ainm, toirt agus stádas grúpála imreora. Ba chóir /Status a fhiosrú más gá an stádas athsheinm reatha.
Nuair a bhíonn imreoirí grúpáilte, is é an príomhimreoir an príomhimreoir sa ghrúpa. Bíonn na himreoirí tánaisteacha ceangailte leis an bpríomhimreoir. /Is cóipeanna de fhreagra an phríomhimreoir iad freagraí an tánaistigh. /SyncStatus Tá pobalbhreith fhada riachtanach ansin chun toirt gach imreora tánaistigh a rianú.
2.1 Stádas Athsheinm
Cur síos
Déanann an críochphointe /Status fiosrúcháin ar fhaisnéis faoi thoirt agus athsheinm. Tugann an fiosrúchán seo go leor tréithe freagartha ar ais,
cuid acu nach bhfuil infheidhme maidir leis an doiciméad seo. Ba chóir neamhaird a dhéanamh ar fhreagraí neamhdhoiciméadaithe.
Iarratas
/Stádas?timeout=soicindí&etag=etag-luach
| Paraiméadair | Cur síos |
| am istigh | Paraiméadar roghnach a úsáidtear le pobalbhreith fhada. Is é 100 soicind an t-eatramh pobalbhreithe molta agus ba chóir é a theorannú go ráta 60 soicind nó mar sin agus gan a bheith níos tapúla ná 10 soicind riamh. |
| etag | Paraiméadar roghnach a úsáidtear le poll fada. Seo é an etag tréith ón |
| Paraiméadair | Cur síos |
| freagra glaonna roimhe seo /Stádas. |
Freagra
<status etag=”4e266c9fbfba6d13d1a4d6ff4bd2e1e6″>
÷ (Sómasach)
Ed Sheeran
fíor
1
159
Deezer:142986206
/Saothar Ealaíne?service=Deezer&songid=Deezer%3A142986206
0
187
1
Foirfe
1054
0
320000
2
Deezer
/Foinsí/íomhánna/DeezerIcon.png
0
8
19
sos
MP3 320 kb/s
5
Foirfe
Ed Sheeran
÷ (Sómasach)
263
4
35
NÓTA: Níl gach tréith freagartha liostaithe sa chairt seo a leanas. D’fhéadfadh eilimintí eile a bheith i láthair agus ba chóir neamhaird a dhéanamh orthu.
| Tréithe Freagartha | Cur síos |
| etag | Tréith den eilimint fréimhe freagartha. Luach teimhneach a úsáidtear le pobalbhreith fhada chun athruithe freagartha a bhrath. Mura bhfuil an luach athraithe ó tugadh an freagra roimhe sin, ráthaítear nach bhfuil an freagra athraithe (ach féach freisin na hailt thíos). |
| soicindí aláraim atá fágtha | Más toradh aláraim atá ar an athsheinm, seo an líon soicind sula stopfaidh sé. |
| gníomh | Féach ar an rannán Gníomhartha le haghaidh Stáisiúin Raidió a Shruthú le haghaidh cur síos. |
| albam | Ainm albaim an rian reatha atá gníomhach. Féach freisin tréith title1. |
| ealaíontóir | Ainm ealaíontóra an riain ghníomhaigh reatha. Féach freisin tréith title1. |
| ceallraí | Taispeántar é seo má tá pacáiste ceallraí ag an imreoir. Áirítear leis na tréithe seo a leanas: · leibhéal – staid an luchta, céatadán · ag muirearú – 1 má tá sé á mhuirearú faoi láthair · deilbhín – URL íomhá an imreora a léiríonn an staid reatha muirir |
|
is féidirBogadhSheinm |
Is fíor é seo más féidir an t-ábhar atá ag seinm faoi láthair nó atá ar sos a bhogadh chuig imreoir eile. |
|
is féidirSearch |
Más 1 é, is féidir an rian reatha a bhrabhsáil, sa raon 0..totlen, trí úsáid a bhaint as an bparaiméadar cuardaigh go /Seinn. Mar shamplaample: /Seinn?lorg=34. |
| db | Leibhéal toirte i dB. |
| Ainm an ghrúpa | Ainm an ghrúpa. Ní mór don imreoir a bheith ar an bpríomhimreoir sa ghrúpa. |
| Imleabhar grúpa | Leibhéal toirte an ghrúpa. Ní mór don imreoir a bheith ar an bpríomhimreoir sa ghrúpa. |
| íomhá | URL den íomhá a bhaineann leis an bhfuaim reatha (albam, stáisiún, ionchur, srl.). Má |
| Tréithe Freagartha | Cur síos |
| an URL má thosaíonn sé le /Artwork, d’fhéadfadh sé go mbeadh atreorú mar thoradh air. Paraiméadar/eochair á chur leis leanAthsheoltaí=1 agus an íomhá á haisghabháil is féidir atreorú a sheachaint. | |
| balbh | Stádas balbhaithe. Socraigh go 1 má tá an toirt balbhaithe. |
| balbhDb | Má tá an seinnteoir múchta, ansin tá an toirt neamh-mhúchta in dB ann. |
| TostFuaim | Más rud é go bhfuil sé múchta, ansin tá an leibhéal toirte neamh-mhúchta ann. Tá na luachanna ó 0 go 100. |
| ainm | Teideal an rian fuaime atá á sheinm faoi láthair. Féach freisin ar an tréith title1. |
| fógra a thabhairturl | URL le haghaidh fógra aníos. |
| id | An uimhir uathúil don scuaine súgartha. Meaitseálann sé an tréith id den fhreagra /Playlist. Má athraítear an scuaine súgartha, athróidh an uimhir seo. |
| réidh | An uimhir aitheantais réamhshocraithe uathúil. Meaitseálann sé an tréith prid sa fhreagra /Presets. Má athraítear réamhshocrú, athróidh an uimhir seo rud a léiríonn gur cheart aon fhreagra taisceáilte ar /Presets a ghlanadh. |
| cáilíochta | Cáilíocht fuaime an fhoinse atá á seinm: · cd – fuaim gan chailliúint ag caighdeán CD · hd – fuaim gan chailliúint le réiteach níos airde ná caighdeán CD nó sampráta le de 88200 sampníos lú/s nó níos mó · dolbyAudio – DolbyDigital nó AC3 · mqa – fuaim MQA bailí díchódaithe · mqaAuthored – fuaim bhailí MQA-Authored díchódaithe Is é luach uimhriúil an ráta giotán garbh de cháilíocht foinse fuaime comhbhrúite den file. |
|
athuair |
0, 1, nó 2. Ciallaíonn 0 scuaine athsheinm, ciallaíonn 1 rian a athdhéanamh, agus ciallaíonn 2 athdhéanamh múchta |
| soic | Líon na soicindí a seinntear an rian fuaime reatha. Ní úsáidtear an luach seo agus e á ríomh.tag agus ní bheidh dul chun cinn ina chúis leis féin go dtarlóidh glao fada-phoillithe. Ceanglaítear ar chliaint an suíomh athsheinm a mhéadú, nuair a bhíonn an stát ina sheinm nó ina shruth, bunaithe ar an eatramh ó tugadh an freagra. |
| seirbhíse | Aitheantas seirbhíse an fhuaime reatha. Ní luach é seo le taispeáint i gcomhéadan úsáideora, mar go bhfuil an |
| Tréithe Freagartha | Cur síos |
| D’fhéadfadh an teaghrán iarbhír a bheith difriúil ó ainm oifigiúil na seirbhíse. | |
| Deilbhín Seirbhíse | URL den deilbhín seirbhíse reatha. |
| suaitheadh | 0 nó 1. Ciallaíonn 0 go bhfuil an suaitheadh múchta agus ciallaíonn 1 go bhfuil an suaitheadh ar siúl. |
| codladh | Na nóiméid atá fágtha sula ngníomhaítear an lasc ama codlata. |
| amhrán | Suíomh an riain reatha sa scuaine imeartha. Féach freisin ar an sruthUrl. |
| stáit | Stádas reatha an imreora. D’fhéadfadh sé a bheith ina sheinm, sos, stad, sruthú, ceangal, srl. Is féidir /Play a úsáid chun atosú nuair atá sé i riocht sos ach ní nuair atá sé i riocht stad. Ba cheart a mheas go bhfuil an bhrí chéanna ag imirt agus sruth. Féach freisin sruthUrl. |
|
stáisiúnÍomhá |
URL i gcás íomhá stáisiúin raidió, más stáisiún raidió an fhuaim reatha, m.sh., raidió Deezer. D’fhéadfadh sé a bheith mar an gcéanna le híomhá. |
| FormáidSrutha | Formáid an fhuaime. |
| sruthUrl | Ba chóir déileáil le láithreacht an eilimint seo mar bhratach agus a bhfuil ann mar luach teimhneach. Má tá sé i láthair, léiríonn sé: · ní foinse an fhuaime reatha an scuaine imeartha (níl baint ag an amhrán leis) · níl baint ag suaitheadh agus athrá le chéile agus ba chóir iad a bhaint as aon chomhéadan úsáideora más féidir · níl an chéad cheann eile ná an ceann roimhe seo ar fáil (ach féach freisin gníomhartha) |
| sioncrónúStat | An aitheantas uathúil chun aon athrú ar an bhfreagra /SyncStatus a léiriú. Meaitseálann sé an tréith syncStat den fhreagra /SyncStatus. Athraíonn sé aon uair a bhíonn athrú ar an Stádas Sioncrónaithe. |
| teideal1 | An chéad líne eolais a chuireann síos ar an bhfuaimrian reatha. teideal1, teideal2 agus teideal3 NÍ MÓR é seo a úsáid mar théacs aon chomhéadain úsáideora a thaispeánann trí líne de mheiteashonraí atá ag seinm faoi láthair. Ná húsáid luachanna ar nós albam, ealaíontóir agus ainm. |
| teideal2 | An dara líne faisnéise a chuireann síos ar an bhfuaim reatha. |
| teideal3 | An tríú líne faisnéise a chuireann síos ar an bhfuaim reatha. |
| tólán | Fad iomlán an riain reatha, i soicindí. |
| teideal_dhálíne1 | An chéad líne de dhá líne ina gcuirtear síos ar an bhfuaim reatha. NÍ MÓR twoline_title1 & twoline_title2, más ann dóibh, a úsáid mar théacs aon chomhéadain úsáideora a thaispeánann dhá cheann. |
| Tréithe Freagartha | Cur síos |
| línte meiteashonraí atá ag seinm faoi láthair. | |
| teideal_dhálíne2 | An dara ceann de dhá líne ina gcuirtear síos ar an bhfuaim reatha. |
| toirte | Leibhéal toirte an imreora i gcéatadántage; -1 ciallaíonn sé go bhfuil toirt an imreora socraithe. |
| soic | Líon na soicindí a seinntear an rian fuaime reatha. |
Example
http://192.168.1.100:11000/Status
Faigheann sé stádas athsheinm an imreora.
http://192.168.1.100:11000/Status?timeout=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Faigheann sé stádas athsheinm an imreora trí úsáid a bhaint as fadphoilliú. Ní chuirtear toradh ar ais roimh an am scoir 100 soicind ach amháin má tá stádas an imreora athraithe. Seachas sin, cuirtear an toradh ar ais tar éis 100 soicind.
2.2 Stádas Sioncrónaithe Imreora agus Grúpa
Cur síos
Tugann an fiosrúchán SyncStatus faisnéis imreora agus faisnéis grúpála imreoirí ar ais. Tugann an fiosrúchán seo go leor tréithe freagartha ar ais, agus níl cuid acu infheidhme maidir leis an doiciméad seo. Ba chóir neamhaird a dhéanamh de fhreagraí neamhdhoiciméadaithe.
Iarratas
/SyncStatus?timeout=soicindí&etag=etag-luach
| Paraiméadair | Cur síos |
| am istigh | Paraiméadar roghnach a úsáidtear le pobalbhreith fhada. Is é an t-eatramh pobalbhreithe i soicindí é. Is é 180 soicind an t-eatramh pobalbhreithe molta. |
| etag | Paraiméadar roghnach a úsáidtear le poll fada. Seo é an etag tréith ón bhfreagra glao /SyncStatus roimhe seo. |
Freagra
<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=”fíor” group=”PULSE-0278 + 2″ syncStat=”23″ id=”192.168.1.100:11000″ mac=”90:56:82:9F:02:78″> 11000
…..
NÓTA: níl gach tréith freagartha liostaithe sa chairt seo a leanas. D’fhéadfadh eilimintí eile a bheith i láthair agus ba chóir neamhaird a dhéanamh orthu.
| Tréithe Freagartha | Cur síos |
| ceallraí | Taispeántar é seo má tá pacáiste ceallraí ag an imreoir. Áirítear leis na tréithe seo a leanas: · leibhéal – staid an luchta, céatadán · ag muirearú – 1 má tá sé á mhuirearú faoi láthair · deilbhín – URL íomhá an imreora a léiríonn an staid reatha muirir |
| branda | Ainm branda an imreora. |
| db | Leibhéal toirte i dB. |
| etag | Tag den fhreagra /SyncStatus, a úsáidtear le haghaidh pobalbhreithe fada. |
| grúpa | Ainm an ghrúpa. |
| íocón | URL ina bhfuil íomhá deilbhín an imreora. |
| id | Seoladh IP agus port an imreora. |
| tosaigh | Ciallaíonn fíor go bhfuil an seinnteoir socraithe cheana féin, ciallaíonn bréagach go gcaithfear an seinnteoir a shocrú. Ní mór an seinnteoir a shocrú leis an aip Rialaitheora BluOS. |
| mac | Aitheantas uathúil an imreora don chomhéadan líonra. B’fhéidir gur seoladh MAC é. |
| máistir | Seoladh IP an phríomhimreoir. Ní bhíonn sé seo i láthair ach amháin má tá imreoir tánaisteach i ngrúpa. Tréithe: · port – uimhir an phoirt. · athcheangal – fíor má tá iarracht á déanamh athcheangal leis an bpríomhimreoir |
| samhail | Aitheantas samhail imreora. |
| samhailName | Ainm mhúnla imreora. |
| balbh | Socraigh go 1 má tá an toirt múchta. |
| balbhDb | Más rud é go bhfuil an seinnteoir ar mhúchadh, seo é an leibhéal toirte neamh-mhúchta i dB. |
| Tréithe Freagartha | Cur síos |
| TostFuaim | Más rud é go bhfuil an seinnteoir múchta, seo é an leibhéal toirte gan mhúchadh (0..100). |
| ainm | Ainm an imreora. |
| LeaganScéime | Leagan scéime bogearraí. |
| sclábhaí | Seoltaí IP imreora tánaisteacha. Ní bhíonn siad i láthair ach amháin má tá an t-imreoir mar phríomhimreoir sa ghrúpa. Is féidir go mbeadh roinnt imreoirí tánaisteacha ann. Tréithe: · id – seoladh IP · port – uimhir an phoirt |
|
sioncrónúStat |
aitheantas stádais sioncrónaithe. Athraítear é aon uair a athraítear aon mhír sa fhreagra /SyncStatus. Meaitseáil le eilimint i bhfreagra /Status. |
| toirte | Leibhéal toirte ar scála 0..100. Ciallaíonn -1 toirt sheasta. |
| chrios | Ainm an ghrúpa seasta. |
| criosMaster | Más é an t-imreoir an príomhimreoir i ngrúpa seasta, socraítear é seo go fíor. |
| criosSlave | Más imreoir tánaisteach i ngrúpa seasta an t-imreoir, socraítear é seo go fíor. |
Example
http://192.168.1.100:11000/SyncStatus
Faigheann sé stádas imreora agus grúpa an imreora.
http://192.168.1.100:11000/SyncStatus?timeout=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Faigheann sé stádas an imreora agus an ghrúpa ag baint úsáide as fad-pholling. Ní chuirtear toradh ar ais roimh an am scoir de 100 soicind ach amháin má tá stádas an imreora athraithe. Seachas sin, cuirtear an toradh ar ais ag 100 soicind.
Rialú Imleabhar
Coigeartaíonn sé leibhéal toirte imreora. Úsáidtear é freisin chun imreoir a mhúchadh.
3.1 Socraigh an Toirt
Cur síos
Déanann an iarratas seo fiosrúchán ar thoirt an imreora nó socraíonn sé é.
Tá gach cineál ordaithe, bíodh paraiméadair leibhéal 0..100, dB absalóideach nó dB coibhneasta á n-úsáid, srianta ag luachanna a eascraíonn i leibhéal laistigh den raon toirte cumraithe atá ar fáil, arb é -80..0 de ghnáth é. Is féidir an raon toirte a choigeartú ag baint úsáide as an aip Rialaitheoir BluOS, ar an leathanach Socruithe -> Imreoir -> Fuaim.
Tacaíonn an fiosrúchán le pobalbhreith fhada (nach léirítear thíos).
Iarratas
/Imleabhar
/Imleabhar?leibhéal=leibhéal&insligh_sclábhaithe=ar_as
/Imleabhar?balbh=ar_as&insigh_sclábhaithe=ar_as
/Imleabhar?abs_db=db&insl_slaves=on_off
/Imleabhar?db=delta-db&insl_slaves=ar_as
| Paraiméadair | Cur síos |
| leibhéal | Socraigh leibhéal toirte absalóideach an imreora. Is slánuimhir é ó 0 -100. |
| inis_do_sclábhaithe | Baineann sé seo le himreoirí grúpáilte. Má shocraítear é go 0, ní athraíonn ach an t-imreoir atá roghnaithe faoi láthair an toirt. Má shocraítear é go 1, athraíonn gach imreoir sa ghrúpa an toirt. |
| balbh | Má shocraítear go 0 é, cuirtear an seinnteoir ar tost. Má shocraítear go 1 é, cuirtear an seinnteoir ar neamh-thost. |
| abs_db | Socraigh an toirt ag baint úsáide as scála dB. |
| db | Déan athrú coibhneasta ar an toirt ag baint úsáide as scála toirte dB. Is féidir le db a bheith ina uimhir dhearfach nó dhiúltach. |
Freagra
<volume db=”-49.9″ mute=”0″ offsetDb=”0″ etag=”6213593a6132887e23fe0476b9ab2cba”>15</volume>
| Tréithe Freagartha | Cur síos |
| Tréithe Freagartha | Cur síos |
| db | Leibhéal toirte i dB. |
| balbh | 1 má tá an t-imreoir múchta, 0 mura bhfuil an t-imreoir múchta. |
| balbhDb | Más rud é go bhfuil an seinnteoir ar mhúchadh, seo é an leibhéal toirte neamh-mhúchta i dB. |
| TostFuaim | Más rud é go bhfuil an seinnteoir múchta, seo é an leibhéal toirte gan mhúchadh (0..100). |
| toirte | An leibhéal toirte reatha: 0..100 nó -1 le haghaidh toirte seasta. |
Example
http://192.168.1.100:11000/Volume?level=15
Socraíonn sé leibhéal toirte an imreora go 15 (as 100).
http://192.168.1.100:11000/Volume? tell_slaves=1&db=2
Méadaíonn sé toirt an phríomhimreoir 192.168.1.100, agus na n-imreoirí tánaisteacha uile sa ghrúpa sin, faoi 2 dB.
http://192.168.1.100:11000/Volume?mute=1
Cuireann sé seo an t-imreoir ar a bhéal.
3.2 Imleabhar Suas
Cur síos
Méadaíonn an iarratas seo an toirt faoi dB áirithe (is é 2dB an luach tipiciúil).
Iarratas
/Imleabhar?db=luach_db
| Paraiméadair | Cur síos |
| db | Céimeanna méadaithe toirte i dB (luach tipiciúil 2dB) |
Freagra
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>
| Tréithe Freagartha | Cur síos |
| db | Leibhéal toirte i dB. |
| balbh | 1 má tá an t-imreoir múchta, 0 mura bhfuil an t-imreoir múchta |
| Tréithe Freagartha | Cur síos |
| fritháireamhDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?db=2
Méadaigh an toirt faoi 2dB.
3.3 Imleabhar an Dúin
Cur síos
Laghdaíonn an iarratas seo an toirt faoi dB áirithe (is é -2dB an luach tipiciúil).
Iarratas
/Imleabhar?db=-luach_db
| Paraiméadair | Cur síos |
| db | Céimeanna méadaithe toirte i dB (luach tipiciúil -2dB) |
Freagra
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>
| Tréithe Freagartha | Cur síos |
| db | Leibhéal toirte i dB |
| balbh | 1 má tá an t-imreoir múchta, 0 mura bhfuil an t-imreoir múchta |
| fritháireamhDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?db=-2
Laghdaigh an toirt faoi 2dB.
3.4 Tost Ar Siúl
Cur síos
Iarratas
/Imleabhar?balbh=1
| Paraiméadair | Cur síos |
| balbh | Socraigh go 1 chun an seinnteoir a mhúchadh |
Freagra
<volume muteDb=”-43.1″ db=”100″
ToirtMúchta=”11″
balbh = "1"
fritháireamhDb=”0″
etag=”2105bed56563d9da46942a696cfadd63″>0</volume
>
| Tréithe Freagartha | Cur síos |
| balbhDb | Leibhéal toirte i dB roimh thost |
| db | Leibhéal toirte i dB |
| TostFuaim | Leibhéal toirte i gcéatadán roimh thost |
| balbh | Ciallaíonn 1 go bhfuil an seinnteoir múchta |
| fritháireamhDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?mute=1
3.5 Múchadh
Cur síos
Cuireann an iarratas seo an t-imreoir ar neamhbholgadh.
Iarratas
/Imleabhar?balbh=0
| Paraiméadair | Cur síos |
| balbh | Socraigh go 0 chun an seinnteoir a dhíbholadh |
Freagra
<volume db=”-43.1″ mute=”0″ offsetDb=”0″ etag=”e72d53db17baa526ebb5ee9c26060b1f”>11</volume>
| Tréithe Freagartha | Cur síos |
| db | Leibhéal toirte i dB |
| balbh | Ciallaíonn 0 nach bhfuil an seinnteoir múchta |
| fritháireamhDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?mute=0
Rialú Athsheinm
Úsáidtear na horduithe seo le haghaidh rialú bunúsach athsheinm. I measc na n-orduithe tá seinm, sos, stad, scipeáil, ar ais, suaimhneas, agus athdhéanamh.
4.1 Imirt
Cur síos
Tosaigh ag athsheinm an fhoinse fuaime reatha. Ceadaíonn paraiméadair roghnacha léim isteach sna rianta fuaime, agus ionchur a roghnú, sula dtosaíonn athsheinm fuaime.
Iarratas
/Imir
/Seinn?lorg=soicindí
/Seinn?lorg=soicindí&id=trackid
/Imirt?url=SruthCódaitheURL
| Paraiméadair | Cur síos |
| lorg | Léim go dtí an suíomh sonraithe sa rian reatha. Bailí ach amháin má chuimsíonn an freagra /Status Ní féidir é a úsáid le paraiméadair inputType agus index. |
| encodedStreamURL | URL de shruthú fuaime saincheaptha. Caithfidh sé a bheith URL ionchódaithe. |
Freagra
súgradh
sruth
| Tréithe Freagartha | Cur síos |
|
stáit |
An staid tar éis an t-ordú a fhorghníomhú. Féach ar an tréith staid freagartha /Status le haghaidh tuilleadh sonraí. |
Example
http://192.168.1.100:11000/Play
Tosaigh ag athsheinm fuaime an rian reatha.
http://192.168.1.100:11000/Play?seek=55
Tosaigh ag athsheinm fuaime ag 55 soicind isteach sa rian reatha.
http://192.168.1.100:11000/Play?seek=55&id=4
Tosaigh ag athsheinm fuaime ag 55 soicind isteach sa rian uimhir 5 sa scuaine.
192.168.1.125:11000/Seinn?url=https%3A%2F%2Fwww%2Esoundhelix%2Ecom%2Fexamples%2Fmp3%
2FSoundHelix-Amhrán-1%2Emp3
Tosaigh ag athsheinm fuaime de chód mp3 ar líne.
4.2 Sos
Cur síos
Cuir sos ar an bhfuaim atá á seinm faoi láthair.
Má tá aláram ag seinm, agus má tá am scoir aige, cuirtear an t-am scoir aláraim ar ceal.
Iarratas
/Sos
/Sos?toggle=1
| Paraiméadair | Cur síos |
| scoránaigh | Má shocraítear é go 1, ansin athraítear an staid sos reatha. |
Freagra
sos
| Tréithe Freagartha | Cur síos |
| stáit | An staid tar éis an t-ordú a fhorghníomhú. Féach ar an tréith staid freagartha /Status le haghaidh tuilleadh sonraí. |
Example
http://192.168.1.100:11000/Pause
Cuireann sé sos ar an bhfuaim atá á seinm faoi láthair.
4.3 Stop
Cur síos
Stop an fhuaim atá á seinm faoi láthair. Má tá aláram á sheinm, agus má tá sos ama aige, cuirtear an sos ama ar ceal. Iarratas
/Stop
| Paraiméadair | Cur síos |
| Dada |
Freagra
stad
| Tréithe Freagartha | Cur síos |
| stáit | Ciallaíonn “stop” go bhfuil an fhuaim reatha stoptha. |
Example
http://192.168.1.100:11000/Stop
Stopann sé an fhuaim atá á seinm faoi láthair.
4.4 Léim
Cur síos
Léim go dtí an chéad rian fuaime eile sa scuaine imeartha
Agus é ag seinm ón scuaine imeartha, léimfidh sé go dtí an chéad rian eile sa scuaine. Más é an rian reatha an ceann deireanach sa scuaine, má ghlaonn tú ar /Skip, rachaidh sé go dtí an chéad rian sa scuaine. Léimfidh sé go dtí an chéad rian eile nó an chéad rian sa scuaine beag beann ar staid an tsocruithe athrá.
Chun a fháil amach an bhfuil tú ag úsáid an scuaine súgartha, fíoraigh nach bhfuil aon cheann annUrl> iontráil sa fhreagra /Status.
Ansin is féidir leat an t-ordú /Skip a úsáid.
Is féidir leat rianta a scipeáil freisin i gcás roinnt stáisiún raidió sruthaithe. Déileáiltear leis seo leis an ordú /Action.
Ní thacaíonn roinnt foinsí ar nós TuneIn agus Optical Input le rogha scipeála. Beidh ag na foinsí seoURL> iontráil ach gan aon ainm gnímh scipeála sa fhreagra /Status.
Iarratas
/Scipeáil
| Paraiméadair | Cur síos |
| Dada |
Freagra
21
| Tréithe Freagartha | Cur síos |
| id | Aitheantas an riain tar éis an t-ordú scipeála a fhorghníomhú. Féach ar an tréith amhrán freagartha /Status le haghaidh sonraí. |
Example
http://192.168.1.100:11000/Skip
Léim go dtí an chéad rian eile.
4.5 Ar ais
Cur síos
Má tá rian á sheinm agus má bhí sé ag seinm ar feadh níos mó ná ceithre soicind, ansin fillfidh an modh ‘ar ais’ ar thús an riain.
Seachas sin, rachaidh an t-ordú ar ais chuig an amhrán roimhe seo sa seinmliosta reatha. Má tá tú ar an gcéad amhrán sa seinmliosta, rachaidh glao ar ais chuig an amhrán deireanach. Rachaidh sé chuig an rian roimhe seo nó an chéad rian sa scuaine beag beann ar staid an tsocruithe athrá.
Chun a fháil amach an bhfuil tú ag úsáid an scuaine súgartha, fíoraigh nach bhfuil aon cheann annUrl> eilimint sa fhreagra /Status.
Ansin is féidir leat an t-ordú /Back a úsáid.
Is féidir leat dul siar ar rianta roinnt stáisiún raidió sruthú freisin. Déileáiltear leis seo leis an ordú /Action.
Ní thacaíonn roinnt foinsí ar nós TuneIn agus Optical Input le rogha ar ais. Beidh ag na foinsí seoUrl> eilimint ach gan ainm gnímh scipeála sa fhreagra /Status.
Iarratas
/ Ar ais
| Paraiméadair | Cur síos |
| Dada |
Freagra
19
| Tréithe Freagartha | Cur síos |
| id | Aitheantas an riain tar éis an t-ordú ar ais a fhorghníomhú. Féach ar an tréith amhrán freagartha /Status le haghaidh tuilleadh sonraí. |
4.6 Suaitheadh
Cur síos
Cruthaíonn an t-ordú shuffle scuaine nua tríd an scuaine reatha a shuffleáil. Coinnítear an scuaine bhunaidh (nach bhfuil suaite) le haghaidh athchóirithe nuair a dhíchumasaítear an shuffleáil.
Iarratas
/Suaitheadh?staid=0|1
| Paraiméadair | Cur síos |
| stáit | · 0 chun suaitheadh a dhíchumasú · 1 chun meascadh a chumasú. Níl aon éifeacht aige má tá an scuaine measctha cheana féin. Féach ar an bhfreagra /Stádas eilimint. |
Freagra
| Tréithe Freagartha | Cur síos |
| modhnaithe | Ciallaíonn 1 gur athraíodh an scuaine ó lódáladh í. Ciallaíonn 0 nach ndearnadh. |
| fad | Líon iomlán na rianta sa scuaine reatha. |
| suaitheadh | An staid mheasctha. Ciallaíonn 1 go bhfuil an scuaine reatha mheasctha. Ciallaíonn 0 nach bhfuil an scuaine reatha mheasctha. |
| id | An aitheantas scuaine reatha. Athraíonn sé aon uair a dhéantar an scuaine imeartha a mhodhnú. |
Example
http://192.168.1.100:11000/Shuffle?state=1
Déanann sé an scuaine imeartha reatha a mheascadh.
4.7 Déan arís
Cur síos
Socraíonn sé roghanna athrá. Tá trí staid ag athrá; ciallaíonn 0 an scuaine reatha a athrá, ciallaíonn 1 an rian reatha a athrá agus ciallaíonn 2 gan athrá. Tá gach athrá gan teorainn, is é sin, ní stopann siad.
Iarratas
/Athdhéan?staid=0|1|2
| Paraiméadair | Cur síos |
| stáit | · 0 chun an scuaine imeartha ar fad a athdhéanamh · 1 chun an rian reatha a athdhéanamh · 2 chun an t-athrá a mhúchadh |
Freagra
| Tréithe Freagartha | Cur síos |
| fad | Líon iomlán na rianta sa scuaine imeartha reatha. |
| id | An aitheantas scuaine reatha. Athraíonn sé aon uair a dhéantar an scuaine imeartha a mhodhnú. |
| athuair | An staid athrá reatha. |
Example
http://192.168.1.100:11000/Repeat?state=1
Déanann sé an rian atá ag seinm faoi láthair a athdhéanamh.
4.8 Gníomhartha le haghaidh Stáisiúin Raidió a Shruthú
Cur síos
Le gníomhartha, is féidir leat léim ar aghaidh, dul ar ais, rianta a ghrá agus a thoirmeasc ar stáisiúin raidió sruthú roghnaithe, amhail Slacker nó Radio Paradise nó Amazon Music Prime Stations. Ní luchtóidh stáisiúin raidió sruthú rianta isteach sa scuaine imeartha. Ina áit sin, soláthraíonn siad... URL ar féidir leat a úsáid chun an fheidhm atá uait a bhaint amach.
Rachaidh Skip go dtí an chéad rian eile. Rachaidh Back go dtí an rian roimhe sin. Marcálfaidh Love an rian mar is maith leis laistigh den tseirbhís cheoil. Léimfidh Ban go dtí an chéad rian eile agus marcálfaidh sé an rian mar nach maith leis laistigh den tseirbhís cheoil.
Má táUrl> iontráil sa fhreagra /Status, agus gníomh cuí, is féidir leat na feidhmeanna seo a dhéanamh. Beidh an gníomh san áireamh URL a úsáidtear chun an gníomh a fhorghníomhú.
Seo seanampón bhfreagra /Status ó imreoir atá ag seinm raidió Slacker:
<action name=”skip” url="/Gníomh?seirbhís=Slacker&skip=4799148"/>
<action icon=”/images/loveban/love.png” name=”love” notification=”Track marked as favorite” state=”1″ text=”Love” url="/Gníomh?seirbhís=Slacker&grá=4799148"/>
<action icon=”/images/loveban/ban.png” name=”ban” notification=”Track banned from this
stáisiún” stát =”-1″ téacs =”Toirmeasc” url="/Gníomh?seirbhís=Slacker&toirmeasc=4799148"/>
Sa seanampNíl le, ar ais ar fáil, ach is féidir scipeáil, grá agus cosc a chur air.
Iarratas
/Gníomh?seirbhís=ainm-seirbhíse&gníomh=gníomh-URL
Nóta: Tugtar sonraí sonracha an iarratais (críochphointe agus paraiméadair) ag an gceann faoi seach eilimint. Na horduithe san Exampan chuid thíos úsáideann gach duine /Gníomh ach is féidir aon URI a úsáid.
| Paraiméadair | Cur síos |
| Ar fáil i eilimint. |
Freagra
Maidir leis an bhfreagra, gheobhaidh tú admháil gnímh. Maidir le scipeáil agus ar ais, gheobhaidh tú:
As grá a gheobhaidh tú:
1
Le haghaidh toirmeasc gheobhaidh tú:
1
| Tréithe Freagartha | Cur síos |
| freagra | Más é fréamh-eilimint an fhreagra ná ansin is fógra é an nód téacs le taispeáint don úsáideoir. Má chuirtear eilimint fréimhe malartach ar ais agus an má chuirtear tréith fógra san áireamh, ba chóir an fógra sin a thaispeáint. |
Example
http://192.168.1.100:11000/Action?service=Slacker&skip=10965139
Léimeann sé go dtí an chéad rian raidió Slacker eile.
http://192.168.1.100:11000/Action?service=Slacker&ban=33332284
Cuireann sé cosc ar an rian raidió Slacker atá á sheinm faoi láthair agus léimeann sé go dtí an chéad rian eile.
Bainistiú Scuaine Súgartha
Modh oibríochta amháin atá ag seinnteoir ná rianta a luchtú isteach i scuaine imeartha, agus ansin na rianta ón scuaine imeartha sin a sheinm. Ligeann na horduithe seo duit view agus bainistigh an scuaine súgartha.
5.1 Liostaigh Rianta
Cur síos
Tabhair stádas na scuaine imeartha ar ais, nó tabhair faisnéis ar ais faoi na rianta uile sa scuaine imeartha.
Ní mholtar an fiosrúchán seo a úsáid gan na paraiméadair faid ná tús agus deireadh, mar d’fhéadfaí freagra an-fhada a ghiniúint ar shlí eile.
Iarratas
/Seinmliosta
/Fad seinmliosta=1
/Playlist?start=first&end=last (aisghabh cuid den scuaine, le haghaidh leathanaigh de ghnáth)
| Paraiméadair | Cur síos |
| fad=1 | Ní thugtar ar ais ach na tréithe barrleibhéil agus gan aon sonraí riain. |
| tús | An chéad iontráil sa scuaine le cur san áireamh sa fhreagra, ag tosú ó 0. |
| deireadh | An iontráil dheireanach sa scuaine le cur san áireamh sa fhreagra. |
Freagra
Le haghaidh stádas scuaine súgartha:
13
243
1
Le haghaidh liosta scuaine súgartha:
2002
Anne-Marie
2002
Deezer:487381362
| Tréithe Freagartha | Cur síos |
| ainm | Ainm an scuaine imeartha reatha. |
| modhnaithe | Ciallaíonn 0 nach ndearnadh aon mhodhnú ar an scuaine ó lódáladh í. Ciallaíonn 1 gur rinneadh modhnú ar an scuaine ó lódáladh í. |
| fad | líon iomlán na rianta sa scuaine reatha |
| id | aitheantas uathúil don staid reatha sa scuaine (m.sh., 1054). Is ionann é agus an i bhfreagra /Stádas. |
| amhrán | Tá roinnt fo-eilimintí san amhrán: · albamid = aitheantas an albaim ina bhfuil an rian · seirbhís = seirbhís cheoil an riain · artistid = aitheantas ealaíontóra an riain · songid = aitheantas amhráin · id = suíomh an riain sa scuaine reatha. Má tá an rian roghnaithe faoi láthair, is ionann id an riain agus i bhfreagra /Stádas. · teideal = ainm an riain · ealaín = ainm an ealaíontóra · albaim = ainm an albaim |
Example
http://192.168.1.100:11000/Playlist
Liostaíonn sé na rianta go léir sa scuaine imeartha.
http://192.168.1.100:11000/Playlist?length=1
5.2 Scrios Rian
Cur síos
Bain rian as an scuaine seinm reatha.
Iarratas
/Scrios?id=suíomh
| Paraiméadair | Cur síos |
| id | Aitheantas an riain atá le scriosadh ón scuaine seinm reatha. |
Freagra
9
| Tréithe Freagartha | Cur síos |
| scriosta | An seasamh sa scuaine den rian atá le baint. |
Example
http://192.168.1.100:11000/Delete?id=9
Baintear an rian ag suíomh 9 sa scuaine imeartha.
5.3 Bog Rian
Cur síos
Bog rian laistigh den scuaine imeartha reatha.
Iarratas
/Bog?nua=ceann scríbe&sean=bunús
| Paraiméadair | Cur síos |
| nua | Suíomh nua ar an mbóthar á bhogadh. |
| d'aois | Seanshuíomh an riain atá á bhogadh. |
Freagra
bhog
| Tréithe Freagartha | Cur síos |
| bhog | Léiríonn sé gur aistríodh an rian. |
Example
http://192.168.1.100:11000/Move?new=8&old=2
Bog an rian ag suíomh 2 go suíomh 8 sa scuaine imeartha.
5.4 Glan an Scuaine
Cur síos
Glan gach rian ón scuaine seinm reatha
Iarratas
/Glan
| Paraiméadair | Cur síos |
| Dada |
Freagra
| Tréithe Freagartha | Cur síos |
| modhnaithe | Ciallaíonn 0 nach bhfuil an scuaine athraithe ó luchtaíodh í, ciallaíonn 1 go bhfuil an scuaine athraithe ó luchtaíodh í. |
| fad | Líon iomlán na rianta sa scuaine reatha. |
| id | An t-aitheantas uathúil don scuaine reatha. |
Example
http://192.168.1.100:11000/Clear
Baintear gach rian den scuaine imeartha leis seo.
5.5 Sábháil an Scuaine
Cur síos
Sábháil an scuaine imeartha mar seinmliosta ainmnithe BluOS.
Iarratas
/Sábháil?ainm=ainm_seinnliosta
| Paraiméadair | Cur síos |
| ainm | Ainm an scuaine súgartha sábháilte. |
Freagra
126
| Tréithe Freagartha | Cur síos |
| iontrálacha | Líon iomlán na rianta sa scuaine imeartha sábháilte. |
Example
http://192.168.1.100:11000/Save?name=Dinner+Music
Sábhálann sé seo an scuaine imeartha mar “Ceol Dinnéir”.
Réamhshocruithe
Le hiarratais réamhshocraithe is féidir leat gach réamhshocrú de chuid seinnteora a liostáil, réamhshocrú a luchtú, agus réamhshocruithe a chur suas/síos. Ní mór réamhshocruithe a chur leis agus a scriosadh ag baint úsáide as an aip Rialaitheora BluOS. Is féidir le réamhshocruithe stáisiúin raidió, seinmliostaí agus ionchuir a áireamh (m.sh.
Bluetooth, analógach, optúil, HDMI ARC).
6.1 Liostaigh Réamhshocruithe
Cur síos
Liostaigh na réamhshocruithe go léir ar an seinnteoir BluOS reatha.
Iarratas
/Réamhshocruithe
| Paraiméadair | Cur síos |
| Dada |
Freagra
<preset id=”6″ name=”Serenity” url=”RadioParadise:/42:4/Serenity”
image=”https://img.radioparadise.com/channels/0/42/cover_512x512/0.jpg”/>
<preset id=”7″ name=”1980s Alternative Rock Classics” url=”/Lódaigh?seirbhís=Tidal&id=fd3f797e-
a3e9-4de9-a1e2-b5adb6a57cc7″ image=”/Artwork?service=Tidal&playlistimage=afacfc12-24034caf-a5c5-a2af28d811c8″/> </presets>
| Tréithe Freagartha | Cur síos |
| bród | Aitheantas uathúil réamhshocruithe an imreora. Is ionann é agus an ceann i bhfreagra /Stádas. |
| ainm | An t-ainm réamhshocraithe. |
| id | An aitheantas réamhshocraithe. |
| url | An réamhshocrú URLIs é an fhoinse réamhshocraithe é. URL a úsáidtear chun an réamhshocrú a luchtú. |
| íomhá | Íomhá URL den réamhshocrú. Má tá an URL má thosaíonn sé le /Artwork, d’fhéadfadh sé go mbeadh atreorú mar thoradh air. Paraiméadar/eochair á chur leis leanAthsheoltaí=1 agus an íomhá á haisghabháil is féidir atreorú a sheachaint. |
Example
http://192.168.1.100:11000/Presets
Liostaigh na réamhshocruithe go léir ar an seinnteoir.
6.2 Luchtaigh Réamhshocrú
Cur síos
Tosaíonn sé ag seinm réamhshocraithe. Is féidir leat uimhir réamhshocraithe ar leith a roghnú, chomh maith leis an gcéad réamhshocrú eile nó an réamhshocrú roimhe sin. Ní gá d’uimhreacha réamhshocraithe a bheith seicheamhach, is é sin, is féidir réamhshocruithe 1,2,3, 5, 7, 8, XNUMX agus XNUMX a bheith agat. Lúbaíonn réamhshocruithe timpeall ó bharr go bun agus ó bhun go barr.
Iarratas
/Réamhshocrú?id=réamhshocrúId|-1|+1
| Paraiméadair | Cur síos |
| id | Uimhir aitheantais an réamhshocraithe atá le luchtú. Faightear liosta na n-aitheantas réamhshocraithe atá ar fáil leis an ordú Taispeáin Réamhshocruithe. Más é +1 an réamhshocrú aitheantais, lódálfaidh sé an chéad réamhshocrú eile. Más é -1 an réamhshocrú aitheantais, lódálfaidh sé an réamhshocrú roimhe. |
Freagra
Más liosta rianta an réamhshocrú, tugann sé líon na rianta den réamhshocrú a luchtaíodh ar ais.
60
Más raidió an réamhshocrú, tugann sé an staid sruthaithe ar ais.
sruth
| Tréithe Freagartha | Cur síos |
| seirbhíse | ainm seirbhíse an réamhshocraithe luchtaithe |
| iontrálacha | líon na rianta den réamhshocrú luchtaithe |
Example
http://192.168.1.100:11000/Preset?id=4
Luchtaigh an réamhshocrú le haitheantas réamhshocraithe 4.
http://192.168.1.100:11000/Preset?id=+1
Brabhsáil agus Cuardach Ábhair
Déantar cur síos sa chuid seo ar orduithe le haghaidh brabhsáil agus cuardach ábhar seirbhíse ceoil.
7.1 Ag Brabhsáil Ábhar Ceoil
Cur síos
Déan nascleanúint trí na foinsí ceoil atá ar fáil, chomh maith le hionchuir agus seinmliostaí.
Is é an eilimint fréimhe do fhreagraí ná mura bhfuil freagra earráide ann. Is sraith de I gcásanna áirithe is é an toradh ná sraith de , agus tá seicheamh i ngach ceann acu má Cuirtear na luachanna uile ar fáil ag baint úsáide as tréithe. Níl aon nóid téacs ann.
D’fhéadfadh earráid a bheith iata i dtábla mar thoradh ar ghlao /Browse eilimint fréimhe. Tá sonraí na hearráide ar fáil i gceann amháin agus nialas nó níos mó nóid téacs.
Iarratas
/Brabhsáil?eochair=eochairluach
/Brabhsáil?eochair=eochairluach&leMíreannaRoghchláirComhthéacs=1
| Paraiméadair | Cur síos |
| eochair | Paraiméadar roghnach. Má bhíonn an paraiméadar seo as láthair, déanfar brabhsáil ar an leibhéal is airde. Tugann sé faisnéis ar ais do leibhéil seachas an leibhéal is airde /Browse. Úsáideann sé an luach a thógtar ó luach tréith “browseKey”, “nextKey”, “parentKey”, nó “contextMenuKey” ó fhreagra níos luaithe. Nóta: ní mór luach-eochair a bheith URL ionchódaithe |
| leMíreannaRoghchláirComhthéacs | Paraiméadar roghnach. Is é 1 an luach i gcónaí. Úsáidtear an paraiméadar seo chun roghchlár comhthéacs inlíne a fháil agus torthaí brabhsála seinmliostaí, albaim, rianta, stáisiúin, ealaíontóirí, srl. á fháil. |
Freagra
Freagra brabhsála den scoth:
<item image=”/images/InputIcon.png” text=”Optical Input”
imirtURL=”/Seinn?url=Capture%3Ahw%3A1%2C0%2F1%2F25%2F2%2Finput1″ inputType=”spdif”
cineál = "fuaim" />
Freagra brabhsála leibhéal eile:
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
seirbhís = "Deezer" cuardaighEochair = "Deezer: Cuardaigh" cineál = "roghchlár">
mír browseKey=”/Seinmliostaí?service=Deezer&genre=0&category=toplist” téacs=”Seinmliostaí Coitianta”
cineál = "nasc" />
cineál = "nasc" />
cineál = "nasc" />
mír browseKey=”/Amhráin?service=Deezer&genre=0&category=toplist” téacs=”Amhráin Choitianta”
cineál = "nasc" />
| Tréithe Freagartha | Cur síos |
| Féach ar na táblaí eilimintí/tréithe thíos |
Example
NÓTA: ní mór na príomhpharaiméadair uile a bheith ionchódaithe in UTF-8.
http://192.168.1.100:11000/Browse
Déanann brabhsáil ardleibhéil.
http://192.168.1.100:11000/Browse?key=Tidal%3A
Déanann brabhsáil dara leibhéal, ag tabhairt na gcatagóirí Taoide ar ais.
http://192.168.1.100:11000/Browse?key=Tidal%3AmenuGroup%2F3
An ndéanann brabhsáil tríú leibhéal, ag tabhairt ar ais fochatagóirí na Máistrí Taoide (Grúpa 3).
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters
Déanann brabhsáil ceathrú leibhéal, ag tabhairt an chéad sraith d'albaim Tidal Masters ar ais.
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters%26 start%3D30%26end%3D79
Déanann brabhsáil ceathrú leibhéal eile, ag tabhairt an dara sraith d'albaim Tidal Masters ar ais.
| Eilimint | Tréith (agus luachanna) | Cur síos | |
| Deilbhín Seirbhíse | An URI le haghaidh deilbhín don tseirbhís atá á brabhsáil faoi láthair. | ||
| seirbhísName | Ainm na seirbhíse atá á brabhsáil faoi láthair, le taispeáint ag an úsáideoir. | ||
| Eochairchuardaigh | Luach le húsáid mar pharaiméadar lárnach d'iarratas /Browse chun an tseirbhís reatha (nó cuid níos doimhne den ordlathas) a chuardach. Ina theannta sin, ní mór paraiméadar aq a bheith san iarratas ina bhfuil an téarma cuardaigh. | ||
| nextKey | Luach le húsáid mar pharaiméadar lárnach d'iarratas /Browse chun an chéad leathanach eile d'earraí a fháil don cheann reatha. viewNíl smacht ag úsáideoir an API ar mhéid an bhloic leathanaigh agus níor cheart aon iarracht a dhéanamh paraiméadair cheiste an luacha seo a pharsáil ná a ionramháil. | ||
| EochairTuismitheora | Luach le húsáid mar pharaiméadar lárnach d'iarratas /Browse chun nascleanúint a dhéanamh ar ais suas an ordlathas más ceart an nascleanúint réamhshocraithe ar ais a shárú. | ||
| cineál | roghchlár | Nód nascleanúna a d'fhéadfadh meascán d'aon chineál míre a bheith ann. Is minic nach mbeidh ann ach míreanna nasc nó fuaime. | |
| RoghchlárComhthéacs | Liosta d’earraí den chineál sonraithe. | ||
| ealaíontóirí | |||
| Eilimint | Tréith (agus luachanna) | Cur síos | |
| cumadóirí | |||
| albam | |||
| seinmliostaí | |||
| rianta | |||
| seánraí | |||
| ailt | Rannóga aibítreacha. | ||
| míreanna | Liosta torthaí ginearálta. Is meascán de nóid roghchláir (cineál = "nasc") agus míreanna raidió (cineál = "fuaim") is coitianta. | ||
| fillteáin | D’fhéadfadh iontrálacha fo-fhillteáin, rianta agus seinmliostaí a bheith ann. | ||
| téacs | Ag dul i dtreo na catagóire. | ||
| nextKey | Luach le húsáid mar pharaiméadar lárnach d'iarratas /Browse chun an chéad leathanach eile d'earraí don chatagóir a fháil. | ||
| EochairTuismitheora | Luach le húsáid mar pharaiméadar lárnach d'iarratas /Browse chun nascleanúint a dhéanamh ar ais suas an ordlathas más ceart an nascleanúint réamhshocraithe ar ais a shárú. | ||
| cineál | nasc | Nód cineálach san ordlathas brabhsála a threoraíonn chuig nóid bhreise | |
| fuaime | Nóid is féidir a imirt go díreach | ||
| ealaíontóir | Mír a léiríonn ealaíontóir | ||
| Eilimint | Tréith (agus luachanna) | Cur síos | |
| cumadóir | Mír a léiríonn cumadóir | ||
| albam | Mír a léiríonn albam nó bailiúchán comhchosúil | ||
| seinmliosta | Mír a léiríonn seinmliosta nó bailiúchán comhchosúil | ||
| rian | Mír a léiríonn rian aonair | ||
| téacs | Nód téacs simplí. | ||
| alt | Roinn aibítreach. | ||
| fillteán | Fillteán i mbrabhsáil fillteáin. | ||
| téacs | Príomhlíne nó an chéad líne de thuairisc an earra | ||
| téacs2 | Dara líne | ||
| íomhá | Deilbhín nó saothar ealaíne don mhír. Má thosaíonn an íomhá le
/Saothar ealaíne d’fhéadfadh sé go mbeadh atreorú mar thoradh air. Paraiméadar/eochair á chur leis leanAthsheoltaí=1 agus an íomhá á haisghabháil is féidir atreorú a sheachaint. |
||
| brabhsáilKey | Luach le húsáid mar pharaiméadar eochrach d'iarratas /Browse ina dhiaidh sin chun dul síos an ordlathas. | ||
| imirtURL | URI ar féidir glaoch air go díreach chun an gníomh súgartha réamhshocraithe a ghlaoch don mhír atá i gceist. De ghnáth, is chun an scuaine a ghlanadh agus tosú ag seinm é a dhéantar é seo. | ||
| uath-imirtURL | URI is féidir a ghairm go díreach chun rian a chur leis an scuaine agus é a sheinm agus rianta ina dhiaidh sin ón réad ina bhfuil sé (amhail albam) a chur leis an uathlíonadh. | ||
| Eilimint | Tréith (agus luachanna) | Cur síos |
| cuid den scuaine súgartha. | ||
| EochairRoghchláirComhthéacs | Luach le húsáid mar pharaiméadar lárnach d'iarratas /Browse chun toradh a fháil ar roghchlár comhthéacs de ghníomhartha a bhaineann leis an mír. | |
| gníomhURL | URI is féidir a ghairm go díreach chun an gníomh sonraithe a dhéanamh. |
D’fhéadfadh na luachanna seo a leanas a bheith ag míreanna roghchláir chomhthéacs don tréith cineál.
| Tréith | ||
| Cur síos | ||
| is fearr leat | -cuir leis | Cuir an mhír leis mar rogha (nó a chomhionann) |
| -scrios | Bain an mhír de rogha an úsáideora | |
| cuir | Cuir leis an scuaine súgartha | |
| cuir | -anois | Cuir leis an scuaine imeartha i ndiaidh an riain reatha agus seinn anois |
| -ar aghaidh | Cuir leis an scuaine imeartha i ndiaidh an riain reatha | |
| -deireanach | Cuir le deireadh na scuaine imeartha | |
| cuir Gach | -anois | Cuir réad ilrian leis an scuaine imeartha agus seinn anois |
| -ar aghaidh | Cuir réad ilrian leis an scuaine imeartha i ndiaidh an riain nó an réada ilrian reatha | |
| -deireanach | Cuir réad ilrian le deireadh na scuaine imeartha | |
| seinnRadio | Seinn stáisiún raidió a bhaineann leis an mír | |
| scrios | Scrios an réad (seinnliosta de ghnáth). Ba chóir deimhniú úsáideora a iarraidh |
Agus tú ag brabhsáil leis an bparaiméadar “withContextMenuItem=1”, beidh roghchlár comhthéacs ionlíneach sa toradh.
Example
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26genre%3D0%26category %3Dtoplist&withContextMenuItems=1
An ndéanann iarratas Deezer => Cad atá Te => Albaim Choitianta le roghchlár comhthéacs inlíne.
Freagra
Tá inlíne sa fhreagra do gach mír.
<item text=”Essonne History X” contextMenuKey=”Deezer:contextMenu/Album?albumid=693798541″
imirtURL=”/Cuir leis?service=Deezer&albumid=693798541&seinn anois=1″ íomhá=”/Saothar ealaíne?service=Deezer&albumid=693798541″
browseKey=”Deezer:Albam?ealaíontóir=Ziak&albam=Essonne%20History%20X&albumid=693798541″ téacs2=”Ziak” cineál=”albam”>
<item text=”Favorite” type=”favourite-add” actionURL=”/AddFavourite?service=Deezer&albam=693798541″/>
<item text=”Play now” type=”add-now”
gníomhURL="/Cuir leis?service=Deezer&playnow=1&clear=0&shuffle=0&where=nextAlbum&albumid=693798541"/>
<item text=”Shuffle” type=”add-shuffle”
gníomhURL="/Cuir leis?seirbhís=Deezer&shuffle=1&seinn anois=1&cá háit=an chéad albam eile&albam=693798541"/>
<item text=”Add next” type=”addAll-next” actionURL=”/Cuir leis?service=Deezer&playnow=-1&cá háit=an chéad albam eile&albam=693798541″/>
<item text=”Add last” type=”addAll-last” actionURL="/Cuir leis?seirbhís=Deezer&seinn anois=-1&cá háit=an ceann deireanach&albam=693798541"/>
…
Nótaí agus Leideanna Cur Chun Feidhme
Cuirtear tréith chineáil earra ar fáil mar leid a d'fhéadfadh roghanna taispeána éagsúla a éascú.
Léirítear an cumas chun ábhar míre a bhrabhsáil trí láithreacht tréith browseKey. Léirítear an cumas chun mír (iomlán) a sheinm trí láithreacht seinmURL (agus b'fhéidir uathsheinm freisinURL) tréith. Féadfaidh tréith browseKey agus tréith play araon a bheith ag mírURL tréith.
Nuair a imríonn an bheirtURL agus uathsheinmURL Tá tréithe ar fáil, ba cheart go mbeadh sé faoi réir rogha úsáideora cén ceann ba chóir a úsáid mar an rogha súgartha réamhshocraithe.
De ghnáth, is URIanna coibhneasta iad luachanna URIanna le comhpháirt chonair absalóideach. Déantar URIanna coibhneasta a réiteach ina URIanna absalóideacha de réir RFC 3986.
Ba cheart luachanna tréithe browseKey, contextMenuKey agus searchKey a bheith ionchódaithe le URI i gcónaí (céatadán éalaithe) nuair a úsáidtear iad mar luach paraiméadair eochrach d’iarratas /Browse, mar a bheidh aon pharaiméadair iarrata eile.
Agus tú ag dul síos an ordlathas brabhsála, d'fhéadfadh sé a bheith úsáideach dá dtaispeánfadh ceanntásc leathanaigh an Chomhéadain Úsáideora cineál brioscaí aráin, is dócha ag baint úsáide as teideal (téacs) na nóid tuismitheora agus seanmháthar.
B’fhéidir go mbeadh sé úsáideach an roghchlár comhthéacs a chur ar fáil don tuismitheoir agus a pháistí á mbrabhsáil.
B’fhéidir go mbeadh sé úsáideach cineál an tuismitheora a chur san áireamh agus cinneadh á dhéanamh maidir le conas a leanaí a thaispeáint.
7.2 Cuardaigh Ábhar Ceoil
Cur síos
Ordú chun cuardach a dhéanamh laistigh de sheirbhís.
Iarratas
/Brabhsáil?eochair=eochairluach&q=Téacs cuardaigh
| Paraiméadair | Cur síos |
| eochair | Luach a tógadh ó luach tréith “searchKey” ó fhreagra níos luaithe |
| q | An teaghrán cuardaigh. Déan cuardach ar an gcomhthéacs atá sonraithe ag an bparaiméadar eochrach (tógtha ó thréith searchKey ó fhreagra). In éagmais paraiméadar eochrach, déan cuardach barrleibhéil. |
Freagra
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
seirbhís = "Deezer" cuardaighEochair = "Deezer: Cuardaigh" cineál = "roghchlár">
Tabhair ar ais an leibhéal is airde de thoradh cuardaigh. Chun tuilleadh torthaí cuardaigh a fháil d’Ealaíontóirí, d’Albaim, d’Amhráin, nó do Sheinmliostaí, tá ordú brabhsála leis an “browseKey” mar eochair ag teastáil.
Le haghaidh example, chun toradh cuardaigh Albam a fheiceáil, seol an t-ordú seo a leanas:
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26expr%3Dmichael
Beidh an freagra mar an gcéanna leis an bhfreagra ar an ngnáthordú /Browse.
| Tréithe Freagartha | Cur síos |
| Féach ar tháblaí eilimintí/tréithe san ordú Brabhsáil |
Example
http://192.168.1.100:11000/Browse?key=Deezer:Search&q=michael Cuardaigh le haghaidh “michael” laistigh de sheirbhís ceoil Deezer.
Grúpáil Imreoirí
Déantar cur síos sa chuid seo ar orduithe le haghaidh grúpáil agus díghrúpáil imreoirí réamhshocraithe. Tacaíonn BluOS le grúpáil sheasta freisin, rud nach bhfuil faoi raon feidhme an doiciméid seo.
Úsáideann BluOS na téarmaí seinnteoir príomhúil agus seinnteoir tánaisteach. Is é an seinnteoir príomhúil an príomhimreoir sa ghrúpa. Úsáidtear an seinnteoir príomhúil chun an fhoinse ceoil a roghnú. Níl ach seinnteoir príomhúil amháin ann. Tá seinnteoir tánaisteach ceangailte leis an seinnteoir príomhúil. Is féidir go mbeadh roinnt seinnteoirí tánaisteacha ann.
Más imreoir tánaisteach é imreoir, ansin déantar go leor iarrataí, má dhírítear chuig an imreoir tánaisteach iad, a sheoladh go hinmheánach chuig an bpríomhimreoir. Áirítear leis seo iarratais /Stádas, Rialú Athsheinm, Bainistíocht Scuaine Singte agus Brabhsáil agus Cuardach Ábhair.
8.1 Imreoirí Grúpa a Dó
Cur síos
Grúpáil imreoir tánaisteach amháin le príomhimreoir.
Iarratas
/CuirSlave Leis?sclábhaí=IPImreoraTánaisteach&port=PortImreoraTánaisteach&group=AinmGrúpa
| Paraiméadair | Cur síos |
| sclábhaí | Seoladh IP an imreora tánaistigh. |
| port | Uimhir phoirt an imreora thánaistigh. Is é 11000 an uimhir phoirt réamhshocraithe. Úsáideann imreoirí ar nós an NAD CI580, a bhfuil ceithre imreoir aige le seoladh IP amháin, ilphoirt. |
| grúpa | ROGHNACH, ainm an ghrúpa. Mura soláthraítear é, tabharfaidh BluOS ainm réamhshocraithe don ghrúpa. |
Freagra
| Tréithe Freagartha | Cur síos |
| calafort sclábhaithe | Uimhir phoirt an imreora thánaistigh a grúpáladh díreach. |
| Id | Aitheantas an imreora thánaistigh a grúpáladh díreach. |
Example
http://192.168.1.100:11000/AddSlave?slave=192.168.1.153&port=11000
Grúpálann sé seo imreoir 192.168.1.153 le himreoir 192.168.1.100. Is é imreoir 192.168.1.100 an príomhimreoir.
8.2 Cuir Il-Imreoirí le Grúpa
Cur síos
Grúpáil beirt imreoirí nó níos mó le chéile chun príomhimreoir a chruthú.
Iarratas
/CuirSlave Leis?sclábhaithe=IPannaImreoraTánaisteacha&calafoirt=CalafoirtImreoraTánaisteacha
| Paraiméadair | Cur síos |
| sclábhaithe | Seoltaí IP na n-imreoirí tánaisteacha atá le cur leis an bpríomhimreoir. Tá seoltaí IP scartha le camóga. |
| poirt | Calafoirt na n-imreoirí tánaisteacha atá le cur leis an bpríomhimreoir. Tá uimhreacha calafoirt scartha le camóga. |
Freagra
| Tréithe Freagartha | Cur síos |
| port | Port an imreora thánaisteach a grúpáladh. |
| Id | Aitheantas an imreora thánaistigh a grúpáladh. |
Example
http://192.168.1.100:11000/AddSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Grúpaíonn sé imreoirí tánaisteacha 192.168.1.153 agus 192.168.1.120 go dtí an príomhimreoir 192.168.1.100.
8.3 Bain Imreoir Amháin as Grúpa
Bain imreoir as grúpa. Má bhaintear imreoir tánaisteach as grúpa, déantar an t-imreoir tánaisteach a dhíghrúpaiú. Má bhaintear an príomhimreoir as grúpa de 3 imreoir nó níos mó, déantar an príomhimreoir a dhíghrúpaiú agus cruthaíonn na himreoirí tánaisteacha atá fágtha grúpa nua.
Iarratas
/BainSlave?sclábhaí=IPImreoraTánaisteach&port=PortImreoraTánaisteach
| Paraiméadair | Cur síos |
| sclábhaí | Seoladh IP an imreora (tánaisteach) le cur le himreoir eile (príomhimreoir). |
| port | Port an imreora (tánaisteach) atá le cur le himreoir eile (príomhimreoir). |
Freagra
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″
branda = "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″>
| Tréithe Freagartha | Cur síos |
| Féach /SyncStatus le haghaidh tuilleadh sonraí. |
Example
http://192.168.1.100:11000/RemoveSlave?slave=192.168.1.153&port=11000
Díghrúpálann sé imreoir 192.168.1.153 ón ngrúpa a bhfuil an príomhimreoir 192.168.1.100 aige.
8.4 Bain Il-Imreoirí as Grúpa
Cur síos
Bain beirt imreoirí nó níos mó as grúpa.
Iarratas
/BainSlave?sclábhaithe=IPannaImreoraTánaisteacha&calafoirt=CalafoirtImreoraTánaisteacha
| Paraiméadair | Cur síos |
| sclábhaithe | Seoltaí IP na n-imreoirí tánaisteacha le baint ón bpríomhimreoir. Tá seoltaí IP scartha le camóga. |
| Paraiméadair | Cur síos |
| poirt | Calafoirt na n-imreoirí tánaisteacha atá le baint ón bpríomhimreoir. Tá uimhreacha calafoirt scartha le camóga. |
Freagra
<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>
| Tréithe Freagartha | Cur síos |
| Féach /SyncStatus le haghaidh tuilleadh sonraí. |
Example
http://192.168.1.100:11000/RemoveSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Baintear imreoirí 192.168.1.153 agus 192.168.1.120 den ghrúpa leis an bpríomhimreoir 192.168.1.100.
Atosaigh an Imreora
Déantar cur síos sa chuid seo ar an ordú le haghaidh atosú bog an imreora.
9.1 Atosaigh Imreoir
Cur síos
Atosaigh imreoir go bog.
Iarratas
Ordú POST /atosaigh leis an bparaiméadar tá (aon luach)
| Paraiméadair | Cur síos |
| tá | Aon luach (m.sh. 1). |
Freagra
Socruithe Nuashonraithe
Ag atosú. Dún an fhuinneog seo le do thoil.
Fan le do thoil…
Example
curl -d tá = 1 192.168.1.100 / atosú
Clog Doras
Déanann an chuid seo cur síos ar an ordú do chloigín dorais an imreora.
10.1 Clog Doras
Cur síos
Gníomhachtaigh cloigíní dorais.
Iarratas
http://PLAYERIP:PORT/Doorbell?play=1
| Paraiméadair | Cur síos |
| imirt | Seinn an clog dorais (i gcónaí 1) |
Freagra
| Tréithe Freagartha | Cur síos |
| chumasú | Léirigh an clingín |
| toirte | Toirt clingíní |
| cling | Fuaim clingín |
Example
http://192.168.1.100:11000/Doorbell?play=1 play doorbell chime
Ionchur Díreach
Déantar cur síos sa chuid seo ar orduithe le haghaidh roghnú foinse ionchuir dhírigh.
11.1 Roghnú Ionchuir Ghníomhaigh
Cur síos
Roghnú foinse ionchuir ghníomhach. Oibríonn an t-ordú seo do na hionchuir ghníomhacha a thaispeántar sa fhreagra ar /RadioBrowse?service=Capture. Ní thacaíonn ach an t-ordú seo le roghnú ionchuir BluOS HUB.
Iarratas
/Imirt?url=URL_luach
| Paraiméadair | Cur síos |
| url | Tá an URL tréith ón bhfreagra ar /RadioBrowse?service=Capture |
Freagra
sruth
| Tréithe Freagartha | Cur síos |
| stáit | Léirigh go bhfuil an t-ionchur ag seinm |
Example
Céim 1. Faigh an URL_luach don pharaiméadar url
Iarratas: http://192.168.1.100:11000/RadioBrowse?service=Capture
Freagra:
<item playerName=”Tick
Ticeáil” téacs =”Bluetooth” cineál ionchuir =”Bluetooth” id =”ionchur2″ URL=”Gabh%3Abluez%3Abluetooth” íomhá =” /images/BluetoothIcon.png” cineál =”fuaim”/>
<item playerName=”Tick Tick” text=”Analog
"ionchur" cineál ionchuir = "analógach" id = "ionchur0" 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
"ionchur" cineál ionchuir = "spdif" id = "ionchur1" URL=”Capture%3Ahw%3Aimxspdif%2C0%2F1%2F25%2F2%3Fid%
3Dinput1″ íomhá="/images/capture/ic_opticalinput.png" cineál="fuaim"/>
<item playerName=”Tick
Ticeáil” téacs =”Spotify” id =”Spotify” URL=”Spotify%3Aplay” íomhá =”/Foinsí/íomhánna/SpotifyIcon.png” seirbhís
Cineál = "Seirbhís Néil" cineál = "fuaim" />
<remoteitem playerName=”Test Hub” text=”Analog Input” inputType=”analog” id=”hub192168114911000input0″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput0″
íomhá = "/ íomhánna / gabháil / i
c_analoginput.png”
cineál = "fuaim" />
<remoteitem playerName=”Test Hub” text=”Coaxial Input” inputType=”spdif” id=”hub192168114911000input3″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput3″
íomhá = "/ íomhánna / gabháil / ic
"_ionchur optúil.png"
cineál = "fuaim" />
<remoteitem playerName=”Test Hub” text=”HDMI ARC” inputType=”arc” id=”hub192168114911000input4″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput4″
íomhá = "/ íomhánna / gabháil / ic
_teilifís.png”
cineál = "fuaim" />
<remoteitem playerName=”Test Hub” text=”Optical Input” inputType=”spdif” id=”hub192168114911000input2″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput2″
íomhá = "/ íomhánna / gabháil / ic
"_ionchur optúil.png"
cineál = "fuaim" />
<remoteitem playerName=”Test Hub” text=”Phono Input” inputType=”phono” id=”hub192168114911000input1″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput1″
íomhá = "/ íomhánna / gabháil / ic
_vinil.png”
cineál = "fuaim" />
Céim 2. Seinn Ionchur Analógach ar an seinnteoir
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óta: Cinntigh go bhfuil na foinsí ceangailte agus nach bhfuil siad i bhfolach.
11.2 Roghnú Ionchuir Sheachtraigh
Cur síos
Rogha foinse ionchuir sheachtraigh. Uaireanta ní thaispeánfar ionchuir sheachtracha neamhghníomhacha sa fhreagra ar
/RadioBrowse?service=Capture. Oibríonn an t-ordú seo le haghaidh roghnú ionchuir ghníomhach agus neamhghníomhach araon. Moltar é le haghaidh roghnú ionchuir sheachtraigh CI.
Iarratas (firmware BluOS níos nuaí ná v3.8.0 agus níos sine ná v4.2.0)
/Seinn?Innéacs ionchuir=AitheantasInnéacs
| Paraiméadair | Cur síos |
| Innéacs ionchuir | Innéacs (a thosaíonn le 1) na n-ionchur a fheictear sa fhreagra ar /Settings?id=capture&shcemaVersion=32 (is é 32 an leagan scéime is déanaí) in ord uimhriúil. Níl Bluetooth san áireamh. |
Freagra
sruth
| Tréithe Freagartha | Cur síos |
| stáit | Léirigh go bhfuil an t-ionchur ag seinm |
Example
Céim 1. Faigh an luach inputIndex
Iarratas: http://192.168.1.100:11000/Settings?id=capture&schemaVersion=32
Freagra:
<menuGroup icon=”/images/settings/ic_capture.png” url=”/suíomh” id=”gabháil”
displayName="Saincheap foinsí">
<setting icon=”/images/settings/ic_bluetooth.png” refresh=”true” url=”/móid fuaime”
id="bluetooth" displayName="Bluetooth" value="3" name="bluetoothAutoplay" description="Disabled" explanation="Ligeann mód láimhe duit aistriú idir foinsí sa tarraiceán nascleanúna. Athraíonn mód uathoibríoch go dtí an fhoinse Bluetooth nuair a thosaíonn gléas Bluetooth ceangailte ag seinm fuaime. Is féidir leat aistriú idir foinsí sa tarraiceán nascleanúna ansin. Athraíonn mód aoi go dtí an fhoinse Bluetooth nuair a thosaíonn gléas Bluetooth ceangailte ag seinm fuaime. Má athraíonn tú go foinse eile, dícheanglóidh Bluetooth. Ní fheictear an fhoinse Bluetooth sa tarraiceán nascleanúna. Baintear an fhoinse as an tarraiceán nascleanúna má dhéantar é díchumasaithe, agus ní cheadaítear dó gléas eile ceangal leis an Seinnteoir mar Bluetooth.
foinse.” rang="liosta">
…
<menuGroup icon=”/images/capture/ic_analoginput.png” url=”/suíomh” id=”ionchur gabhála0″
taispeánainm="Analógach"
Ionchur">
<menuGroup icon=”/images/capture/ic_opticalinput.png” url=”/socrú” id=”ionchur-gabhála1″
displayName = "Ionchur Optúil">
Taispeánann an freagra Bluetooth, Ionchur Analógach, agus Ionchur Optúil. Níl Bluetooth san áireamh, mar sin is é 1 luach inputIndex don Ionchur Analógach, agus is é 2 luach inputIndex don Ionchur Optúil.
Céim 2. Seinn Ionchur Optúil ar an seinnteoir.
http://192.168.1.100:11000/Play?InputId=2
Iarratas (firmware BluOS v4.2.0 nó níos nuaí)
/Seinn?InnéacsCineáilIonchuir=$InnéacsCineáil
| Paraiméadair | Cur síos |
| Innéacs CineálIonchuir | Tá an fhormáid seo a leanas ag typeIndex innéacs cineáil d'ionchur. Seo liosta na n-ionchur cineál: spdif (Ionchur Optúil) analógach (Ionchur Analógach, Líne Isteach) comhaiseach (Ionchur Comhaiseach) bluetooth stua (HDMI ARC) ríomhaire earc (HDMI eARC) phono (Vinyl). aesebu (AES/EBU) cothrom (Cothrom Isteach) micreafón (Ionchur Micreafóin) Tá an innéacs tosaíonn ó 1. Nuair a bhíonn níos mó ná ionchur amháin den chineál céanna ann, tá ionchur 1 innéacs 1, tá ionchur 2 innéacs 2, agus mar sin de. |
Freagra
sruth
| Tréithe Freagartha | Cur síos |
| stáit | Léirigh go bhfuil an t-ionchur ag seinm |
Example
Iarratas: http://192.168.1.100:11000/Play?inputTypeIndex=spdif-2 chun Ionchur Optúil 2 a roghnú
Freagra: sruth
Bluetooth
Déantar cur síos sa chuid seo ar an ordú chun mód Bluetooth a athrú.
12.1 Athraigh Mód Bluetooth
Cur síos
Athraigh mód Bluetooth: Lámhleabhar, Uathoibríoch, Aoi, Díchumasaithe.
Iarratas
/móidfuaime?bluetoothAutoplay=luach
| Paraiméadair | Cur síos |
|
bluetoothAutoplay |
Modh Bluetooth luach Ciallaíonn 0 Lámhleabhar, ciallaíonn 1 Uathoibríoch, ciallaíonn 2 Aoi, ciallaíonn 3 Díchumasaithe. |
Gan freagra
Example
Iarratas: http://192.168.1.100:11000/audiomodes?bluetoothAutoplay=3 chun bluetooth a dhíchumasú
Aguisín
13.1 Prótacal Fionnachtana Seirbhíse Lenbrook
Réamhrá
Úsáideann agus braitheann modhanna fionnachtana coitianta ar nós mDNS agus SSDP ar chumarsáid ilchraolta UDP. Úsáideann formhór na dtáirgí reatha Lenbrook mDNS le haghaidh fionnachtana. Ar an drochuair, fuaireamar amach go bhfuil líonraí baile ag líon suntasach dár gcustaiméirí nach bhfeidhmíonn trácht ilchraolta i gceart iontu agus nach féidir ár ngléasanna a aimsiú go hiontaofa. Mar thoradh air sin, tá go leor táirgí curtha ar ais agus tá ár ndáileoirí ag gearán faoi.
Chun aghaidh a thabhairt ar an gceist seo, chruthaíomar prótacal fionnachtana saincheaptha ar a dtugtar LSDP a úsáideann craoladh UDP. Léirigh tástáil tosaigh go bhfuil sé seo i bhfad níos iontaofa ná fionnachtain bunaithe ar mDNS.
Prótacal os a chionnview
Is é cuspóir amháin den phrótacal seo a bheith réasúnta simplí. Féadfar é a úsáid i bhfeistí leabaithe a bhfuil cuimhne an-teoranta acu.
Úsáideann an prótacal gach paicéad craolta UDP chuig agus ó phort UDP 11430. Tá an port seo cláraithe leis an IANA agus tá sé sannta do Lenbrook le húsáid LSDP ó 27 Márta, 2014.
Ag staid sheasmhach, craolann gach nód a bhfuil seirbhís fógraíochta aige teachtaireacht Fógra gach nóiméad.
Ag an tosaithe agus nuair a athraíonn an liosta seirbhísí nó paraiméadair an líonra, craolfar seacht bpacáiste le eatraimh ghearra chun ligean don chéad fhionnachtain agus athruithe a scaipeadh níos tapúla. I gcás nóid a fhógraíonn seirbhísí, beidh teachtaireacht Fógra san áireamh sna seacht bpacáiste tosaigh seo. I gcás nóid atá ag iarraidh seirbhísí a aimsiú, beidh teachtaireacht Iarratais san áireamh sna seacht bpacáiste tosaigh. I gcás seirbhísí nach bhfuil ar fáil a thuilleadh, ba chóir teachtaireacht Scriosta a bheith san áireamh sna seacht bpacáiste.
Seoltar na paicéid tosaigh seo seacht n-uaire mar gheall ar nádúr neamhiontaofa na bpacáistí UDP. Sa chás nach dócha go dteipeann ar na seacht bpacáiste go léir, aimseofar seirbhísí fós tar éis tamaill ó na teachtaireachtaí Fógra tréimhsiúla aon nóiméad.
Má fhaigheann nód teachtaireacht Iarratais do rang seirbhíse atá á fhógairt aige, freagróidh sé le teachtaireacht Fógra tar éis moill ghearr ama randamach agus athshocróidh sé a chuid ama reatha Fógra.
Tá réimsí faid sa cheanntásc paicéid agus sna blocanna teachtaireachta uile. Tugann sé seo solúbthacht bhreise agus ceadaíonn sé athruithe atá comhoiriúnach ar gcúl a dhéanamh amach anseo. D’fhéadfaí réimsí nó cineálacha teachtaireachtaí breise a chur leis amach anseo agus d’fhéadfadh cur i bhfeidhm níos sine scipeáil orthu agus iad á bparsáil. Dá mba rud é go gcinnteoimid athrú neamh-chomhoiriúnach ar gcúl a dhéanamh, tá réimse leagan ann freisin sa cheanntásc paicéid ar féidir é a mhéadú.
Ligeann an prótacal freisin do thaifid TXT a bheith san áireamh le fógraí seirbhíse cosúil le taifid TXT a úsáidtear
le mDNS. Tugann sé seo solúbthacht shuntasach chun meiteashonraí treallacha breise a chur san áireamh leis an tseirbhís
fógraí gan an prótacal a athrú.
Sonraí Prótacail
Tráthúlacht
Ba chóir gach paicéad a sheoltar a sceidealú le hamchlár nó moilleanna randamacha chun cabhrú le himbhuailtí a sheachaint.
- Am Pacáiste Tosaithe: 7 Pacáiste ag an am = [0, 1, 2, 3, 5, 7, 10s] + (0 go 250ms randamach). Is amanna absalóideacha iad seo, ní moilleanna. Ba chóir na 7 bpacáiste go léir a sheoladh laistigh de thart ar 10 soicind.
- Tréimhse Fhógartha Príomhúil: 57s + (0 go 6s randamach)
- Moill ar Fhreagra ar Iarratas: (0 go 750ms randamach)
Aitheantas nód
Beidh ID uathúil ag gach nód ar féidir é a úsáid chun an nód a aithint. Cuirtear an ID uathúil san áireamh i dteachtaireachtaí Fógartha agus Scriosta. Is féidir le cliaint an luach seo a úsáid mar phríomheochair agus luachanna á gcur i dtaisce agus chun nód a aithint go huathúil. Is féidir leis an ID uathúil seo a bheith ina sheoladh MAC ach ba chóir go mbeadh sé mar an gcéanna do gach comhéadan má tá il-chomhéadain ag nód a bhfuil sé ag fógraíocht orthu.
Struchtúr Paicéad
Tosaíonn gach paicéad le ceanntásc paicéid agus ina dhiaidh sin líon treallach bloic teachtaireachtaí. Tosaíonn gach bloc teachtaireachta le réimse faid ionas gur féidir teachtaireachtaí neamhaitheanta a scipeáil. Mura sonraítear a mhalairt, stórálfar gach luach uimhir ilbheart mar big endian (na bearta is suntasaí ar dtús). Mura sonraítear a mhalairt, is luachanna gan síniú iad na huimhreacha uile. Mar shampla.ampIs féidir le fad aon bheart amháin na luachanna 0 go 255 a bheith aige.
Ceanntásc Paicéad
| Réimse | Bearta | Cur síos |
| Fad | 1 | Fad iomlán an cheanntásca lena n-áirítear an réimse seo. |
| Focal Draíochta | 4 | Beidh na ceithre bheart ASCII de “LSDP” sa réimse seo. Cuidíonn sé seo linn paicéid a aithint mar phaicéid atá beartaithe lena n-úsáid ionas nach gá dúinn iarracht a dhéanamh sonraí randamacha a pharsáil ó fhoinse éigin gan choinne. |
| Leagan Prótacail | 1 | Leagan den phrótacal. Má dhéantar athruithe amach anseo ar an bprótacal atá neamh-chomhoiriúnach ar gcúl, beidh an leagan seo |
| Réimse | Bearta Cur síos | |
| athrófar é. Is é 1 an leagan reatha. | ||
Teachtaireacht Iarratais
| Réimse | ||
| Bearta | Cur síos | |
| Fad | 1 | Fad iomlán an teachtaireachta lena n-áirítear an réimse seo. |
| Cineál Teachtaireachta | 1 | “Q” = 0x51: Iarratas caighdeánach le haghaidh freagra craolta. “R” = 0x52: Iarratas le haghaidh freagra unicast. |
| Áireamh | 1 | Líon na ranganna le fiosrú. |
| Aicme 1 | 2 | Aitheantóir ranga 16 giotán (2 bheart). |
| … | Déan an réimse roimhe seo arís do gach rang breise. | |
Fógraigh Teachtaireacht
Ceanntásc Fógraíochta
| Réimse | ||
| Bearta | Cur síos | |
| Fad | 1 | Fad iomlán an teachtaireachta lena n-áirítear ceanntásc iomlán an fhógra agus taifid an fhógra. |
| Cineál Teachtaireachta | 1 | “A” = 0x41 |
| Fad ID an Nóid | 1 | Fad réimse ID an Nóid. |
| Aitheantas nód | Athróg | ID Nóid Uathúil an nóid atá ag seoladh an fhógra. De ghnáth is é seo seoladh MAC cheann de chomhéadain na nóid. |
| Fad an tSeolta | 1 | Fad an réimse Seolta. I gcás IPv4, is é 4 a bheidh ann. |
| Réimse | ||
| Bearta | Cur síos | |
| Seoladh | Athróg | Seoladh IP an nóid. |
| Áireamh | 1 | Líon na dtaifead fógraíochta le leanúint. |
Taifead a Fhógairt
| Réimse | Bearta | Cur síos |
| Aicme | 2 | Aitheantóir ranga 16 giotán (2 bheart). |
|
Líon TXT |
1 |
Líon na dtaifead TXT le leanúint. Mura bhfuil ann, fágtar na réimsí seo a leanas ar lár. |
| Fad Eochair 1 | 1 | Fad ainm an eochrach. |
| Eochair 1 | Athróg | Ainm eochrach. |
| Fad Luach 1 | 1 | Fad téacs luacha. |
| Luach 1 | Athróg | Téacs luacha. |
|
… |
Déan na 4 réimse roimhe seo arís do gach taifead TXT breise. |
Scrios Teachtaireacht
| Réimse | ||
| Bearta | Cur síos | |
| Fad | 1 | Fad iomlán an teachtaireachta lena n-áirítear an réimse seo. |
| Cineál Teachtaireachta | 1 | “D” = 0x44 |
| Fad ID an Nóid | 1 | Fad réimse ID an Nóid. |
| Aitheantas nód | Athróg | ID Nóid Uathúil an nóid atá ag seoladh an teachtaireachta. Is gnách gurb é seo seoladh MAC ceann de na nóid. |
| Réimse | ||
| Bearta | Cur síos | |
| comhéadain. | ||
| Áireamh | 1 | Líon na ranganna le leanúint. |
| Aicme 1 | 2 | Aitheantóir ranga 16 giotán (2 bheart). |
| … | Déan an réimse roimhe seo arís do gach rang breise. | |
Sannadh Aitheantais Ranga
| Aitheantas Aicme | Cur síos | Coibhéis mDNS |
| 0x0001 | Imreoir BluOS | _musc._tcp |
| 0x0002 | Freastalaí BluOS | _muss._tcp |
| 0x0003 | Seinnteoir BluOS (tánaisteach i seinnteoirí ilchriosacha ar nós an CI580) | _musp._tcp |
| 0x0004 | sovi-mfg a úsáidtear le haghaidh tástála déantúsaíochta. | _sovi-mfg._tcp |
| 0x0005 | sovi-méarchlár | _sovi-keypad._tcp |
| 0x0006 | Seinnteoir BluOS (sclábhaí péireála) | _musz._tcp |
| 0x0007 | cianda Web Aip (OSD AVR Web leathanach) | _cianda-web-ui._tcp |
| 0x0008 | Mol BluOS | _mush._tcp |
| 0xFFFF | Gach Rang – Is féidir é a úsáid le Teachtaireacht Iarratais. |
Nóta 1:
Ní mór an pacáiste LSDP foriomlán a láimhseáil mar shonraí dénártha.
Nóta 2:
Mura féidir le Teachtaireacht Fógra amháin faisnéis na nóid go léir a choinneáil (go háirithe CI580), roinnfear ina dhá Theachtaireacht Fógra nó níos mó í agus ceanntásc agus taifead i ngach Teachtaireacht agus faisnéis iomlán an nóid/na nóid i ngach Teachtaireacht.
API Comhtháthaithe Saincheaptha BluOS Leagan 1.7
Doiciméid / Acmhainní
 |
API Comhtháthaithe Saincheaptha BluOS T 778 [pdfLámhleabhar Úsáideora T 778, T 778 API Comhtháthaithe Saincheaptha, T 778, API Comhtháthaithe Saincheaptha, API Comhtháthaithe, API |