API Whakauru Ritenga
T 778 API Whakauru Ritenga
Ko nga korero kei roto i tenei pukapuka na Lenbrook Industries.
Ko te tikanga mo te whakamahi ngaio anake. Karekau he kawenga a Lenbrook Industries mo te tika o te kawa. Ko te kawa he "as-is", me nga hapa katoa me te kore he raihana ahakoa he aha te ahua, kua whakahuahia, kua whakahuahia ranei.
Kaupapa Whakamahi API
Ma te uru atu ki nga API, ka whakaae koe ki tenei Kaupapa Whakamahi API (te "Kaupapahere") me a maatau Ture. Ka whakaratohia e matou enei API ki te tuku i nga kamupene me nga tangata ki te hanga me te whai hua mai i ta maatau Ratonga ma te hanga rorohiko, ratonga, tauira ranei e hono ana ki to maatau papaahi, ka uru ranei ki nga raraunga i roto i to maatau papaahi ma o maatau API (he "Whakakotahi"). Ko tenei Kaupapahere ka waiho hei waahanga o a maatau Ture.
Ka whakaratohia te raupaparorohiko "AS IS", kaore he momo whakamana, he aha te ahua, he korero, he korero ranei, tae atu engari kaua e whakawhäitihia ki nga whakamanatanga mo te hokohoko, te oranga mo tetahi kaupapa me te kore takahi. Karekau rawa nga kaituhi, nga kaipupuri mana pupuri ranei e tika mo tetahi kereme, he kino, he aha atu ranei, ahakoa he mahi kirimana, Tort, he aha ranei, i puta mai, i waho, i te hononga ranei ki te rorohiko, ki te whakamahi, ki etahi atu mahi ranei i roto i te rorohiko.
Whakamahi Whakaaetia
Kaore pea koe e whakamahi i te API ki te tuku mokowhiti, ki te mahi ranei i nga mahi e takahi ana i ta maatau Kaupapa Whakamahi Whakaaetanga me a maatau Ture Whakamahi Paerewa. Ka whai koe ki nga ture katoa e pa ana (tae atu ki nga ture tūmataiti me nga ture whakahaere kaweake o Amerika, te GPR Pakeha me nga ture me nga ture me nga ture herenga ohaoha). Ka whai koe i nga tuhinga katoa ka tukuna e matou mo nga API. Kaore koe e ngana ki te tarai, ki te whakarereke ranei i te mahi a te Ratonga. Ka taea e matou te aro turuki i to whakamahi i nga API mo te u ki enei ture, ka kore pea koe e uru ki te API mena ka takahi koe i tenei Kaupapahere.
Tūmataitinga
To Ko te whakaurunga me whakaatu he kaupapa here mo nga kaiwhakamahi e whakaatu ana i nga korero ka kohia e koe mai i a raatau ka whakamahi i te Whakauru. Ka uru noa koe ki nga raraunga a te kaiwhakamahi ki nga mea e whakaaetia ana e te kaiwhakamahi me te whakamarama i roto i to kaupapa here tūmataiti. Me muku tonu e koe nga raraunga a te kaiwhakamahi mena ka tono te kaiwhakamahi kia mukua, ka whakamutua ranei tana kaute me koe.
Haumarutanga
Ka whakatinanahia e koe, ka pupuri hoki i nga tikanga haumaru hangarau me te whakahaere hei tiaki me te pupuri i te haumarutanga, te pono, me te noho muna o nga raraunga. Ko enei tikanga haumaru ka aukati i te urunga kore mana, te whakaatu ranei i nga raraunga whaiaro, matatapu ranei ka tukatukahia e koe.
Rangatiratanga
Kei a matou nga mana katoa, nga taitara, me nga paanga ki te Ratonga me nga API, tae atu ki nga motika taonga hinengaro, tohu, waehere, me nga ahuatanga. Kaore koe e takahi, whakamuri i te miihini, ka kape ranei i to maatau waehere, hoahoa, ihirangi ranei. Kaore koe e uru atu ki a maatau API ki te whakataetae me ta maatau Ratonga. Ko nga motika karekau i tino whakawhiwhia e tenei Kaupapahere ka kaiponuhia, na, ki te kore koe e kite i konei, ehara tena i te tika e whakaaehia ana koe.
Te Whakamahi Tohu
Kare pea koe e whakamahi i o matou ingoa me o maatau tohu (te tikanga o o maatau tohu, tohu, me nga whakaahua mana pupuri) ahakoa he aha. Kaore pea koe e whakarereke, e tango ranei i nga panui whai mana i a maatau tohu. Kare koe e whakamahi i o matou ingoa, tohu ranei i to ingoa Whakakotahitanga, tohu tohu ranei, i tetahi huarahi ranei e kii ana he tautoko na matou.
Te Whakamahi Mahinga Tohu
Ko enei aratohu e whakamarama ana me pehea e tika ai te whakamahi i o maatau ingoa, tohu me nga rawa waitohu i nga wa katoa. Ko to whakamahi e tohu ana i to whakaae ki enei aratohu, a ka mohio koe ko to whakamahi i te takahi i enei aratohu ka mutu te whakakore aunoa i to whakaaetanga ki te whakamahi i o maatau ingoa, tohu, me nga rawa waitohu.
- Ko te whakamahi i o matou ingoa, tohu me nga rawa waitohu me tino whakamana ma te tuhi.
- Kaua e huri, whakarereke, whakakorikori, kape, peehi ranei i a maatau Rawa Waitohu ahakoa he aha, tae atu ki te whakarereke i te tae, te hurihuri me te totoro. I etahi atu kupu, me pupuri a tatou Rawa Waitohu ki o raatau ahua taketake.
- Kaua e whakanuia o matou ingoa, tohu me nga rawa o to waitohu ki to ingoa me to waitohu.
- Kaua e whakaatu i o matou ingoa, tohu, me nga rawa tohu ki te taha, ki tetahi momo hokohoko whakataetae ranei, me te kore e whakaaehia e matou.
- Ko to whakamahi me kaua e whakapohehe i nga kaihoko mo to maatau tautoko, hononga ki te tautoko ranei o to kamupene, o au hua, ratonga ranei.
- Ko o matou ingoa, tohu me nga taonga waitohu ko to matou taonga motuhake. Ko nga whakaaro pai katoa ka puta mai i to whakamahi ka waiho hei painga mo matou anake. Kare koe e mahi i nga mahi e taupatupatu ana ki o maatau motika, mana pupuri ranei.
- Ko o tatou ingoa, tohu me nga rawa o te waitohu me whakamahi i runga i te whakaute me te kore e taea te whakamahi i tetahi huarahi e pa ana ki a tatou, ki a tatou hua, ratonga ranei, ki tetahi tikanga ranei, ki ta matou whakaaro, ka whakaiti, ka kino ranei to matou ingoa, te pai ranei o to matou ingoa, tohu me nga taonga waitohu. I etahi atu kupu, kaua e honoa a matou rawa ki tetahi mahi he, he ture ranei, kaua e whakamahi ma te tinihanga, he kino ranei.
Exampte whakamahi pai:
“[TOU Ingoa HUA] (hototahi ki / mahi me BluOS)”
Exampte whakamahi kore e whakaaetia
“[TOU Ingoa HUA] – BluOS”
“BluOS – [TOU Ingoa HUA]”
“[TOU Ingoa HUA] – Whakamana ki te BluOS”
Te hokohoko me nga panui panui
I muri i te whakaaetanga o to tono, ka tohua pea ki to maatau web taonga. Ko te tikanga karekau matou e whakaputa tahi i nga whakaputanga perehi, ka uru atu ranei ki te hokohoko-tahi o to tono.
I mua i to tohatoha i te tuku perehi mo to taupānga, me waea mai koe ki a matou i [EMAIL]. Mena kei te whakahua koe i a BluOS, katahi ka hiahia matou ki te whakahoki anoview te tukunga. Ka tūtohu matou kia toro atu ki to tuku panui whakamutunga ka taea.
Whakakahoretanga
Ki te nui rawa atu e whakaaetia ana e te ture, ka whakaratohia e matou nga API i nga wa katoa. Ko te tikanga karekau matou e tuku whakamana ahakoa he aha, he korero, he korero korero ranei, tae atu engari kaua e iti ki te hokohoko me te oranga mo tetahi kaupapa.
Nga whakahou
Ka taea e matou te whakahou, te whakarereke ranei i nga API me tenei Kaupapahere mai i ia wa i ia wa ma te tuku i nga huringa i runga i tenei pae, te whakamohio atu ranei ma te imeera. Ka pa pea enei huringa ki to whakamahi i nga API, ki te huarahi ranei o to Whakakotahitanga ki te API. Mena ka mahia e matou he huringa kaore koe e whakaae, me mutu te whakamahi i nga API.
Te muna
Ka taea pea e koe te uru ki nga korero matatapu, rangatira, me nga korero kore-a-iwi motuhake mo nga API ("Mohiohio Matatapu"). Ka taea e koe te whakamahi i enei korero ki te hanga me nga API anake. E kore koe e whakaatu i nga korero huna ki tetahi me te kore e whakaaehia e matou, a ka tiakina e koe nga korero huna mai i te whakamahi kore mana me te whakaatu i te huarahi ano e tiaki ai koe i ou ake korero matatapu.
Whakataunga
Ka whakakorehia e koe me te pupuri i a matou me to matou Kapa kia kore e kino mai i nga mate (tae atu ki nga utu roia) ka puta mai i nga kereme a te hunga tuatoru e pa ana ki to whakamahi i te API.
Ko te toenga
Kaore tenei Kaupapahere e hanga, e kii ana ranei i tetahi hononga, umanga, mahi tahi ranei. Ka pa tenei Kaupapahere mo te wa e whakamahi ana koe i nga API, tae noa ki te whakamutua i runga i o maatau Ture. Ki te puta he taupatupatu i waenga i tenei Kaupapahere me nga Ture Whakamahi Paerewa, ma nga Ture Whakamahi Paerewa e whakahaere.
©2025 LENBROOK INDUSTRIES LIMITED
633 Kooti Granite, Pickering, Ontario, Canada L1W 3K1
Katoa nga mana
Karekau he wahanga o tenei whakaputanga e ahei te whakaputa, te penapena, te tuku ranei i tetahi ahua me te kore whakaaetanga a Lenbrook Industries Limited. Ahakoa kua whakapau kaha ki te whakarite kia tika nga korero i te wa o te whakaputanga, ka rereke pea nga ahuatanga me nga whakaritenga kaore he panui.
| Tuhinga o mua | ||
| Putanga | Rā | Whakaahuatanga |
| 1.0 | 6/17/2019 | Tukunga tuatahi |
| 1.2 | 01/12/2022 | Kua taapirihia te whakaaraara ngawari, te tangi o te pere kuaha, te ruri whakarunga/whakararo, nekehia te ara i roto i te rarangi, me nga whakahau whakauru tika. He tuhipoka taapiri ki te Apitihanga LSDP. |
| 1.4 | 04/26/2022 | Kua taapirihia te whakahau wahangu; kua whakarereketia nga whakahau whakauru tika mo te HUB; kua whakahouhia te whakahau Play hei purei i nga ororongo ritenga rere. |
| 1.5 | 07/18/2022 | Kua taapirihia te whakahau Nihokikorangi; I whakahouhia te LSDP hei taapiri i te akomanga 5 ki te 8; Kua taapirihia te "Whakamahinga Mahinga Tohu" i roto i te Kaupapa Whakamahi API. |
| 1.6 | 03/13/2024 | I taapirihia he tuhipoka mo /Tuanga mo nga kaitakaro kua whakarōpūhia i te wahanga 2; Kua tapirihia /Play?seek=seconds is=tracked in sect 4.1; |
| 1.7 | 04/09/2025 | Kua whakahoutia te waahanga 8.3 example; Kua taapirihia te tono tirotiro tahua horopaki roraina exampi te wahanga 7.1; Kua taapirihia he whakahau whiriwhiri whakauru tika hou ki te waahanga 11.2; Kua whakahouhia te waahanga 6.1 hei taapiri i te huanga "ahua" mo nga tatūkē; Kua taapirihia he korero "followRedirects=1" mo nga huanga whakaahua katoa; I whakahōuhia te whakamāramatanga o ngā huanga tākaroURL me te taapiri-inaianei ki te waahanga 7.1 |
Kupu Whakataki
Ko te BluOS™ he punaha whakahaere me nga punaha whakahaere puoro e taea ai e koe te uru me te tuku puoro korekore ki te 24-bit/192kHz ki ia ruma ma te whakamahi i to whatunga kaainga. Ka kitea te BluOS i nga hua mai i Bluesound, NAD Electronics, DALI Loudspeakers me etahi atu.
I hangaia tenei tuhinga hei awhina i nga kaiwhakawhanake me nga kaiwhakauru punaha e mahi ana i te maakete whakaurunga ritenga (CI). Kei roto he waahanga o nga tono API kua tuhia ki roto i te Kawa Whakahaere API BluOS katoa.
Ko nga tono katoa e whakaahuatia ana i tenei tuhinga ka tukuna hei tono HTTP GET. He paerewa nga tawhā URL ingoa/uara takirua kua whakawaeheretia. Ka whiwhi nga kaitakaro BluOS i enei whakahau katahi ka whakautu me nga raraunga XML kua whakawaeheretia UTF-8.
Ko nga tono katoa kei te ahua o http:// : / kei hea:
- Ko te player_ip te wāhitau IP o te kaitākaro BluOS (hei tauira, 192.168.1.100)
- Ko te tauranga te tauranga TC e whakamahia ana mo nga korero. Ka whakamahia te Tauranga 11000 mo nga kaitakaro BluOS katoa, haunga te CI580. Ko te CI580 e wha nga pona roma i roto i te tahuhu kotahi, kei te whakamahi te node 1 i te tauranga 11000, kei te whakamahi te node 2 i te tauranga 11010, kei te whakamahi te node 3 i te tauranga 11020, kei te whakamahi te node 4 i te tauranga 11030. Me kitea te tauranga tuuturu ma te whakamahi i te kawa MDNS ma te whakamahi i nga ratonga musc.tcp.
- Ko te tono ko te tono BluOS, patai ranei (hei tauira, Play)
Tuhipoka: Ka whakamahia e tenei tuhinga http://192.168.1.100:11000 hei kaitākaro IP me te tauranga i roto i te ex katoaamples.
Uiui Tūnga
Ka whakamahia nga patai mana ki te uiui i tetahi kaitakaro BluOS.
Ka whakaratohia e BluOS nga tikanga e rua mo te mahi uiui mana; pooti auau me te pooti roa. Ko te pooti auau ka whakahoki tonu i te hua patai. Ko te pooti roa e pupuri ana i te hononga mo te wa kua tohua, ka whakahoki noa i te hua patai ka huri nga korero, ka mutu ranei. Ka taea e te pooti roa te whakaiti i te maha o nga waea ki tetahi kaitakaro.
Ki te kore e whakamahia te pooti-roa, me whakawhäitihia e nga kiritaki o raatau reeti pooti ki te nuinga o te tono kotahi ia 30 hēkona. I te wa e whakamahia ana te pooti roa, me kaua te kaihoko e tono kia rua nga tono karapīpiti mo te rauemi kotahi iti iho i te kotahi hēkona te wehe, ahakoa ka hoki mai te tono tuatahi i roto i te iti iho i te kotahi hēkona.
E rua nga tawhā mo nga tono pooti roa: te waahi me te etag. Ko te wa mutunga ko te roanga o te tono pooti roa me te etag ka tangohia mai i te whakautu o mua (he huanga kei roto i te huanga pakiaka o te whakautu).
I te nuinga o te waa, me whai pooti roa mo tetahi o /Tuanga, /SyncStatus ranei. Kei roto i te urupare /Tuanga he huānga ( ) e tohu ana mehemea kua huri te /SyncStatus. / SyncStatus me pootihia mena ko te ingoa anake, te rōrahi me te mana whakarōpūtanga o te kaitākaro e aro ana. /Me pootihia te mana ki te hiahiatia te mana purei o naianei.
Ina whakarōpūhia nga kaitakaro, ko te kaitakaro tuatahi te kaitakaro matua o te roopu. Ko nga kaitakaro tuarua e piri ana ki te kaitakaro tuatahi. / Ko te whakautu mana o nga kaitakaro tuarua he kape o ta te kaitakaro tuatahi. / SyncStatus pooti roa ka tika ki te whai i te rōrahi o ia kaitākaro tuarua.
2.1 Tūnga Purei
Whakaahuatanga
Ko te /Tūnga mutunga ka uiui te rōrahi me te pārongo purei anō. He maha nga huanga whakautu e whakahoki mai ana tenei patai,
ko etahi o enei kaore e pa ana ki tenei tuhinga. Me waiho nga whakautu kore tuhinga.
Tono
/Status?timeout=hekona&etag=etag-uara
| Tawhā | Whakaahuatanga |
| whakawātea | Tawhā kōwhiringa ka whakamahia me te pooti roa. He 100 hēkona te wā pōtitanga e taunakitia ana, ā, me whakawhāiti ki te reiti 60 hēkona neke atu rānei, kaua rawa e tere ake i te 10 hēkona. |
| etag | Tawhā kōwhiringa ka whakamahia me te pooti roa. Ko te etag huanga mai i te |
| Tawhā | Whakaahuatanga |
| Tuhinga o mua /Tuhinga waea urupare. |
Whakautu
<status etag=”4e266c9fbfba6d13d1a4d6ff4bd2e1e6″>
÷ (Deluxe)
Ed Sheeran
pono
1
159
Deezer:142986206
/Artwork?service=Deezer&songid=Deezer%3A142986206
0
187
1
Tino pai
1054
0
320000
2
Deezer
/Sources/images/DeezerIcon.png
0
8
19
okioki
MP3 320 kb/s
5
Tino pai
Ed Sheeran
÷ (Deluxe)
263
4
35
FAKATOKANGA: karekau nga huanga whakautu katoa e whakarārangihia ki te tūtohi e whai ake nei. Ko etahi atu huānga kei reira, me waiho noa.
| Huanga Whakautu | Whakaahuatanga |
| etag | Huanga o te huānga pakiaka whakautu. Ko te uara puatakore e whakamahia ana me te pooti-roa ki te kite i nga huringa whakautu. Mena kaore i rereke te uara mai i te whakautu o mua katahi ka whakapumauhia te whakautu kaore i rereke (engari tirohia ano nga hekona i raro nei) |
| hekona whakaoho e toe ana | Mēnā ko te purei anō te hua o te whakaoho, koinei te maha o nga hēkona ka mutu. |
| mahi | Tirohia te waahanga Mahi mo te Rererangi Reo Irirangi mo te whakamaarama. |
| pukaemi | Ingoa Pukaemi o te riu hohe o naianei. Tirohia hoki te huanga taitara1. |
| kaitoi | Ingoa kaitoi o te riu hohe o naianei. Tirohia hoki te huanga taitara1. |
| pūhiko | Ka whakaatuhia mena he putea pākahiko to te kaitakaro. Kei roto ko nga huanga: · taumata – te noho utu, ōrau · te utu – 1 mena kei te utu · icon – URL o te ahua o te kaitakaro e whakaatu ana i te ahua utu o naianei |
|
taeaMovePlayback |
He pono mena ka taea te nuku i te purei o naianei, i nga mea kua whakataa ki tetahi atu kaitakaro. |
|
canSeek |
Ki te 1 ka taea ki te muru i te ara o naianei, i te awhe 0..totlen, ma te whakamahi i te tawhā rapu ki /Play. Mo te example: /Play?seek=34. |
| db | taumata rōrahi i roto i te dB. |
| ingoa roopu | Te ingoa o te roopu. Ko te kaitakaro ko te kaitakaro tuatahi i roto i te roopu. |
| Rōpū Volume | Te taumata rōrahi o te roopu. Ko te kaitakaro ko te kaitakaro tuatahi i roto i te roopu. |
| whakaahua | URL o te ahua e hono ana ki te oro o naianei (pukapuka, teihana, whakaurunga, me etahi atu). Mehemea |
| Huanga Whakautu | Whakaahuatanga |
| te URL ka timata ki te /Mahinga Toi ka puta pea ki te anga. Tāpiri tawhā/ kī followRedirects=1 Ka taea e te tiki te atahanga te karo i te anga. | |
| wahangu | Te wahangu. Tautuhi ki te 1 ki te wahangu te rōrahi. |
| wahanguDb | ki te wahangu te kaitakaro, kei roto i tenei te ruri kore wahangu i roto i te dB. |
| muteVolume | Mena kua wahangu, kei roto i tenei te taumata ororongo kore. Ko nga uara mai i te 0 ki te 100. |
| ingoa | Te taitara o te riu ororongo e purei ana. Tirohia hoki te huanga taitara1. |
| whakamōhiourl | URL mo te panui panui. |
| id | Ko te id rarangi takaro ahurei. He ōrite ki te huanga id o te whakautu /Rārangipāpāho. Mena ka hurihia te rarangi takaro ka huri tenei tau. |
| whakakore | Ko te id tatūkē ahurei. He rite ki te huanga prid i te whakautu /Tatūkē. Mena ka hurihia he tatūkē ka huri tenei tau e tohu ana me purea nga urupare keteroki ki /Tautuhi. |
| kounga | Te kounga o te ororongo puna purei: · cd – ororongo kore ngaro me te kounga CD · hd – ororongo korekore me te taumira teitei ake te kounga CD, s raneiampLe- reiti o 88200 sampiti/s neke atu ranei · dolbyAudio – DolbyDigital AC3 ranei · mqa – MQA whai mana ororongo wetekina · mqaAuthored – whaimana MQA-Authored ororongo wetemuna Ko te uara tau ko te tere moka tata o te kounga puna ororongo o te file. |
|
tukurua |
0, 1, 2 ranei. Ko te 0 te tikanga tukurua i te rarangi purei, 1 te tikanga tukurua i te riu, me te 2 te tikanga tukurua atu |
| hekona | Te maha o nga hēkona kua whakatangihia te riu oro o naianei. Karekau tenei uara e whakamahia ki te tataunga o te etag a e kore e hoki mai te ahunga whakamua mai i te pooti roa. Me whakanui nga kaihoko i te tuunga purei, i te wa e purei ana te kawanatanga, e rere ana ranei, i runga i te waa mai i te whakautu. |
| ratonga | Ko te id ratonga o te ororongo o naianei. Ehara tenei i te uara mo te whakaatu ki te UI, penei i te |
| Huanga Whakautu | Whakaahuatanga |
| He rereke pea te aho i te ingoa ratonga mana. | |
| serviceIcon | URL o te ata ratonga onāianei. |
| riwhi | Ko te 0, ko te 1 ranei. Ko te 0 te tikanga o te riwhi me te 1 te tikanga o te riwhi. |
| moe | Ko nga meneti e toe ana i mua i te whakahohenga o te matawā moe. |
| waiata | Te tūnga o te riu o nāianei i te tūtira purei. Tirohia hoki te awaUrl. |
| āhua | Te ahua o te kaitakaro o naianei. Ka taea te purei, te okioki, te whakamutu, te rere, te hono, aha atu. /Ka taea te purei ki te whakaara ano i te wa e okioki ana engari kaua i te wa ka mutu. kia rite tonu te tikanga o te takaro me te awa. Tirohia hoki te awaUrl. |
|
teihanaWhakaahua |
URL mo te ahua o te reo irirangi, mena he reo irirangi te reo irirangi o naianei, hei tauira, te reo irirangi Deezer. Ka rite pea ki te ahua. |
| StreamFormat | Hōputu ororongo. |
| awaUrl | Ko te noho mai o tenei huānga me kiia he haki me ona mea kei roto hei uara puatakore. Mena kei reira ka tohu: · ko te rarangi purei ehara i te puna o te oro o naianei (he koretake te waiata) · ko te riwhi me te tukurua karekau e tika ana me tango mai i tetahi UI mena ka taea · karekau e whai ake me o mua (engari tirohia nga mahi) |
| syncStat | Ko te id ahurei hei tohu i nga huringa o te whakautu /SyncStatus. He rite ki te huanga syncStat o te whakautu /SyncStatus. Ka huri i nga wa katoa he huringa i roto i te Tūnga Tukutahi. |
| taitara1 | Ko te rarangi tuatahi o nga korero e whakaatu ana i te ororongo o naianei. taitara1, taitara2 me te taitara3 ME whakamahi hei kuputuhi o tetahi UI e whakaatu ana i nga rarangi e toru o nga metadata e purei ana inaianei. Kaua e whakamahia nga uara penei i te pukaemi, te kaitoi me te ingoa. |
| taitara2 | Ko te rarangi tuarua o nga korero e whakaahua ana i te ororongo o naianei. |
| taitara3 | Ko te rarangi tuatoru o nga korero e whakaatu ana i te ororongo o naianei. |
| totlen | Tapeke roa o te riu onāianei, i roto i te hēkona. |
| raina_taitara1 | Ko te tuatahi o nga rarangi e rua e whakaatu ana i te ororongo o naianei. twoline_title1 & twoline_title2, mena kei reira, ME whakamahi hei tuhinga mo tetahi UI e whakaatu ana e rua |
| Huanga Whakautu | Whakaahuatanga |
| nga rarangi metadata e purei ana inaianei. | |
| raina_taitara2 | Ko te tuarua o nga rarangi e rua e whakaatu ana i te ororongo o naianei. |
| rōrahi | Te taumata rōrahi kaitākaro i roto i te ōrautage; -1 te tikanga kua whakaritea te rōrahi kaitākaro. |
| hekona | Te maha o nga hēkona kua whakatangihia te riu oro o naianei. |
Example
http://192.168.1.100:11000/Status
Ka whiwhi i te mana purei o te kaitakaro.
http://192.168.1.100:11000/Status?wāenga=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Ka whiwhi i te mana purei o te kaitakaro ma te pooti-roa. Ka whakahokia mai he hua i mua i te paunga o te 100 hēkona mena kua huri te mana o te kaitakaro. Ki te kore, ka whakahokia te hua i muri i te 100 hēkona.
2.2 Tūnga Tukutahi Kaipāpāho me te Rōpū
Whakaahuatanga
Ko te patai a SyncStatus ka whakahoki i nga korero a te kaitakaro me nga korero whakarōpū kaitakaro. He maha nga huanga whakautu ka whakahokia mai e tenei patai, ko etahi kaore e tika ana ki tenei tuhinga. Me waiho nga whakautu kore tuhinga.
Tono
/SyncStatus?timeout=hekona&etag=etag-uara
| Tawhā | Whakaahuatanga |
| whakawātea | Tawhā kōwhiringa ka whakamahia me te pooti roa. Ko te waahi pooti i roto i nga hēkona. 180 hēkona te wā pōtitanga e taunakitia ana. |
| etag | Tawhā kōwhiringa ka whakamahia me te pooti roa. Ko te etag huanga mai i te whakautu waea /SyncStatus o mua. |
Whakautu
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″ brand=”Bluesound” etag=”23″ outlevel =”-62.9″ schemaVersion =”25″ arawhiti =”pono” roopu =”PULSE-0278 + 2″ syncStat =”23″ id=”192.168.1.100:11000″:5000″:92:92:92:92:92 192.168.1.100
…..
FAKATOKANGA: karekau nga huanga whakautu katoa e whakarārangihia ki te tūtohi e whai ake nei. Ko etahi atu huānga kei reira, me waiho noa.
| Huanga Whakautu | Whakaahuatanga |
| pūhiko | Ka whakaatuhia mena he putea pākahiko to te kaitakaro. Kei roto ko nga huanga: · taumata – te noho utu, ōrau · te utu – 1 mena kei te utu · icon – URL o te ahua o te kaitakaro e whakaatu ana i te ahua utu o naianei |
| waitohu | Te ingoa waitohu kaitakaro. |
| db | taumata rōrahi i roto i te dB. |
| etag | Tag o te whakautu /SyncStatus, whakamahia mo te pooti roa. |
| roopu | Ko te ingoa roopu. |
| tohu | URL kei roto te ahua o te tohu kaitakaro. |
| id | Kaitoro IP me te tauranga. |
| arawhiti | Tika te tikanga kua tatū kē te kaitākaro, he teka te tikanga me whakarite te kaitākaro. Me tatū te kaitākaro ki te taupānga BluOS Controller. |
| mac | Kaitoro id ahurei mo te atanga whatunga. He wahitau MAC pea. |
| rangatira | Wāhitau IP kaitākaro matua. Ka tae mai mena he kaitakaro tuarua te kaitakaro ki tetahi roopu. Huanga: · tauranga – tau tauranga. · hono anō – pono ki te ngana ki te hono atu ki te kaitākaro tuatahi |
| tauira | Id tauira kaitākaro. |
| Ingoa tauira | Ingoa tauira kaitākaro. |
| wahangu | Tautuhi ki te 1 ki te wahangu te rōrahi. |
| wahanguDb | Mena kua wahangu te kaitakaro, koinei te taumata ororongo kore i te dB. |
| Huanga Whakautu | Whakaahuatanga |
| muteVolume | Mena kua wahangu te kaitakaro, koinei te taumata ororongo kore (0..100). |
| ingoa | Ingoa kaitākaro. |
| schemaVersion | Putanga aronuinga rorohiko. |
| taurekareka | Ngā wāhitau IP kaitākaro tuarua. Ka tae mai mena ko te kaitakaro te kaitakaro tuatahi o tetahi roopu. He maha nga kaitakaro tuarua. Huanga: · id – wāhitau IP · tauranga – tau tauranga |
|
syncStat |
id o te mana tukutahi. Ka huri i nga wa katoa ka huri tetahi mea kei roto i te whakautu /SyncStatus. Whakaorite ki huānga i roto i te /Tuunga whakautu. |
| rōrahi | taumata rōrahi i runga i te tauine 0..100. -1 te tikanga o te rōrahi pūmau. |
| rohe | Ingoa o te roopu pumau. |
| roheMaster | Mēnā ko te kaitākaro te kaitākaro tuatahi i roto i tētahi rōpū pūmau, ka tautuhia tēnei ki te pono. |
| roheTaurekareka | Mēnā he kaitākaro tuarua te kaitākaro i roto i te rōpū pūmau, ka tautuhia tēnei ki te pono. |
Example
http://192.168.1.100:11000/SyncStatus
Ka whiwhi i te kaitakaro me te mana roopu o te kaitakaro.
http://192.168.1.100:11000/SyncStatus?wāenga=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Ka whiwhi i te mana o te kaitakaro me te roopu o te kaitakaro ma te pooti roa. Ka whakahokia mai he hua i mua i te paunga o te 100 hēkona mena kua huri te mana o te kaitakaro. Ki te kore, ka whakahokia te hua i te 100 hēkona.
Mana Rōrahi
He whakarite i te taumata oro o te kaitakaro. I whakamahia ano ki te wahangu i te kaitakaro.
3.1 Tautuhi Rōrahi
Whakaahuatanga
Ko tenei tono ka patai, ka tautuhi ranei i te rōrahi kaitākaro.
Ko nga momo whakahau katoa, ahakoa te whakamahi i te taumata 0..100, i te dB tino, i nga tawhā whanaunga dB ranei, ka herea ki nga uara ka puta he taumata i roto i te awhe rōrahi e waatea ana, ko te tikanga -80..0. Ka taea te whakatika i te awhe rōrahi ma te whakamahi i te taupānga BluOS Controller, i runga i te Tautuhinga -> Player -> Wharangi Ororongo.
E tautoko ana te patai i nga pooti roa (kaore i te whakaahua i raro nei).
Tono
/Rōrahi
/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
| Tawhā | Whakaahuatanga |
| taumata | Tautuhia te taumata rōrahi tino o te kaitākaro. He tauoti mai i te 0 -100. |
| korero_taurekareka | Ka pa ki nga kaitakaro kua whakarōpūhia. Mena ka tautuhia ki te 0, ko te kaitoro kua tohua i tenei wa ka huri te rōrahi. Mena ka tautuhia ki te 1, ka huri nga kaitoro katoa o te roopu ki te ruri. |
| wahangu | Mena ka tautuhia ki te 0, ka wahangu te kaitakaro. Mena ka tautuhia ki te 1, ka kore te wahangu o te kaitakaro. |
| abs_db | Tautuhia te rōrahi ma te whakamahi i te tauine dB. |
| db | Mahia he huringa rōrahi whanaunga mā te tauine rōrahi dB. Ka taea e db te tau pai, kino ranei. |
Whakautu
<volume db=”-49.9″ mute=”0″ offsetDb=”0″ etag=”6213593a6132887e23fe0476b9ab2cba”>15</volume>
| Huanga Whakautu | Whakaahuatanga |
| Huanga Whakautu | Whakaahuatanga |
| db | taumata rōrahi i roto i te dB. |
| wahangu | 1 ki te wahangu te kaitakaro, 0 ki te wahangu te kaitakaro. |
| wahanguDb | Mena kua wahangu te kaitakaro, koinei te taumata ororongo kore i te dB. |
| muteVolume | Mena kua wahangu te kaitakaro, koinei te taumata ororongo kore (0..100). |
| rōrahi | Te taumata rōrahi o nāianei: 0..100 ranei -1 mo te rōrahi pūmau. |
Example
http://192.168.1.100:11000/Volume?level=15
Ka tautuhi i te taumata rōrahi kaitākaro ki te 15 (o te 100).
http://192.168.1.100:11000/Volume? tell_slaves=1&db=2
Ka whakanui ake i te rōrahi o te kaitākaro matua 192.168.1.100, me ngā kaitākaro tuarua katoa o taua rōpū, mā te 2 dB.
http://192.168.1.100:11000/Volume?mute=1
Ka whakangū i te kaitākaro.
3.2 Pukapuka Whakarunga
Whakaahuatanga
Ko tenei tono ka piki ake te rōrahi ma etahi dB (ko te 2dB te uara tikanga).
Tono
/Volume?db=db_value
| Tawhā | Whakaahuatanga |
| db | Te piki o te rōrahi i roto i te dB (te uara angamaheni 2dB) |
Whakautu
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>
| Huanga Whakautu | Whakaahuatanga |
| db | taumata rōrahi i roto i te dB. |
| wahangu | 1 ki te wahangu te kaitakaro, 0 ki te kore e wahangu te kaitakaro |
| Huanga Whakautu | Whakaahuatanga |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?db=2
Whakanuia te rōrahi mā te 2dB.
3.3 Raro Whakararo
Whakaahuatanga
Ko tenei tono ka whakaheke i te rōrahi e etahi dB (ko te uara angamaheni -2dB).
Tono
/Volume?db=-db_value
| Tawhā | Whakaahuatanga |
| db | Ko nga hikoi whakanui i roto i te dB (te uara angamaheni -2dB) |
Whakautu
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>
| Huanga Whakautu | Whakaahuatanga |
| db | taumata rōrahi i roto i te dB |
| wahangu | 1 ki te wahangu te kaitakaro, 0 ki te kore e wahangu te kaitakaro |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?db=-2
Whakahekea te rōrahi mā te 2dB.
3.4 Wahangu Ka
Whakaahuatanga
Tono
/Volume?mute=1
| Tawhā | Whakaahuatanga |
| wahangu | Tautuhia ki te 1 hei wahangu i te kaitakaro |
Whakautu
<volume muteDb=”-43.1″ db=”100″
muteVolume="11"
wahangu =”1″
offsetDb="0"
etag=”2105bed56563d9da46942a696cfadd63″>0</volume
>
| Huanga Whakautu | Whakaahuatanga |
| wahanguDb | Te taumata rōrahi i roto i te dB i mua i te wahangu |
| db | taumata rōrahi i roto i te dB |
| muteVolume | Te taumata rōrahi i roto i te ōrau i mua i te wahangu |
| wahangu | 1 te tikanga kua wahangu te kaitakaro |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?mute=1
3.5 Wahangu Weto
Whakaahuatanga
Ko tenei tono ka whakatau i te kaitoro ki te wetewete.
Tono
/Volume?mute=0
| Tawhā | Whakaahuatanga |
| wahangu | Tautuhia ki te 0 hei wetewete i te kaitakaro |
Whakautu
<volume db=”-43.1″ mute=”0″ offsetDb=”0″ etag=”e72d53db17baa526ebb5ee9c26060b1f”>11</volume>
| Huanga Whakautu | Whakaahuatanga |
| db | taumata rōrahi i roto i te dB |
| wahangu | Ko te 0 te tikanga kaore te kaitakaro i wahangu |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?mute=0
Mana purei
Ka whakamahia enei whakahau mo te mana purei taketake. Ko nga whakahau ko te takaro, te okioki, te whakamutu, te peke, te hoki, te riwhi, me te tukurua.
4.1 Whakaari
Whakaahuatanga
Tīmatahia te purei anō o te puna ororongo onāianei. Ka taea e nga tawhā whiriwhiri te peke ki roto i nga riu oro, me te kowhiria he whakaurunga, i mua i te tiimata o te purei oro.
Tono
/Taakaro
/Play?seek=hekona
/Play?seek=seconds&id=tracked
/Takaro?url=encodedStreamURL
| Tawhā | Whakaahuatanga |
| rapu | Peke ki te waahi kua tohua i te riu onāianei. Ka whai mana anake mena ka uru te urupare /Tuanga . Kaore e taea te whakamahi me nga tawhā whakauruMomo me te taupū. |
| awa whakawaehereURL | URL o ororongo ritenga rere. Me penei URL whakawaeheretia. |
Whakautu
takaro
awa
| Huanga Whakautu | Whakaahuatanga |
|
āhua |
Ko te kawanatanga i muri i te whakahaere i te whakahau. Tirohia te /Tunga whakautu ahua huanga mo etahi atu taipitopito. |
Example
http://192.168.1.100:11000/Play
Tīmatahia te purei ororongo o te riu onāianei.
http://192.168.1.100:11000/Play?seek=55
Tīmatahia te purei oro i te 55 hēkona ki te riu o nāianei.
http://192.168.1.100:11000/Play?seek=55&id=4
Tīmatahia te purei ororongo i te 55 hēkona ki te tau riu 5 i te tūtira.
192.168.1.125:11000/Play?url=https%3A%2F%2Fwww%2Esoundhelix%2Ecom%2Fexampiti%2Fmp3%
2FSoundHelix-Waiata-1%2Emp3
Tīmatahia te purei ororongo o te ororongo mp3 ipurangi.
4.2 Okioki
Whakaahuatanga
Tatarihia te ororongo purei onāianei.
Mena kei te purei he whakaoho, a he wa mutunga, ka whakakorehia te wa whakaoho.
Tono
/Tatari
/Pause?toggle=1
| Tawhā | Whakaahuatanga |
| takahuri | Ki te tautuhia ki te 1, ka takahurihia te ahua okioki o naianei. |
Whakautu
okioki
| Huanga Whakautu | Whakaahuatanga |
| āhua | Ko te kawanatanga i muri i te whakahaere i te whakahau. Tirohia te /Tunga whakautu ahua huanga mo etahi atu taipitopito. |
Example
http://192.168.1.100:11000/Pause
Ka okioki i te ororongo e purei ana.
4.3 Kati
Whakaahuatanga
Whakamutua te ororongo purei onāianei. Mena kei te whakatangihia he whakaoho, he wa mutunga, ka whakakorehia te wa whakaoho Tono
/Kati
| Tawhā | Whakaahuatanga |
| Karekau |
Whakautu
mutu
| Huanga Whakautu | Whakaahuatanga |
| āhua | "Kati" te tikanga kua mutu te ororongo o naianei. |
Example
http://192.168.1.100:11000/Stop
Ka mutu te ororongo e purei ana.
4.4 Tīpoka
Whakaahuatanga
Hūpeke ki te riu oro o muri mai i te rārangi purei
Ina purei mai i te rarangi purei, ka peke ki te riu e whai ake nei i te rarangi. Mena ko te riu o naianei te mea whakamutunga i roto i te rarangi, ko te waea /Skip ka haere ki te riu tuatahi i te rarangi. . Ka peke ki te riu panuku, tuatahi ranei i roto i te rarangi ahakoa te ahua o te tautuhinga tukurua.
Hei whakatau mena kei te whakamahi koe i te rarangi purei, tirohia kaore heUrl> urunga i roto i te whakautu /Tuanga.
Na ka taea e koe te whakamahi i te whakahau /Skip.
Ka taea hoki e koe te peke i nga ara mo etahi teihana reo irirangi. Ka whakahaerehia enei ma te tono /Action.
Ko etahi o nga puna penei i a TuneIn me te Optical Input kaore i te tautoko i te whiringa peke. Ko enei puna ka whai aURL> te urunga engari kaore he ingoa mahi peke i te whakautu /Tuanga.
Tono
/Hoki
| Tawhā | Whakaahuatanga |
| Karekau |
Whakautu
21
| Huanga Whakautu | Whakaahuatanga |
| id | Ko te id ara i muri i te mahi i te whakahau peke. Tirohia te /Tunga whakautu waiata huanga mo nga taipitopito. |
Example
http://192.168.1.100:11000/Skip
Huka ki te riu e whai ake nei.
4.5 Hoki
Whakaahuatanga
Mena kei te purei tetahi riu, kua neke atu i te wha hēkona ka hoki mai ano ki te timatanga o te ara.
Ki te kore ka haere te whakahau whakamuri ki te waiata o mua i te rārangipāpāho o nāianei. Mena i runga i te waiata tuatahi i roto i te rārangipāpāho karanga hoki ka haere ki te waiata whakamutunga. Ka haere ki te ara o mua, tuatahi ranei i roto i te rarangi ahakoa te ahua o te tautuhinga tukurua.
Hei whakatau mena kei te whakamahi koe i te rarangi purei, tirohia kaore heUrl> huānga i roto i te whakautu /Tuanga.
Na ka taea e koe te whakamahi i te whakahau /Hoki.
Ka taea hoki e koe te hoki whakamuri mo etahi teihana reo irirangi. Ka whakahaerehia enei ma te tono /Action.
Ko etahi o nga puna penei i te TuneIn me te Optical Input kaore i te tautoko i tetahi whiringa whakamuri. Ko enei puna ka whai aUrl> huānga engari karekau he ingoa hohenga peke i te whakautu /Tuanga.
Tono
/Hoki
| Tawhā | Whakaahuatanga |
| Karekau |
Whakautu
19
| Huanga Whakautu | Whakaahuatanga |
| id | Ko te id ara i muri i te mahi i te whakahau whakamuri. Tirohia te /Tunga whakautu waiata huanga mo nga taipitopito. |
4.6 Riwhi
Whakaahuatanga
Ka hangaia e te tono riwhi he rarangi hou ma te riwhi i te rarangi o naianei. Ko te rarangi taketake (kaore i riwhi) ka mau tonu hei whakaora ina monokia te riwhi.
Tono
/Shuffle?state=0|1
| Tawhā | Whakaahuatanga |
| āhua | · 0 hei whakakore i te riwhi · 1 kia taea te riwhi. Kare he painga mena kei te noho riwhi ke te tutira. Tirohia /Tunga whakautu huānga. |
Whakautu
| Huanga Whakautu | Whakaahuatanga |
| whakarerekētia | Ko te tikanga 1 kua whakarereketia te rarangi mai i te utaina. 0 te tikanga kaore. |
| roa | Tau tapeke o nga riu i te rarangi o naianei. |
| riwhi | Te ahua riwhi. 1 te tikanga kua riwhi te rarangi o naianei. Ko te tikanga 0 karekau te rarangi o naianei i riwhi. |
| id | Ko te id tūtira o nāianei. Ka huri i nga wa katoa ka whakarereketia te rarangi purei. |
Example
http://192.168.1.100:11000/Shuffle?state=1
Ka riwhi i te rarangi purei onāianei.
4.7 Tukurua
Whakaahuatanga
Ka tautuhi i nga whiringa tukurua. E toru nga ahuatanga o Repeat; Ko te tikanga 0 te tukurua i te rarangi o naianei, ko te tikanga 1 te tukurua i te ara o naianei, ko te tikanga 2 kaua e tukurua. Ko nga mahi tukurua katoa he mutunga kore, ara, kare e mutu.
Tono
/Repeat?state=0|1|2
| Tawhā | Whakaahuatanga |
| āhua | · 0 ki te tukurua i te rarangi takaro katoa · 1 ki te tukurua i te ara o naianei · 2 hei whakaweto i te tukurua |
Whakautu
| Huanga Whakautu | Whakaahuatanga |
| roa | Te tapeke o nga riu i roto i te rarangi purei o naianei. |
| id | Ko te id tūtira o nāianei. Ka huri i nga wa katoa ka whakarereketia te rarangi purei. |
| tukurua | Ko te ahua tukurua o naianei. |
Example
http://192.168.1.100:11000/Repeat?state=1
Ka tukurua i te riu purei onāianei.
4.8 Nga Mahi mo nga Rererangi Reo Irirangi
Whakaahuatanga
Ma nga mahi ka taea e koe te peke whakamua, te hoki whakamuri, te aroha me te aukati i nga riipene i runga i nga teihana reo irirangi kua tohua, penei i a Slacker, Radio Paradise, Amazon Music Prime Stations ranei. Karekau nga reo irirangi roma e uta i nga riu ki te rarangi purei. Engari, ka whakaratohia e ratou he URL ka taea e koe te whakamahi ki te whakatutuki i te mahi e hiahiatia ana.
Ka haere a Skip ki te ara e whai ake nei. Ka hoki ki te ara o mua. Ma te aroha e kara te ara e pai ana i roto i te ratonga puoro. Ka peke atu te aukati ki te riu e whai ake nei, ka kara te riu i te kore e pai ki roto i te ratonga puoro.
Mena he aUrl> te urunga ki te whakautu /Tuanga, me tetahi mahi e tika ana, ka taea e koe enei mahi. Kei roto i te mahi te URL ka whakamahia hei mahi i te mahi.
Anei tetahi o muaampmai i te whakautu /Tuanga o tetahi kaitakaro e whakatangi ana i te reo irirangi 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
teihana” state="-1″ text="Rāhui" url= ”/Action?service=Slacker&ban=4799148″/>
I roto i tenei exampe, kaore i te waatea te hoki, engari ka peke, ka taea te aroha me te aukati.
Tono
/Action?service=service-name&action=action-URL
Tuhipoka: Ko nga taipitopito tono motuhake (te waahi mutunga me nga tawhā) ka tukuna e ia huānga. Ko nga whakahau kei te ExampKo te waahanga kei raro ka whakamahi katoa / Mahi engari ka taea te URI.
| Tawhā | Whakaahuatanga |
| Ka whakaratohia ki roto huānga. |
Whakautu
Mo te whakautu, ka whiwhi koe i te whakaaetanga mahi. Mo te peke me te hoki, ka whiwhi koe:
Mo te aroha ka whiwhi koe:
1
Mo te aukati ka whiwhi koe:
0
| Huanga Whakautu | Whakaahuatanga |
| whakautu | Mena ko te takenga o te whakautu na ko te node kuputuhi he panui hei whakaatu ki te kaiwhakamahi. Mena ka whakahokia mai he huānga pakiaka rereke me te i whakauruhia he huanga whakamohiotanga katahi ka whakaatuhia taua panui. |
Example
http://192.168.1.100:11000/Action?service=Slacker&skip=10965139
Ka peke atu ki te riu irirangi Slacker e whai ake nei.
http://192.168.1.100:11000/Action?service=Slacker&ban=33332284
Ka aukati i te riu reo irirangi Slacker e purei ana, ka peke ki te riu panuku.
Purei Whakahaere Tūtira
Ko tetahi o nga mahi a te kaitakaro ko te uta i nga riu ki roto i te rarangi takaro, ka purei i nga riu mai i taua rarangi takaro. Ko enei whakahau ka taea e koe view me te whakahaere i te rarangi takaro.
5.1 Rarangi Riu
Whakaahuatanga
Whakahokia te mana o te rarangi purei, whakahoki korero ranei mo nga riu katoa o te rarangi purei.
Kaore i te tūtohutia kia whakamahia tenei patai me te kore te roa, te tiimata me te mutunga, na te mea ka puta he whakautu roa rawa atu.
Tono
/Rārangipāpāho
/Rārangipāpāho?length=1
/Rārangipāpāho?start=first&end=last (tangohia he wāhanga o te tūtira, mo te whakawhārangi i te nuinga o te wā)
| Tawhā | Whakaahuatanga |
| roa=1 | Whakahokia nga huanga taumata-runga noa kaore he taipitopito ara. |
| timata | Te urunga tuatahi ki te rarangi hei whakauru ki te whakautu, timata mai i te 0. |
| mutunga | Te urunga whakamutunga ki te rarangi hei whakauru ki te whakautu. |
Whakautu
Mō te tūnga tūtira purei:
13
243
1
Mo te rarangi rarangi takaro:
2002
Ana-Marie
2002
Deezer:487381362
| Huanga Whakautu | Whakaahuatanga |
| ingoa | Ko te ingoa rarangi purei o naianei. |
| whakarerekētia | Ko te tikanga ko te 0 kaore ano kia whakarereketia mai i te utaina. Ko te tikanga 1 kua whakarereketia te rarangi mai i te utaina. |
| roa | te tapeke o nga riu i te rarangi o naianei |
| id | id ahurei mo te ahua o naianei tūtira (hei tauira, 1054). He rite ano ki te i roto i te /Tuanga whakautu. |
| waiata | Ko te waiata he maha nga waahanga iti: · albumid = id o te pukaemi kei roto te riu · ratonga = ratonga waiata o te riu · artistid = id of the track artist · waiata = waiata id · id = tūnga ara i te tūtira o nāianei. Mena kua tohua te riu i tenei wa, he rite tonu te id track ki i roto i te /Tuanga whakautu. · taitara = ingoa ara · toi = ingoa toi · alb = ingoa pukaemi |
Example
http://192.168.1.100:11000/Playlist
Ka whakarārangihia ngā ara katoa i te tūtira purei.
http://192.168.1.100:11000/Playlist?length=1
5.2 Muku He Riu
Whakaahuatanga
Tangohia tetahi riu mai i te rarangi purei o naianei.
Tono
/Muku?id=tūranga
| Tawhā | Whakaahuatanga |
| id | Ko te id ara o te riu ka mukua mai i te rarangi purei o naianei. |
Whakautu
9
| Huanga Whakautu | Whakaahuatanga |
| kua mukua | Ko te tuunga i roto i te rarangi o te ara ka tangohia. |
Example
http://192.168.1.100:11000/Delete?id=9
Ka tango i te riu i te turanga 9 i te rarangi purei.
5.3 Nuku He Riu
Whakaahuatanga
Nukuhia he riu i roto i te rarangi purei o naianei.
Tono
/Move?new=destination&old=origin
| Tawhā | Whakaahuatanga |
| hou | Te tuunga hou i runga i te ara e nekehia ana. |
| tawhito | Te tuunga tawhito o te ara e nekehia ana. |
Whakautu
neke
| Huanga Whakautu | Whakaahuatanga |
| neke | E tohu ana i nukuhia te riu. |
Example
http://192.168.1.100:11000/Move?new=8&old=2
Nukuhia te riu i te turanga 2 ki te turanga 8 i te rarangi purei.
5.4 Maama Tutira
Whakaahuatanga
Ūkuia ngā riu katoa mai i te tūtira purei onāianei
Tono
/ Marama
| Tawhā | Whakaahuatanga |
| Karekau |
Whakautu
| Huanga Whakautu | Whakaahuatanga |
| whakarerekētia | Ko te tikanga o te 0 kaore i whakarereketia te rarangi mai i te utaina, 1 te tikanga kua whakarereketia te rarangi mai i te utaina. |
| roa | Te tapeke o nga riu i te rarangi o naianei. |
| id | Ko te id ahurei mo te rarangi o naianei. |
Example
http://192.168.1.100:11000/Clear
Ka tangohia nga riu katoa mai i te rarangi purei.
5.5 Tiaki Te Tutira
Whakaahuatanga
Tiakina te rarangi purei hei rarangi ingoa BluOS.
Tono
/Tiaki?ingoa=playlist_name
| Tawhā | Whakaahuatanga |
| ingoa | Ko te ingoa rarangi purei kua tiakina. |
Whakautu
126
| Huanga Whakautu | Whakaahuatanga |
| whakaurunga | Te tapeke o nga riu i roto i te rarangi purei kua tiakina. |
Example
http://192.168.1.100:11000/Save?name=Dinner+Music
Ka tiakina e tenei te rarangi purei hei "Waiata Dinner".
Tatūkē
Ko nga tono tatūkē ka taea e koe te whakarārangi i nga tatūkē katoa o te kaitākaro, te uta i te tatūkē, me te piki ake / whakaheke i nga tatūkē. Me taapiri me te whakakore i nga tatūkē ma te whakamahi i te taupānga BluOS Controller. Ka taea e nga tatūkē te whakauru i nga reo irirangi, nga reirangi me nga whakaurunga (hei tauira
Nihokikorangi, tairitenga, whatu, HDMI ARC).
6.1 Rarangi Tatūkē
Whakaahuatanga
Whakarārangihia ngā tatūkē katoa ki te kaitākaro BluOS o nāianei.
Tono
/Tautuhi
| Tawhā | Whakaahuatanga |
| Karekau |
Whakautu
<preset id=”6″ name=”Serenity” url=”RadioParadise:/42:4/Taiora”
image=”https://img.radioparadise.com/channels/0/42/cover_512x512/0.jpg”/>
<preset id=”7″ name=”1980s Alternative Rock Classics” url=”/Uta?service=Tidal&id=fd3f797e-
a3e9-4de9-a1e2-b5adb6a57cc7″ image=”/Artwork?service=Tidal&playlistimage=afacfc12-24034caf-a5c5-a2af28d811c8″/> </presets>
| Huanga Whakautu | Whakaahuatanga |
| whakakake | He id ahurei o te tatūkē kaitākaro. He rite ano ki te i roto i te /Tuanga whakautu. |
| ingoa | Ko te ingoa tatūkē. |
| id | Ko te id tatūkē. |
| url | Ko te tatūkē URL. Ko te puna tatūkē URL whakamahia ki te uta i te tatūkē. |
| whakaahua | Whakaahua URL o te tatūkē. Mena ko te URL ka timata ki te /Mahinga Toi ka puta pea ki te anga. Tāpiri tawhā/ kī followRedirects=1 Ka taea e te tiki te atahanga te karo i te anga. |
Example
http://192.168.1.100:11000/Presets
Whakarārangihia ngā tatūkē katoa ki te kaitākaro.
6.2 Utaina He Tatūkē
Whakaahuatanga
Ka timata te purei tatūkē. Ka taea e koe te kowhiri i tetahi tau tatūkē tauwhāiti, me te tatūkē panuku, o mua ranei. Ko nga tau tatūkē e kore e whai raupapa, ara, ka taea e koe te tatūkē 1,2,3 5, 7 me te 8. Tatūkē porowhita huri noa mai i runga ki raro me raro ki runga.
Tono
/Preset?id=presetId|-1|+1
| Tawhā | Whakaahuatanga |
| id | Te tau id o te tatūkē kia utaina. Ka kitea te rarangi o nga id tatūkē e waatea ana me te whakahau Whakaatu Tatūkē. Mena he +1 te id tatūkē, ka utaina te tatūkē panuku. Mena he -1 te id tatūkē, ka utaina te tatūkē o mua. |
Whakautu
Mena he rarangi ara te tatūkē ka whakahokia te maha o nga riu o te tatūkē kua utaina.
60
Mena he reo irirangi te tatūkē ka whakahokia te ahua o te awa.
awa
| Huanga Whakautu | Whakaahuatanga |
| ratonga | ingoa ratonga o te tatūkē kua utaina |
| whakaurunga | kua utaina nga riu tau o te tatūkē |
Example
http://192.168.1.100:11000/Preset?id=4
Utaina te tatūkē me te id tatūkē 4.
http://192.168.1.100:11000/Preset?id=+1
Tirotiro Ihirangi me te Rapu
Ko tenei waahanga e whakaatu ana i nga whakahau mo te tirotiro me te rapu ihirangi ratonga waiata.
7.1 Tirotiro Ihirangi Waiata
Whakaahuatanga
Whakatere i roto i nga puna waiata e waatea ana, tae atu ki nga whakaurunga me nga raarangi.
Ko te huanga putake mo nga whakautu ko ki te kore he whakautu hapa. Ko te nuinga o nga hua he raupapa o . I etahi wa ko te hua he raupapa o , kei roto i ia waahanga he raupapa mena . Ka whakaratohia nga uara katoa ma te whakamahi i nga huanga. Karekau he pona kupu.
Ko te hua o te waea / Tirotiro he hapa kei roto i te huānga pakiaka. Ko te taipitopito o te hapa ka tukuna ki tetahi me te kore, neke atu ranei kōpuku kupu.
Tono
/Tirotiro?key=key-value
/Tirotiro?key=key-value&withContextMenuItems=1
| Tawhā | Whakaahuatanga |
| kī | Tawhā kōwhiringa. Ko te kore o tenei tawhā ka puta he tirotiro taumata-runga. He whakahoki korero mo nga taumata ke atu i te taumata o runga /Tirotiro. Ka whakamahi i te uara ka tangohia mai i te uara huanga "browseKey", "NextKey", "parentKey", "contextMenuKey" ranei mai i te whakautu o mua. Tuhipoka: me noho te uara-matua URL whakawaeheretia |
| me ngaTuemiTaahua Horopaki | Tawhā kōwhiringa. Ko te uara he 1 tonu. Ka whakamahia tenei tawhā ki te tiki i te rarangi horopaki tahua i te wa e whiwhi ana koe i nga hua tirotiro o nga raarangi, pukaemi, ara, teihana, kaitoi, aha atu. |
Whakautu
Whakautu tirotiro taumata runga:
<item image=”/images/InputIcon.png” text=”Optical Input”
takaroURL=”/Takaro?url=Capture%3Ahw%3A1%2C0%2F1%2F25%2F2%2Finput1″ inputType=”spdif”
momo =”ororongo”/>
He whakautu tirotiro taumata ano:
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
service =”Deezer” searchKey =”Deezer:Rapu” type=”menu”>
item browseKey=”/Rārangipāpāho?service=Deezer&genre=0&category=toplist” text=”Rārangipāpāho rongonui”
momo =”hono”/>
momo =”hono”/>
momo =”hono”/>
item browseKey=”/Songs?service=Deezer&genre=0&category=toplist” text=”Waiata rongonui”
momo =”hono”/>
| Huanga Whakautu | Whakaahuatanga |
| Tirohia nga ripanga huānga/huanga i raro nei |
Example
FAKATOKANGA: Ko nga tawhā matua katoa me whakawaeheretia UTF-8.
http://192.168.1.100:11000/Browse
He tirotiro taumata runga.
http://192.168.1.100:11000/Browse?key=Tidal%3A
He tirotiro taumata tuarua, e whakahoki ana i nga waahanga Tidal.
http://192.168.1.100:11000/Browse?key=Tidal%3AmenuGroup%2F3
Ka tirotiro i te taumata tuatoru, ka whakahoki i nga waahanga iti o Tidal Masters (Rōpū 3).
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters
Ka tirotirohia te taumata tuawha, ka whakahoki i te huinga tuatahi o nga pukapuka Tidal Masters.
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters%26 start%3D30%26end%3D79
Kei te tirotiro ano i te taumata tuawha, ka whakahoki i te huinga tuarua o nga pukapuka a Tidal Masters.
| Huānga | Huanga (me nga uara) | Whakaahuatanga | |
| serviceIcon | Ko te URI mo tetahi ata mo te ratonga e tirotirohia ana i tenei wa. | ||
| ingoa ratonga | Ko te ingoa o te ratonga e tirotirohia ana i tenei wa, hei whakaatu i nga kaiwhakamahi. | ||
| Kī rapu | He uara hei whakamahi mo te tawhā matua ki te tono / Tirotiro ki te rapu i te ratonga o naianei (he waahanga hohonu ake ranei o te arowhai). I tua atu, me whai tawhā aq te tono kei roto te kupu rapu. | ||
| Pātuhi Panuku | He uara hei whakamahi mo te tawhā matua ki te tono /Tirotiro kia whiwhi i te wharangi o muri o nga mea mo te onāianei view. Ko te rahi o te tiihi wharangi kaore i raro i te mana o te kaiwhakamahi API, a kaua e ngana ki te tarai, ki te raweke ranei i nga tawhā patai o tenei uara. | ||
| matuaKey | He uara hei whakamahi mo te tawhā matua ki te tono / Tirotiro ki te whakatere whakamuri i te naakapa mena ka whakakorehia te whakatere whakamuri taunoa. | ||
| momo | tahua | He kōpuku whakaterenga kei roto pea he ranunga o tetahi momo tuemi. Ko te nuinga o nga wa ka hono noa nga taonga ororongo. | |
| Tahua horopaki | He rarangi o nga mea o te momo kua tohua. | ||
| kaitoi | |||
| Huānga | Huanga (me nga uara) | Whakaahuatanga | |
| kaitito waiata | |||
| pukaemi | |||
| rārangipāpāho | |||
| ara | |||
| momo | |||
| nga wahanga | Nga wahanga reta. | ||
| tūemi | rārangi hua whānui. Ko te nuinga he ranunga o nga pona tahua (momo = "hono") me nga taonga reo irirangi (momo = "ororongo"). | ||
| kōpaki | Kei roto pea he kōpakiroto, riu me te rārangipāpāho tāurunga. | ||
| kuputuhi | Te upoko mo te waahanga. | ||
| Pātuhi Panuku | He uara hei whakamahi mo te tawhā matua ki te tono / Tirotiro kia whiwhi i te wharangi o muri o nga taonga mo te waahanga. | ||
| matuaKey | He uara hei whakamahi mo te tawhā matua ki te tono / Tirotiro ki te whakatere whakamuri i te naakapa mena ka whakakorehia te whakatere whakamuri taunoa. | ||
| momo | hono | He kōpuku whānui i roto i te aroākapa tirotiro e ahu atu ana ki ētahi kōpuku | |
| ororongo | He node ka taea te purei tika | ||
| kaitoi | He taonga e tohu ana i tetahi kaitoi | ||
| Huānga | Huanga (me nga uara) | Whakaahuatanga | |
| kaitito waiata | He tūemi e tohu ana i te kaitito waiata | ||
| pukaemi | He tuemi e tohu ana i tetahi pukaemi, kohinga rite ranei | ||
| rārangipāpāho | He tūemi e tohu ana i te rārangipāpāho, kohinga rite rānei | ||
| ara | He tuemi e tohu ana i te riu kotahi | ||
| kuputuhi | He node kuputuhi tokau. | ||
| wahanga | He wahanga piapa. | ||
| kōpaki | He kōpaki kei roto i te kōpaki tirotiro. | ||
| kuputuhi | Raina matua tuatahi ranei o te whakaahuatanga taonga | ||
| kupu2 | Raina tuarua | ||
| whakaahua | He ata, he mahi toi ranei mo te taonga. Mena ka timata te ahua ki te
/Mahinga toi ka hua ake pea. Tāpiri tawhā/ kī followRedirects=1 Ka taea e te tiki te atahanga te karo i te anga. |
||
| browseKey | He uara hei whakamahi mo te tawhā matua ki te tono / Tirotiro ka whai ake ki te heke iho i te aroākapa. | ||
| takaroURL | He URI ka taea te tono tika ki te tono i te hohenga purei taunoa mo te mea e patai ana. I te nuinga o te wa ko te whakawātea i te tūtira ka tīmata ki te purei. | ||
| purei aunoaURL | He URI ka taea te tono tika ki te taapiri i tetahi riu ki te rarangi me te purei me te taapiri i nga riu o muri mai i te mea kei roto (penei i te pukaemi) ki te whakakii-aunoa | ||
| Huānga | Huanga (me nga uara) | Whakaahuatanga |
| wahanga o te rarangi whakaari. | ||
| contextMenuKey | He uara hei whakamahi mo te tawhā matua ki te tono / Tirotiro kia whiwhi ai i tetahi hua ko te tahua horopaki o nga mahi e pa ana ki te mea. | |
| mahiURL | He URI ka taea te tono tika ki te mahi i te mahi kua tohua. |
Ko nga taonga tahua horopaki ka whai uara e whai ake nei mo te huanga momo.
| Huanga | ||
| Whakaahuatanga | ||
| tino pai | - taapiri | Tāpirihia te tūemi hei tino pai (he rite ranei) |
| -muku | Tango i te tūemi mai i te makau a te kaiwhakamahi | |
| tāpiri | Tāpirihia ki te rārangi tākaro | |
| tāpiri | -inaianei | Tāpirihia ki te rārangi purei i muri i te riu o nāianei ka purei ināianei |
| -i muri mai | Tāpirihia ki te rārangi purei i muri i te riu o nāianei | |
| -whakamutunga | Tāpirihia ki te mutunga o te tūtira tākaro | |
| tāpiriKatoa | -inaianei | Tāpirihia te ahanoa riu-maha ki te tūtira purei ka purei inaianei |
| -i muri mai | Tāpiri ahanoa riu-maha ki te tūtira purei i muri i te riu o naianei, te ahanoa riu-maha ranei | |
| -whakamutunga | Tāpirihia te ahanoa riu-maha ki te mutunga o te tūtira purei | |
| pureiIrirangi | Whakatangihia he reo irirangi e pa ana ki te taonga | |
| whakakore | Mukua te ahanoa (ko te tikanga he rārangipāpāho). Me tono te haamauraa a te kaiwhakamahi |
I te wa e tirotiro ana me te tawhā “withContextMenuItem=1”, ko te hua ka mau i roto i te rarangi-rarangi tahua horopaki.
Example
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26genre%3D0%26category %3Dtoplist&withContextMenuItems=1
He tono Deezer => He aha te Wera => Pukaemi rongonui me te rarangi horopaki tahua.
Whakautu
Kei roto te whakautu i roto i te raina mo ia mea.
<item text=”Essonne History X” contextMenuKey=”Deezer:contextMenu/Album?albumid=693798541″
takaroURL=”/Add?service=Deezer&albumid=693798541&playnow=1″ image=”/Toi?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”
mahiURL=”/Add?service=Deezer&playnow=1&clear=0&shuffle=0&where=NextAlbum&albumid=693798541″/>
<item text=”Shuffle” type=”add-shuffle”
mahiURL=”/Taapiri?service=Deezer&shuffle=1&playnow=1&kei hea=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″/>
…
Nga Panui Whakatinana me nga Tohu
Ko te momo huanga o tetahi mea ka tukuna hei tohu ka taea e koe te whakahaere i nga whiringa whakaatu rereke.
Ko te kaha ki te tirotiro i nga ihirangi o tetahi mea ka tohuhia e te ahua o tetahi huanga browseKey. Ko te kaha ki te purei i tetahi mea (katoa) e tohuhia ana e te noho o tetahi whakaariURL (me te purei aunoa ano peaURL) huanga. He huanga browseKey pea tetahi mea me tetahi taakaroURL huanga.
Ina takaro rauaURL me te purei aunoaURL Kei te waatea nga huanga, ko tehea hei whakamahi hei whiringa takaro taunoa me waiho hei kaupapa mo te hiahia a te kaiwhakamahi.
Ko nga uara URI i te nuinga o te waa he URI whanaunga me tetahi waahanga ara tino. Ka whakatauhia nga URI whanaunga ki nga URI tino rite ki te RFC 3986.
Ko nga uara huanga browseKey, contextMenuKey me searchKey me whakawaeheretia URI i nga wa katoa (kua mawhiti te ōrau) ina whakamahia hei uara o te tawhā matua ki te tono / Tirotiro, me era atu tawhā tono.
Ina heke iho i te aroākapa tirotiro ka whai hua pea ma te pane wharangi UI te whakaatu i etahi momo kongakonga parāoa, ma te whakamahi pea i te taitara (kuputuhi) o nga pona matua me nga koroua.
Ka whai hua pea ki te watea i te tahua horopaki mo te matua i te wa e tirotiro ana i ana tamariki.
He pai pea te whakaaro ki te ahua o te matua i te wa e whakatau ana me pehea te whakaatu i ana tamariki.
7.2 Rapu Ihirangi Waiata
Whakaahuatanga
Tono ki te rapu i roto i te ratonga.
Tono
/Tirotiro?key=key-value&q=searchText
| Tawhā | Whakaahuatanga |
| kī | Ko te uara ka tangohia mai i te uara huanga "KeyKey" mai i te whakautu o mua |
| q | Ko te aho rapu. Mahia he rapunga o te horopaki kua tohua e te tawhā matua (i tangohia mai i te huanga rapuKey mai i te whakautu). Ki te kore he tawhā matua, mahia he rapunga taumata-runga. |
Whakautu
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
service =”Deezer” searchKey =”Deezer:Rapu” type=”menu”>
Whakahokia te taumata o runga o te hua rapu. Mo etahi atu kitenga rapunga mo nga Kaitoi, Pukaemi, Waiata, Rarangi Purei ranei, he whakahau tirotiro me te "Key Tirotiro" hei ki te hiahia.
Mo te exampki te kite i te hua rapu o nga Pukaemi, tuku whakahau:
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26expr%3Dmichael
Ka rite te whakautu ki te whakautu ki te whakahau noa /Tirotiro.
| Huanga Whakautu | Whakaahuatanga |
| Tirohia nga ripanga huānga/huanga kei te tono Tirotiro |
Example
http://192.168.1.100:11000/Browse?key=Deezer:Search&q=michael Rapua "michael" i roto i te ratonga puoro Deezer.
Whakarōpū Kaitākaro
Ko tenei waahanga e whakaatu ana i nga tono mo te whakarōpū kaitākaro taunoa me te wetewete. Kei te tautoko hoki a BluOS i te whakarōpūtanga kua whakaritea, kaore i te waahi mo tenei tuhinga.
Ka whakamahi a BluOS i te kupu kaitākaro tuatahi me te kaitākaro tuarua. Ko te kaitakaro tuatahi te kaitakaro matua o te roopu. Ka whakamahia te kaitakaro tuatahi ki te kowhiri i te puna waiata. Kotahi noa te kaitakaro tuatahi. Ka piri tetahi kaitakaro tuarua ki te kaitakaro tuatahi. He maha nga kaitakaro tuarua.
Mena he kaitakaro tuarua te kaitakaro, he maha nga tono, mena ka tukuna ki te kaitakaro tuarua, ka tukuna ki te kaitakaro tuatahi. Kei roto i enei ko te /Tūnga, Whakahaere Purei, Whakahaerenga Tutira purei me nga tono Tirotiro Ihirangi me te Rapu.
8.1 Rōpū Rua Kaitākaro
Whakaahuatanga
Whakarōpūhia tetahi kaitakaro tuarua ki tetahi kaitakaro tuatahi.
Tono
/AddSlave?slave=secondaryPlayerIP&port=secondaryPlayerPort&group=GroupIngoa
| Tawhā | Whakaahuatanga |
| taurekareka | Wāhitau IP o te kaitākaro tuarua. |
| tauranga | Tau tauranga o te kaitakaro tuarua. Ko te tau tauranga taunoa ko 11000. Ko nga kaitakaro penei i te NAD CI580, e wha nga kaitakaro me te IP kotahi, ka whakamahi i nga tauranga maha. |
| roopu | OPTIONAL, ingoa o te roopu. Ki te kore e whakaratohia, ka hoatu e BluOS he ingoa roopu taunoa. |
Whakautu
| Huanga Whakautu | Whakaahuatanga |
| tauranga taurekareka | Tau tauranga o te kaitakaro tuarua katahi ano ka whakarōpūhia. |
| Id | ID o te kaitakaro tuarua katahi ano ka whakarōpūhia. |
Example
http://192.168.1.100:11000/AddSlave?slave=192.168.1.153&port=11000
Ka whakarōpū tenei kaitakaro 192.168.1.153 ki te kaitakaro 192.168.1.100. Ko te kaitakaro 192.168.1.100 te kaitakaro tuatahi.
8.2 Tāpiri Kaitākaro Maha Ki Te Rōpū
Whakaahuatanga
Whakarōpūhia kia rua, neke atu rānei ngā kaitākaro ki tētahi kaitākaro tuatahi.
Tono
/AddSlave?slaves=secondaryPlayerIPs&ports=secondaryPlayerPorts
| Tawhā | Whakaahuatanga |
| taurekareka | Ko nga wahitau IP o nga kaitakaro tuarua hei taapiri atu ki te kaitakaro tuatahi. Kua wehea nga wahitau IP. |
| tauranga | Ko nga tauranga o nga kaitakaro tuarua hei taapiri atu ki te kaitakaro tuatahi. Ko nga tau tauranga kua wehea te piko. |
Whakautu
| Huanga Whakautu | Whakaahuatanga |
| tauranga | Ko te tauranga o te kaitakaro tuarua i whakarōpūhia. |
| Id | Ko te id o te kaitakaro tuarua i whakarōpūhia. |
Example
http://192.168.1.100:11000/AddSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Whakarōpūhia nga kaitakaro tuarua 192.168.1.153 me te 192.168.1.120 ki te kaitakaro tuatahi 192.168.1.100.
8.3 Tango Kotahi Kaiakaro Mai I Te Roopu
Tangohia tetahi kaitakaro mai i tetahi roopu. Mena ka tangohia tetahi kaitakaro tuarua mai i tetahi roopu, ka wehea te kaitakaro tuarua. Mena ka tangohia te kaitakaro tuatahi mai i te roopu o nga kaitakaro 3 neke atu ranei, ka wehea te kaitakaro tuatahi ka hanga roopu hou nga toenga o nga kaitakaro tuarua.
Tono
/RemoveSlave?slave=secondaryPlayerIP&port=secondaryPlayerPort
| Tawhā | Whakaahuatanga |
| taurekareka | IP o te kaitākaro (tuarua) ki te tāpiri ki tetahi atu kaitākaro (tuatahi). |
| tauranga | Ko te tauranga o te kaitakaro (tuarua) hei taapiri atu ki tetahi atu kaitakaro (tuatahi). |
Whakautu
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″
waitohu=”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″>
| Huanga Whakautu | Whakaahuatanga |
| Tirohia /SyncStatus mo nga taipitopito. |
Example
http://192.168.1.100:11000/RemoveSlave?slave=192.168.1.153&port=11000
Wewetehia te kaitakaro 192.168.1.153 mai i te roopu kei a ia te kaitakaro tuatahi 192.168.1.100
8.4 Tango i nga Kaitakaro maha mai i te roopu
Whakaahuatanga
Tangohia kia rua, neke atu ranei nga kaitakaro mai i te roopu.
Tono
/RemoveSlave?slaves=secondaryPlayerIPs&ports=secondaryPlayerPorts
| Tawhā | Whakaahuatanga |
| taurekareka | Ko nga wahitau IP o nga kaitakaro tuarua kia tangohia mai i te kaitakaro tuatahi. Kua wehea nga wahitau IP. |
| Tawhā | Whakaahuatanga |
| tauranga | Ko nga tauranga o nga kaitakaro tuarua kia tangohia mai i te kaitakaro tuatahi. Ko nga tau tauranga kua wehea te piko. |
Whakautu
<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>
| Huanga Whakautu | Whakaahuatanga |
| Tirohia /SyncStatus mo nga taipitopito. |
Example
http://192.168.1.100:11000/RemoveSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Ka tango i nga kaitakaro 192.168.1.153 me 192.168.1.120 mai i te roopu me te kaitakaro tuatahi 192.168.1.100.
Whakahou Kaioro
Ko tenei waahanga e whakaatu ana i te whakahau mo te whakaara ano i nga kaitakaro.
9.1 Whakaara Anō He Kaitākaro
Whakaahuatanga
Whakahoutanga ngawari he kaitakaro.
Tono
Tono POST / whakaara ano me te tawhā ae (tetahi uara)
| Tawhā | Whakaahuatanga |
| āe | Tetahi uara (hei tauira 1). |
Whakautu
Kua Whakahoutia nga Tautuhinga
Kei te whakaara ano. Katia koa tenei matapihi.
Taihoa koa…
Example
curl -d ae=1 192.168.1.100/whakahou
Paoro Paoro
Ko tenei waahanga e whakaatu ana i te whakahau mo te tangi o te pere tatau.
10.1 Paoro Paoro
Whakaahuatanga
Whakahohehia nga tangi pere kuaha.
Tono
http://PLAYERIP:PORT/Doorbell?play=1
| Tawhā | Whakaahuatanga |
| takaro | Purei pere kuaha (1 tonu) |
Whakautu
| Huanga Whakautu | Whakaahuatanga |
| taea | Tohua te tangi |
| rōrahi | Rōrahi tangi |
| whakatangitangi | Ororongo tangi |
Example
http://192.168.1.100:11000/Doorbell?play=1 play doorbell chime
Whakauru Tika
Ko tenei waahanga e whakaatu ana i nga tono mo te whiriwhiringa puna whakauru tika.
11.1 Kōwhiringa Whakauru Hohe
Whakaahuatanga
Kōwhiringa pūtake tāuru hohe. Ka mahi tenei whakahau mo nga whakaurunga hohe e puta ana i te whakautu ki /RadioBrowse?service=Capture. Ko te whiriwhiringa whakaurunga BluOS HUB e tautokohia ana e tenei whakahau anake.
Tono
/Takaro?url=URL_uara
| Tawhā | Whakaahuatanga |
| url | Ko te URL huanga mai i te whakautu ki /RadioBrowse?service=Hopu |
Whakautu
awa
| Huanga Whakautu | Whakaahuatanga |
| āhua | Tohua kei te purei te whakauru |
Example
Hipanga 1. Tikina te URL_uara mo te tawhā url
Tono: http://192.168.1.100:11000/RadioBrowse?service=Capture
Whakautu:
<item playerName=”Tick
Tohua" kuputuhi = "Nihokikorangi" inputType = "bluetooth" id = "whakauru2" URL=”Hopu%3Abluez%3Abluetooth” image=” /images/BluetoothIcon.png” type=”oro”/>
<item playerName=”Tick Tick” text=”Analog
Whakauru" inputType = "analog" id = "whakauru0" 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
Whakauru" inputType = "spdif" id = "whakauru1" URL=”Capture%3Ahw%3Aimxspdif%2C0%2F1%2F25%2F2%3Fid%
3Dinput1″ whakaahua =”/images/capture/ic_opticalinput.png” momo =”oro”/>
<item playerName=”Tick
Tohua” text="Spotify" id="Spotify" URL=”Spotify%3Aplay” image =”/Sources/images/SpotifyIcon.png” ratonga
Momo = "Ratonga Kapua" momo = "ororongo"/>
<remoteitem playerName=”Test Hub” text=”Analog Input” inputType=”analog” id=”hub192168114911000input0″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput0″
whakaahua =”/images/capture/i
c_analoginput.png”
momo =”ororongo”/>
<remoteitem playerName=”Test Hub” text=”Coaxial Input” inputType=”spdif” id=”hub192168114911000input3″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput3″
image =”/images/capture/ic
_opticalinput.png”
momo =”ororongo”/>
<remoteitem playerName=”Test Hub” text=”HDMI ARC” inputType=”arc” id=”hub192168114911000input4″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput4″
image =”/images/capture/ic
_tv.png”
momo =”ororongo”/>
<remoteitem playerName=”Test Hub” text=”Optical Input” inputType=”spdif” id=”hub192168114911000input2″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput2″
image =”/images/capture/ic
_opticalinput.png”
momo =”ororongo”/>
<remoteitem playerName=”Test Hub” text=”Phono Input” inputType=”phono” id=”hub192168114911000input1″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput1″
image =”/images/capture/ic
_vinyl.png”
momo =”ororongo”/>
Hipanga 2. Play Tauru Analog i runga i te kaitākaro
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
Tuhipoka: Me mohio kei te hono nga puna me te kore e huna.
11.2 Kōwhiringa Tāuru o waho
Whakaahuatanga
Kōwhiringa puna tāuru o waho. I etahi wa kaore pea nga whakaurunga o waho hohekore e puta mai i te whakautu ki
/RadioBrowse?service=Hopu. Ka mahi tenei tono mo te kowhiringa whakauru hohe me te hohekore. E taunaki ana mo te whiriwhiringa whakaurunga o waho o te CI.
Tono (Marō BluOS hou ake i te v3.8.0 me te pakeke ake i te v4.2.0)
/Play?inputIndex=IndexId
| Tawhā | Whakaahuatanga |
| whakauruIndex | Ko te taurangi (ka timata ki te 1) o nga whakaurunga ka puta ki te whakautu ki /Settings?id=capture&shcemaVersion=32 (32 ko te putanga aronuinga hou) i roto i te raupapa tau. Ka whakakorehia te Nihokikorangi. |
Whakautu
awa
| Huanga Whakautu | Whakaahuatanga |
| āhua | Tohua kei te purei te whakauru |
Example
Hipanga 1. Tikina te uara whakauruIndex
Tono: http://192.168.1.100:11000/Settings?id=capture&schemaVersion=32
Whakautu:
<menuGroup icon=”/images/settings/ic_capture.png” url=”/setting” id=”hopu”
displayName = "Whakaritea nga puna">
<setting icon=”/images/settings/ic_bluetooth.png” refresh=”true” url=”/audiomodes”
id=”bluetooth” displayName=”Nihokikorangi” uara=”3″ name=”bluetoothAutoplay” description=”Kua mono” te whakamaramatanga=”Ma te aratau a-ringa ka taea e koe te huri i waenga i nga puna i roto i te pouaka whakatere. Ka huri te aratau aunoa ki te puna Nihokikorangi ina timata tetahi taputapu Nihokikorangi hono ki te purei ororongo. Ka taea e koe te huri i waenga i nga puna i roto i te pouaka whakatere. Ka huri te aratau manuhiri ki te puna Nihokikorangi ina timata tetahi taputapu Nihokikorangi hono ki te purei ororongo. Mena ka huri koe ki tetahi atu puna, ka momotu a Nihokikorangi. Karekau te puna Nihokikorangi e puta ki te pouaka whakatere. Ka whakakorehia e te monoa te puna mai i te pouaka whakatere, karekau e whakaae kia hono atu tetahi atu taputapu ki te Kaipāho hei Nihokikorangi
puna.” class="rarangi">
…
<menuGroup icon=”/images/capture/ic_analoginput.png” url=”/setting” id=”captureinput0″
displayName =”Taurite
Whakauru”>
<menuGroup icon=”/images/capture/ic_opticalinput.png” url=”/setting” id=”capture-input1″
displayName = "Tauru Matapihi">
Ko te whakautu e whakaatu ana i te Nihokikorangi, te Taapiri Analog, me te Whakauru Optical. Ko te Nihokikorangi kua whakakorehia, no reira ko te uara inputIndex he 1 mo te Tauru Analog, ko te uara inputIndex he 2 mo te Whakauru Matapihi.'
Hipanga 2. Play Tāuru Optical i runga i te kaitākaro.
http://192.168.1.100:11000/Play?InputId=2
Tono (BluOS firmware v4.2.0 he mea hou ake ranei)
/Play?inputTypeIndex=$typeIndex
| Tawhā | Whakaahuatanga |
| tāuruTypeIndex | typeIndex te whakatakotoranga o momo-taupū o te whakaurunga. Anei te rarangi whakauru momo: spdif (Tauru Matapihi) tairitenga (Analog Input, Line In) coax (Coaxial Input) bluetooth pewa (HDMI ARC) earc (HDMI eARC) phono (Vinyl) rorohiko aesebu (AES/EBU) taurite (Tautika ki roto) hopuoro (Tukuoroorooro) Ko te taupū ka timata mai i te 1. Ina neke atu i te kotahi nga whakaurunga o te momo rite, ko te whakauru 1 kei a taupū 1, whakauru 2 kua taupū 2, me era atu. |
Whakautu
awa
| Huanga Whakautu | Whakaahuatanga |
| āhua | Tohua kei te purei te whakauru |
Example
Tono: http://192.168.1.100:11000/Play?inputTypeIndex=spdif-2 ki te kowhiri i te Whakauru Optical 2
Whakautu: awa
Nihokikorangi
Ko tenei waahanga e whakaatu ana i te whakahau ki te huri i te aratau Nihokikorangi.
12.1 Hurihia te Aratau Nihokikorangi
Whakaahuatanga
Hurihia te aratau Nihokikorangi: A-ringa, Aunoa, Manuhiri, Mono.
Tono
/audiomodes?bluetoothAutoplay=uara
| Tawhā | Whakaahuatanga |
|
bluetoothAutoplay |
Aratau Nihokikorangi uara Ko te 0 te tikanga a-ringa, 1 te tikanga Aunoa, te 2 te tikanga Manuhiri, 3 te tikanga mo te Haua. |
Karekau he whakautu
Example
Tono: http://192.168.1.100:11000/audiomodes?bluetoothAutoplay=3 ki te whakakore i te bluetooth
Apitihanga
13.1 Kawa Tuhura Ratonga Lenbrook
Kupu Whakataki
Ko nga tikanga rapu rongonui penei i te mDNS me te SSDP te whakamahi me te whakawhirinaki ki te UDP multicast whakawhitiwhiti. Ko te nuinga o nga hua Lenbrook o naianei e whakamahi ana i te mDNS mo te kitenga. Kia aroha mai, kua kitea e matou he maha o taatau kaihoko he whatunga kaainga kei te kore e tika te mahi a nga waka multicast me te kore e kitea pono a maatau taputapu. Na tenei kua maha nga hokinga mai o nga hua me nga amuamu mai i a maatau kaihoko.
Hei whakatika i tenei take kua hanga e matou he kawa whakahura ritenga e kiia nei ko LSDP e whakamahi ana i te purongo UDP. Ko nga whakamatautau tuatahi i whakaatu he pono ake tenei i te kitenga mai i te mDNS.
Kawa Mutuview
Ko tetahi whainga o tenei kawa he ngawari noa. Ka whakamahia pea i roto i nga taputapu whakauru he iti rawa te mahara.
Ka whakamahia e te kawa nga paanui panui UDP katoa mai i te tauranga UDP 11430. Kua rehitatia tenei tauranga ki te IANA, kua tohaina ki a Lenbrook mo te whakamahi LSDP mai i te Maehe 27, 2014.
Ka noho tonu ia node me tetahi ratonga ki te panui panui he panui panui mo ia meneti.
I te tiimatanga me te wa ka huri te rarangi ratonga, tawhā whatunga ranei, kia whitu nga paanui ka paohohia me nga wa poto kia tere ake ai te whakamohiotanga me nga huringa. Mo nga ratonga panui ponga ka uru ki enei kete tuatahi e whitu he panui Panui. Mo nga pona e ngana ana ki te rapu ratonga me whakauru nga paatete tuatahi e whitu he karere Uiui. Mo nga ratonga karekau i te watea, me whakauru nga paakete e whitu he karere Muku.
E whitu nga wa ka tukuna enei paakete tuatahi na te kore pono o nga paatete UDP. Mena karekau pea ka ngaro nga ratonga e whitu ka kitea tonu i muri mai i te meneti kotahi te panui panui.
Mena ka whiwhi te node i te karere Uiui mo tetahi karaehe ratonga kei te panui ka whakahoki mai me te panui Panui i muri i te wa roa ohorere, ka tautuhi ano i tana waahi Panuitanga o naianei.
Kei roto i te pane pane me nga paraka karere katoa nga mara roa. Ma tenei ka whaiwari ake, ka taea hoki nga huringa hototahi whakamuri kia mahia a meake nei. Ka taea te taapiri etahi atu mara, momo karere ranei a muri ake nei ka taea e nga whakatinanatanga tawhito te peke i te wa e poroporoaki ana. Mena i whakatau matou ki te huri whakamuri hotokore, tera ano he waahanga putanga kei te pane pane ka taea te whakanui ake.
Ka taea hoki e te kawa te whakauru i nga rekoata TXT me nga panui ratonga e rite ana ki nga rekoata TXT i whakamahia
me te mDNS. Ma tenei ka tino ngawari te whakauru atu o nga raraunga meta ki te ratonga
nga panui me te kore e whakarereke i te kawa.
Nga Taipitopito Kawa
Wā
Ko nga paatete katoa ka tukuna me whakarite ki te wa ohorere, ki te whakaroa ranei hei awhina i nga tukinga.
- Wā Mōkī Whakaoho: 7 Pākete i te wā = [0, 1, 2, 3, 5, 7, 10s] + (0 ki te 250ms matapōkere). He wa tuturu enei, ehara i te whakaroa. Me tuku katoa nga paatete e 7 i roto i te 10 hēkona.
- Wā Panui Matua: 57s + (0 ki te 6s matapōkere)
- Whakaroa Whakahoki Uiui: (0 ki te 750ms matapōkere)
ID Node
Me whai ID ahurei ia node ka taea te whakamahi hei tautuhi i te node. Ko te ID ahurei kei roto i te Panui me te Mukua nga karere. Ka taea e nga kaihoko te whakamahi i tenei uara hei matua matua i te wa e keteroki ana i nga uara me te tautuhi motuhake i tetahi node. Ka taea e tenei ID ahurei he wahitau MAC engari kia rite tonu mo ia atanga mena he maha nga atanga o te node e panuitia ana.
Hanganga Pakete
Ka timata ia kete ki te pane pane ka whai i te maha o nga paraka karere. Ka timata ia paraka karere ki tetahi mara roa kia taea te peke i nga karere kore mohio. Ki te kore e tauwhāitihia nga uara tau paita-maha ka penapena i te endian nui (nga paita tino nui i te tuatahi). Ki te kore e tohua he uara kore haina nga nama katoa. Mo te exampKo te roa o te paita kotahi te uara 0 ki te 255.
Pane Packet
| Mara | Paita | Whakaahuatanga |
| Te roa | 1 | Tapeke roa o te pane me tenei mara. |
| Kupu makutu | 4 | Ko tenei mara ko nga paita ASCII e wha o "LSDP". Ka awhina tenei i a maatau ki te tautuhi i nga paatete hei whakamahi kia kore ai e hiahia ki te tarai i nga raraunga matapōkere mai i etahi puna ohorere. |
| Putanga Kawa | 1 | Putanga o te kawa. Mena ka huri nga huringa ki te kawa whakamuri kaore i te hototahi ki tenei putanga |
| Mara | Paita Whakaahuatanga | |
| ka hurihia. Ko te putanga o naianei ko 1. | ||
Karere Uiui
| Mara | ||
| Paita | Whakaahuatanga | |
| Te roa | 1 | Tapeke roa o te karere me tenei mara. |
| Momo Karere | 1 | “Q” = 0x51: Uiui paerewa mo te whakautu haapurororaa. “R” = 0x52: Uiui mo te whakautu unicast. |
| Tatau | 1 | Te maha o nga karaehe hei patai. |
| akomanga 1 | 2 | 16 moka (2 paita) tautohu karaehe. |
| … | Whakahokia te mara o mua mo ia akomanga taapiri. | |
Panuitia te Karere
Panui Panui
| Mara | ||
| Paita | Whakaahuatanga | |
| Te roa | 1 | Tapeke roa o te karere tae atu ki te pane panui me nga rekoata panui. |
| Momo Karere | 1 | “A” = 0x41 |
| Node ID Roa | 1 | Te roa o te mara Node ID. |
| ID Node | Taurangi | Node ID ahurei o te node e tuku ana i te panui. Ko te tikanga tenei ko te wahitau MAC o tetahi o nga atanga node. |
| Wāhitau Roa | 1 | Te roa o te mara Wāhitau. Mo IPv4 ko te 4 tenei. |
| Mara | ||
| Paita | Whakaahuatanga | |
| Wāhitau | Taurangi | Wāhitau IP o te kōpuku. |
| Tatau | 1 | Te maha o nga rekoata panui hei whai. |
Panuitia te Rekoata
| Mara | Paita | Whakaahuatanga |
| Karaehe | 2 | 16 moka (2 paita) tautohu karaehe. |
|
Tatau TXT |
1 |
Te maha o nga rekoata TXT hei whai. Ki te kore ka waihohia nga mara e whai ake nei. |
| Kī 1 Te roa | 1 | Te roa o te ingoa matua. |
| Kī 1 | Taurangi | Ingoa matua. |
| Uara 1 Te roa | 1 | Te roa o te kuputuhi uara. |
| Uara 1 | Taurangi | Kuputuhi uara. |
|
… |
Whakahokia nga mara e 4 o mua mo ia rekoata TXT taapiri. |
Muku Karere
| Mara | ||
| Paita | Whakaahuatanga | |
| Te roa | 1 | Tapeke roa o te karere me tenei mara. |
| Momo Karere | 1 | “D” = 0x44 |
| Node ID Roa | 1 | Te roa o te mara Node ID. |
| ID Node | Taurangi | Node ID ahurei o te node e tuku ana i te karere. Ko te tikanga tenei ko te wahitau MAC o tetahi o nga pona |
| Mara | ||
| Paita | Whakaahuatanga | |
| taurangi. | ||
| Tatau | 1 | Te maha o nga karaehe hei whai. |
| akomanga 1 | 2 | 16 moka (2 paita) tautohu karaehe. |
| … | Whakahokia te mara o mua mo ia akomanga taapiri. | |
Taumahi ID akomanga
| ID akomanga | Whakaahuatanga | mDNS Ōrite |
| 0x0001 | BluOS Player | _musc._tcp |
| 0x0002 | Tūmau BluOS | _muss._tcp |
| 0x0003 | BluOS Player (tuarua i roto i nga kaitakaro-rohe maha penei i te CI580) | _musp._tcp |
| 0x0004 | sovi-mfg i whakamahia mo te whakamatautau whakangao. | _sovi-mfg._tcp |
| 0x0005 | papapātuhi sovi | _sovi-keypad._tcp |
| 0x0006 | BluOS Player (taurekareka takirua) | _musz._tcp |
| 0x0007 | Mamao Web Taupānga (AVR OSD Web Whārangi) | _mamao-web-ui._tcp |
| 0x0008 | BluOS Hub | _mush._tcp |
| 0xFFFF | Nga Karaehe Katoa - Ka taea te whakamahi me te Karere Uiui. |
Tuhipoka 1:
Ko te katoa o te paatete LSDP me noho hei raraunga rua.
Tuhipoka 2:
Ki te kore e taea e tetahi Karere Panui te pupuri i nga korero mokopuku katoa (ina koa ko CI580), ka wehea kia 2, neke atu ranei nga Karere Panui me ia Karere kei roto te Pane me te Rekoata me ia Karere kei te pupuri i te katoa o nga korero.
BluOS Ritenga Whakauru API Putanga 1.7
Tuhinga / Rauemi
 |
BluOS T 778 API Whakauru Ritenga [pdf] Pukapuka Kaiwhakamahi T 778, T 778 API Whakauru Ritenga, T 778, API Whakauru Ritenga, API Whakauru, API |