API njikọta omenala

API Njikọ Omenala T 778

The information contained in this manual is the property of Lenbrook Industries.
It is to be solely intended for professional use. Lenbrook Industries assumes no responsibility for the accuracy of the protocol. The protocol is provided “as-is”, with all faults and without warranty of any kind, either expressed or implied.

Amụma iji API

Site na ịnweta API, ị kwenyere na amụma ojiji API a (“Iwu”) yana Usoro anyị. Anyị na-enye API ndị a iji kwe ka ụlọ ọrụ na ndị mmadụ na-ewulite ma rite uru na Ọrụ anyị site na ịmepụta ngwanrọ, ọrụ, ma ọ bụ modul na-ejikọta na ikpo okwu anyị ma ọ bụ nweta data dị n'ime ikpo okwu anyị site na API anyị ("Mmekọrịta"). Iwu a bụ ma a ga-emeso ya dị ka akụkụ nke Usoro anyị.
A na-enye ngwanro a “DỊ KA Ọ BỤ”, na-enweghị ikike ụdị ọ bụla, ekwupụta ma ọ bụ akọwapụta ya, gụnyere mana ọnweghị oke na ikike nke ịzụ ahịa, mma maka otu ebumnuche na enweghị mmebi. Ọ nweghị ihe ọ bụla ndị odee ma ọ bụ ndị ji nwebiisinka agaghị akwụ ụgwọ maka nkwupụta ọ bụla, mmebi, ma ọ bụ ụgwọ ọzọ, ma ọ bụ n'ime nkwekọrịta, Tort ma ọ bụ ihe ọzọ, sitere na, sitere na ma ọ bụ na njikọ na ngwanrọ ma ọ bụ ojiji ma ọ bụ mmekọ ndị ọzọ na ngwanrọ ahụ.
Ekwenyere iji
Ịnweghị ike iji API izipu spam ma ọ bụ mee omume ọ bụla mebiri Amụma Oji anabatara yana Usoro ojiji anyị. Ị ga-erube isi n'iwu niile dị (gụnyere iwu nzuzo na iwu njikwa mbupụ nke United States, European GPR na ụkpụrụ na iwu na iwu mmachi akụ na ụba). Ị ga-eso akwụkwọ niile anyị nyere maka API. Ị gaghị anwa mbanye anataghị ikike ma ọ bụ gbanwee ka ọrụ ahụ si arụ ọrụ. Anyị nwere ike nyochaa ojiji ị na-eji API maka nnabata n'iwu ndị a, anyị nwekwara ike ịgọnarị gị ịnweta API ma ọ bụrụ na ị mebie Iwu a.
Nzuzo
Gị Integration must display a privacy policy for users detailing the information you will collect from them when they use the Integration. You will only access a user’s data to the extent permitted by the user and explained in your privacy policy. You must immediately delete a user’s data if the user requests deletion or terminates their account with you.
Nchekwa
Ị ga-emejuputa ma jikwaa usoro nchekwa teknụzụ na nhazi kwesịrị ekwesị iji chekwaa na ichekwa nchekwa, iguzosi ike n'ezi ihe na nzuzo nke data. Usoro nchekwa ndị a ga-egbochi ịnweta ma ọ bụ mkpughe nke data nkeonwe ma ọ bụ nzuzo nke ị na-ahazi.
Nwe
Anyị nwere ikike niile, aha, na mmasị na Ọrụ na API, gụnyere ikike ikike ọgụgụ isi, akara, koodu na atụmatụ niile. Ị gaghị emebi, tụgharịa injinia, ma ọ bụ detuo koodu anyị, imewe ma ọ bụ ọdịnaya anyị. Ị gaghị enweta API anyị iji soro Ọrụ anyị mpi. A na-egbochi ikike ọ bụla nke Iwu a enyeghị nke ọma, yabụ ọ bụrụ na ịhụghị ya ebe a, ọ bụghị ikike anyị na-ahapụ gị.
Iji akara
Ịnweghị ike iji aha na akara anyị (pụtara akara ngosi anyị, akara anyị na onyonyo nwebiisinka) n'ụzọ ọ bụla. Ị nwere ike ị gaghị agbanwe ma ọ bụ wepụ ọkwa ọ bụla nwe na akara anyị. Ị gaghị eji aha ma ọ bụ akara anyị n'aha njikọ ma ọ bụ akara gị, ma ọ bụ n'ụzọ ọ bụla nke na-egosi nkwado anyị.
Iji akara eme ihe
Ntuziaka ndị a na-akọwa otu ị ga-esi eji aha, akara na akụ anyị eme ihe mgbe niile. Ojiji gị na-egosi nnabata gị na ntuziaka ndị a, ma ị ghọtara na ojiji gị mebiri ụkpụrụ nduzi ndị a ga-ebute nkwụsị nke ikike gị iji aha, akara, na akụ anyị.

• Use of our name, marks and brand assets must be expressly authorized in writing.
• Do not change, modify, distort, copy, or imitate our Brand Assets in any way, including changing the colour, rotating and/or stretching. In other words, our Brand Assets must be kept in their original forms.
• Do not give our name, marks and brand assets undue prominence compared to your name and logo.
• Do not display our name, marks, and brand assets next to, or in any form of competitive marketing, without our express consent.
• Your use must not mislead consumers as to our sponsorship of, affiliation with or endorsement of your company or your products or services.
• Our name, marks and brand assets are our exclusive property. All goodwill that results from your use will be solely to our benefit. You will not take any action that is at odds with our rights or ownership.
• Our name, marks and brand assets must be used in a respectful manner and may not be used in a way that harms us, our products, or services, or in a manner which, in our opinion, lessens or otherwise damages our reputation or the goodwill in our name, marks and brand assets. In other words, please do not associate our assets with any illicit or illegal activities or use them in a way that is deceptive or harmful.

Examples nke anabatara ojiji:
"[Aha ngwaahịa gị] (dakọtara na / na-arụ ọrụ na BluOS)"
Examples nke anabataghị ojiji
"[Aha ngwaahịa gị] - BluOS"
“BluOS – [YOUR PRODUCT NAME]”
“[YOUR PRODUCT NAME] – Powered with BluOS”
Ịzụ ahịa na akwụkwọ akụkọ
Mgbe akwadochara ngwa gị, enwere ike depụta ya na nke anyị web Njirimara. Anyị na-agaghị ejikọta ọnụ na-ebipụta akwụkwọ akụkọ ma ọ bụ tinye aka na ahịa nke ngwa gị.
Before you distribute a press release about your app, make sure that you reach out to us at [EMAIL]. If you will be mentioning BluOS, then we will need to review the release. We recommend reaching out with your final press release as soon as possible.
Nkwuputa
To the maximum extent permitted by law, we provide the APIs as-is. That means we do not provide warranties of any kind, either express or implied, including but not limited to merchantability and fitness for a particular purpose.
Mmelite
We may update or modify the APIs and this Policy from time to time by posting the changes on this site or notifying you via email. These changes may affect your use of the APIs or the way your Integration interacts with the API. If we make a change that is unacceptable to you, you should stop using the APIs.
Nzuzo
You may have access to confidential, proprietary, and non-public information specific to the APIs (“Confidential Information”). You may use this information only to build with the APIs. You will not disclose the Confidential Information to anyone without our written consent, and you will protect the Confidential Information from unauthorized use and disclosure in the same way you would protect your own confidential information.
Indemnification
You will indemnify and hold us and our Team harmless from any losses (including attorney fees) that result from third-party claims that relate to your use of the API.
The Rest
This Policy does not create or imply any partnership, agency, or joint venture. This Policy will apply for as long as you use the APIs or until terminated in accordance with our Terms. In the event of a conflict between this Policy and the Standard Terms of Use, the Standard Terms of Use shall control.
©2025 LENBROOK INDUSTRIES LIMITED
633 Granite Court, Pickering, Ontario, Canada L1W 3K1
Ikike niile echekwabara
Enweghị akụkụ nke akwụkwọ a nwere ike ịmegharị, chekwaa ma ọ bụ bufee n'ụdị ọ bụla na-enweghị ikike ederede nke Lenbrook Industries Limited. Ọ bụ ezie na agbaala mbọ niile iji hụ na ọdịnaya ziri ezi n'oge mbipụta, njirimara na nkọwapụta nwere ike ịgbanwe n'enweghị ọkwa.

Akụkọ ngbanwe
Ụdị	Ụbọchị	Nkọwa
1.0	6/17/2019	Ntọhapụ mbụ
1.2	01/12/2022	Added soft reboot, doorbell chime, volume up/down, move track in queue, and direct input commands. Added note to Appendix LSDP.
1.4	04/26/2022	Added mute command; modified direct input commands for HUB; updated Play command to play streamed custom audio.
1.5	07/18/2022	Added Bluetooth command; Updated LSDP to add class 5 to 8; Added “Practical Use of Marks” in API Use Policy.
1.6	03/13/2024	Added a note for /Status for grouped players in sect 2; Added /Play?seek=seconds is=trackid in sect 4.1;
1.7	04/09/2025	Akụkụ 8.3 emelitere example; Arịrịọ nchọgharị menu onodu ahịrị agbakwunyere example in section 7.1; Added new direct input selection command in section 11.2; Updated section 6.1 to add “image” attribute for presets; Added “followRedirects=1” comment for all image attributes; Updated the explanation of attributes playURL ma tinye-ugbu a na ngalaba 7.1

Okwu mmalite

BluOS™ is an advanced operating system and music management software that allows you to access and stream lossless music up to 24-bit/192kHz to every room using your home network. BluOS can be found in products from Bluesound, NAD Electronics, DALI Loudspeakers and others.
Emepụtara akwụkwọ a iji nyere ndị mmepe na ndị na-emekọ ihe na sistemụ na-arụ ọrụ n'ahịa njikọta omenala (CI). O nwere akụkụ nke arịrịọ API edekọrọ na BluOS API Control Protocol.
Arịrịọ niile akọwara n'ime akwụkwọ a ka ezigara dị ka arịrịọ HTTP GET. Paragraf ndị ahụ bụ ọkọlọtọ URL agbakwunyere aha/otu uru bara uru. Ndị egwuregwu BluOS na-enweta iwu ndị a wee zaghachi na UTF-8 agbakwunyere data XML.
Arịrịọ niile dị n'ụdị http:// : / ebe:

• player_ip is the IP address of the BluOS player (e.g., 192.168.1.100)
• port is the TC port used for communications. Port 11000 is used for all BluOS players, with the exception of the CI580. The CI580 has four streamers nodes in one chassis, where node 1 uses port 11000, node 2 uses port 11010, node 3 uses port 11020, and node 4 uses port 11030. The actual port to use should be discovered by use of the MDNS protocol using the services musc.tcp and musp.tcp.
• request is the actual BluOS command or query (e.g., Play)

Mara: This document will use http://192.168.1.100:11000 as player IP and port in all examples.

Status Queries

A na-eji ajụjụ ọnọdụ wee jụọ onye ọkpụkpọ BluOS ajụjụ.
BluOS na-enye usoro abụọ maka ịme ajụjụ ọnọdụ; ntuli aka mgbe nile na ogologo ntuli aka. Ntuli aka oge niile na-eweghachi nsonaazụ ajụjụ ozugbo. Ogologo ntuli aka na-edobe njikọ maka oge a kapịrị ọnụ, ma na-eweghachi naanị nsonaazụ ajụjụ mgbe ozi agbanweela ma ọ bụ kwụsịchaa. Ogologo ntuli aka nwere ike ibelata ọnụ ọgụgụ oku a na-akpọ onye ọkpụkpọ.
Mgbe a naghị eji ntuli aka ogologo oge, ndị ahịa kwesịrị igbochi ọnụego ntuli aka ha ka ọ bụrụ otu arịrịọ kwa sekọnd 30 ọ bụla. Mgbe a na-eji ogologo ntuli aka, onye ahịa agaghị arịọ arịrịọ ugboro abụọ maka otu akụ ihe na-erughị otu sekọnd, ọbụlagodi na arịrịọ mbụ lọghachiri n'ihe na-erughị otu sekọnd.
Arịrịọ ntuli aka ogologo na-ewere parampat abụọ: nkwụsị oge na etag. oge nkwụsị bụ oge nke arịrịọ ogologo ntuli aka na etag a na-ewepụta site na nzaghachi gara aga (àgwà dị na mgbọrọgwụ nke nzaghachi).
Na mkpokọta, ọ dị mkpa naanị ịnwe ntuli aka ogologo maka otu n'ime / Ọnọdụ ma ọ bụ / SyncStatus. Nzaghachi / Ọnọdụ gụnyere ihe mmewere ( ) nke na-egosi ma /SyncStatus agbanweela. / SyncStatus kwesịrị ịkpọpụta ma ọ bụrụ na naanị aha, olu na ọkwa mkpokọta nke onye ọkpụkpọ bụ mmasị. Ekwesịrị ịkpọpụta ọkwa ma ọ bụrụ na achọrọ ọkwa ọkpụkpọ ugbu a.
Mgbe a na-agbakọ ndị egwuregwu, onye na-egwu egwuregwu bụ isi n'ime otu. Ndị egwuregwu nke abụọ na-ejikọta na onye ọkpụkpọ nke mbụ. /Nzaghachi ọnọdụ nke ndị egwuregwu sekọndrị bụ nnomi nke onye ọkpụkpọ mbụ. /SyncStatus ogologo ntụli aka dị mkpa iji soro olu nke ọkpụkpọ nke abụọ ọ bụla.
2.1 Ọnọdụ ọkpụkpọ
Nkọwa
The /Status endpoint queries volume and playback information. This query returns many response attributes,
some of which are not applicable to this document. Undocumented responses should be ignored.
Arịrịọ
/Ọnọdụ?Oge-oge =sekọnd&etag=etag-uru

Oke	Nkọwa
nkeji oge	Oke nhọrọ ejiri mee ntuli aka ogologo. Ogologo oge ntuli aka akwadoro bụ 100 sekọnd ma kwesịrị ịbụ oke na ọnụego sekọnd 60 ma ọ bụ karịa na ọ dịghị ngwa ngwa karịa sekọn 10.
etag	Oke nhọrọ ejiri mee ntuli aka ogologo. Nke a bụ etag àgwà si

Oke	Nkọwa
	Nzaghachi oku gara aga / Ọnọdụ.

Nzaghachi
<status etag=”4e266c9fbfba6d13d1a4d6ff4bd2e1e6″>
<album>÷ (Deluxe)</album>
<artist>Ed Sheeran</artist>
<canMovePlayback>true</canMovePlayback>
<canSeek>1</canSeek>
<cursor>159</cursor>
Deezer: 142986206
<image>/Artwork?service=Deezer&songid=Deezer%3A142986206</image>
<indexing>0</indexing>
<mid>187</mid>
<mode>1</mode>
<name>Perfect</name>
<pid>1054</pid>
<prid>0</prid>
<quality>320000</quality>
<repeat>2</repeat>
<service>Deezer</service>
<serviceIcon>/Sources/images/DeezerIcon.png</serviceIcon>
<shuffle>0</shuffle>
<sid>8</sid>
<sleep/>
<song>19</song>
kwụsịtụ
<streamFormat>MP3 320 kb/s</streamFormat>
<syncStat>5</syncStat>
<title1>Perfect</title1>
<title2>Ed Sheeran</title2>
<title3>÷ (Deluxe)</title3>
<totlen>263</totlen>
<volume>4</volume>
<secs>35</secs>
</status>
IHE: not all response attributes are listed in the following chart. Other elements may be present and should be ignored.

Àgwà nzaghachi	Nkọwa
etag	Attribute of the response root element. Opaque value used with long-polling to detect response changes. If the value has not changed since the previous response then the response is guaranteed not to have changed (but see also secs below)
alarm seconds remaining	If playback is the result of an alarm, then this is how many seconds before it will stop.
ime ihe	See Actions for Streaming Radio Stations section for description.
album	Album name of the current active track. Also see title1 attribute.
artist	Artist name of the current active track. Also see title1 attribute.
batrị	Shown if the player has a battery pack. Includes attributes: ·  level – state of charge, percent ·  charging – 1 if currently charging ·   icon – URL onyonyo ọkpụkpọ na-egosi steeti ụgwọ dị ugbu a
canMovePlayback	Is true if it is possible to move the current playing or paused content to another player.
canSeek	If 1 then it is possible to scrub through the current track, in the range 0..totlen, by use of the seek parameter to /Play. For example: /Play?seek=34.
db	Ọkwa olu na dB.
group Name	Name of the group. The player must be the primary player in the group.
group Volume	Volume level of the group. The player must be the primary player in the group.
onyonyo	URL onyonyo jikọtara ya na ọdịyo dị ugbu a (albọm, ọdụ, ntinye, wdg). Ọ bụrụ

Àgwà nzaghachi	Nkọwa
	nke URL starts with /Artwork it may result in redirect. Adding a parameter/key followRedirects=1 when retrieving the image can avoid redirect.
mechie ogbi	Mute state. Set to 1 if volume is muted.
ogbiDb	if the player is muted, then this contains the unmuted volume in dB.
ogbi	If ther is muted, then this contains the unmuted volume level. Values are from 0 to 100.
aha	The title of the current playing audio track. Also see title1 attribute.
gwaurl	URL for a pop up notification.
id	The unique play queue id. It matches the id attribute of the /Playlist response. If the play queue is changed this number will change.
kpochapu	The unique preset id. It matches the prid attribute in the /Presets response. If a preset is changed this number will change indicating that any cached response to /Presets should be purged.
àgwà	Quality of the playing source audio: ·  cd – losless audio at CD quality ·  hd – lossless audio with higher resolution that CD quality or sample- rate of 88200 samples/s ma ọ bụ karịa ·  dolbyAudio – DolbyDigital or AC3 ·  mqa – valid MQA audio decoded ·   mqaAuthored – valid MQA-Authored audio decoded Ọnụọgụ ọnụọgụgụ bụ mkpokọta bitrate nke ogo isi iyi ọdịyo abịakọrọ file.
kwugharịa	0, 1, or 2. 0 means repeat play queue, 1 means repeat a track, and 2 means repeat off
sk	Number of seconds the current audio track has been played. This value is not used in the calculation of etag and progress will not of itself cause a return from a long-polling call. Clients are required to increment the playback position, when state is play or stream, based on the interval since the response.
ọrụ	The service id of the current audio. This is not a value for displaying in a UI, as the

Àgwà nzaghachi	Nkọwa
	ezigbo eriri nwere ike ịdị iche na aha ọrụ gọọmentị.
akara ọrụ	URL nke akara ngosi ọrụ ugbu a.
ichikota	0 ma ọ bụ 1. 0 pụtara ịgbanyụ ma 1 pụtara ịgbanye.
ura	Nkeji fọdụrụ tupu ngụ oge ihi ụra arụ ọrụ.
egwu	Ọnọdụ egwu dị ugbu a na kwụ n'ahịrị egwuregwu. hụkwa iyiUrl.
steeti	The current player state. It could be play, pause, stop, stream, connecting, etc. /Play can be used to resume when in a pause state but not when in stop state. play and stream should be considered to have the same meaning. Also see streamUrl.
stationImage	URL for the image of a radio station, if the current audio is a radio station, e.g., Deezer radio. It may be the same as image.
streamFormat	Format of the audio.
iyiUrl	The presence of this element should be treated as a flag and its contents as an opaque value. If present it indicates: ·  the play queue is not the source of the current audio (song is irrelevant) ·  shuffle and repeat are not relevant and should be removed from any UI if possible ·   next and previous are not available (but see also actions)
syncstat	The unique id to indicate any change in /SyncStatus response. It matches the syncStat attribute of the /SyncStatus response. It changes whenever there is a change in Sync Status.
title1	The first line of information describing the current audio. title1, title2 and title3 MUST be used as the text of any UI that displays three lines of now-playing metadata. Do not use values such as album, artist and name.
title2	The second line of information describing the current audio.
title3	Ahịrị ozi nke atọ na-akọwa ọdịyo dị ugbu a.
totlen	Total length of the current track, in seconds.
twoline_title1	The first of two lines describing the current audio. twoline_title1 & twoline_title2, if present, MUST be used as the text of any UI that displays two

Àgwà nzaghachi	Nkọwa
	ahịrị metadata na-egwu ugbu a.
twoline_title2	Ahịrị abụọ nke abụọ na-akọwa ọdịyo dị ugbu a.
olu	Ọkwa olu ọkpụkpọ na pasentịtage; -1 pụtara olu ọkpụkpọ edoziri.
sk	Ọnụọgụ nke sekọnd nke egwu ọdịyo dị ugbu a ka akpọọla.

Example
http://192.168.1.100:11000/Status
Gets the playback status of the player.
http://192.168.1.100:11000/Status?timeout=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Gets the playback status of the player using long-polling. A result is only returned before the timeout of 100 seconds if the player’s status has changed. Otherwise, the result is returned after 100 seconds.
2.2 Onye ọkpụkpọ na ọnọdụ mmekọrịta otu
Nkọwa
Ajụjụ SyncStatus weghachiri ozi ọkpụkpọ na ozi nchịkọta ọkpụkpọ. Ajụjụ a weghachiri ọtụtụ njirimara nzaghachi, ụfọdụ n'ime ha anaghị emetụta akwụkwọ a. Ekwesịrị ileghara nzaghachi na-enweghị akwụkwọ anya.
Arịrịọ
/SyncStatus?mgbe oge =sekọnd&etag=etag-uru

Oke	Nkọwa
nkeji oge	Oke nhọrọ ejiri mee ntuli aka ogologo. Ọ bụ oge ntuli aka na sekọnd. Ogologo oge ntuli aka akwadoro bụ 180 sekọnd.
etag	Oke nhọrọ ejiri mee ntuli aka ogologo. Nke a bụ etag attribute from the previous /SyncStatus call response.

Nzaghachi
<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=”true” group=”PULSE-0278 + 2″ syncStat=”23″ id=”192.168.1.100:11000″ mac=”90:56:82:9F:02:78″> <master port=”11000″>192.168.1.100</master>


…….

IHE: Ọ bụghị àgwà nzaghachi niile ka edepụtara na chaatị a. Ihe ndị ọzọ nwere ike ịdị adị ma ekwesịrị ileghara ya anya.

Àgwà nzaghachi	Nkọwa
batrị	Shown if the player has a battery pack. Includes attributes: · level – state of charge, percent ·  charging – 1 if currently charging ·  icon – URL onyonyo ọkpụkpọ na-egosi steeti ụgwọ dị ugbu a
ika	Player brand name.
db	Ọkwa olu na dB.
etag	Tag of the /SyncStatus response, used for long polling.
otu	The group name.
akara ngosi	URL that contains the player icon image.
id	Player IP and port.
ibido	True means the player is already setup, false means the player needs setup. The player must be setup with the BluOS Controller app.
mac	Player unique id for network interface. May be a MAC address.
nna ukwu	Master player IP address. Only present if a player is a secondary player in a group. Attributes: ·  port – port number. ·  reconnecting – true if trying to reconnect to primary player
ihe nlereanya	Player model id.
aha nlereanya	Player model name.
mechie ogbi	Set to 1 if volume is muted.
ogbiDb	Ọ bụrụ na akpọchiri onye ọkpụkpọ ahụ ogbi, nke a bụ ọkwa olu emechiri emechi na dB.

Àgwà nzaghachi	Nkọwa
ogbi	Ọ bụrụ na akpọchiri onye ọkpụkpọ ahụ ogbi, nke a bụ ọkwa olu emechiri emechi (0..100).
aha	Player name.
schemaVersion	Software schema version.
ohu	Secondary player(s) IP addresses. Only present if player is the primary player of a group. There can be multiple secondary players. Attributes: ·  id – IP address ·  port – port number
syncstat	id nke mmekọrịta ọnọdụ. A na-agbanwe ya mgbe ọ bụla agbanwere ihe ọ bụla dị na /SyncStatus nzaghachi. Dakọtara na mmewere na /Nzaghachi ọnọdụ.
olu	Ọkwa olu na nha 0..100. -1 pụtara ụda olu.
mpaghara	Aha nke otu edozi.
zoneMaster	Ọ bụrụ na onye ọkpụkpọ bụ onye ọkpụkpọ mbụ n'ime otu a kapịrị ọnụ, nke a ka edobere ka ọ bụrụ eziokwu.
zone ohu	Ọ bụrụ na onye ọkpụkpọ ahụ bụ onye ọkpụkpọ nke abụọ na otu etinyere, edobere nke a ka ọ bụrụ eziokwu.

Example
http://192.168.1.100:11000/SyncStatus
Gets the player and group status of the player.
http://192.168.1.100:11000/SyncStatus?timeout=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Gets the player and group status of the player using long-polling. A result is only returned before the timeout of 100 seconds if the player’s status has changed. Otherwise, the result is returned at 100 seconds.

Njikwa olu

Na-edozi ọkwa olu nke ọkpụkpọ. A na-ejikwa ogbi mechie onye ọkpụkpọ.
3.1 Tọọ olu
Nkọwa
Arịrịọ a na-ajụ ajụjụ ma ọ bụ na-edozi olu ọkpụkpọ.
Ọdịiche dị iche iche nke iwu, ma ọ na-eji ọkwa 0..100, dB zuru oke ma ọ bụ paramita dB ikwu, na-egbochi ụkpụrụ nke na-ebute ọkwa n'ime oke olu ahaziri, nke na-abụkarị -80..0. Enwere ike ịhazi oke oke site na iji ngwa njikwa BluOS, na Ntọala -> Ihe ọkpụkpọ -> ibe ọdịyo.
Ajụjụ a na-akwado ntuli aka ogologo (anaghị egosipụta n'okpuru).
Arịrịọ
/ Mpịakọta
/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

Oke	Nkọwa
ọkwa	Tọọ ọkwa ụda olu zuru oke nke onye ọkpụkpọ. Ọ bụ ọnụọgụgụ sitere na 0-100.
gwa_ndị ohu	Na-emetụta ndị egwuregwu agbakọtara. Ọ bụrụ na atọrọ na 0, naanị onye ọkpụkpọ ahọpụtara na-agbanwe olu. Ọ bụrụ na atọrọ na 1, mgbe ahụ ndị egwuregwu niile na-agbanwe olu.
mechie ogbi	Ọ bụrụ na atọrọ na 0, a na-emechi ihe ọkpụkpọ ahụ. Ọ bụrụ na atọrọ na 1, a ga-ewepụ ihe ọkpụkpọ ahụ.
abs_db	Tọọ olu site na iji ọnụ ọgụgụ dB.
db	Do a relative volume change using a dB volume scale. db can be a positive or negative number.

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

Àgwà nzaghachi

Nkọwa

Àgwà nzaghachi	Nkọwa
db	Ọkwa olu na dB.
mechie ogbi	1 ma ọ bụrụ na emechiri ihe ọkpụkpọ, 0 ma ọ bụrụ na ewepụghị ihe ọkpụkpọ.
ogbiDb	Ọ bụrụ na akpọchiri onye ọkpụkpọ ahụ ogbi, nke a bụ ọkwa olu emechiri emechi na dB.
ogbi	Ọ bụrụ na akpọchiri onye ọkpụkpọ ahụ ogbi, nke a bụ ọkwa olu emechiri emechi (0..100).
olu	Ọkwa olu dị ugbu a: 0..100 ma ọ bụ -1 maka olu edoziri.

Example
http://192.168.1.100:11000/Volume?level=15
Sets the player volume level to 15 (out of 100).
http://192.168.1.100:11000/Volume? tell_slaves=1&db=2
Increases the volume of master player 192.168.1.100, and all of the secondary players in that group, by 2 dB.
http://192.168.1.100:11000/Volume?mute=1
Mutes the player.
3.2 Oke elu
Nkọwa
Arịrịọ a na-abawanye olu site na ụfọdụ dB (uru na-ahụkarị bụ 2dB).
Arịrịọ
/Mpịakọta?db=db_uru

Oke	Nkọwa
db	Usoro mmụba olu na dB (ụkpụrụ a na-ahụkarị 2dB)

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

Àgwà nzaghachi	Nkọwa
db	Ọkwa olu na dB.
mechie ogbi	1 ma ọ bụrụ na emechiri ihe ọkpụkpọ, 0 ma ọ bụrụ na emechirighị ihe ọkpụkpọ

Àgwà nzaghachi	Nkọwa
akwụ ụgwọDb
etag

Example
http://192.168.1.100:11000/Volume?db=2
Increase the volume by 2dB.
3.3 Mpịakọta ọnụ
Nkọwa
Arịrịọ a na-ebelata olu site na ụfọdụ dB (uru na-ahụkarị bụ -2dB).
Arịrịọ
/Mpịakọta?db=-db_value

Oke	Nkọwa
db	Usoro mmụba olu na dB (ụkpụrụ a na-ahụkarị -2dB)

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

Àgwà nzaghachi	Nkọwa
db	Ọkwa olu na dB
mechie ogbi	1 ma ọ bụrụ na emechiri ihe ọkpụkpọ, 0 ma ọ bụrụ na emechirighị ihe ọkpụkpọ
akwụ ụgwọDb
etag

Example
http://192.168.1.100:11000/Volume?db=-2
Decrease the volume by 2dB.
3.4 Gbanye ogbi
Nkọwa
Arịrịọ
/Mpịakọta?Ogbi=1

Oke	Nkọwa
mechie ogbi	Tọọ ka ọ bụrụ 1 ka o mechie ọkpụkpọ

Nzaghachi
<volume muteDb=”-43.1″ db=”100″
muteVolume=”11″
mute=”1″
offsetDb=”0″
etag=”2105bed56563d9da46942a696cfadd63″>0</volume
>

Àgwà nzaghachi	Nkọwa
ogbiDb	Ọkwa olu na dB tupu ogbi
db	Ọkwa olu na dB
ogbi	Ọkwa olu na pasent tupu ogbi
mechie ogbi	1 pụtara na akpọchiri akpọchi
akwụ ụgwọDb
etag

Example
http://192.168.1.100:11000/Volume?mute=1
3.5 Gbanyụọ ogbi
Nkọwa
Arịrịọ a na-edobe onye ọkpụkpọ ka iwepu ụda.
Arịrịọ
/Mpịakọta?Ogbi=0

Oke	Nkọwa
mechie ogbi	Tọọ 0 ka iwepu ụda olu egwu

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

Àgwà nzaghachi	Nkọwa
db	Ọkwa olu na dB
mechie ogbi	0 means the player is not muted
akwụ ụgwọDb
etag

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

Njikwa playback

A na-eji iwu ndị a maka njikwa ọkpụkpọ nkiti. Iwu gụnyere egwuregwu, kwụsịtụ, kwụsị, mawuo, azụ, megharịa, na kwugharịa.
4.1 Gwuo
Nkọwa
Malite ịkpọghachi nke isi iyi ọdịyo dị ugbu a. Nhọrọ nhọrọ na-enye ohere ịwụba n'ime egwu ọdịyo, yana ntinye ka ahọpụtara, tupu ịmalite ịkpọghachi ọdịyo.
Arịrịọ
/Play
/Play?seek=seconds
/Play?seek=seconds&id=trackid
/Egwuregwu?url= encodedStreamURL

Oke	Nkọwa
chọọ	Malie gaa n'ọnọdụ akọwapụtara na egwu dị ugbu a. Ọ dị naanị ma ọ bụrụ / nzaghachi ọnọdụ gụnyere . Enweghị ike iji ntinye ụdị na paramita index.
encodedStreamURL	URL nke streamed custom audio. Ọ ga-abụrịrị URL etinyere ya.

Nzaghachi
<state>play</state>
iyi

Àgwà nzaghachi	Nkọwa
steeti	Steeti mgbe emechara iwu ahụ. Hụ / Ọnọdụ nzaghachi njirimara steeti maka nkọwa ndị ọzọ.

Example
http://192.168.1.100:11000/Play
Malite ịkpọghachi ọdịyo nke egwu dị ugbu a.
http://192.168.1.100:11000/Play?seek=55
Malite ịkpọghachi ọdịyo na sekọnd 55 n'ime egwu dị ugbu a.
http://192.168.1.100:11000/Play?seek=55&id=4
Start audio playback at 55 seconds into the track number 5 in the queue.
192.168.1.125:11000/Play?url=https%3A%2F%2Fwww%2Esoundhelix%2Ecom%2Fexamples%2Fmp3%
2FSoundHelix-Song-1%2Emp3
Start audio playback of an online mp3 audio.
4.2 kwusi
Nkọwa
Kwụsịtụ ọdịyo a na-akpọ ugbu a.
Ọ bụrụ na oti mkpu na-akpọ, ma ọ nwere nkwụsị oge, mgbe ahụ, a kagbuola oge nkwụsị.
Arịrịọ
/kwụsịtụ
/kwụsịtụ?toggle=1

Oke	Nkọwa
tụgharịa	Ọ bụrụ na atọrọ na 1, yabụ ọnọdụ nkwụsịtụ dị ugbu a ka agbanwere.

Nzaghachi
kwụsịtụ

Àgwà nzaghachi	Nkọwa
steeti	Steeti mgbe emechara iwu ahụ. Hụ / Ọnọdụ nzaghachi njirimara steeti maka nkọwa ndị ọzọ.

Example
http://192.168.1.100:11000/Pause
Pauses the currently playing audio.
4.3 Kwụsị
Nkọwa
Stop the current playing audio. If an alarm is playing, and it has a timeout, then the alarm timeout is canceled Request
/Kwụsị

Oke	Nkọwa
Ọ dịghị

Nzaghachi
Kwụsị

Àgwà nzaghachi	Nkọwa
steeti	"kwụsị" pụtara akwụsịla ọdịyo dị ugbu a.

Example
http://192.168.1.100:11000/Stop
Stops the currently playing audio.
4.4 Gaba
Nkọwa
Gaa na egwu ọdịyo na-esote na kwụ n'ahịrị egwuregwu
Mgbe a na-egwuri egwu site na kwụ n'ahịrị egwuregwu, ọ ga-amaba na egwu na-esote na kwụ n'ahịrị. Ọ bụrụ na egwu dị ugbu a bụ nke ikpeazụ na kwụ n'ahịrị, ịkpọ /Skip ga-aga na egwu mbụ na kwụ n'ahịrị. . Ọ ga-amali na egwu na-esote ma ọ bụ nke mbụ na kwụ n'ahịrị n'agbanyeghị ọnọdụ ntọala ugboro ugboro.
Iji chọpụta ma ị na-eji kwụ n'ahịrị egwuregwu, chọpụta na ọ nweghịUrl> entry in the /Status response.
Then you can use the /Skip command.
Ị nwekwara ike ịgafe egwu maka ụfọdụ ụlọ ọrụ redio na-enuba. A na-eji iwu /Action eme ihe ndị a.
Ụfọdụ isi mmalite dị ka TuneIn na Optical Input anaghị akwado nhọrọ mwụda. Isi mmalite ndị a ga-enwe aURL> ntinye mana enweghị aha mwụda na nzaghachi / Ọnọdụ.
Arịrịọ
/Gaa

Oke	Nkọwa
Ọ dịghị

Nzaghachi
21

Àgwà nzaghachi	Nkọwa
id	The track id after executing the skip command. Refer to the /Status response song attribute for details.

Example
http://192.168.1.100:11000/Skip
Gaa na egwu na-esote.
4.5 Azụ
Nkọwa
If a track is playing and has been playing for more than four seconds then back will return to the start of the track.
Otherwise the back command will go to the previous song in the current playlist. If on the first song in the playlist calling back will go to the last song. It will go to the previous or first track in the queue regardless of the state of the repeat setting.
Iji chọpụta ma ị na-eji kwụ n'ahịrị egwuregwu, chọpụta na ọ nweghịUrl> element in the /Status response.
Then you can use the /Back command.
Ị nwekwara ike ịlaghachi egwu maka ụfọdụ ụlọ ọrụ redio na-enuba. A na-eji iwu /Action eme ihe ndị a.
Ụfọdụ isi mmalite dị ka TuneIn na Optical Input anaghị akwado nhọrọ azụ. Isi mmalite ndị a ga-enwe aUrl> mmewere mana enweghị aha mwụda na nzaghachi / Ọnọdụ.
Arịrịọ
/Azu

Oke	Nkọwa
Ọ dịghị

Nzaghachi
19

Àgwà nzaghachi	Nkọwa
id	The track id after executing the back command. Refer to the /Status response song attribute for details.

4.6 Mgbochi
Nkọwa
Iwu shuffle na-emepụta kwụ n'ahịrị ọhụrụ site na ịmegharị kwụ n'ahịrị dị ugbu a. A na-edoba kwụ n'ahịrị izizi (anaghị emegharị emegharị) maka iweghachi mgbe agbanyụrụ shuffle.
Arịrịọ
/Shffle?state=0|1

Oke	Nkọwa
steeti	· 0 to disable shuffle · 1 to enable shuffle. Has no effect if queue is already in shuffled state. See /Status response <shuffle> element.

Nzaghachi

Àgwà nzaghachi	Nkọwa
gbanwee	1 pụtara na agbanweela kwụ n'ahịrị kemgbe ebugoro ya. 0 pụtara na ọ bụghị.
ogologo	Ngụkọta ọnụọgụ egwu dị na kwụ n'ahịrị ugbu a.
ichikota	Steeti shuffle. 1 pụtara na agbachiela kwụ n'ahịrị ugbu a. 0 pụtara na kwụ n'ahịrị ugbu a anaghị atụgharị.
id	Id kwụ n'ahịrị ugbu a. Ọ na-agbanwe mgbe ọ bụla agbanwere kwụ n'ahịrị egwuregwu.

Example
http://192.168.1.100:11000/Shuffle?state=1
Na-emegharị kwụ n'ahịrị egwuregwu ugbu a.
4.7 Tinyegharịa
Nkọwa
Tọọ nhọrọ ikwugharị. Tinyegharịa nwere steeti atọ; 0 pụtara ikwugharị kwụ n'ahịrị ugbu a, 1 pụtara ikwugharị egwu dị ugbu a yana 2 pụtara emeghachila. Nkwugharị niile anaghị agwụ agwụ, ya bụ, ha anaghị akwụsị.
Arịrịọ
/Tigharịa?state=0|1|2

Oke	Nkọwa
steeti	· 0 to repeat the entire play queue · 1 to repeat the current track · 2 to turn repeat off

Nzaghachi

Àgwà nzaghachi	Nkọwa
ogologo	Ngụkọta ọnụọgụ egwu dị na kwụ n'ahịrị egwu dị ugbu a.
id	Id kwụ n'ahịrị ugbu a. Ọ na-agbanwe mgbe ọ bụla agbanwere kwụ n'ahịrị egwuregwu.
kwugharịa	Ọnọdụ ikwugharị ugbu a.

Example
http://192.168.1.100:11000/Repeat?state=1
Repeats the current playing track.
4.8 Omume maka ọdụ redio na-enuba
Nkọwa
Omume na-enye gị ohere ịga n'ihu, laghachi azụ, hụ n'anya na machibido egwu na ọdụ redio ahọpụtara, dị ka Slacker ma ọ bụ Radio Paradaịs ma ọ bụ Amazon Music Prime Stations. Ụlọ redio na-enuba anaghị ebu egwu n'ahịrị egwuregwu. Kama, ha na-enye a URL nke ị nwere ike iji rụọ ọrụ achọrọ.
Mfe ga-aga na egwu na-esote. Azụ ga-aga na egwu gara aga. Lovehụnanya ga-egosipụta egwu egwu ahụ ka ọ masịrị ya n'ime ọrụ egwu. Mmachibido iwu ga-amaba na egwu na-esote wee tọọ egwu egwu ahụ dịka enweghị mmasị na ọrụ egwu.
Ọ bụrụ na e nwere aUrl> ntinye na nzaghachi / Ọnọdụ, yana omume kwesịrị ekwesị, ị nwere ike ịrụ ọrụ ndị a. Ihe omume a ga-enwe URL nke a na-eji eme ihe.
Nke a bụ example site na nzaghachi / Ọnọdụ nke onye ọkpụkpọ na-akpọ Slacker redio:
<actions>
<action name=”back”/>
<action name=”skip” url="/Action?ọrụ=Slacker&skip=4799148″/>
<action icon=”/images/loveban/love.png” name=”love” notification=”Track marked as favorite” state=”1″ text=”Love” url="/Action?ọrụ=Slacker&love=4799148″/>
<action icon=”/images/loveban/ban.png” name=”ban” notification=”Track banned from this
station” state=”-1″ text=”Ban” url=”/Action?ọrụ=Slacker&ban=4799148″/>

Na nke a example, azụ adịghị, ma ịgafe, ịhụnanya na mmachibido iwu ga-ekwe omume.
Arịrịọ
/Action?service=service-name&action=action-URL
Mara: The specific request details (endpoint and parameters) are given by the respective <action> element. The commands in the Example ngalaba n'okpuru niile eji / Action ma ọ bụla URI kwere omume.

Oke	Nkọwa
	Enyere na mmewere.

Nzaghachi
Maka nzaghachi, ị ga-enweta nkwenye mmemme. Maka ịgagharị na azụ, ị ga-enweta:
<skip/>
<back/>
For love you receive:
<love>1</love>
For ban you receive:
1

Àgwà nzaghachi	Nkọwa
nzaghachi	Ọ bụrụ na isi ihe kpatara nzaghachi bụ mgbe ahụ node ederede bụ ngosi iji gosi onye ọrụ. Ọ bụrụ na eweghachitere ihe mgbọrọgwụ mgbọrọgwụ ọzọ na nke gụnyere njirimara ngosi mgbe ahụ ekwesịrị igosi ọkwa ahụ.

Example
http://192.168.1.100:11000/Action?service=Slacker&skip=10965139
Skips to the next Slacker radio track.
http://192.168.1.100:11000/Action?service=Slacker&ban=33332284
Machibidoro egwu redio Slacker na-akpọ ugbu a wee mafee na egwu na-esote.

 Play Queue Management

Otu ụdị ọrụ onye ọkpụkpọ na-arụ bụ ịkwanye egwu n'ahịrị egwuregwu, wee kpọọ egwu site na kwụ n'ahịrị egwuregwu ahụ. Iwu ndị a na-enye gị ohere view ma jikwaa kwụ n'ahịrị egwuregwu.
5.1 Ndepụta egwu
Nkọwa
Weghachite ọkwa kwụ n'ahịrị egwuregwu, ma ọ bụ weghachi ozi na egwu niile dị na kwụ n'ahịrị egwuregwu.
A naghị atụ aro ka iji ajụjụ a na-enweghị ma ogologo ma ọ bụ mmalite na njedebe njedebe, n'ihi na ma ọ bụghị ya, enwere ike iwepụta nzaghachi dị ogologo.
Arịrịọ
/Playlist
/Playlist?length=1
/Playlist?start=first&end=last (retrieve part of the queue, for pagination usually)

Oke	Nkọwa
ogologo =1	Weghachite naanị njirimara dị elu na enweghị nkọwa egwu.
malite	Ntinye mbụ na kwụ n'ahịrị iji tinye na nzaghachi, malite na 0.
ngwucha	Ntinye ikpeazụ na kwụ n'ahịrị iji tinye na nzaghachi.

Nzaghachi
Maka ọkwa kwụ n'ahịrị egwuregwu:
<playlist>
<length>13</length>
243
<name></name>
<modified>1</modified>

For a play queue listing:


2002
Anne-Marie
2002
Deezer: 487381362

Àgwà nzaghachi	Nkọwa
aha	Aha kwụ n'ahịrị egwuregwu ugbu a.
gbanwee	0 pụtara na agbanwebeghị kwụ n'ahịrị kemgbe ebugoro ya. 1 pụtara na agbanweela kwụ n'ahịrị kemgbe ebugoro ya.
ogologo	ngụkọta ọnụọgụ egwu dị na kwụ n'ahịrị ugbu a
id	unique id for the current queue state (e.g., 1054). It is same as the <pid> in /Status response.
egwu	Abụ nwere ọtụtụ obere ihe mejupụtara: ·  albumid = id of the album the track is in ·  service = music service of the track · artistid = id of the track artist · songid = song id ·  id = track position in the current queue. If the track is currently selected, track id is same as <song> in /Status response. · title = track name · art = artist name ·  alb = album name

Example
http://192.168.1.100:11000/Playlist
Lists all the tracks in the play queue.
http://192.168.1.100:11000/Playlist?length=1
5.2 Hichapụ Track
Nkọwa
Wepu egwu na kwụ n'ahịrị egwu dị ugbu a.
Arịrịọ
/Hichapụ?id=ọnọdụ

Oke	Nkọwa
id	A ga-ehichapụ id egwu egwu na kwụ n'ahịrị egwu ugbu a.

Nzaghachi
9

Àgwà nzaghachi	Nkọwa
ehichapụ	Ọnọdụ dị na kwụ n'ahịrị egwu a ga-ewepụ.

Example
http://192.168.1.100:11000/Delete?id=9
Removes the track at position 9 in the play queue.
5.3 Bugharịa Track
Nkọwa
Bugharịa egwu n'ime kwụ n'ahịrị egwu dị ugbu a.
Arịrịọ
/Move?ọhụrụ=ebe&ochie=mbụ

Oke	Nkọwa
ọhụrụ	New position on the track being moved.
ochie	Old position of the track being moved.

Nzaghachi
kpaliri

Àgwà nzaghachi	Nkọwa
kpaliri	Na-egosi na ebugharịra egwu ahụ.

Example
http://192.168.1.100:11000/Move?new=8&old=2
Move the track at position 2 to position 8 in the play queue.
5.4 Kpochapụ kwụ n'ahịrị
Nkọwa
Hichapụ egwu niile na kwụ n'ahịrị egwu dị ugbu a
Arịrịọ
/Kpochapụ

Oke	Nkọwa
Ọ dịghị

Nzaghachi

Àgwà nzaghachi	Nkọwa
gbanwee	0 pụtara na anaghị agbanwe kwụ n'ahịrị kemgbe ebujuru ya, 1 pụtara na agbanwere kwụ n'ahịrị kemgbe ebugoro ya.
ogologo	Ngụkọta ọnụọgụ egwu dị na kwụ n'ahịrị ugbu a.
id	Id pụrụ iche maka kwụ n'ahịrị ugbu a.

Example
http://192.168.1.100:11000/Clear
This removes all tracks from the play queue.
5.5 Chekwaa kwụ n'ahịrị
Nkọwa
Chekwaa kwụ n'ahịrị egwu dịka ndepụta ọkpụkpọ BluOS akpọrọ.
Arịrịọ
/Chekwa?name=list_aha

Oke	Nkọwa
aha	Aha kwụ n'ahịrị egwuregwu echekwara.

Nzaghachi
<saved>
<entries>126</entries>

Àgwà nzaghachi	Nkọwa
ndenye	Ngụkọta ọnụọgụ egwu dị na kwụ n'ahịrị egwuregwu echekwara.

Example
http://192.168.1.100:11000/Save?name=Dinner+Music
Nke a na-echekwa kwụ n'ahịrị egwu dị ka "Egwu nri abalị".

Ntọala

Preset requests allow you to list all presets of a player, load a preset, and step up / down presets. Presets must be added and deleted using the BluOS Controller app. Presets can include radio stations, playlists and inputs (e.g.
Bluetooth, analog, optical, HDMI ARC).
6.1 Ndepụta atọrọ
Nkọwa
Depụta ntọala niile na ihe ọkpụkpọ BluOS dị ugbu a.
Arịrịọ
/ atọrọ ntọala

Oke	Nkọwa
Ọ dịghị

Nzaghachi

<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=”/ Ibu ibu?ọrụ=Tidal&amp;id=fd3f797e-
a3e9-4de9-a1e2-b5adb6a57cc7″ image=”/Artwork?service=Tidal&amp;playlistimage=afacfc12-24034caf-a5c5-a2af28d811c8″/> </presets>

Àgwà nzaghachi	Nkọwa
prid	Id pụrụ iche nke atọrọ ihe ọkpụkpọ. Ọ bụ otu ihe ahụ na /Nzaghachi ọnọdụ.
aha	Aha atọrọ ntọala.
id	Id etinyere ya.
url	Ntọala URL. Ọ bụ isi mmalite ntọala URL used to load the preset.
onyonyo	Onyonyo URL nke preset. Ọ bụrụ na URL starts with /Artwork it may result in redirect. Adding a parameter/key followRedirects=1 when retrieving the image can avoid redirect.

Example
http://192.168.1.100:11000/Presets
List all the presets on the player.
6.2 Ibu Ibu ihe atọrọ
Nkọwa
Malite ịkpọ preset. Ị nwere ike ịhọrọ nọmba atọrọ atọ, yana nke ọzọ ma ọ bụ nke mbụ atọrọ. Ọnụọgụ ndị e debere ekwesịghị ịdị n'usoro, ya bụ, ị nwere ike ịnwe presets 1,2,3 5, 7 na 8. Edebere aka aka site n'elu ruo ala na ala ruo n'elu.
Arịrịọ
/Preset?id=presetId|-1|+1

Oke	Nkọwa
id	The id number of the preset to be loaded. The list of available preset id’s is found with the Show Presets command. If preset id is +1, it will load the next preset. If preset id is -1, it will load the previous preset.

Nzaghachi
Ọ bụrụ na atọrọ atọ bụ ndepụta egwu, ọ na-eweghachi ọnụọgụ egwu nke etinyegoro.
<loaded service=”Deezer”>
<entries>60</entries>
</loaded>
If the preset is a radio it returns the stream state.
iyi

Àgwà nzaghachi	Nkọwa
ọrụ	aha ọrụ nke atọrọ n'elu
ndenye	egwu ọnụọgụgụ nke atọrọ atọ

Example
http://192.168.1.100:11000/Preset?id=4
Load the preset with preset id 4.
http://192.168.1.100:11000/Preset?id=+1

Content Browsing and Searching

Akụkụ a na-akọwa iwu maka nchọgharị ọdịnaya ọdịnaya ọrụ egwu.
7.1 Ọdịnaya Egwu Nchọgharị
Nkọwa
Chọgharịa site na isi mmalite egwu dị, yana ntinye na listi ọkpụkpọ.
Mgbọrọgwụ mmewere maka nzaghachi bụ ọ gwụla ma enwere nzaghachi njehie. Ọtụtụ nsonaazụ bụ usoro nke . N'ọnọdụ ụfọdụ, nsonaazụ ya bụ usoro nke , nke ọ bụla n'ime ha nwere usoro ma ọ bụrụ . A na-enye ụkpụrụ niile site na iji njirimara. Enweghị ọnụ ederede.
Nsonaazụ nke oku /Chọgharịa nwere ike ịbụ njehie agbakwunyere na ihe mgbọrọgwụ element. Enyere nkọwa nke njehie ahụ n'otu na efu ma ọ bụ karịa ọnụ ederede .
Arịrịọ
/Browse?key=key-value
/Browse?key=key-value&withContextMenuItems=1

Oke	Nkọwa
igodo	Optional parameter. The absence of this parameter will result in a top-level browse. Returns information for levels other than the top level /Browse. Uses the value that is taken from a “browseKey”, “nextKey”, “parentKey”, or “contextMenuKey” attribute value from an earlier response. Mara: igodo-uru ga-abụrịrị URL etinyere ya
naContextMenuItems	Optional parameter. The value is always 1. A na-eji oke a nweta menu onodu inline mgbe ị na-eme nchọgharị nke listi ọkpụkpọ, ọba, egwu, ọdụ ụgbọ mmiri, ndị na-ese ihe, wdg.

Nzaghachi
Nzaghachi nchọgharị ọkwa dị elu:
<browse sid=”16″ type=”menu”>
<item image=”/images/ci_myplaylists.png” browseKey=”playlists” text=”Playlists” type=”link”/>
<item image=”/images/LibraryIcon.png” browseKey=”LocalMusic:” text=”Library” type=”link”/>
<item image=”/images/InputIcon.png” text=”Optical Input”
gwuo egwuURL=”/Gwuo?url=Capture%3Ahw%3A1%2C0%2F1%2F25%2F2%2Finput1″ inputType=”spdif”
type=”audio”/>
<item image=”/Sources/images/TuneInIcon.png” browseKey=”TuneIn:” text=”TuneIn” type=”link”/>
<item image=”/Sources/images/SlackerIcon.png” browseKey=”Slacker:” text=”Slacker” type=”link”/>
<item image=”/Sources/images/TidalIcon.png” browseKey=”Tidal:” text=”TIDAL” type=”link”/>

Other level browse response:
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
service=”Deezer” searchKey=”Deezer:Search” type=”menu”>
item browseKey=”/Playlists?service=Deezer&genre=0&category=toplist” text=”Popular Playlists”
type=”link”/>
<item browseKey=”/Artists?service=Deezer&genre=0&category=toplist” text=”Popular Artists”
type=”link”/>
<item browseKey=”/Albums?service=Deezer&genre=0&category=toplist” text=”Popular Albums”
type=”link”/>
item browseKey=”/Songs?service=Deezer&genre=0&category=toplist” text=”Popular Songs”
type=”link”/>

Àgwà nzaghachi	Nkọwa
Rụtụ aka na tebụl mmewere/mmadụ dị n'okpuru

Example
IHE: all key parameters must be UTF-8 encoded.
http://192.168.1.100:11000/Browse
Does a top level browse.
http://192.168.1.100:11000/Browse?key=Tidal%3A
Does a second level browse, returning the Tidal categories.
http://192.168.1.100:11000/Browse?key=Tidal%3AmenuGroup%2F3
Does a third level browse, returning the Tidal Masters (Group 3) sub-categories.
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters
Na-eme nchọgharị ọkwa nke anọ, na-eweghachite ọba Tidal Masters mbụ.
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters%26 start%3D30%26end%3D79
Does another fourth level browse, returning the second set of Tidal Masters albums.

Ihe	Njirimara (na ụkpụrụ)		Nkọwa
	akara ọrụ		URI maka akara ngosi maka ọrụ a na-achọgharị ugbu a.
	aha ọrụ		Aha ọrụ a na-achọgharị ugbu a, maka ngosipụta onye ọrụ.
	igodo ọchụchọ		Uru ị ga-eji maka igodo igodo na arịrịọ /Chọgharịa iji chọọ ọrụ dị ugbu a (ma ọ bụ akụkụ miri emi nke ndị isi). Na mgbakwunye, arịrịọ ahụ ga-enwe paramita aq nwere okwu ọchụchọ.
	igodo na-esote		Uru ị ga-eji maka igodo igodo na arịrịọ /Chọgharịa iji nweta ibe ihe na-esote maka ugbu a view. Ogo chunk paging anọghị n'okpuru njikwa nke onye ọrụ API, ọ nweghịkwa mbọ ọ bụla ekwesịrị ịmegharị ma ọ bụ megharịa usoro ajụjụ nke uru a.
	igodo nne na nna		Uru ị ga-eji maka igodo igodo na arịrịọ / Chọgharịa ka ịnyagharịa azụ n'ọkwa ahụ ma ọ bụrụ na aga-ewepụ igodo azụ ndabara.
	ụdị	menu	Ọnụ ụzọ igodo nwere ike ịnwe ngwakọta nke ụdị ihe ọ bụla. Ọtụtụ ga-enwe naanị njikọ ma ọ bụ ihe ọdịyo.
		onodu menu	Ndepụta ihe nke ụdị akọwapụtara.
		ndị na-ese ihe

Ihe	Njirimara (na ụkpụrụ)		Nkọwa
		composers
		albums
		playlists
		egwu
		genres
		ngalaba	Alphabetic sections.
		ihe	Generic result list. Most commonly a mix of menu nodes (type=”link”) and radio items (type=”audio”).
		nchekwa	May contain subfolders, tracks and playlists entries.
<category>	ederede		Heading for the category.
	igodo na-esote		A value to use for a key parameter to a /Browse request to get the next page of items for the category.
	igodo nne na nna		Uru ị ga-eji maka igodo igodo na arịrịọ / Chọgharịa ka ịnyagharịa azụ n'ọkwa ahụ ma ọ bụrụ na aga-ewepụ igodo azụ ndabara.
	ụdị	njikọ	A generic node in the browse hierarchy that leads to further nodes
		ọdịyo	A node that can be played directly
		artist	An item representing an artist

Ihe	Njirimara (na ụkpụrụ)		Nkọwa
		composer	Ihe na-anọchi anya onye na-ede ihe
		album	Ihe na-anọchite anya ọba ma ọ bụ mkpokọta yiri ya
		ndepụta ọkpụkpọ	Ihe na-anọchi anya ndepụta ọkpụkpọ ma ọ bụ mkpokọta yiri ya
		egwu	Ihe na-anọchi anya otu egwu
		ederede	Ọnụ ederede dị larịị.
		ngalaba	Akụkụ mkpụrụedemede.
		nchekwa	Otu nchekwa dị na chọgharịa folda.
	ederede		Isi ma ọ bụ nke mbụ nke nkọwa ihe
	text2		Ahịrị nke abụọ
	onyonyo		An icon or artwork for the item. If the image starts with /Artwork it may result in redirect. Adding a parameter/key followRedirects=1 when retrieving the image can avoid redirect.
	browseKey		A value to use for a key parameter to a subsequent /Browse request to descend the hierarchy.
	gwuo egwuURL		A URI that may be invoked directly to invoke the default play action for the item in question. Usually this is to clear the queue and start playing it.
	akpaakaURL		URI nke enwere ike ịkpọ ozugbo ka ịgbakwunye egwu na kwụ n'ahịrị wee kpọọ ya ma tinye egwu na-esote site na ihe nwere (dị ka ọba) na njuputa akpaaka.

Ihe	Njirimara (na ụkpụrụ)	Nkọwa
		section of the play queue.
	ỌnọdụMenuKey	Uru ị ga-eji maka igodo igodo maka arịrịọ / Chọgharịa iji nweta nsonaazụ nke bụ ọnọdụ-nchịkọta nhọrọ nke omume metụtara ihe ahụ.
	ime iheURL	URI nke enwere ike ịkpọku ozugbo ka ọ rụọ ọrụ akọwapụtara.

Ihe nchịkọta nhọrọ ọnọdụ nwere ike ịnwe ụkpụrụ ndị a maka njirimara ụdị.

Njirimara
		Nkọwa
ọkacha mmasị	-add	Tinye ihe ahụ ka ọkacha mmasị (ma ọ bụ ihe dakọtara)
	-delete	Remove the item from the user’s favourites
tinye		Tinye na kwụ n'ahịrị egwuregwu
tinye	-ugbu a	Add to the play queue after the current track and play now
	-next	Add to the play queue after the current track
	-last	Add to the end of the play queue
addAll	-ugbu a	Add multi-track object to the play queue and play now
	-next	Add multi-track object to the play queue after the current track or multi- track object
	-last	Add multi-track object to the end of the play queue
playRadio		Play a radio station related to the item

hichapụ

Hichapụ ihe ahụ (na-abụkarị ndepụta ọkpụkpọ). Ekwesịrị ịrịọ nkwenye onye ọrụ

When browsing with parameter “withContextMenuItem=1”, the result will contain in-lined context menu.
Example
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26genre%3D0%26category %3Dtoplist&withContextMenuItems=1
Ọ na-arịọ Deezer => Kedu ihe na-ekpo ọkụ => Albums ndị ama ama nwere menu inline.
Nzaghachi
Nzaghachi nwere inline maka ihe ọ bụla.

<item text=”Essonne History X” contextMenuKey=”Deezer:contextMenu/Album?albumid=693798541″
gwuo egwuURL=”/Add?service=Deezer&albumid=693798541&playnow=1″ image=”/Artwork?service=Deezer&albumid=693798541″
browseKey=”Deezer:Album?artist=Ziak&album=Essonne%20History%20X&albumid=693798541″ text2=”Ziak” type=”album”> <contextMenu>
<item text=”Favorite” type=”favourite-add” actionURL=”/AddFavourite?service=Deezer&albumid=693798541″/>
<item text=”Play now” type=”add-now”
ime iheURL=”/Add?service=Deezer&playnow=1&clear=0&shuffle=0&where=nextAlbum&albumid=693798541″/>
<item text=”Shuffle” type=”add-shuffle”
ime iheURL=”/Add?service=Deezer&shuffle=1&playnow=1&where=nextAlbum&albumid=693798541″/>
<item text=”Add next” type=”addAll-next” actionURL=”/Add?service=Deezer&playnow=-1&where=nextAlbum&albumid=693798541″/>
<item text=”Add last” type=”addAll-last” actionURL=”/ Tinye?ọrụ=Deezer&playnow=-1&where= ikpeazụ&albumid=693798541″/>
</contextMenu>
</item>
…

Ndetu mmejuputa iwu na ndumodu
A na-enye ụdị njirimara nke ihe dị ka ihe ngosi nke nwere ike ịkwado nhọrọ ngosi dị iche iche.
Egosiri ike ịmegharị ọdịnaya nke ihe site na ọnụnọ nke njirimaraKey browse. A na-egosipụta ike ịkpọ ihe (n'ozuzu) site na ọnụnọ nke egwuregwuURL (na ikekwe na-akpakwa akpaakaURL) àgwà. Otu ihe nwere ike ịnwe ma njirimara Key browse na egwuregwuURL àgwà.
Mgbe ha abụọ na-egwu egwuURL na autoplayURL njirimara dị, nke a ga-eji dị ka nhọrọ egwuregwu ndabara kwesịrị ịbụ isiokwu nke mmasị onye ọrụ.
Ụkpụrụ URI ga-abụkarị URI ndị nwere akụkụ ụzọ zuru oke. A na-edozi URI ndị ikwu ka ha bụrụ URI zuru oke dịka RFC 3986 siri dị.
browseKey, contextMenuKey and searchKey attribute values shall always be URI-encoded (percent escaped) when used as the value of a key parameter to a /Browse request, as shall any other request parameters.
When descending the browse hierarchy it may be useful for the UI page header to show some sort of breadcrumb(s), probably using the title (text) of the parent and grandparent nodes.
It may be useful to make available the context-menu for the parent when browsing its children.
It may be useful to consider the type of the parent when deciding how to display its children.
7.2 Chọọ ọdịnaya egwu
Nkọwa
Iwu ka ịchọọ n'ime ọrụ.
Arịrịọ
/Chọgharịa?key=key-uru&q=searchText

Oke	Nkọwa
igodo	Uru ewepụtara na uru njirimara “searchKey” site na nzaghachi mbụ
q	The search string. Perform a search of the context specified by the key parameter (taken from a searchKey attribute from a response). In the absence of a key parameter, perform a top-level search.

Nzaghachi
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
service=”Deezer” searchKey=”Deezer:Search” type=”menu”>
<item browseKey=”/Artists?service=Deezer&expr=michael” text=”Artists” type=”link”/>
<item browseKey=”/Albums?service=Deezer&expr=michael” text=”Albums” type=”link”/>
<item browseKey=”/Songs?service=Deezer&expr=michael” text=”Songs” type=”link”/>
<item browseKey=”/Playlists?service=Deezer&expr=michael” text=”Playlists” type=”link”/>

Return the top level of search result. For further search result of Artists, Albums, Songs, or Playlists, a browse command with the “browseKey” as the key is required.
Maka example, ka ịhụ nsonaazụ ọchụchọ nke Albums, zipu iwu:
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26expr%3Dmichael
Nzaghachi a ga-abụ otu nzaghachi nye iwu nkịtị /Chọgharịa.

Àgwà nzaghachi	Nkọwa
Rụtụ aka na tebụl mmewere/njirimara dị na iwu Chọgharịa

Example
http://192.168.1.100:11000/Browse?key=Deezer:Search&q=michael Chọọ maka “michael” within the Deezer music service.

Player Grouping

Akụkụ a na-akọwa iwu maka ịchịkọta ọkpụkpọ na ịwepu aha. BluOS na-akwadokwa nchikota a kapịrị ọnụ, nke na-enweghị oke maka akwụkwọ a.
BluOS na-eji okwu okwu bụ isi na ọkpụkpọ nke abụọ. Onye ọkpụkpọ mbụ bụ onye ọkpọ egwuregwu na otu. A na-eji ọkpọ ọkpọ mbụ họrọ isi iyi egwu. Enwere naanị otu onye ọkpụkpọ mbụ. A na-ejikọta onye ọkpụkpọ nke abụọ na onye ọkpụkpọ nke mbụ. Enwere ike inwe ọtụtụ ndị egwuregwu sekọndrị.
Ọ bụrụ na onye ọkpụkpọ bụ onye ọkpụkpọ nke abụọ, ọtụtụ arịrịọ, ọ bụrụ na agwara onye ọkpụkpọ nke abụọ, na-abanye n'ime onye ọkpụkpọ mbụ. Ndị a gụnyere /Ọnọdụ, Njikwa Playback, Njikwa Play Queue na Nchọgharị Ọdịnaya na arịrịọ Ọchọ.
8.1 Ndị na-egwu egwuregwu abụọ
Nkọwa
Kpọkọta onye ọkpụkpọ sekọndịrị n'otu n'egwuregwu praịmarị.
Arịrịọ
/AddSlave?ohu=secondaryPlayerIP&port=secondaryPlayerPort&group=Aha otu

Oke	Nkọwa
ohu	Adreesị IP nke onye ọkpụkpọ nke abụọ.
ọdụ ụgbọ mmiri	Port number of the secondary player. The default port number is 11000. Players such as the NAD CI580, which has four players with one IP, use multiple ports.
otu	Nhọrọ, aha otu. Ọ bụrụ na enyeghị ya, BluOS ga-enye aha otu ndabara.

Nzaghachi

Àgwà nzaghachi	Nkọwa
slave port	Port number of the secondary player that was just grouped.
Id	ID of the secondary player that was just grouped.

Example
http://192.168.1.100:11000/AddSlave?slave=192.168.1.153&port=11000
This groups player 192.168.1.153 to player 192.168.1.100. Player 192.168.1.100 is the primary player.
8.2 Tinye ọtụtụ ndị egwu na otu
Nkọwa
Kpọkọta ndị egwuregwu abụọ ma ọ bụ karịa na onye ọkpụkpọ mbụ.
Arịrịọ
/AddSlave?ohu=secondaryPlayerIPs&ports=secondaryPlayerPorts

Oke	Nkọwa
ndị ohu	Adreesị IP nke ndị egwuregwu sekọndrị ga-agbakwunye na onye ọkpụkpọ mbụ. Adreesị IP ekewapụrụ rikoma.
ọdụ ụgbọ mmiri	A ga-agbakwunye ọdụ ụgbọ mmiri nke ndị egwuregwu sekọndrị na onye ọkpụkpọ mbụ. A na-ekewa nọmba ọdụ ụgbọ mmiri rikoma.

Nzaghachi

Àgwà nzaghachi	Nkọwa
ọdụ ụgbọ mmiri	Ọdụ ụgbọ mmiri nke onye ọkpụkpọ nke abụọ nke agbakọtara.
Id	Id onye egwu sekọndịrị nke agbakọtara.

Example
http://192.168.1.100:11000/AddSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Groups secondary players 192.168.1.153 and 192.168.1.120 to primary player 192.168.1.100.
8.3 Wepụ otu ọkpụkpọ na otu
Wepu onye ọkpụkpọ n'otu. Ọ bụrụ na ewepụrụ onye ọkpụkpọ nke abụọ n'otu, onye ọkpụkpọ nke abụọ enweghị otu. Ọ bụrụ na ewepụ onye ọkpụkpọ mbụ n'otu egwuregwu atọ ma ọ bụ karịa, onye ọkpụkpọ mbụ enweghị otu, ndị egwuregwu sekọndrị fọdụrụnụ na-etolite otu ọhụrụ.
Arịrịọ
/Wepụ Ohu?ohu=secondaryPlayerIP&port=secondaryPlayerPort

Oke	Nkọwa
ohu	IP nke ọkpụkpọ (nke abụọ) ka agbakwunyere na ọkpụkpọ ọzọ (isi).
ọdụ ụgbọ mmiri	Port nke onye ọkpụkpọ (nke abụọ) ka a ga-agbakwunye na onye ọkpụkpọ ọzọ (isi).

Nzaghachi
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″
brand=”Bluesound” etag=”25″ outlevel=”-62.9″ schemaVersion=”25″ initialized=”true” group=”PULSE-0278+POWERNODE-0A6A” syncStat=”25″ id=”192.168.1.100:11000″mac=”90:56:82:9F:02:78″>

Àgwà nzaghachi	Nkọwa
	Hụ /SyncStatus maka nkọwa.

Example
http://192.168.1.100:11000/RemoveSlave?slave=192.168.1.153&port=11000
Ungroups player 192.168.1.153 from the group that has primary player 192.168.1.100
8.4 Wepụ ọtụtụ ndị egwuregwu na otu
Nkọwa
Wepụ ndị egwu abụọ ma ọ bụ karịa n'otu.
Arịrịọ
/Wepụ Ohu?ohu=secondaryPlayerIPs&ports=secondaryPlayerPorts

Oke	Nkọwa
ndị ohu	A ga-ewepụ adreesị IP nke ndị egwuregwu sekọndrị na onye ọkpụkpọ mbụ. Adreesị IP ekewapụrụ rikoma.

Oke	Nkọwa
ọdụ ụgbọ mmiri	A ga-ewepụ ọdụ ụgbọ mmiri nke ndị egwuregwu sekọndrị na onye ọkpụkpọ mbụ. A na-ekewa nọmba ọdụ ụgbọ mmiri rikoma.

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

Àgwà nzaghachi	Nkọwa
	Hụ /SyncStatus maka nkọwa.

Example
http://192.168.1.100:11000/RemoveSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Removes players 192.168.1.153 and 192.168.1.120 from the group with primary player 192.168.1.100.

Player Reboot

Akụkụ a na-akọwa iwu maka nrụpụta nro nke ọkpụkpọ.
9.1 Malitegharịa ihe ọkpụkpọ
Nkọwa
Malitegharịa ekwentị dị nro.
Arịrịọ
Iwu POST / malitegharịa na parameter ee (uru ọ bụla)

Oke	Nkọwa
ee	Uru ọ bụla (dịka ọmụmaatụ 1).

Nzaghachi
Emelitere ntọala
Na-amalitegharị. Biko mechie windo a.
Biko chere…
Example
curl -d ee = 1 192.168.1.100/regharịa

Doorbell Chimes

Akụkụ a na-akọwa iwu maka mgbịrịgba ọnụ ụzọ ọkpụkpọ.
10.1 mgbịrịgba ọnụ ụzọ
Nkọwa
Tinye mgbịrịgba ọnụ ụzọ rụọ ọrụ.
Arịrịọ
http://PLAYERIP:PORT/Doorbell?play=1

Oke	Nkọwa
gwuo egwu	Kpọọ mgbịrịgba ọnụ ụzọ (mgbe niile 1)

Nzaghachi

Àgwà nzaghachi	Nkọwa
mee ka	Indicate the chime
olu	Chime olu
chime	Chime audio

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

Ntinye aka ozugbo

Akụkụ a na-akọwa iwu maka nhọrọ ntinye ntinye ozugbo.
11.1 Nhọrọ ntinye arụ ọrụ
Nkọwa
Nhọrọ isi mmalite ntinye arụ ọrụ. Iwu a na-arụ ọrụ maka ntinye arụ ọrụ pụtara na nzaghachi /RadioBrowse?service=Capture. A na-akwado nhọrọ ntinye BluOS HUB naanị site na iwu a.
Arịrịọ
/Egwuregwu?url=URL_uru

Oke	Nkọwa
url	Nke URL njirimara sitere na nzaghachi /RadioBrowse?service=Capture

Nzaghachi
iyi

Àgwà nzaghachi	Nkọwa
steeti	Gosi na ntinye na-akpọ

Example
Nzọụkwụ 1. Nweta URL_Uru maka oke url
Arịrịọ: http://192.168.1.100:11000/RadioBrowse?service=Capture
Azịza ya:
<radiotime service=”Capture”>
<item playerName=”Tick
Tinye akara" ederede = "Bluetooth" ntinye ụdị = "bluetooth" id =" ntinye2″ URL="Wepụta%3Abluez%3Abluetooth" image=" /images/BluetoothIcon.png" ụdị ="audio"/>
<item playerName=”Tick Tick” text=”Analog
Input” inputType=”analog” id=”input0″ URL=”Capture%3Aplughw%3Aimxnadadc%2C0%2F48000%2F 24%2F2%3Fid%3Dinput0″ image=”/images/capture/ic_analoginput.png” type=”audio”/>
<item playerName=”Tick Tick” text=”Optical
Input” inputType=”spdif” id=”input1″ URL=”Capture%3Ahw%3Aimxspdif%2C0%2F1%2F25%2F2%3Fid%
3Dinput1″ image=”/images/capture/ic_opticalinput.png” type=”audio”/>
<item playerName=”Tick
Tick” text=”Spotify” id=”Spotify” URL=”Spotify%3Aplay” image=”/Sources/images/SpotifyIcon.png” service
Type=”CloudService” type=”audio”/>

<remoteitem playerName=”Test Hub” text=”Analog Input” inputType=”analog” id=”hub192168114911000input0″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput0″
image=”/images/capture/i
c_analoginput.png”
type=”audio”/>
<remoteitem playerName=”Test Hub” text=”Coaxial Input” inputType=”spdif” id=”hub192168114911000input3″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput3″
image=”/images/capture/ic
_opticalinput.png”
type=”audio”/>
<remoteitem playerName=”Test Hub” text=”HDMI ARC” inputType=”arc” id=”hub192168114911000input4″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput4″
image=”/images/capture/ic
_tv.png”
type=”audio”/>
<remoteitem playerName=”Test Hub” text=”Optical Input” inputType=”spdif” id=”hub192168114911000input2″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput2″
image=”/images/capture/ic
_opticalinput.png”
type=”audio”/>
<remoteitem playerName=”Test Hub” text=”Phono Input” inputType=”phono” id=”hub192168114911000input1″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput1″
image=”/images/capture/ic
_vinyl.png”
type=”audio”/>
</category>
</radiotime>
Nzọụkwụ 2. Kpọọ ntinye Analog na ihe ọkpụkpọ
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
Mara: Make sure the sources are connected and not hidden.
11.2 Nhọrọ Ntinye Mpụga
Nkọwa
External input source selection. Sometimes inactive external inputs may not show up in the response to
/RadioBrowse?service=Capture. This command works for both active and inactive input selection. It’s recommended for CI external input selection.
Arịrịọ (BluOS firmware dị ọhụrụ karịa v3.8.0 na karịa v4.2.0)
/Play?inputIndex=IndexId

Oke	Nkọwa
ntinye Index	Ndekọ (malitere na 1) nke ntinye pụtara na nzaghachi / Settings?id=capture&shcemaVersion=32 (32 bụ ụdị schema kachasị ọhụrụ) n'usoro ọnụọgụ. Ewepula Bluetooth.

Nzaghachi
iyi

Àgwà nzaghachi	Nkọwa
steeti	Gosi na ntinye na-akpọ

Example
Nzọụkwụ 1. Nweta uru ntinye Index
Arịrịọ: http://192.168.1.100:11000/Settings?id=capture&schemaVersion=32
Azịza ya:
<settings schemaVersion=”32″>
<menuGroup icon=”/images/settings/ic_capture.png” url="/setting" id =" ijide"
displayName=”Customize sources”>
<setting icon=”/images/settings/ic_bluetooth.png” refresh=”true” url=”/ audiomodes”
id=”bluetooth” displayName=”Bluetooth” value=”3″ name=”bluetoothAutoplay” description=”Disabled” explanation=”Manual mode allows you to switch between sources in the navigation drawer. Automatic mode switches to the Bluetooth source when a connected Bluetooth device starts playing audio. You can then switch between sources in the navigation drawer. Guest mode switches to the Bluetooth source when a connected Bluetooth device starts playing audio. If you change to another source, Bluetooth will disconnect. The Bluetooth source does not appear in the navigation drawer. Disabled removes the source from the navigation drawer, and does not allow another device to connect to the Player as a Bluetooth
source.” class=”list”>
…
</setting>
<menuGroup icon=”/images/capture/ic_analoginput.png” url=”/setting” id=”captureinput0″
displayName=”Analog
Input”>
</menuGroup>
<menuGroup icon=”/images/capture/ic_opticalinput.png” url=”/setting” id=”capture-input1″
displayName=”Optical Input”> </menuGroup>
</menuGroup>

The response shows Bluetooth, Analog Input, and Optical Input. Bluetooth is excluded, so inputIndex value is 1 for Analog Input, and inputIndex value is 2 for Optical Input.’
Nzọụkwụ 2. Kpọọ ntinye anya na ihe ọkpụkpọ.
http://192.168.1.100:11000/Play?InputId=2
Arịrịọ (BluOS firmware v4.2.0 ma ọ bụ nke ọhụrụ)
/Play?inputTypeIndex=$typeIndex

Oke

Nkọwa

ntinye Ụdị Index

typeIndex has the format of type-index of an input. Here is the list of input ụdị: spdif (Optical Input) analog (Analog Input, Line In) coax (Coaxial Input) bluetooth arc (HDMI ARC) earc (HDMI eARC) phono (Vinyl) computer aesebu (AES/EBU) balanced (Balanced In) microphone (Microphone Input) Nke index starts from 1. When there are more than one inputs of the same type, input 1 has index 1, input 2 has index 2, na ihe ndị ọzọ.

Nzaghachi
iyi

Àgwà nzaghachi	Nkọwa
steeti	Gosi na ntinye na-akpọ

Example
Arịrịọ: http://192.168.1.100:11000/Play?inputTypeIndex=spdif-2 ịhọrọ ntinye ngwa anya 2
Azịza ya: iyi

Bluetooth

Akụkụ a na-akọwa iwu ịgbanwe ọnọdụ Bluetooth.
12.1 Gbanwee ọnọdụ Bluetooth
Nkọwa
Gbanwee ụkpụrụ Bluetooth: Akwụkwọ ntuziaka, akpaaka, ọbịa, Agbanyụrụ.
Arịrịọ
/audiomodes?bluetoothAutoplay=uru

Oke	Nkọwa
bluetoothAutoplay	Ọnọdụ Bluetooth uru 0 means Manual, 1 means Automatic, 2 means Guest, 3 means Disabled.

Enweghị nzaghachi
Example
Request: http://192.168.1.100:11000/audiomodes?bluetoothAutoplay=3 to disable bluetooth

Ihe odide ntụkwasị

13.1 Protocol nchọpụta ọrụ Lenbrook
Okwu mmalite
Ụzọ nchọpụta ama ama dị ka mDNS na SSDP na-eji ma dabere na nzikọrịta ozi multicast UDP. Ọtụtụ ngwaahịa Lenbrook dị ugbu a na-eji mDNS maka nchọpụta. N'ụzọ dị mwute, anyị achọpụtala na ọnụ ọgụgụ dị ukwuu nke ndị ahịa anyị nwere netwọk ụlọ ebe okporo ụzọ multicast adịghị arụ ọrụ nke ọma na ngwaọrụ anyị enweghị ike ịchọta nke ọma. Nke a ebutela ọtụtụ nloghachi ngwaahịa yana mkpesa sitere n'aka ndị nkesa anyị.
Iji dozie okwu a, anyị ekepụtala usoro nchọpụta omenala akpọrọ LSDP nke na-eji mgbasa ozi UDP. Nnwale mbụ egosila na nke a nwere ntụkwasị obi karịa nchọpụta dabere na mDNS.
Protocol gafereview
Otu ebumnuche nke usoro a bụ ịdị mfe. Enwere ike iji ya na ngwaọrụ agbakwunyere na ebe nchekwa nwere oke oke.
Usoro ahụ na-eji ngwugwu mgbasa ozi UDP niile gaa na site na ọdụ ụgbọ mmiri UDP 11430. Edebanyela ọdụ ụgbọ mmiri a na IANA ma kenye ya na Lenbrook maka iji LSDP dịka nke March 27, 2014.
Na steeti ọ bụla ọnụ ọnụ ọ bụla nwere ọrụ iji kpọsaa mgbasa ozi ozi mara ọkwa ihe dị ka nkeji ọ bụla.
Na mbido na mgbe ndepụta ọrụ ma ọ bụ parampat netwọk gbanwere ngwugwu asaa ga-agbasa na obere oge iji mee ka nchọpụta mbụ na mgbanwe gbasaa ngwa ngwa. Maka ọrụ mgbasa ozi ọnụ ụzọ ngwugwu asaa ndị a ga-agụnye ozi ọkwa. Maka ọnụ ọnụ na-agbalị ịchọta ọrụ ngwugwu asaa mbụ ga-agụnye ozi ajụjụ. Maka ọrụ na-adịkwaghị ngwugwu asaa ahụ kwesịrị ịgụnye ozi Hichapụ.
A na-eziga ngwugwu mbụ ndị a ugboro asaa n'ihi enweghị ntụkwasị obi nke ngwugwu UDP. N'okwu a na-atụghị anya ya, a ka ga-achọpụta ọrụ asaa niile na-ada ada mgbe obere oge gasịrị site na nkeji nkeji Kpọọ ozi.
Ọ bụrụ na ọnụ na-anata ozi ajụjụ maka klaasị ọrụ ọ na-akpọsa, ọ ga-eji ozi ọkwa zaghachi ma obere oge gbue oge ma tọgharịa ọkwa ọkwa ya ugbu a.
Ihe nkụnye eji isi mee ihe na mgbochi ozi niile gụnyere mpaghara ogologo. Nke a na-enyekwu mgbanwe ma na-enye ohere maka mgbanwe dakọtara azụ ka emee n'ọdịnihu. Enwere ike ịgbakwunye mpaghara ma ọ bụ ụdị ozi n'ọdịnihu nke mmejuputa iwu ochie nwere ike ịfefe mgbe a na-atụgharị ya. Ọ bụrụ na anyị kpebiri ime mgbanwe na-ekwekọghị azụ azụ, enwekwara mpaghara ụdị na nkụnye eji isi mee nke nwere ike ịbawanye.
The protocol also allows for TXT records to be included with service advertisements similar to TXT records used
with mDNS. This gives significant flexibility for additional arbitrary meta data to be included with service
advertisements without changing the protocol.
Nkọwa Protocol
N'oge
All packets sent should be scheduled with random timing or delays to help avoid collisions.

• Oge ngwungwu mmalite: ngwugwu 7 n'oge = [0, 1, 2, 3, 5, 7, 10s] + (0 ruo 250ms random). Ndị a bụ oge zuru oke, ọ bụghị igbu oge. Ekwesịrị izipu ngwugwu 7 niile n'ime ihe dịka sekọnd iri.
• Main Announce Period: 57s + (0 to 6s random)
• Query Response Delay: (0 to 750ms random)

ID nke ọnụ
Each node shall have a unique ID which can be used to identify the node. The unique ID is included in Announce and Delete messages. Clients can use this value as a primary key when caching values and to uniquely identify a node. This unique ID can be a MAC address but should be the same for each interface if a node has multiple interfaces it is advertising on.
Ọdịdị ngwugwu
Each packet starts with a packet header followed by an arbitrary number of message blocks. Each message block starts with a length field so unrecognized messages can be skipped. Unless otherwise specified all multi-byte number values shall be stored big endian (most significant bytes first). Unless otherwise specified all numbers are unsigned values. For example otu byte ogologo nwere ike inwe ụkpụrụ 0 ruo 255.
Isi ihe ngwugwu

Ubi	Bytes	Nkọwa
Ogologo	1	Ngụkọta ogologo nkụnye eji isi mee gụnyere mpaghara a.
Okwu Ime Anwansi	4	This field shall be the four ASCII bytes of “LSDP”. This helps us identify packets as being intended for use so we do not need to try to parse random data from some unexpected source.
Usoro Protocol	1	Version of protocol. If future changes are made to the protocol that is backwards incompatible this version

Ubi	Bytes Nkọwa
		will be changed. The current version is 1.

Query Message

Ubi
	Bytes	Nkọwa
Ogologo	1	Total length of message including this field.
Ụdị ozi	1	“Q” = 0x51: Standard query for broadcast response. “R” = 0x52: Query for unicast response.
Gụọ	1	Number of classes to query.
Klas 1	2	16 bit (2 byte) class identifier.
…		Repeat previous field for each additional class.

Announce Message
Announce Header

Ubi
	Bytes	Nkọwa
Ogologo	1	Mgbakọta ogologo ozi gụnyere nkụnye eji isi mee ọkwa zuru oke yana kwupụta ndekọ.
Ụdị ozi	1	"A" = 0x41
Node ID Length	1	Ogologo ubi ID Node.
ID nke ọnụ	Na-agbanwe agbanwe	NJ Node pụrụ iche nke ọnụ na-eziga ọkwa ahụ. Nke a na-abụkarị adreesị MAC nke otu n'ime oghere ọnụ.
Ogologo adreesị	1	Ogologo ubi adreesị. Maka IPv4 nke a ga-abụ 4.

Ubi
	Bytes	Nkọwa
Adreesị	Na-agbanwe agbanwe	IP address of node.
Gụọ	1	Number of announce records to follow.

Announce Record

Ubi	Bytes	Nkọwa
Klas	2	16 bit (2 byte) class identifier.
Ọnụọgụ TXT	1	Number of TXT records to follow. If zero the following fields are omitted.
Key 1 Length	1	Length of key name.
Igodo 1	Na-agbanwe agbanwe	Key name.
Value 1 Length	1	Length of value text.
Uru 1	Na-agbanwe agbanwe	Value text.
…		Repeat previous 4 fields for each additional TXT record.

Hichapụ ozi

Ubi
	Bytes	Nkọwa
Ogologo	1	Total length of message including this field.
Ụdị ozi	1	“D” = 0x44
Node ID Length	1	Ogologo ubi ID Node.
ID nke ọnụ	Na-agbanwe agbanwe	Unique Node ID of node sending the message. This is usually the MAC address of one of the nodes

Ubi
	Bytes	Nkọwa
		ihu.
Gụọ	1	Number of classes to follow.
Klas 1	2	16 bit (2 byte) class identifier.
…		Repeat previous field for each additional class.

Class ID Assignments

NJ klas	Nkọwa	mDNS Dakọtara
0x0001	BluOS Player	_musc._tcp
0x0002	BluOS Server	_muss._tcp
0x0003	BluOS Player (secondary in multi-zone players such as the CI580)	_musp._tcp
0x0004	sovi-mfg used for manufacturing testing.	_sovi-mfg._tcp
0x0005	sovi-keypad	_sovi-keypad._tcp
0x0006	BluOS Player (pair slave)	_musz._tcp
0x0007	Ime ime Web Ngwa (AVR OSD Web Ibe)	_remote-web-ui._tcp
0x0008	BluOS Hub	_mush._tcp
0xFFFF	All Classes – Can be used with Query Message.

Rịba ama 1:
The overall LSDP packet needs to be treated as binary data.
Rịba ama 2:
Ọ bụrụ na otu ozi ọkwa enweghị ike ijide ozi ọnụ niile (karịsịa CI580), ọ ga-ekewa n'ime ozi ọkwa abụọ ma ọ bụ karịa yana ozi ọ bụla nwere isi na ndekọ yana ozi ọ bụla na-ejide ozi ọnụ (s) niile.

Ngwakọta BluOS Custom API ụdị 1.7

Akwụkwọ / akụrụngwa

API Njikọ Omenala BluOS T 778 [pdf] Akwụkwọ ntuziaka onye ọrụ T 778, T 778 API Njikọ Omenala, T 778, API Njikọ Omenala, API Mgbakwunye, API

Ntụaka

• Akwụkwọ ntuziaka onye ọrụ