API Προσαρμοσμένης Ενσωμάτωσης

API Προσαρμοσμένης Ενσωμάτωσης 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.

Πολιτική Χρήσης API

Με την πρόσβαση στα API, συμφωνείτε με την παρούσα Πολιτική Χρήσης API (η «Πολιτική») και τους Όρους μας. Παρέχουμε αυτά τα API για να επιτρέψουμε σε εταιρείες και άτομα να αξιοποιήσουν και να επωφεληθούν από την Υπηρεσία μας δημιουργώντας λογισμικό, υπηρεσίες ή ενότητες που συνδέονται με την πλατφόρμα μας ή έχουν πρόσβαση στα δεδομένα εντός της πλατφόρμας μας μέσω των API μας (μια «Ενσωμάτωση»). Η παρούσα Πολιτική αποτελεί και θα αποτελεί μέρος των Όρων μας.
Το λογισμικό παρέχεται «ΩΣ ΕΧΕΙ», χωρίς κανενός είδους εγγύηση, ρητή ή σιωπηρή, συμπεριλαμβανομένων ενδεικτικά των εγγυήσεων εμπορευσιμότητας, καταλληλότητας για συγκεκριμένο σκοπό και μη παραβίασης. Σε καμία περίπτωση οι δημιουργοί ή οι κάτοχοι πνευματικών δικαιωμάτων δεν θα ευθύνονται για οποιαδήποτε αξίωση, αποζημίωση ή άλλη ευθύνη, είτε σε συμβατική, αδικοπραξία είτε άλλως, που προκύπτει από, από ή σε σχέση με το λογισμικό ή τη χρήση ή άλλες συναλλαγές στο λογισμικό.
Επιτρεπόμενη χρήση
Δεν επιτρέπεται να χρησιμοποιείτε το API για την αποστολή ανεπιθύμητης αλληλογραφίας ή για να προβαίνετε σε ενέργειες που παραβιάζουν την Πολιτική Αποδεκτής Χρήσης και τους Τυπικούς Όρους Χρήσης μας. Θα συμμορφώνεστε με όλους τους ισχύοντες νόμους (συμπεριλαμβανομένων των νόμων περί απορρήτου και των νόμων ελέγχου εξαγωγών των Ηνωμένων Πολιτειών, των ευρωπαϊκών κανονισμών και κανονισμών GPR και των νόμων και κανονισμών οικονομικών κυρώσεων). Θα ακολουθείτε όλα τα έγγραφα που παρέχουμε για τα API. Δεν θα επιχειρήσετε να παραβιάσετε ή να αλλάξετε τον τρόπο λειτουργίας της Υπηρεσίας. Ενδέχεται να παρακολουθούμε τη χρήση των API από εσάς για συμμόρφωση με αυτούς τους κανόνες και ενδέχεται να σας αρνηθούμε την πρόσβαση στο API εάν παραβιάσετε την παρούσα Πολιτική.
Μυστικότητα
Σας 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.
Ασφάλεια
Θα εφαρμόζετε και θα διατηρείτε κατάλληλα τεχνικά και οργανωτικά μέτρα ασφαλείας για την προστασία και τη διατήρηση της ασφάλειας, της ακεραιότητας και της εμπιστευτικότητας των δεδομένων. Αυτά τα μέτρα ασφαλείας θα αποτρέπουν την μη εξουσιοδοτημένη πρόσβαση ή αποκάλυψη προσωπικών ή εμπιστευτικών δεδομένων που επεξεργάζεστε.
Ιδιοκτησία
Κατέχουμε όλα τα δικαιώματα, τους τίτλους και τα συμφέροντα στην Υπηρεσία και τα API, συμπεριλαμβανομένων όλων των δικαιωμάτων πνευματικής ιδιοκτησίας, σημάτων, κώδικα και λειτουργιών. Δεν θα παραβιάσετε, δεν θα κάνετε αντίστροφη μηχανική ή αντιγραφή του κώδικα, του σχεδιασμού ή του περιεχομένου μας. Δεν θα έχετε πρόσβαση στα API μας για να ανταγωνιστείτε την Υπηρεσία μας. Οποιαδήποτε δικαιώματα που δεν παραχωρούνται ρητά από την παρούσα Πολιτική παρακρατούνται, επομένως αν δεν τα βλέπετε εδώ, τότε δεν είναι δικαίωμα που σας παραχωρούμε.
Χρήση Σημάτων
Δεν επιτρέπεται να χρησιμοποιείτε το όνομα και τα σήματα μας (δηλαδή τα λογότυπά μας, τις επωνυμίες μας και τις εικόνες που προστατεύονται από πνευματικά δικαιώματα) με οποιονδήποτε τρόπο. Δεν επιτρέπεται να τροποποιείτε ή να αφαιρείτε οποιεσδήποτε ειδοποιήσεις ιδιοκτησίας στα σήματα μας. Δεν θα χρησιμοποιείτε το όνομα ή τα σήματα μας στο όνομα ή το λογότυπο της Ενσωμάτωσής σας ή με οποιονδήποτε τρόπο που υπονοεί την έγκρισή μας.
Πρακτική Χρήση Σημάτων
Αυτές οι οδηγίες εξηγούν πώς πρέπει πρακτικά να χρησιμοποιείτε το όνομα, τα σήματα και τα στοιχεία της επωνυμίας μας ανά πάσα στιγμή. Η χρήση από εσάς υποδηλώνει την αποδοχή αυτών των οδηγιών και κατανοείτε ότι η χρήση από εσάς κατά παράβαση αυτών των οδηγιών θα οδηγήσει σε αυτόματη λήξη της άδειάς σας να χρησιμοποιείτε το όνομα, τα σήματα και τα στοιχεία της επωνυμίας μας.

• 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.

Exampλιγότερο αποδεκτής χρήσης:
«[ΤΟ ΟΝΟΜΑ ΤΟΥ ΠΡΟΪΟΝΤΟΣ ΣΑΣ] (συμβατό με / λειτουργεί με BluOS)»
Exampλιγότερο απαράδεκτη χρήση
«[ΤΟ ΟΝΟΜΑ ΤΟΥ ΠΡΟΪΟΝΤΟΣ ΣΑΣ] – BluOS»
“BluOS – [YOUR PRODUCT NAME]”
“[YOUR PRODUCT NAME] – Powered with BluOS”
Μάρκετινγκ και Δελτία Τύπου
Αφού εγκριθεί η αίτησή σας, ενδέχεται να καταχωρηθεί στην ιστοσελίδα μας web ιδιότητες. Γενικά, δεν θα δημοσιεύουμε από κοινού δελτία τύπου ούτε θα συμβάλλουμε στο κοινό μάρκετινγκ της αίτησής σας.
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.
Αρνηση
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.
Ενημερώσεις
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.
Εμπιστευτικότητα
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.
Αποζημίωση
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
Με την επιφύλαξη παντός δικαιώματος
Απαγορεύεται η αναπαραγωγή, η αποθήκευση ή η μετάδοση οποιουδήποτε μέρους αυτής της δημοσίευσης σε οποιαδήποτε μορφή χωρίς την έγγραφη άδεια της Lenbrook Industries Limited. Παρόλο που έχει καταβληθεί κάθε δυνατή προσπάθεια για να διασφαλιστεί η ακρίβεια του περιεχομένου κατά τη στιγμή της δημοσίευσης, τα χαρακτηριστικά και οι προδιαγραφές ενδέχεται να αλλάξουν χωρίς προειδοποίηση.

Ιστορικό αναθεώρησης
Εκδοχή	Ημερομηνία	Περιγραφή
1.0	6/17/2019	Πρώτη κυκλοφορία
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	Ενημερωμένη ενότητα 8.3 example; Προστέθηκε αίτημα περιήγησης σε ενσωματωμένο μενού περιβάλλοντος 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 και προσθήκη στην ενότητα 7.1

Εισαγωγή

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.
Αυτό το έγγραφο δημιουργήθηκε για να βοηθήσει τους προγραμματιστές και τους ολοκληρωτές συστημάτων που εργάζονται στην αγορά προσαρμοσμένης ολοκλήρωσης (CI). Περιέχει ένα υποσύνολο των αιτημάτων API που τεκμηριώνονται στο πλήρες Πρωτόκολλο Ελέγχου API του BluOS.
Όλα τα αιτήματα που περιγράφονται σε αυτό το έγγραφο αποστέλλονται ως αιτήματα HTTP GET. Οι παράμετροι είναι ένα τυπικό URL κωδικοποιημένο ζεύγος ονόματος/τιμής. Οι συσκευές αναπαραγωγής BluOS λαμβάνουν αυτές τις εντολές και στη συνέχεια απαντούν με δεδομένα XML κωδικοποιημένα με UTF-8.
Όλα τα αιτήματα είναι σε μορφή http:// : / όπου:

• 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)

Σημείωμα: This document will use http://192.168.1.100:11000 as player IP and port in all examples.

Status Queries

Τα ερωτήματα κατάστασης χρησιμοποιούνται για την υποβολή ερωτημάτων σε μια συσκευή αναπαραγωγής BluOS.
Το BluOS παρέχει δύο μηχανισμούς για την εκτέλεση ερωτημάτων κατάστασης: την κανονική polling και τη μακρά polling. Η κανονική polling επιστρέφει αμέσως το αποτέλεσμα του ερωτήματος. Η μακρά polling διατηρεί μια σύνδεση για ένα καθορισμένο χρονικό διάστημα και επιστρέφει ένα αποτέλεσμα ερωτήματος μόνο όταν οι πληροφορίες έχουν αλλάξει ή έχει λήξει το χρονικό όριο. Η μακρά polling μπορεί να μειώσει σημαντικά τον αριθμό των κλήσεων προς έναν παίκτη.
Όταν δεν χρησιμοποιείται η μακροχρόνια polling, οι πελάτες θα πρέπει να περιορίσουν τον ρυθμό polling σε το πολύ ένα αίτημα κάθε 30 δευτερόλεπτα. Όταν χρησιμοποιείται η μακροχρόνια polling, ένας πελάτης δεν πρέπει να υποβάλλει δύο διαδοχικά αιτήματα για τον ίδιο πόρο με διαφορά μικρότερη του ενός δευτερολέπτου, ακόμη και αν το πρώτο αίτημα επιστρέψει σε λιγότερο από ένα δευτερόλεπτο.
Τα αιτήματα μακράς polling λαμβάνουν δύο παραμέτρους: χρονικό όριο και etag. το χρονικό όριο είναι η διάρκεια του αιτήματος μακράς ψηφοφορίας και etag λαμβάνεται από την προηγούμενη απόκριση (ένα χαρακτηριστικό στο ριζικό στοιχείο της απόκρισης).
Γενικά, είναι απαραίτητο να έχετε ενεργή μια long-poll μόνο για ένα από τα /Status ή /SyncStatus. Η απόκριση /Status περιλαμβάνει ένα στοιχείο ( ) που υποδεικνύει εάν το /SyncStatus έχει αλλάξει. Το /SyncStatus θα πρέπει να ερωτηθεί εάν ενδιαφέρει μόνο το όνομα, η ένταση ήχου και η κατάσταση ομαδοποίησης ενός παίκτη. Το /Status θα πρέπει να ερωτηθεί εάν απαιτείται η τρέχουσα κατάσταση αναπαραγωγής.
Όταν οι παίκτες ομαδοποιούνται, ο κύριος παίκτης είναι ο κύριος παίκτης της ομάδας. Οι δευτερεύοντες παίκτες συνδέονται με τον κύριο παίκτη. Η απόκριση /Status των δευτερευόντων παικτών είναι αντίγραφα αυτής του κύριου παίκτη. Η μακρά ψηφοφορία /SyncStatus είναι στη συνέχεια απαραίτητη για την παρακολούθηση της έντασης κάθε δευτερεύοντος παίκτη.
2.1 Κατάσταση αναπαραγωγής
Περιγραφή
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.
Αίτηση
/Status?timeout=δευτερόλεπτα&etag=etag-αξία

Παράμετροι	Περιγραφή
timeout	Προαιρετική παράμετρος που χρησιμοποιείται με μεγάλη σταθμοσκόπηση. Το συνιστώμενο διάστημα σταθμοσκόπησης είναι 100 δευτερόλεπτα και θα πρέπει να περιορίζεται σε ρυθμό περίπου 60 δευτερολέπτων και ποτέ μεγαλύτερο από 10 δευτερόλεπτα.
etag	Προαιρετική παράμετρος που χρησιμοποιείται με μακρά ψηφοφορία. Αυτό είναι το etag χαρακτηριστικό από το

Παράμετροι	Περιγραφή
	προηγούμενη απόκριση κλήσης /Status.

Απάντηση
<status etag=”4e266c9fbfba6d13d1a4d6ff4bd2e1e6″>
<album>÷ (Deluxe)</album>
<artist>Ed Sheeran</artist>
<canMovePlayback>true</canMovePlayback>
<canSeek>1</canSeek>
<cursor>159</cursor>
Ντίζερ: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>
παύση
<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>
ΣΗΜΕΙΩΜΑ: not all response attributes are listed in the following chart. Other elements may be present and should be ignored.

Χαρακτηριστικά απόκρισης	Περιγραφή
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.
δράση	See Actions for Streaming Radio Stations section for description.
άλμπουμ	Album name of the current active track. Also see title1 attribute.
artist	Artist name of the current active track. Also see title1 attribute.
μπαταρία	Shown if the player has a battery pack. Includes attributes: ·  level – state of charge, percent ·  charging – 1 if currently charging ·   icon – URL εικόνας παίκτη που υποδεικνύει την τρέχουσα κατάσταση φόρτισης
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	Επίπεδο έντασης σε 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.
εικών	URL εικόνας που σχετίζεται με τον τρέχοντα ήχο (άλμπουμ, σταθμός, είσοδος κ.λπ.). Εάν

Χαρακτηριστικά απόκρισης	Περιγραφή
	ο URL starts with /Artwork it may result in redirect. Adding a parameter/key followRedirects=1 when retrieving the image can avoid redirect.
βουβός	Mute state. Set to 1 if volume is muted.
muteDb	if the player is muted, then this contains the unmuted volume in dB.
σίγαση έντασης ήχου	If ther is muted, then this contains the unmuted volume level. Values are from 0 to 100.
όνομα	The title of the current playing audio track. Also see title1 attribute.
κοινοποιούνurl	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.
απαλλάσσω	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.
ποιότητα	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 sampλιγότερο/δευτ. ή περισσότερο ·  dolbyAudio – DolbyDigital or AC3 ·  mqa – valid MQA audio decoded ·   mqaAuthored – valid MQA-Authored audio decoded Μια αριθμητική τιμή είναι ο κατά προσέγγιση ρυθμός μετάδοσης bit μιας συμπιεσμένης πηγής ήχου με την ποιότητα του file.
επαναλαμβάνω	0, 1, or 2. 0 means repeat play queue, 1 means repeat a track, and 2 means repeat off
δευτερόλεπτα	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.
υπηρεσία	The service id of the current audio. This is not a value for displaying in a UI, as the

Χαρακτηριστικά απόκρισης	Περιγραφή
	Η πραγματική συμβολοσειρά ενδέχεται να διαφέρει από το επίσημο όνομα της υπηρεσίας.
Εικονίδιο υπηρεσίας	URL του εικονιδίου της τρέχουσας υπηρεσίας.
ανάμιξη	0 ή 1. Το 0 σημαίνει ότι η τυχαία αναπαραγωγή είναι απενεργοποιημένη και το 1 σημαίνει ότι η τυχαία αναπαραγωγή είναι ενεργοποιημένη.
ύπνος	Τα λεπτά που απομένουν πριν ενεργοποιηθεί ο χρονοδιακόπτης ύπνου.
τραγούδι	Η θέση του τρέχοντος κομματιού στην ουρά αναπαραγωγής. Δείτε επίσης ροήUrl.
κατάσταση	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.
ρεύμαUrl	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	Η τρίτη γραμμή πληροφοριών που περιγράφει τον τρέχοντα ήχο.
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

Χαρακτηριστικά απόκρισης	Περιγραφή
	γραμμές μεταδεδομένων που αναπαράγονται τώρα.
twoline_title2	Η δεύτερη από τις δύο γραμμές που περιγράφουν τον τρέχοντα ήχο.
τόμος	Το επίπεδο έντασης ήχου του παίκτη σε ποσοστόtagε; -1 σημαίνει ότι η ένταση του ήχου του παίκτη είναι σταθερή.
δευτερόλεπτα	Ο αριθμός των δευτερολέπτων που έχει αναπαραχθεί το τρέχον ηχητικό κομμάτι.

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 Κατάσταση συγχρονισμού παίκτη και ομάδας
Περιγραφή
Το ερώτημα SyncStatus επιστρέφει πληροφορίες παίκτη και πληροφορίες ομαδοποίησης παικτών. Αυτό το ερώτημα επιστρέφει πολλά χαρακτηριστικά απόκρισης, μερικά από τα οποία δεν ισχύουν για αυτό το έγγραφο. Οι μη τεκμηριωμένες απαντήσεις θα πρέπει να αγνοούνται.
Αίτηση
/SyncStatus?timeout=δευτερόλεπτα&etag=etag-αξία

Παράμετροι	Περιγραφή
timeout	Προαιρετική παράμετρος που χρησιμοποιείται με μεγάλη σταθμοσκόπηση. Είναι το διάστημα σταθμοσκόπησης σε δευτερόλεπτα. Το συνιστώμενο διάστημα σταθμοσκόπησης είναι 180 δευτερόλεπτα.
etag	Προαιρετική παράμετρος που χρησιμοποιείται με μακρά ψηφοφορία. Αυτό είναι το etag attribute from the previous /SyncStatus call response.

Απάντηση
<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>


…..

ΣΗΜΕΙΩΣΗ: Δεν παρατίθενται όλα τα χαρακτηριστικά απόκρισης στο παρακάτω διάγραμμα. Ενδέχεται να υπάρχουν και άλλα στοιχεία και θα πρέπει να αγνοηθούν.

Χαρακτηριστικά απόκρισης	Περιγραφή
μπαταρία	Shown if the player has a battery pack. Includes attributes: · level – state of charge, percent ·  charging – 1 if currently charging ·  icon – URL εικόνας παίκτη που υποδεικνύει την τρέχουσα κατάσταση φόρτισης
μάρκα	Player brand name.
db	Επίπεδο έντασης σε dB.
etag	Tag of the /SyncStatus response, used for long polling.
ομάδα	The group name.
εικόνισμα	URL that contains the player icon image.
id	Player IP and port.
αρχικοποιήθηκε	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.
κύριος	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
μοντέλο	Player model id.
όνομα μοντέλου	Player model name.
βουβός	Set to 1 if volume is muted.
muteDb	Εάν η συσκευή αναπαραγωγής είναι σε σίγαση, τότε αυτή είναι η μη σίγαση της έντασης ήχου σε dB.

Χαρακτηριστικά απόκρισης	Περιγραφή
σίγαση έντασης ήχου	Εάν η συσκευή αναπαραγωγής είναι σε σίγαση, τότε αυτό είναι το επίπεδο έντασης ήχου χωρίς σίγαση (0..100).
όνομα	Player name.
schemaVersion	Software schema version.
δούλος	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	αναγνωριστικό κατάστασης συγχρονισμού. Αλλάζει κάθε φορά που αλλάζει οποιοδήποτε στοιχείο στην απάντηση /SyncStatus. Ταίριασμα με στοιχείο στην απόκριση /Status.
τόμος	Επίπεδο έντασης σε κλίμακα 0..100. -1 σημαίνει σταθερή ένταση.
ζώνη	Όνομα σταθερής ομάδας.
zoneMaster	Εάν ο παίκτης είναι ο κύριος παίκτης σε μια σταθερή ομάδα, αυτό ορίζεται σε true.
ζώνηΣκλάβος	Εάν ο παίκτης είναι δευτερεύων παίκτης σε μια σταθερή ομάδα, αυτό ορίζεται σε true.

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.

Έλεγχος έντασης ήχου

Ρυθμίζει την ένταση ήχου ενός παίκτη. Χρησιμοποιείται επίσης για σίγαση ενός παίκτη.
3.1 Ρύθμιση έντασης ήχου
Περιγραφή
Αυτό το αίτημα υποβάλλει ερώτημα ή ορίζει την ένταση του ήχου της συσκευής αναπαραγωγής.
Όλες οι παραλλαγές εντολών, είτε χρησιμοποιούν επίπεδο 0..100, απόλυτες ή σχετικές παραμέτρους dB, περιορίζονται σε τιμές που έχουν ως αποτέλεσμα ένα επίπεδο εντός του διαμορφωμένου διαθέσιμου εύρους έντασης, το οποίο είναι συνήθως -80..0. Το εύρος έντασης μπορεί να ρυθμιστεί χρησιμοποιώντας την εφαρμογή BluOS Controller, στη σελίδα Ρυθμίσεις -> Αναπαραγωγή -> Ήχος.
Το ερώτημα υποστηρίζει μακρά polling (δεν απεικονίζεται παρακάτω).
Αίτηση
/Τόμος
/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

Παράμετροι	Περιγραφή
επίπεδο	Ορίστε την απόλυτη στάθμη έντασης ήχου της συσκευής αναπαραγωγής. Είναι ένας ακέραιος αριθμός από 0 έως 100.
tell_slaves	Ισχύει για ομαδοποιημένους παίκτες. Εάν οριστεί σε 0, μόνο ο παίκτης που έχει επιλεγεί αλλάζει ένταση ήχου. Εάν οριστεί σε 1, τότε όλοι οι παίκτες στην ομάδα αλλάζουν ένταση ήχου.
βουβός	Εάν οριστεί σε 0, ο παίκτης τίθεται σε σίγαση. Εάν οριστεί σε 1, ο παίκτης δεν τίθεται σε σίγαση.
abs_db	Ρυθμίστε την ένταση χρησιμοποιώντας μια κλίμακα dB.
db	Do a relative volume change using a dB volume scale. db can be a positive or negative number.

Απάντηση
<volume db=”-49.9″ mute=”0″ offsetDb=”0″ etag=”6213593a6132887e23fe0476b9ab2cba”>15</volume>

Χαρακτηριστικά απόκρισης

Περιγραφή

Χαρακτηριστικά απόκρισης	Περιγραφή
db	Επίπεδο έντασης σε dB.
βουβός	1 εάν ο παίκτης είναι σε σίγαση, 0 εάν ο παίκτης δεν είναι σε σίγαση.
muteDb	Εάν η συσκευή αναπαραγωγής είναι σε σίγαση, τότε αυτή είναι η μη σίγαση της έντασης ήχου σε dB.
σίγαση έντασης ήχου	Εάν η συσκευή αναπαραγωγής είναι σε σίγαση, τότε αυτό είναι το επίπεδο έντασης ήχου χωρίς σίγαση (0..100).
τόμος	Η τρέχουσα στάθμη έντασης: 0..100 ή -1 για σταθερή ένταση.

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 Αύξηση έντασης
Περιγραφή
Αυτό το αίτημα αυξάνει την ένταση κατά ορισμένα dB (η τυπική τιμή είναι 2dB).
Αίτηση
/Όγκος?db=τιμή_db

Παράμετροι	Περιγραφή
db	Βήματα αύξησης έντασης ήχου σε dB (τυπική τιμή 2dB)

Απάντηση
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>

Χαρακτηριστικά απόκρισης	Περιγραφή
db	Επίπεδο έντασης σε dB.
βουβός	1 εάν ο παίκτης είναι σε σίγαση, 0 εάν ο παίκτης δεν είναι σε σίγαση

Χαρακτηριστικά απόκρισης	Περιγραφή
offsetDb
etag

Example
http://192.168.1.100:11000/Volume?db=2
Increase the volume by 2dB.
3.3 Μείωση έντασης
Περιγραφή
Αυτό το αίτημα μειώνει την ένταση κατά ορισμένα dB (η τυπική τιμή είναι -2dB).
Αίτηση
/Όγκος?db=-db_value

Παράμετροι	Περιγραφή
db	Βήματα αύξησης έντασης ήχου σε dB (τυπική τιμή -2dB)

Απάντηση
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>

Χαρακτηριστικά απόκρισης	Περιγραφή
db	Επίπεδο έντασης σε dB
βουβός	1 εάν ο παίκτης είναι σε σίγαση, 0 εάν ο παίκτης δεν είναι σε σίγαση
offsetDb
etag

Example
http://192.168.1.100:11000/Volume?db=-2
Decrease the volume by 2dB.
3.4 Σίγαση ενεργοποιημένη
Περιγραφή
Αίτηση
/Volume?mute=1

Παράμετροι	Περιγραφή
βουβός	Ορίστε σε 1 για σίγαση του παίκτη

Απάντηση
<volume muteDb=”-43.1″ db=”100″
muteVolume=”11″
mute=”1″
offsetDb=”0″
etag=”2105bed56563d9da46942a696cfadd63″>0</volume
>

Χαρακτηριστικά απόκρισης	Περιγραφή
muteDb	Επίπεδο έντασης ήχου σε dB πριν από τη σίγαση
db	Επίπεδο έντασης σε dB
σίγαση έντασης ήχου	Επίπεδο έντασης ήχου σε ποσοστό πριν από τη σίγαση
βουβός	Το 1 σημαίνει ότι ο παίκτης είναι σε σίγαση
offsetDb
etag

Example
http://192.168.1.100:11000/Volume?mute=1
3.5 Σίγαση Απενεργοποίηση
Περιγραφή
Αυτό το αίτημα ορίζει τον παίκτη σε ενεργοποίηση σίγασης.
Αίτηση
/Volume?mute=0

Παράμετροι	Περιγραφή
βουβός	Ορίστε σε 0 για να απενεργοποιήσετε τη σίγαση του παίκτη

Απάντηση
<volume db=”-43.1″ mute=”0″ offsetDb=”0″ etag=”e72d53db17baa526ebb5ee9c26060b1f”>11</volume>

Χαρακτηριστικά απόκρισης	Περιγραφή
db	Επίπεδο έντασης σε dB
βουβός	0 means the player is not muted
offsetDb
etag

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

Έλεγχος αναπαραγωγής

Αυτές οι εντολές χρησιμοποιούνται για τον βασικό έλεγχο της αναπαραγωγής. Οι εντολές περιλαμβάνουν αναπαραγωγή, παύση, διακοπή, παράλειψη, επιστροφή, τυχαία αναπαραγωγή και επανάληψη.
4.1 Παίξτε
Περιγραφή
Έναρξη αναπαραγωγής της τρέχουσας πηγής ήχου. Οι προαιρετικές παράμετροι επιτρέπουν την μετάβαση στα κομμάτια ήχου και την επιλογή μιας εισόδου πριν από την έναρξη της αναπαραγωγής ήχου.
Αίτηση
/Play
/Play?seek=seconds
/Play?seek=seconds&id=trackid
/Παιχνίδι;url=encodedStreamURL

Παράμετροι	Περιγραφή
ζητώ	Μετάβαση σε καθορισμένη θέση στο τρέχον κομμάτι. Ισχύει μόνο εάν η απόκριση /Status περιλαμβάνει Δεν μπορεί να χρησιμοποιηθεί με παραμέτρους inputType και ευρετηρίου.
κωδικοποιημένοΡεύμαURL	URL ροής προσαρμοσμένου ήχου. Πρέπει να είναι URL κωδικοποιημένα.

Απάντηση
<state>play</state>
ρεύμα

Χαρακτηριστικά απόκρισης	Περιγραφή
κατάσταση	Η κατάσταση μετά την εκτέλεση της εντολής. Δείτε το χαρακτηριστικό κατάστασης απόκρισης /Status για περισσότερες λεπτομέρειες.

Example
http://192.168.1.100:11000/Play
Έναρξη αναπαραγωγής ήχου του τρέχοντος κομματιού.
http://192.168.1.100:11000/Play?seek=55
Έναρξη αναπαραγωγής ήχου στα 55 δευτερόλεπτα από την έναρξη του τρέχοντος κομματιού.
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 Παύση
Περιγραφή
Παύση του τρέχοντος αναπαραγόμενου ήχου.
Εάν αναπαράγεται ένα ξυπνητήρι και έχει χρονικό όριο, τότε το χρονικό όριο του ξυπνητηριού ακυρώνεται.
Αίτηση
/Παύση
/Παύση?toggle=1

Παράμετροι	Περιγραφή
μπαρέτα	Εάν οριστεί σε 1, τότε η τρέχουσα κατάσταση παύσης εναλλάσσεται.

Απάντηση
παύση

Χαρακτηριστικά απόκρισης	Περιγραφή
κατάσταση	Η κατάσταση μετά την εκτέλεση της εντολής. Δείτε το χαρακτηριστικό κατάστασης απόκρισης /Status για περισσότερες λεπτομέρειες.

Example
http://192.168.1.100:11000/Pause
Pauses the currently playing audio.
Διακοπή 4.3
Περιγραφή
Stop the current playing audio. If an alarm is playing, and it has a timeout, then the alarm timeout is canceled Request
/Στάση

Παράμετροι	Περιγραφή
Κανένας

Απάντηση
στάση

Χαρακτηριστικά απόκρισης	Περιγραφή
κατάσταση	«Διακοπή» σημαίνει ότι ο τρέχων ήχος έχει διακοπεί.

Example
http://192.168.1.100:11000/Stop
Stops the currently playing audio.
4.4 Παράλειψη
Περιγραφή
Μετάβαση στο επόμενο κομμάτι ήχου στην ουρά αναπαραγωγής
Κατά την αναπαραγωγή από την ουρά αναπαραγωγής, θα μεταβεί στο επόμενο κομμάτι στην ουρά. Εάν το τρέχον κομμάτι είναι το τελευταίο στην ουρά, η κλήση του /Skip θα μεταβεί στο πρώτο κομμάτι στην ουρά. Θα μεταβεί στο επόμενο ή στο πρώτο κομμάτι στην ουρά ανεξάρτητα από την κατάσταση της ρύθμισης επανάληψης.
Για να διαπιστώσετε εάν χρησιμοποιείτε την ουρά αναπαραγωγής, βεβαιωθείτε ότι δεν υπάρχειUrl> entry in the /Status response.
Then you can use the /Skip command.
Μπορείτε επίσης να παραλείψετε κομμάτια για ορισμένους ραδιοφωνικούς σταθμούς συνεχούς ροής. Αυτά τα χειρίζεστε με την εντολή /Action.
Ορισμένες πηγές όπως το TuneIn και η οπτική είσοδος δεν υποστηρίζουν την επιλογή παράλειψης. Αυτές οι πηγές θα έχουνURL> καταχώρηση αλλά δεν υπάρχει όνομα ενέργειας παράλειψης στην απόκριση /Status.
Αίτηση
/Παραλείπω

Παράμετροι	Περιγραφή
Κανένας

Απάντηση
21

Χαρακτηριστικά απόκρισης	Περιγραφή
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
Μετάβαση στο επόμενο κομμάτι.
4.5 Πίσω
Περιγραφή
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.
Για να διαπιστώσετε εάν χρησιμοποιείτε την ουρά αναπαραγωγής, βεβαιωθείτε ότι δεν υπάρχειUrl> element in the /Status response.
Then you can use the /Back command.
Μπορείτε επίσης να επιστρέψετε σε παλαιότερα κομμάτια για ορισμένους ραδιοφωνικούς σταθμούς συνεχούς ροής. Αυτά διαχειρίζονται με την εντολή /Action.
Ορισμένες πηγές όπως το TuneIn και η οπτική είσοδος δεν υποστηρίζουν την επιλογή επιστροφής. Αυτές οι πηγές θα έχουνUrl> στοιχείο αλλά δεν υπάρχει όνομα ενέργειας παράλειψης στην απόκριση /Status.
Αίτηση
/Πίσω

Παράμετροι	Περιγραφή
Κανένας

Απάντηση
19

Χαρακτηριστικά απόκρισης	Περιγραφή
id	The track id after executing the back command. Refer to the /Status response song attribute for details.

4.6 Ανακάτεμα
Περιγραφή
Η εντολή shuffle δημιουργεί μια νέα ουρά ανακατεύοντας την τρέχουσα ουρά. Η αρχική (μη ανακατεμένη) ουρά διατηρείται για επαναφορά όταν η ανακάτεμα είναι απενεργοποιημένη.
Αίτηση
/Shuffle?state=0|1

Παράμετροι	Περιγραφή
κατάσταση	· 0 to disable shuffle · 1 to enable shuffle. Has no effect if queue is already in shuffled state. See /Status response <shuffle> element.

Απάντηση

Χαρακτηριστικά απόκρισης	Περιγραφή
τροποποιήθηκε	Το 1 σημαίνει ότι η ουρά έχει τροποποιηθεί από τότε που φορτώθηκε. Το 0 σημαίνει ότι όχι.
μήκος	Συνολικός αριθμός κομματιών στην τρέχουσα ουρά.
ανάμιξη	Η κατάσταση τυχαίας αναπαραγωγής. Το 1 σημαίνει ότι η τρέχουσα ουρά έχει ανακατευτεί. Το 0 σημαίνει ότι η τρέχουσα ουρά δεν έχει ανακατευτεί.
id	Το τρέχον αναγνωριστικό ουράς. Αλλάζει κάθε φορά που τροποποιείται η ουρά αναπαραγωγής.

Example
http://192.168.1.100:11000/Shuffle?state=1
Ανακατεύει την τρέχουσα ουρά αναπαραγωγής.
4.7 Επαναλάβετε
Περιγραφή
Ορίζει επιλογές επανάληψης. Η επανάληψη έχει τρεις καταστάσεις: 0 σημαίνει επανάληψη της τρέχουσας ουράς, 1 σημαίνει επανάληψη του τρέχοντος κομματιού και 2 σημαίνει ότι δεν επαναλαμβάνεται. Όλες οι επαναλήψεις είναι αόριστες, δηλαδή δεν σταματούν.
Αίτηση
/Επανάληψη?κατάσταση=0|1|2

Παράμετροι	Περιγραφή
κατάσταση	· 0 to repeat the entire play queue · 1 to repeat the current track · 2 to turn repeat off

Απάντηση

Χαρακτηριστικά απόκρισης	Περιγραφή
μήκος	Ο συνολικός αριθμός κομματιών στην τρέχουσα ουρά αναπαραγωγής.
id	Το τρέχον αναγνωριστικό ουράς. Αλλάζει κάθε φορά που τροποποιείται η ουρά αναπαραγωγής.
επαναλαμβάνω	Η τρέχουσα κατάσταση επανάληψης.

Example
http://192.168.1.100:11000/Repeat?state=1
Repeats the current playing track.
4.8 Ενέργειες για ροή ραδιοφωνικών σταθμών
Περιγραφή
Οι ενέργειες σάς επιτρέπουν να κάνετε παράλειψη προς τα εμπρός, να επιστρέφετε, να κάνετε "αγάπη" και να αποκλείετε κομμάτια σε επιλεγμένους ραδιοφωνικούς σταθμούς ροής, όπως το Slacker ή το Radio Paradise ή το Amazon Music Prime Stations. Οι ραδιοφωνικοί σταθμοί ροής δεν φορτώνουν κομμάτια στην ουρά αναπαραγωγής. Αντίθετα, παρέχουν ένα URL που μπορείτε να χρησιμοποιήσετε για να ολοκληρώσετε την επιθυμητή λειτουργία.
Με την επιλογή Παράλειψη θα μεταβείτε στο επόμενο κομμάτι. Με την επιλογή Πίσω θα μεταβείτε στο προηγούμενο κομμάτι. Με την επιλογή Love θα επισημανθεί το κομμάτι ως αρεστό στην υπηρεσία μουσικής. Με την επιλογή Ban θα μεταβείτε στο επόμενο κομμάτι και θα επισημανθεί ως μη αρεστό στην υπηρεσία μουσικής.
Εάν υπάρχει έναUrl> καταχώρηση στην απόκριση /Status και μια κατάλληλη ενέργεια, μπορείτε να εκτελέσετε αυτές τις λειτουργίες. Η ενέργεια θα περιέχει το URL που χρησιμοποιείται για την εκτέλεση της ενέργειας.
Εδώ είναι ένας πρώηνampαπό την απόκριση /Status ενός παίκτη που παίζει Slacker radio:
<actions>
<action name=”back”/>
<action name=”skip” url=”/Ενέργεια?service=Slacker&skip=4799148″/>
<action icon=”/images/loveban/love.png” name=”love” notification=”Track marked as favorite” state=”1″ text=”Love” url=”/Δράση?υπηρεσία=Τεμπέλης&αγάπη=4799148″/>
<action icon=”/images/loveban/ban.png” name=”ban” notification=”Track banned from this
station” state=”-1″ text=”Ban” url=”/Action?service=Slacker&ban=4799148″/>

Σε αυτό το πρώηνample, η επιστροφή δεν είναι διαθέσιμη, αλλά η παράλειψη, η αγάπη και η απαγόρευση είναι δυνατές.
Αίτηση
/Action?service=όνομα-υπηρεσίας&action=action-URL
Σημείωμα: The specific request details (endpoint and parameters) are given by the respective <action> element. The commands in the ExampΗ παρακάτω ενότητα χρησιμοποιεί όλα το /Action, αλλά οποιοδήποτε URI είναι δυνατό.

Παράμετροι	Περιγραφή
	Παρέχεται σε στοιχείο.

Απάντηση
Για την απόκριση, λαμβάνετε μια επιβεβαίωση ενέργειας. Για παράλειψη και επιστροφή, λαμβάνετε:
<skip/>
<back/>
For love you receive:
<love>1</love>
For ban you receive:
1

Χαρακτηριστικά απόκρισης	Περιγραφή
απάντηση	Αν το βασικό στοιχείο της απόκρισης είναι τότε ο κόμβος κειμένου είναι μια ειδοποίηση που θα εμφανιστεί στον χρήστη. Εάν επιστραφεί ένα εναλλακτικό στοιχείο ρίζας και το συμπεριλάμβανε ένα χαρακτηριστικό ειδοποίησης, τότε θα έπρεπε να εμφανίζεται αυτή η ειδοποίηση.

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
Απαγορεύει το τρέχον αναπαραγόμενο κομμάτι του ραδιοφώνου Slacker και μεταβαίνει στο επόμενο κομμάτι.

 Play Queue Management

Ένας τρόπος λειτουργίας ενός προγράμματος αναπαραγωγής είναι η φόρτωση κομματιών σε μια ουρά αναπαραγωγής και, στη συνέχεια, η αναπαραγωγή των κομματιών από αυτήν την ουρά αναπαραγωγής. Αυτές οι εντολές σάς επιτρέπουν να view και να διαχειρίζεστε την ουρά αναπαραγωγής.
5.1 Λίστα κομματιών
Περιγραφή
Είτε επιστρέψτε την κατάσταση της ουράς αναπαραγωγής είτε επιστρέψτε πληροφορίες για όλα τα κομμάτια στην ουρά αναπαραγωγής.
Δεν συνιστάται η χρήση αυτού του ερωτήματος χωρίς τις παραμέτρους μήκους ή έναρξης και λήξης, καθώς διαφορετικά θα μπορούσε να δημιουργηθεί μια πολύ μεγάλη απόκριση.
Αίτηση
/Playlist
/Playlist?length=1
/Playlist?start=first&end=last (retrieve part of the queue, for pagination usually)

Παράμετροι	Περιγραφή
μήκος=1	Επιστρέφει μόνο τα χαρακτηριστικά ανώτατου επιπέδου και καμία λεπτομέρεια κομματιού.
αρχή	Πρώτη καταχώρηση στην ουρά που θα συμπεριληφθεί στην απόκριση, ξεκινώντας από το 0.
τέλος	Τελευταία καταχώρηση στην ουρά που θα συμπεριληφθεί στην απάντηση.

Απάντηση
Για την κατάσταση της ουράς αναπαραγωγής:
<playlist>
<length>13</length>
243
<name></name>
<modified>1</modified>

For a play queue listing:


2002
Άννα-Μαρί
2002
Ντίζερ:487381362

Χαρακτηριστικά απόκρισης	Περιγραφή
όνομα	Το τρέχον όνομα της ουράς αναπαραγωγής.
τροποποιήθηκε	Το 0 σημαίνει ότι η ουρά δεν έχει τροποποιηθεί από τότε που φορτώθηκε. Το 1 σημαίνει ότι η ουρά έχει τροποποιηθεί από τότε που φορτώθηκε.
μήκος	συνολικός αριθμός κομματιών στην τρέχουσα ουρά
id	unique id for the current queue state (e.g., 1054). It is same as the <pid> in /Status response.
τραγούδι	Το τραγούδι αποτελείται από διάφορα υποστοιχεία: ·  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 Διαγραφή κομματιού
Περιγραφή
Αφαίρεση κομματιού από την τρέχουσα ουρά αναπαραγωγής.
Αίτηση
/Διαγραφή?id=θέση

Παράμετροι	Περιγραφή
id	Το αναγνωριστικό κομματιού του κομματιού που θα διαγραφεί από την τρέχουσα ουρά αναπαραγωγής.

Απάντηση
9

Χαρακτηριστικά απόκρισης	Περιγραφή
διαγράφηκε	Η θέση στην ουρά του κομματιού που θα αφαιρεθεί.

Example
http://192.168.1.100:11000/Delete?id=9
Removes the track at position 9 in the play queue.
5.3 Μετακίνηση κομματιού
Περιγραφή
Μετακίνηση ενός κομματιού εντός της τρέχουσας ουράς αναπαραγωγής.
Αίτηση
/Μετακίνηση?new=προορισμός&old=προέλευση

Παράμετροι	Περιγραφή
νέος	New position on the track being moved.
παλιός	Old position of the track being moved.

Απάντηση
μετακόμισε

Χαρακτηριστικά απόκρισης	Περιγραφή
μετακόμισε	Υποδεικνύει ότι η τροχιά μετακινήθηκε.

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 Εκκαθάριση ουράς
Περιγραφή
Διαγραφή όλων των κομματιών από την τρέχουσα ουρά αναπαραγωγής
Αίτηση
/Σαφής

Παράμετροι	Περιγραφή
Κανένας

Απάντηση

Χαρακτηριστικά απόκρισης	Περιγραφή
τροποποιήθηκε	Το 0 σημαίνει ότι η ουρά δεν έχει τροποποιηθεί από τη φόρτωσή της, το 1 σημαίνει ότι η ουρά έχει τροποποιηθεί από τη φόρτωσή της.
μήκος	Ο συνολικός αριθμός κομματιών στην τρέχουσα ουρά.
id	Το μοναδικό αναγνωριστικό για την τρέχουσα ουρά.

Example
http://192.168.1.100:11000/Clear
This removes all tracks from the play queue.
5.5 Αποθήκευση της ουράς
Περιγραφή
Αποθηκεύστε την ουρά αναπαραγωγής ως ονομασμένη λίστα αναπαραγωγής BluOS.
Αίτηση
/Αποθήκευση?name=όνομα_λίστας_αναπαραγωγής

Παράμετροι	Περιγραφή
όνομα	Το όνομα της αποθηκευμένης ουράς αναπαραγωγής.

Απάντηση
<saved>
<entries>126</entries>

Χαρακτηριστικά απόκρισης	Περιγραφή
καταχωρήσεις	Ο συνολικός αριθμός κομματιών στην αποθηκευμένη ουρά αναπαραγωγής.

Example
http://192.168.1.100:11000/Save?name=Dinner+Music
Αυτό αποθηκεύει την ουρά αναπαραγωγής ως «Μουσική Δείπνου».

Προεπιλογές

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 Λίστα προεπιλογών
Περιγραφή
Λίστα όλων των προεπιλογών στην τρέχουσα συσκευή αναπαραγωγής BluOS.
Αίτηση
/Προεπιλογές

Παράμετροι	Περιγραφή
Κανένας

Απάντηση

<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=”/Φόρτωση?υπηρεσία=Παλιρροία&amp;id=fd3f797e-
a3e9-4de9-a1e2-b5adb6a57cc7″ image=”/Artwork?service=Tidal&amp;playlistimage=afacfc12-24034caf-a5c5-a2af28d811c8″/> </presets>

Χαρακτηριστικά απόκρισης	Περιγραφή
prid	Ένα μοναδικό αναγνωριστικό των προεπιλογών του προγράμματος αναπαραγωγής. Είναι το ίδιο με το στην απόκριση /Status.
όνομα	Το όνομα της προεπιλογής.
id	Το προκαθορισμένο αναγνωριστικό.
url	Η προεπιλογή URLΕίναι η προκαθορισμένη πηγή URL used to load the preset.
εικών	Εικών URL της προεπιλογής. Εάν το 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 Φόρτωση προεπιλογής
Περιγραφή
Ξεκινά την αναπαραγωγή μιας προεπιλογής. Μπορείτε να επιλέξετε έναν συγκεκριμένο αριθμό προεπιλογής, καθώς και την επόμενη ή την προηγούμενη προεπιλογή. Οι αριθμοί προεπιλογής δεν χρειάζεται να είναι διαδοχικοί, δηλαδή, μπορείτε να έχετε τις προεπιλογές 1,2,3, 5, 7, 8, XNUMX και XNUMX. Οι προεπιλογές εναλλάσσονται από πάνω προς τα κάτω και από κάτω προς τα πάνω.
Αίτηση
/Preset?id=presetId|-1|+1

Παράμετροι	Περιγραφή
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.

Απάντηση
Εάν η προεπιλογή είναι μια λίστα κομματιών, επιστρέφει τον αριθμό των κομματιών της προεπιλογής που έχει φορτωθεί.
<loaded service=”Deezer”>
<entries>60</entries>
</loaded>
If the preset is a radio it returns the stream state.
ρεύμα

Χαρακτηριστικά απόκρισης	Περιγραφή
υπηρεσία	όνομα υπηρεσίας της φορτωμένης προεπιλογής
καταχωρήσεις	τον αριθμό των κομματιών της προεπιλογής που έχει φορτωθεί

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

Αυτή η ενότητα περιγράφει εντολές για την περιήγηση και αναζήτηση περιεχομένου μουσικής υπηρεσίας.
7.1 Περιήγηση σε μουσικό περιεχόμενο
Περιγραφή
Πλοηγηθείτε στις διαθέσιμες πηγές μουσικής, καθώς και στις εισόδους και τις λίστες αναπαραγωγής.
Το βασικό στοιχείο για τις απαντήσεις είναι εκτός αν υπάρχει απόκριση σφάλματος. Τα περισσότερα αποτελέσματα είναι μια ακολουθία από Σε ορισμένες περιπτώσεις, το αποτέλεσμα είναι μια ακολουθία από , καθένα από τα οποία περιέχει μια ακολουθία αν Όλες οι τιμές παρέχονται χρησιμοποιώντας χαρακτηριστικά. Δεν υπάρχουν κόμβοι κειμένου.
Το αποτέλεσμα μιας κλήσης /Browse μπορεί να είναι ένα σφάλμα που περικλείεται σε ένα ριζικό στοιχείο. Οι λεπτομέρειες του σφάλματος παρέχονται σε ένα και μηδέν ή περισσότερο κόμβοι κειμένου.
Αίτηση
/Browse?key=key-value
/Browse?key=key-value&withContextMenuItems=1

Παράμετροι	Περιγραφή
κλειδί	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. Σημείωση: το κλειδί-τιμή πρέπει να είναι URL κωδικοποιημένα
μεΣτοιχείαΜενούΠλαισίου	Optional parameter. The value is always 1. Αυτή η παράμετρος χρησιμοποιείται για την εμφάνιση του ενσωματωμένου μενού περιβάλλοντος κατά την εμφάνιση των αποτελεσμάτων περιήγησης σε λίστες αναπαραγωγής, άλμπουμ, κομμάτια, σταθμούς, καλλιτέχνες κ.λπ.

Απάντηση
Απόκριση περιήγησης ανώτατου επιπέδου:
<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”
παιχνίδιURL=”/Παίξτε;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”/>

Χαρακτηριστικά απόκρισης	Περιγραφή
Ανατρέξτε στους πίνακες στοιχείων/χαρακτηριστικών παρακάτω

Example
ΣΗΜΕΙΩΜΑ: 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
Πραγματοποιεί περιήγηση τέταρτου επιπέδου, επιστρέφοντας το πρώτο σετ άλμπουμ Tidal Masters.
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.

Στοιχείο	Χαρακτηριστικό (και τιμές)		Περιγραφή
	Εικονίδιο υπηρεσίας		Το URI για ένα εικονίδιο για την υπηρεσία στην οποία γίνεται αναζήτηση τη δεδομένη στιγμή.
	όνομα υπηρεσίας		Το όνομα της υπηρεσίας που περιηγείται αυτήν τη στιγμή, για εμφάνιση από τον χρήστη.
	Κλειδί αναζήτησης		Μια τιμή που θα χρησιμοποιηθεί για μια παράμετρο-κλειδί σε ένα αίτημα /Browse για αναζήτηση στην τρέχουσα υπηρεσία (ή σε κάποιο βαθύτερο μέρος της ιεραρχίας). Επιπλέον, το αίτημα θα πρέπει να έχει την παράμετρο aq που περιέχει τον όρο αναζήτησης.
	επόμενο κλειδί		Μια τιμή που θα χρησιμοποιηθεί για μια παράμετρο κλειδιού σε ένα αίτημα /Browse για να ληφθεί η επόμενη σελίδα στοιχείων για το τρέχον viewΤο μέγεθος του τμήματος σελιδοποίησης δεν ελέγχεται από τον χρήστη του API και δεν πρέπει να γίνει καμία προσπάθεια ανάλυσης ή χειραγώγησης των παραμέτρων ερωτήματος αυτής της τιμής.
	γονικό κλειδί		Μια τιμή που θα χρησιμοποιηθεί για μια παράμετρο κλειδιού σε ένα αίτημα /Browse για πλοήγηση προς τα πάνω στην ιεραρχία, εάν η προεπιλεγμένη πλοήγηση προς τα πίσω πρέπει να παρακαμφθεί.
	τύπος	μενού	Ένας κόμβος πλοήγησης που θα μπορούσε ενδεχομένως να περιέχει ένα μείγμα οποιουδήποτε τύπου στοιχείου. Συνήθως θα περιέχει μόνο στοιχεία συνδέσμου ή ήχου.
		μενού περιβάλλοντος	Μια λίστα στοιχείων του καθορισμένου τύπου.
		καλλιτέχνες

Στοιχείο	Χαρακτηριστικό (και τιμές)		Περιγραφή
		composers
		άλμπουμ
		playlists
		κομμάτια
		είδη
		ενότητες	Alphabetic sections.
		είδη	Generic result list. Most commonly a mix of menu nodes (type=”link”) and radio items (type=”audio”).
		φακέλους	May contain subfolders, tracks and playlists entries.
<category>	κείμενο		Heading for the category.
	επόμενο κλειδί		A value to use for a key parameter to a /Browse request to get the next page of items for the category.
	γονικό κλειδί		Μια τιμή που θα χρησιμοποιηθεί για μια παράμετρο κλειδιού σε ένα αίτημα /Browse για πλοήγηση προς τα πάνω στην ιεραρχία, εάν η προεπιλεγμένη πλοήγηση προς τα πίσω πρέπει να παρακαμφθεί.
	τύπος	σύνδεσμος	A generic node in the browse hierarchy that leads to further nodes
		ήχου	A node that can be played directly
		artist	An item representing an artist

Στοιχείο	Χαρακτηριστικό (και τιμές)		Περιγραφή
		composer	Ένα αντικείμενο που αντιπροσωπεύει έναν συνθέτη
		άλμπουμ	Ένα στοιχείο που αντιπροσωπεύει ένα άλμπουμ ή παρόμοια συλλογή
		λίστα αναπαραγωγής	Ένα στοιχείο που αντιπροσωπεύει μια λίστα αναπαραγωγής ή παρόμοια συλλογή
		τροχιά	Ένα στοιχείο που αντιπροσωπεύει ένα μόνο κομμάτι
		κείμενο	Ένας κόμβος απλού κειμένου.
		τμήμα	Ένα αλφαβητικό τμήμα.
		ντοσιέ	Ένας φάκελος σε μια περιήγηση φακέλων.
	κείμενο		Κύρια ή πρώτη γραμμή περιγραφής στοιχείου
	text2		Δεύτερη γραμμή
	εικών		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.
	παιχνίδιURL		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.
	αυτόματη αναπαραγωγήURL		Ένα URI που μπορεί να κληθεί απευθείας για την προσθήκη ενός κομματιού στην ουρά και την αναπαραγωγή του, καθώς και την προσθήκη επόμενων κομματιών από το αντικείμενο που το περιέχει (όπως ένα άλμπουμ) στην αυτόματη συμπλήρωση.

Στοιχείο	Χαρακτηριστικό (και τιμές)	Περιγραφή
		section of the play queue.
	contextMenuKey	Μια τιμή που θα χρησιμοποιηθεί για μια παράμετρο-κλειδί σε ένα αίτημα /Browse για την απόκτηση ενός αποτελέσματος, το οποίο είναι ένα μενού περιβάλλοντος με ενέργειες που σχετίζονται με το στοιχείο.
	δράσηURL	Ένα URI που μπορεί να κληθεί απευθείας για την εκτέλεση της καθορισμένης ενέργειας.

Τα στοιχεία του μενού περιβάλλοντος μπορούν να έχουν τις ακόλουθες τιμές για το χαρακτηριστικό type.

Ιδιότης
		Περιγραφή
ευνοούμενος	-add	Προσθήκη του αντικειμένου ως αγαπημένου (ή ισοδύναμου)
	-delete	Remove the item from the user’s favourites
προσθέτω		Προσθήκη στην ουρά αναπαραγωγής
προσθέτω	-τώρα	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	-τώρα	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

διαγράφω

Διαγραφή του αντικειμένου (συνήθως μιας λίστας αναπαραγωγής). Θα πρέπει να ζητηθεί επιβεβαίωση από τον χρήστη

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
Κάνει ένα αίτημα Deezer => Τι είναι δημοφιλές => Δημοφιλή άλμπουμ με ενσωματωμένο μενού περιβάλλοντος.
Απάντηση
Η απάντηση περιέχει ενσωματωμένο για κάθε στοιχείο.

<item text=”Essonne History X” contextMenuKey=”Deezer:contextMenu/Album?albumid=693798541″
παιχνίδιURL=”/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”
δράσηURL=”/Add?service=Deezer&playnow=1&clear=0&shuffle=0&where=nextAlbum&albumid=693798541″/>
<item text=”Shuffle” type=”add-shuffle”
δράσηURL=”/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=”/Προσθήκη?υπηρεσίας=Deezer&playnow=-1&where=last&albumid=693798541″/>
</contextMenu>
</item>
…

Σημειώσεις και υποδείξεις εφαρμογής
Το χαρακτηριστικό τύπου ενός στοιχείου παρέχεται ως υπόδειξη που μπορεί να διευκολύνει διαφορετικές επιλογές εμφάνισης.
Η δυνατότητα περιήγησης στα περιεχόμενα ενός αντικειμένου υποδεικνύεται από την παρουσία ενός χαρακτηριστικού browseKey. Η δυνατότητα αναπαραγωγής ενός (ολόκληρου) αντικειμένου υποδεικνύεται από την παρουσία ενός χαρακτηριστικού αναπαραγωγής.URL (και πιθανώς και αυτόματη αναπαραγωγήURL) χαρακτηριστικό. Ένα στοιχείο μπορεί να έχει τόσο ένα χαρακτηριστικό browseKey όσο και ένα χαρακτηριστικό playURL ιδιότης.
Όταν παίζουν και οι δύοURL και αυτόματη αναπαραγωγήURL Υπάρχουν διαθέσιμα χαρακτηριστικά, το ποιο από τα δύο θα χρησιμοποιηθεί ως προεπιλεγμένη επιλογή αναπαραγωγής θα πρέπει να αποτελεί αντικείμενο προτίμησης χρήστη.
Οι τιμές URI θα είναι γενικά σχετικά URI με μια απόλυτη συνιστώσα διαδρομής. Τα σχετικά URI αναλύονται σε απόλυτα URI σύμφωνα με το RFC 3986.
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 Αναζήτηση μουσικού περιεχομένου
Περιγραφή
Εντολή για αναζήτηση μέσα σε μια υπηρεσία.
Αίτηση
/Browse?key=key-value&q=searchText

Παράμετροι	Περιγραφή
κλειδί	Τιμή που λαμβάνεται από μια τιμή χαρακτηριστικού "searchKey" από μια προηγούμενη απόκριση
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.

Απάντηση
<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.
Για π.χampδηλ., για να δείτε το αποτέλεσμα αναζήτησης των Άλμπουμ, στείλτε την εντολή:
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26expr%3Dmichael
Η απάντηση θα είναι η ίδια με την απάντηση στην κανονική εντολή /Browse.

Χαρακτηριστικά απόκρισης	Περιγραφή
Ανατρέξτε στους πίνακες στοιχείων/χαρακτηριστικών στην εντολή Αναζήτηση

Example
http://192.168.1.100:11000/Browse?key=Deezer:Search&q=michael Αναζήτηση για “michael” within the Deezer music service.

Player Grouping

Αυτή η ενότητα περιγράφει εντολές για την προεπιλεγμένη ομαδοποίηση και κατάργηση ομαδοποίησης παικτών. Το BluOS υποστηρίζει επίσης σταθερή ομαδοποίηση, η οποία δεν εμπίπτει στο πεδίο εφαρμογής αυτού του εγγράφου.
Το BluOS χρησιμοποιεί τους όρους κύριος παίκτης και δευτερεύων παίκτης. Ο κύριος παίκτης είναι ο κύριος παίκτης στην ομάδα. Ο κύριος παίκτης χρησιμοποιείται για την επιλογή της πηγής μουσικής. Υπάρχει μόνο ένας κύριος παίκτης. Ένας δευτερεύων παίκτης είναι συνδεδεμένος στον κύριο παίκτη. Μπορεί να υπάρχουν πολλοί δευτερεύοντες παίκτες.
Εάν ένας παίκτης είναι δευτερεύων παίκτης, τότε πολλά αιτήματα, εάν απευθύνονται στον δευτερεύοντα παίκτη, διαβιβάζονται εσωτερικά στον κύριο παίκτη. Αυτά περιλαμβάνουν τα αιτήματα /Status, Έλεγχο αναπαραγωγής, Διαχείριση ουράς αναπαραγωγής και Αναζήτηση και περιήγηση περιεχομένου.
8.1 Παίκτες Δεύτερης Ομάδας
Περιγραφή
Ομαδοποιήστε έναν δευτερεύοντα παίκτη με έναν κύριο παίκτη.
Αίτηση
/AddSlave?slave=secondaryPlayerIP&port=secondaryPlayerPort&group=ΌνομαΟμάδας

Παράμετροι	Περιγραφή
δούλος	Διεύθυνση IP του δευτερεύοντος παίκτη.
λιμάνι	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.
ομάδα	ΠΡΟΑΙΡΕΤΙΚΑ, όνομα της ομάδας. Εάν δεν παρέχεται, το BluOS θα δώσει ένα προεπιλεγμένο όνομα ομάδας.

Απάντηση

Χαρακτηριστικά απόκρισης	Περιγραφή
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 Προσθήκη πολλαπλών παικτών σε μια ομάδα
Περιγραφή
Ομαδοποιήστε δύο ή περισσότερους παίκτες σε έναν κύριο παίκτη.
Αίτηση
/AddSlave?slaves=secondaryPlayerIPs&ports=secondaryPlayerPorts

Παράμετροι	Περιγραφή
σκλάβους	Διευθύνσεις IP των δευτερευόντων παικτών που θα προστεθούν στον κύριο παίκτη. Οι διευθύνσεις IP διαχωρίζονται με κόμμα.
λιμάνια	Οι θύρες των δευτερευόντων παικτών που θα προστεθούν στον κύριο παίκτη. Οι αριθμοί θυρών διαχωρίζονται με κόμμα.

Απάντηση

Χαρακτηριστικά απόκρισης	Περιγραφή
λιμάνι	Η θύρα του δευτερεύοντος παίκτη που ομαδοποιήθηκε.
Id	Το αναγνωριστικό του δευτερεύοντος παίκτη που ομαδοποιήθηκε.

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 Αφαίρεση ενός παίκτη από μια ομάδα
Αφαίρεση ενός παίκτη από μια ομάδα. Εάν αφαιρείτε έναν δευτερεύοντα παίκτη από μια ομάδα, ο δευτερεύων παίκτης καταργείται από την ομάδα. Εάν αφαιρείτε τον κύριο παίκτη από μια ομάδα 3 ή περισσότερων παικτών, ο κύριος παίκτης καταργείται από την ομάδα και οι υπόλοιποι δευτερεύοντες παίκτες σχηματίζουν μια νέα ομάδα.
Αίτηση
/RemoveSlave?slave=secondaryPlayerIP&port=secondaryPlayerPort

Παράμετροι	Περιγραφή
δούλος	IP του παίκτη (δευτερεύουσα) που θα προστεθεί σε έναν άλλο παίκτη (κύρια).
λιμάνι	Θύρα του παίκτη (δευτερεύουσα) που θα προστεθεί σε έναν άλλο παίκτη (κύρια).

Απάντηση
<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″>

Χαρακτηριστικά απόκρισης	Περιγραφή
	Ανατρέξτε στο /SyncStatus για λεπτομέρειες.

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 Αφαίρεση πολλαπλών παικτών από μια ομάδα
Περιγραφή
Αφαιρέστε δύο ή περισσότερους παίκτες από μια ομάδα.
Αίτηση
/RemoveSlave?slaves=secondaryPlayerIPs&ports=secondaryPlayerPorts

Παράμετροι	Περιγραφή
σκλάβους	Διευθύνσεις IP των δευτερευόντων παικτών που θα αφαιρεθούν από τον κύριο παίκτη. Οι διευθύνσεις IP διαχωρίζονται με κόμμα.

Παράμετροι	Περιγραφή
λιμάνια	Οι θύρες των δευτερευόντων συσκευών αναπαραγωγής που θα αφαιρεθούν από τον κύριο παίκτη. Οι αριθμοί θυρών διαχωρίζονται με κόμμα.

Απάντηση
<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>

Χαρακτηριστικά απόκρισης	Περιγραφή
	Ανατρέξτε στο /SyncStatus για λεπτομέρειες.

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

Αυτή η ενότητα περιγράφει την εντολή για επανεκκίνηση του προγράμματος αναπαραγωγής μέσω λογισμικού.
9.1 Επανεκκίνηση ενός παίκτη
Περιγραφή
Μαλακή επανεκκίνηση ενός παίκτη.
Αίτηση
Εντολή POST /reboot με παράμετρο ναι (οποιαδήποτε τιμή)

Παράμετροι	Περιγραφή
Ναί	Οποιαδήποτε τιμή (π.χ. 1).

Απάντηση
Ενημερώθηκαν οι ρυθμίσεις
Επανεκκίνηση. Κλείστε αυτό το παράθυρο.
Παρακαλώ περιμένετε…
Example
curl -d ναι=1 192.168.1.100/επανεκκίνηση

Doorbell Chimes

Αυτή η ενότητα περιγράφει την εντολή για το κουδούνι της πόρτας του παίκτη.
10.1 Κουδούνια πόρτας
Περιγραφή
Ενεργοποιήστε τα κουδούνια της πόρτας.
Αίτηση
http://PLAYERIP:PORT/Doorbell?play=1

Παράμετροι	Περιγραφή
παιχνίδι	Παίξτε το κουδούνι της πόρτας (πάντα 1)

Απάντηση

Χαρακτηριστικά απόκρισης	Περιγραφή
καθιστώ ικανό	Indicate the chime
τόμος	Ένταση κουδουνίσματος
αρμονική κωδωνοκρουσία	Chime audio

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

Άμεση είσοδος

Αυτή η ενότητα περιγράφει εντολές για την άμεση επιλογή πηγής εισόδου.
11.1 Επιλογή ενεργής εισόδου
Περιγραφή
Επιλογή ενεργής πηγής εισόδου. Αυτή η εντολή λειτουργεί για τις ενεργές εισόδους που εμφανίζονται στην απάντηση στο /RadioBrowse?service=Capture. Η επιλογή εισόδων BluOS HUB υποστηρίζεται μόνο από αυτήν την εντολή.
Αίτηση
/Παιχνίδι;url=URL_αξία

Παράμετροι	Περιγραφή
url	Ο URL χαρακτηριστικό από την απάντηση στο /RadioBrowse?service=Capture

Απάντηση
ρεύμα

Χαρακτηριστικά απόκρισης	Περιγραφή
κατάσταση	Υποδεικνύει ότι η είσοδος αναπαράγεται

Example
Βήμα 1. Αποκτήστε το URL_τιμή για την παράμετρο url
Αίτημα: http://192.168.1.100:11000/RadioBrowse?service=Capture
Απάντηση:
<radiotime service=”Capture”>
<item playerName=”Tick
Σημειώστε” κείμενο=”Bluetooth” inputType=”bluetooth” id=”input2″ URL=”Λήψη%3Abluez%3Abluetooth” image=” /images/BluetoothIcon.png” type=”ήχος”/>
<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>
Βήμα 2. Αναπαραγωγή αναλογικής εισόδου στη συσκευή αναπαραγωγής
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
Σημείωμα: Make sure the sources are connected and not hidden.
11.2 Επιλογή εξωτερικής εισόδου
Περιγραφή
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.
Αίτημα (υλικολογισμικό BluOS νεότερο από την έκδοση v3.8.0 και παλαιότερο από την έκδοση v4.2.0)
/Play?inputIndex=ΚωδικόςΔείκτη

Παράμετροι	Περιγραφή
Δείκτης εισόδου	Ο δείκτης (ξεκινά με 1) των εισόδων που εμφανίζονται στην απάντηση στο /Settings?id=capture&shcemaVersion=32 (το 32 είναι η πιο πρόσφατη έκδοση σχήματος) με αριθμητική σειρά. Εξαιρείται το Bluetooth.

Απάντηση
ρεύμα

Χαρακτηριστικά απόκρισης	Περιγραφή
κατάσταση	Υποδεικνύει ότι η είσοδος αναπαράγεται

Example
Βήμα 1. Λήψη της τιμής inputIndex
Αίτημα: http://192.168.1.100:11000/Settings?id=capture&schemaVersion=32
Απάντηση:
<settings schemaVersion=”32″>
<menuGroup icon=”/images/settings/ic_capture.png” url=”/setting” id=”συλλογή”
displayName=”Customize sources”>
<setting icon=”/images/settings/ic_bluetooth.png” refresh=”true” url=”/λειτουργίες ήχου”
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.’
Βήμα 2. Αναπαραγωγή οπτικής εισόδου στη συσκευή αναπαραγωγής.
http://192.168.1.100:11000/Play?InputId=2
Αίτημα (υλικολογισμικό BluOS έκδοση 4.2.0 ή νεότερη έκδοση)
/Play?inputTypeIndex=$typeIndex

Παράμετροι

Περιγραφή

inputTypeIndex

typeIndex has the format of type-index of an input. Here is the list of input τύπος: 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) Ο δείκτης starts from 1. When there are more than one inputs of the same type, input 1 has δείκτης 1, input 2 has δείκτης 2, και ούτω καθεξής.

Απάντηση
ρεύμα

Χαρακτηριστικά απόκρισης	Περιγραφή
κατάσταση	Υποδεικνύει ότι η είσοδος αναπαράγεται

Example
Αίτημα: http://192.168.1.100:11000/Play?inputTypeIndex=spdif-2 για να επιλέξετε την Οπτική Είσοδο 2
Απάντηση: ρεύμα

Bluetooth

Αυτή η ενότητα περιγράφει την εντολή για την αλλαγή της λειτουργίας Bluetooth.
12.1 Αλλαγή λειτουργίας Bluetooth
Περιγραφή
Αλλαγή λειτουργίας Bluetooth: Χειροκίνητη, Αυτόματη, Επισκέπτης, Απενεργοποιημένη.
Αίτηση
/audiomodes?bluetoothAutoplay=value

Παράμετροι	Περιγραφή
Αυτόματη αναπαραγωγή bluetooth	Λειτουργία Bluetooth αξία 0 means Manual, 1 means Automatic, 2 means Guest, 3 means Disabled.

Καμία απάντηση
Example
Request: http://192.168.1.100:11000/audiomodes?bluetoothAutoplay=3 to disable bluetooth

Παράρτημα

13.1 Πρωτόκολλο Ανακάλυψης Υπηρεσίας Lenbrook
Εισαγωγή
Οι δημοφιλείς μέθοδοι ανακάλυψης, όπως το mDNS και το SSDP, χρησιμοποιούν και βασίζονται στην επικοινωνία πολλαπλής διανομής UDP. Τα περισσότερα από τα τρέχοντα προϊόντα της Lenbrook χρησιμοποιούν το mDNS για την ανακάλυψη. Δυστυχώς, έχουμε διαπιστώσει ότι ένας σημαντικός αριθμός πελατών μας έχει οικιακά δίκτυα όπου η κίνηση πολλαπλής διανομής δεν λειτουργεί σωστά και οι συσκευές μας δεν μπορούν να ανακαλυφθούν αξιόπιστα. Αυτό έχει οδηγήσει σε πολλές επιστροφές προϊόντων και παράπονα από τους διανομείς μας.
Για να αντιμετωπίσουμε αυτό το πρόβλημα, δημιουργήσαμε ένα προσαρμοσμένο πρωτόκολλο ανακάλυψης που ονομάζεται LSDP, το οποίο χρησιμοποιεί μετάδοση UDP. Οι αρχικές δοκιμές έδειξαν ότι αυτό είναι πολύ πιο αξιόπιστο από την ανακάλυψη που βασίζεται στο mDNS.
Πάνω από το πρωτόκολλοview
Ένας στόχος αυτού του πρωτοκόλλου είναι να είναι σχετικά απλό. Μπορεί να χρησιμοποιηθεί σε ενσωματωμένες συσκευές με πολύ περιορισμένη μνήμη.
Το πρωτόκολλο χρησιμοποιεί όλα τα πακέτα μετάδοσης UDP από και προς τη θύρα UDP 11430. Αυτή η θύρα έχει καταχωρηθεί στο IANA και έχει εκχωρηθεί στο Lenbrook για χρήση LSDP από τις 27 Μαρτίου 2014.
Σε σταθερή κατάσταση, κάθε κόμβος με μια υπηρεσία για διαφήμιση εκπέμπει ένα μήνυμα ανακοίνωσης περίπου κάθε λεπτό.
Κατά την εκκίνηση και όταν η λίστα υπηρεσιών ή οι παράμετροι δικτύου αλλάζουν, επτά πακέτα θα πρέπει να μεταδίδονται σε σύντομα διαστήματα για να επιτρέπουν την ταχύτερη διάδοση της αρχικής ανακάλυψης και των αλλαγών. Για κόμβους που διαφημίζουν υπηρεσίες, αυτά τα αρχικά επτά πακέτα θα πρέπει να περιλαμβάνουν ένα μήνυμα ανακοίνωσης. Για κόμβους που προσπαθούν να ανακαλύψουν υπηρεσίες, τα αρχικά επτά πακέτα θα πρέπει να περιλαμβάνουν ένα μήνυμα ερωτήματος. Για υπηρεσίες που δεν είναι πλέον διαθέσιμες, τα επτά πακέτα θα πρέπει να περιλαμβάνουν ένα μήνυμα διαγραφής.
Αυτά τα αρχικά πακέτα αποστέλλονται επτά φορές λόγω της αναξιόπιστης φύσης των πακέτων UDP. Στην απίθανη περίπτωση που και τα επτά πακέτα αποτύχουν, οι υπηρεσίες θα ανακαλυφθούν μετά από λίγο από τα περιοδικά μηνύματα ανακοίνωσης ενός λεπτού.
Εάν ένας κόμβος λάβει ένα μήνυμα ερωτήματος για μια κλάση υπηρεσίας που διαφημίζει, θα απαντήσει με ένα μήνυμα ανακοίνωσης μετά από μια σύντομη τυχαία χρονική καθυστέρηση και θα επαναφέρει το τρέχον χρονικό όριο ανακοίνωσης.
Η κεφαλίδα του πακέτου και όλα τα μπλοκ μηνυμάτων περιλαμβάνουν πεδία μήκους. Αυτό παρέχει επιπλέον ευελιξία και επιτρέπει την πραγματοποίηση αλλαγών συμβατών με παλαιότερες εκδόσεις στο μέλλον. Στο μέλλον θα μπορούσαν να προστεθούν επιπλέον πεδία ή τύποι μηνυμάτων, τα οποία οι παλαιότερες υλοποιήσεις θα μπορούσαν να παραλείψουν κατά την ανάλυση. Εάν αποφασίσουμε να κάνουμε μια αλλαγή μη συμβατή με παλαιότερες εκδόσεις, υπάρχει επίσης ένα πεδίο έκδοσης στην κεφαλίδα του πακέτου, το οποίο μπορεί να αυξηθεί.
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.
Λεπτομέρειες πρωτοκόλλου
Συγχρονισμός
All packets sent should be scheduled with random timing or delays to help avoid collisions.

• Χρόνος εκκίνησης πακέτων: 7 πακέτα τη χρονική στιγμή = [0, 1, 2, 3, 5, 7, 10s] + (0 έως 250ms τυχαία). Αυτοί είναι απόλυτοι χρόνοι, όχι καθυστερήσεις. Και τα 7 πακέτα θα πρέπει να αποσταλούν εντός περίπου 10 δευτερολέπτων.
• Main Announce Period: 57s + (0 to 6s random)
• Query Response Delay: (0 to 750ms random)

Αναγνωριστικό κόμβου
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.
Δομή Πακέτων
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 exampΈνα μήκος ενός byte μπορεί να έχει τιμές από 0 έως 255.
Κεφαλίδα πακέτου

Πεδίο	Bytes	Περιγραφή
Μήκος	1	Συνολικό μήκος κεφαλίδας συμπεριλαμβανομένου αυτού του πεδίου.
Μαγική Λέξη	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.
Έκδοση πρωτοκόλλου	1	Version of protocol. If future changes are made to the protocol that is backwards incompatible this version

Πεδίο	Bytes Περιγραφή
		will be changed. The current version is 1.

Query Message

Πεδίο
	Bytes	Περιγραφή
Μήκος	1	Total length of message including this field.
Τύπος μηνύματος	1	“Q” = 0x51: Standard query for broadcast response. “R” = 0x52: Query for unicast response.
Κόμης	1	Number of classes to query.
Τάξη 1	2	16 bit (2 byte) class identifier.
…		Repeat previous field for each additional class.

Announce Message
Announce Header

Πεδίο
	Bytes	Περιγραφή
Μήκος	1	Συνολικό μήκος μηνύματος, συμπεριλαμβανομένης της πλήρους κεφαλίδας ανακοίνωσης και των εγγραφών ανακοίνωσης.
Τύπος μηνύματος	1	«Α» = 0x41
Node ID Length	1	Μήκος πεδίου Αναγνωριστικού κόμβου.
Αναγνωριστικό κόμβου	Μεταβλητός	Μοναδικό αναγνωριστικό κόμβου του κόμβου που στέλνει την ανακοίνωση. Αυτή είναι συνήθως η διεύθυνση MAC μιας από τις διεπαφές των κόμβων.
Μήκος διεύθυνσης	1	Μήκος πεδίου διεύθυνσης. Για IPv4 αυτό θα πρέπει να είναι 4.

Πεδίο
	Bytes	Περιγραφή
Διεύθυνση	Μεταβλητός	IP address of node.
Κόμης	1	Number of announce records to follow.

Announce Record

Πεδίο	Bytes	Περιγραφή
Τάξη	2	16 bit (2 byte) class identifier.
Αριθμός μηνυμάτων κειμένου	1	Number of TXT records to follow. If zero the following fields are omitted.
Key 1 Length	1	Length of key name.
Κλειδί 1	Μεταβλητός	Key name.
Value 1 Length	1	Length of value text.
Αξία 1	Μεταβλητός	Value text.
…		Repeat previous 4 fields for each additional TXT record.

Διαγραφή μηνύματος

Πεδίο
	Bytes	Περιγραφή
Μήκος	1	Total length of message including this field.
Τύπος μηνύματος	1	“D” = 0x44
Node ID Length	1	Μήκος πεδίου Αναγνωριστικού κόμβου.
Αναγνωριστικό κόμβου	Μεταβλητός	Unique Node ID of node sending the message. This is usually the MAC address of one of the nodes

Πεδίο
	Bytes	Περιγραφή
		διεπαφές.
Κόμης	1	Number of classes to follow.
Τάξη 1	2	16 bit (2 byte) class identifier.
…		Repeat previous field for each additional class.

Class ID Assignments

Ταυτότητα τάξης	Περιγραφή	Ισοδύναμο mDNS
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	Μακρινός Web Εφαρμογή (AVR OSD) Web Σελίδα)	_remote-web-ui._tcp
0x0008	BluOS Hub	_mush._tcp
0xFFFF	All Classes – Can be used with Query Message.

Σημείωση 1:
The overall LSDP packet needs to be treated as binary data.
Σημείωση 2:
Εάν ένα μήνυμα ανακοίνωσης δεν μπορεί να περιέχει όλες τις πληροφορίες κόμβων (ειδικά το CI580), θα χωριστεί σε 2 ή περισσότερα μηνύματα ανακοίνωσης, με κάθε μήνυμα να περιέχει κεφαλίδα και εγγραφή και κάθε μήνυμα να περιέχει τις πληροφορίες ολόκληρου του/των κόμβου/ων.

API προσαρμοσμένης ενσωμάτωσης BluOS Έκδοση 1.7

Έγγραφα / Πόροι

API προσαρμοσμένης ενσωμάτωσης BluOS T 778 [pdf] Εγχειρίδιο χρήστη T 778, API Προσαρμοσμένης Ενσωμάτωσης T 778, T 778, API Προσαρμοσμένης Ενσωμάτωσης, API Ενσωμάτωσης, API

Αναφορές

• Εγχειρίδιο χρήστη