API tích hợp tùy chỉnh
API tích hợp tùy chỉnh T 778
Thông tin trong hướng dẫn này là tài sản của Lenbrook Industries.
Tài liệu này chỉ dành cho mục đích sử dụng chuyên nghiệp. Lenbrook Industries không chịu trách nhiệm về tính chính xác của giao thức. Giao thức được cung cấp "nguyên trạng", có thể có lỗi và không có bất kỳ bảo đảm nào, dù được nêu rõ hay ngụ ý.
Chính sách sử dụng API
Bằng việc truy cập API, bạn đồng ý với Chính sách Sử dụng API này (“Chính sách”) và các Điều khoản của chúng tôi. Chúng tôi cung cấp các API này để cho phép các công ty và cá nhân xây dựng và hưởng lợi từ Dịch vụ của chúng tôi bằng cách tạo phần mềm, dịch vụ hoặc mô-đun kết nối với nền tảng của chúng tôi hoặc truy cập dữ liệu trong nền tảng của chúng tôi thông qua API (“Tích hợp”). Chính sách này là và sẽ được coi là một phần của Điều khoản của chúng tôi.
Phần mềm được cung cấp "NGUYÊN TRẠNG", không có bất kỳ bảo đảm nào, dù rõ ràng hay ngụ ý, bao gồm nhưng không giới hạn ở các bảo đảm về khả năng bán được, tính phù hợp cho một mục đích cụ thể và không vi phạm. Trong mọi trường hợp, tác giả hoặc chủ sở hữu bản quyền sẽ không chịu trách nhiệm cho bất kỳ khiếu nại, thiệt hại hoặc trách nhiệm pháp lý nào khác, dù là trong hành động hợp đồng, hành vi vi phạm pháp luật hoặc các trường hợp khác, phát sinh từ, do hoặc liên quan đến phần mềm, việc sử dụng hoặc các giao dịch khác liên quan đến phần mềm.
Sử dụng được phép
Bạn không được sử dụng API để gửi thư rác hoặc thực hiện bất kỳ hành động nào vi phạm Chính sách Sử dụng Chấp nhận được và Điều khoản Sử dụng Tiêu chuẩn của chúng tôi. Bạn sẽ tuân thủ tất cả các luật hiện hành (bao gồm luật riêng tư và luật kiểm soát xuất khẩu của Hoa Kỳ, GPR và các quy định của Châu Âu, cũng như luật và quy định về trừng phạt kinh tế). Bạn sẽ tuân thủ tất cả các tài liệu chúng tôi cung cấp cho API. Bạn sẽ không cố gắng hack hoặc thay đổi cách thức hoạt động của Dịch vụ. Chúng tôi có thể giám sát việc bạn sử dụng API để đảm bảo tuân thủ các quy tắc này và chúng tôi có thể từ chối quyền truy cập API của bạn nếu bạn vi phạm Chính sách này.
Sự riêng tư
Của bạn Tích hợp phải hiển thị chính sách bảo mật cho người dùng, trong đó nêu chi tiết thông tin bạn sẽ thu thập từ họ khi họ sử dụng Tích hợp. Bạn sẽ chỉ truy cập dữ liệu của người dùng trong phạm vi được người dùng cho phép và được giải thích trong chính sách bảo mật của bạn. Bạn phải xóa ngay dữ liệu của người dùng nếu người dùng yêu cầu xóa hoặc chấm dứt tài khoản với bạn.
Bảo vệ
Bạn sẽ triển khai và duy trì các biện pháp bảo mật kỹ thuật và tổ chức phù hợp để bảo vệ và duy trì tính bảo mật, toàn vẹn và bí mật của dữ liệu. Các biện pháp bảo mật này sẽ ngăn chặn việc truy cập hoặc tiết lộ trái phép dữ liệu cá nhân hoặc dữ liệu bí mật mà bạn xử lý.
Quyền sở hữu
Chúng tôi sở hữu mọi quyền, quyền sở hữu và lợi ích liên quan đến Dịch vụ và API, bao gồm tất cả các quyền sở hữu trí tuệ, nhãn hiệu, mã và tính năng. Bạn sẽ không vi phạm, đảo ngược kỹ thuật hoặc sao chép mã, thiết kế hoặc nội dung của chúng tôi. Bạn sẽ không truy cập API của chúng tôi để cạnh tranh với Dịch vụ của chúng tôi. Bất kỳ quyền nào không được Chính sách này cấp rõ ràng đều bị giữ lại, vì vậy nếu bạn không thấy quyền đó ở đây, thì đó không phải là quyền mà chúng tôi cho phép bạn.
Sử dụng nhãn hiệu
Bạn không được phép sử dụng tên và nhãn hiệu của chúng tôi (bao gồm logo, thương hiệu và hình ảnh có bản quyền của chúng tôi) dưới bất kỳ hình thức nào. Bạn không được phép thay đổi hoặc xóa bất kỳ thông báo độc quyền nào trên nhãn hiệu của chúng tôi. Bạn không được phép sử dụng tên hoặc nhãn hiệu của chúng tôi trong tên hoặc logo Tích hợp của bạn, hoặc dưới bất kỳ hình thức nào ngụ ý sự xác nhận của chúng tôi.
Sử dụng thực tế các dấu hiệu
Những hướng dẫn này giải thích cách bạn phải thực tế sử dụng tên, nhãn hiệu và tài sản thương hiệu của chúng tôi mọi lúc. Việc sử dụng của bạn đồng nghĩa với việc bạn chấp nhận những hướng dẫn này, và bạn hiểu rằng việc vi phạm những hướng dẫn này sẽ dẫn đến việc bạn tự động bị chấm dứt quyền sử dụng tên, nhãn hiệu và tài sản thương hiệu của chúng tôi.
- Việc sử dụng tên, nhãn hiệu và tài sản thương hiệu của chúng tôi phải được ủy quyền rõ ràng bằng văn bản.
- Không được thay đổi, chỉnh sửa, bóp méo, sao chép hoặc bắt chước Tài sản Thương hiệu của chúng tôi dưới bất kỳ hình thức nào, bao gồm thay đổi màu sắc, xoay và/hoặc kéo giãn. Nói cách khác, Tài sản Thương hiệu của chúng tôi phải được giữ nguyên hình thức ban đầu.
- Không nên đặt tên, nhãn hiệu và tài sản thương hiệu của chúng tôi quá nổi bật so với tên và logo của bạn.
- Không hiển thị tên, nhãn hiệu và tài sản thương hiệu của chúng tôi bên cạnh hoặc trong bất kỳ hình thức tiếp thị cạnh tranh nào mà không có sự đồng ý rõ ràng của chúng tôi.
- Việc sử dụng của bạn không được gây hiểu lầm cho người tiêu dùng về việc chúng tôi tài trợ, liên kết hoặc xác nhận công ty hoặc sản phẩm hoặc dịch vụ của bạn.
- Tên, nhãn hiệu và tài sản thương hiệu của chúng tôi là tài sản độc quyền của chúng tôi. Mọi thiện chí phát sinh từ việc bạn sử dụng sẽ chỉ mang lại lợi ích cho chúng tôi. Bạn sẽ không thực hiện bất kỳ hành động nào trái với quyền hoặc quyền sở hữu của chúng tôi.
- Tên, nhãn hiệu và tài sản thương hiệu của chúng tôi phải được sử dụng một cách tôn trọng và không được sử dụng theo cách gây hại cho chúng tôi, sản phẩm hoặc dịch vụ của chúng tôi, hoặc theo cách mà theo quan điểm của chúng tôi, làm giảm hoặc gây tổn hại đến danh tiếng hoặc uy tín của chúng tôi đối với tên, nhãn hiệu và tài sản thương hiệu của chúng tôi. Nói cách khác, vui lòng không liên kết tài sản của chúng tôi với bất kỳ hoạt động bất hợp pháp hoặc vi phạm pháp luật nào, hoặc sử dụng chúng theo cách lừa dối hoặc gây hại.
Exampcác mục đích sử dụng được chấp nhận:
“[TÊN SẢN PHẨM CỦA BẠN] (tương thích với / hoạt động với BluOS)”
Exampsử dụng không thể chấp nhận được
“[TÊN SẢN PHẨM CỦA BẠN] – BluOS”
“BluOS – [TÊN SẢN PHẨM CỦA BẠN]”
“[TÊN SẢN PHẨM CỦA BẠN] – Được hỗ trợ bởi BluOS”
Tiếp thị và Thông cáo báo chí
Sau khi đơn đăng ký của bạn được chấp thuận, nó có thể được liệt kê trên web thuộc tính. Chúng tôi thường sẽ không đồng xuất bản thông cáo báo chí hoặc đóng góp vào việc đồng tiếp thị ứng dụng của bạn.
Trước khi bạn phân phối thông cáo báo chí về ứng dụng của mình, hãy đảm bảo bạn liên hệ với chúng tôi theo địa chỉ [EMAIL]. Nếu bạn sẽ đề cập đến BluOS, thì chúng tôi sẽ cần phải xem xét lại.view bản phát hành. Chúng tôi khuyên bạn nên gửi bản thông cáo báo chí cuối cùng càng sớm càng tốt.
Tuyên bố miễn trừ trách nhiệm
Trong phạm vi tối đa được pháp luật cho phép, chúng tôi cung cấp API theo nguyên trạng. Điều này có nghĩa là chúng tôi không đưa ra bất kỳ bảo đảm nào, dù rõ ràng hay ngụ ý, bao gồm nhưng không giới hạn ở khả năng bán được và tính phù hợp cho một mục đích cụ thể.
Cập nhật
Chúng tôi có thể cập nhật hoặc sửa đổi API và Chính sách này theo thời gian bằng cách đăng tải các thay đổi trên trang web này hoặc thông báo cho bạn qua email. Những thay đổi này có thể ảnh hưởng đến việc bạn sử dụng API hoặc cách Tích hợp của bạn tương tác với API. Nếu chúng tôi thực hiện bất kỳ thay đổi nào mà bạn không chấp nhận, bạn nên ngừng sử dụng API.
Bảo mật
Bạn có thể truy cập thông tin bí mật, độc quyền và không công khai dành riêng cho API (“Thông tin Bí mật”). Bạn chỉ được phép sử dụng thông tin này để xây dựng với API. Bạn sẽ không tiết lộ Thông tin Bí mật cho bất kỳ ai nếu không có sự đồng ý bằng văn bản của chúng tôi, và bạn sẽ bảo vệ Thông tin Bí mật khỏi việc sử dụng và tiết lộ trái phép giống như cách bạn bảo vệ thông tin bí mật của chính mình.
Bồi thường
Bạn sẽ bồi thường và bảo vệ chúng tôi và Nhóm của chúng tôi khỏi mọi tổn thất (bao gồm cả phí luật sư) phát sinh từ các khiếu nại của bên thứ ba liên quan đến việc bạn sử dụng API.
Phần còn lại
Chính sách này không tạo ra hoặc ngụ ý bất kỳ quan hệ đối tác, đại lý hoặc liên doanh nào. Chính sách này sẽ có hiệu lực trong suốt thời gian bạn sử dụng API hoặc cho đến khi chấm dứt theo Điều khoản của chúng tôi. Trong trường hợp có xung đột giữa Chính sách này và Điều khoản Sử dụng Tiêu chuẩn, Điều khoản Sử dụng Tiêu chuẩn sẽ được ưu tiên áp dụng.
©2025 CÔNG TY TNHH LENBROOK INDUSTRIES
633 Granite Court, Pickering, Ontario, Canada L1W 3K1
Mọi quyền được bảo lưu
Không được phép sao chép, lưu trữ hoặc truyền tải bất kỳ phần nào của ấn phẩm này dưới bất kỳ hình thức nào mà không có sự cho phép bằng văn bản của Lenbrook Industries Limited. Mặc dù chúng tôi đã nỗ lực hết sức để đảm bảo nội dung chính xác tại thời điểm xuất bản, các tính năng và thông số kỹ thuật có thể thay đổi mà không cần thông báo trước.
| Lịch sử sửa đổi | ||
| Phiên bản | Ngày | Sự miêu tả |
| 1.0 | 6/17/2019 | Bản phát hành đầu tiên |
| 1.2 | 01/12/2022 | Đã thêm khởi động lại nhẹ nhàng, tiếng chuông cửa, tăng/giảm âm lượng, di chuyển bài hát trong hàng đợi và lệnh nhập trực tiếp. Đã thêm ghi chú vào Phụ lục LSDP. |
| 1.4 | 04/26/2022 | Đã thêm lệnh tắt tiếng; sửa đổi lệnh nhập trực tiếp cho HUB; cập nhật lệnh Phát để phát âm thanh tùy chỉnh được truyền phát. |
| 1.5 | 07/18/2022 | Đã thêm lệnh Bluetooth; Đã cập nhật LSDP để thêm lớp 5 đến 8; Đã thêm “Sử dụng thực tế các dấu hiệu” vào Chính sách sử dụng API. |
| 1.6 | 03/13/2024 | Đã thêm ghi chú cho /Trạng thái cho người chơi được nhóm trong phần 2; Đã thêm /Play?seek=seconds is=trackid trong phần 4.1; |
| 1.7 | 04/09/2025 | Đã cập nhật phần 8.3ample; Đã thêm yêu cầu duyệt menu ngữ cảnh nội tuyếnample trong phần 7.1; Đã thêm lệnh lựa chọn đầu vào trực tiếp mới trong phần 11.2; Đã cập nhật phần 6.1 để thêm thuộc tính "image" cho các cài đặt trước; Đã thêm bình luận "followRedirects=1" cho tất cả các thuộc tính hình ảnh; Đã cập nhật phần giải thích về thuộc tính playURL và thêm vào ngay trong phần 7.1 |
Giới thiệu
BluOS™ là hệ điều hành và phần mềm quản lý nhạc tiên tiến cho phép bạn truy cập và phát nhạc lossless lên đến 24-bit/192kHz đến mọi phòng thông qua mạng gia đình. BluOS có thể được tìm thấy trong các sản phẩm của Bluesound, NAD Electronics, DALI Loudspeakers và nhiều thương hiệu khác.
Tài liệu này được tạo ra để hỗ trợ các nhà phát triển và nhà tích hợp hệ thống đang làm việc trên thị trường tích hợp tùy chỉnh (CI). Tài liệu này bao gồm một tập hợp con các yêu cầu API được ghi lại trong Giao thức Kiểm soát API BluOS đầy đủ.
Tất cả các yêu cầu được mô tả trong tài liệu này đều được gửi dưới dạng yêu cầu HTTP GET. Các tham số là một tiêu chuẩn URL cặp tên/giá trị được mã hóa. Trình phát BluOS nhận các lệnh này và sau đó phản hồi bằng dữ liệu XML được mã hóa UTF-8.
Tất cả các yêu cầu đều ở dạng http:// : / Ở đâu:
- player_ip là địa chỉ IP của trình phát BluOS (ví dụ: 192.168.1.100)
- Cổng là cổng TC được sử dụng cho giao tiếp. Cổng 11000 được sử dụng cho tất cả các đầu phát BluOS, ngoại trừ CI580. CI580 có bốn nút streamer trong một khung máy, trong đó nút 1 sử dụng cổng 11000, nút 2 sử dụng cổng 11010, nút 3 sử dụng cổng 11020 và nút 4 sử dụng cổng 11030. Cổng thực tế cần sử dụng sẽ được phát hiện bằng cách sử dụng giao thức MDNS với các dịch vụ musc.tcp và musp.tcp.
- yêu cầu là lệnh hoặc truy vấn BluOS thực tế (ví dụ: Phát)
Ghi chú: Tài liệu này sẽ sử dụng http://192.168.1.100:11000 như IP của người chơi và cổng trong tất cả các exampđồng nghiệp.
Truy vấn trạng thái
Truy vấn trạng thái được sử dụng để truy vấn trình phát BluOS.
BluOS cung cấp hai cơ chế để thực hiện truy vấn trạng thái: thăm dò thông thường (regular polling) và thăm dò dài (long polling). Thăm dò thông thường trả về kết quả truy vấn ngay lập tức. Thăm dò dài duy trì kết nối trong một khoảng thời gian xác định và chỉ trả về kết quả truy vấn khi thông tin thay đổi hoặc hết thời gian chờ. Thăm dò dài có thể giảm đáng kể số lượng lệnh gọi đến người chơi.
Khi không sử dụng long-polling, máy khách nên giới hạn tốc độ polling ở mức tối đa một yêu cầu mỗi 30 giây. Khi sử dụng long-polling, máy khách không được thực hiện hai yêu cầu liên tiếp cho cùng một tài nguyên cách nhau chưa đầy một giây, ngay cả khi yêu cầu đầu tiên được trả về trong vòng chưa đầy một giây.
Các yêu cầu thăm dò dài có hai tham số: thời gian chờ và etag. timeout là thời lượng của yêu cầu thăm dò dài và etag được lấy từ phản hồi trước đó (thuộc tính trong phần tử gốc của phản hồi).
Nhìn chung, chỉ cần kích hoạt long-poll cho một trong hai tùy chọn /Status hoặc /SyncStatus. Phản hồi /Status bao gồm một phần tử ( ) cho biết /SyncStatus có thay đổi hay không. Nên thăm dò /SyncStatus nếu chỉ cần tên, âm lượng và trạng thái nhóm của trình phát. Nên thăm dò /Status nếu cần trạng thái phát lại hiện tại.
Khi người chơi được nhóm lại, người chơi chính là người chơi chính trong nhóm. Các người chơi phụ được kết nối với người chơi chính. /Phản hồi trạng thái của người chơi phụ là bản sao của người chơi chính. /SyncStatus sau đó cần được kiểm tra dài hạn để theo dõi âm lượng của từng người chơi phụ.
2.1 Trạng thái phát lại
Sự miêu tả
Điểm cuối /Status truy vấn thông tin về ổ đĩa và phát lại. Truy vấn này trả về nhiều thuộc tính phản hồi,
một số trong đó không áp dụng cho tài liệu này. Những phản hồi không có tài liệu nên được bỏ qua.
Lời yêu cầu
/Trạng thái?thời gian chờ=giây&etag=etag-giá trị
| Các tham số | Sự miêu tả |
| thời gian chờ | Tham số tùy chọn được sử dụng với chế độ thăm dò dài. Khoảng thời gian thăm dò được khuyến nghị là 100 giây và nên giới hạn ở tốc độ khoảng 60 giây và không bao giờ nhanh hơn 10 giây. |
| etag | Tham số tùy chọn được sử dụng với thăm dò dài. Đây là etag thuộc tính từ |
| Các tham số | Sự miêu tả |
| phản hồi cuộc gọi trạng thái trước đó. |
Phản ứng
<status etag=”4e266c9fbfba6d13d1a4d6ff4bd2e1e6″>
÷ (Cao cấp)
Ed Sheeran
ĐÚNG VẬY
1
159
Deezer:142986206
/Tác phẩm nghệ thuật?dịch vụ=Deezer&songid=Deezer%3A142986206
0
187
1
Hoàn hảo
1054
0
320000
2
Deezer
/Nguồn/hình ảnh/DeezerIcon.png
0
8
19
tạm dừng
MP3 320 kb/giây
5
Hoàn hảo
Ed Sheeran
÷ (Cao cấp)
263
4
35
GHI CHÚ: Không phải tất cả các thuộc tính phản hồi đều được liệt kê trong bảng sau. Các yếu tố khác có thể xuất hiện và nên bỏ qua.
| Thuộc tính phản hồi | Sự miêu tả |
| etag | Thuộc tính của phần tử gốc phản hồi. Giá trị mờ được sử dụng với thăm dò dài để phát hiện các thay đổi phản hồi. Nếu giá trị không thay đổi kể từ phản hồi trước đó thì phản hồi được đảm bảo là không thay đổi (xem thêm các mục bên dưới) |
| giây báo động còn lại | Nếu phát lại là kết quả của báo thức thì đây là số giây trước khi báo thức dừng lại. |
| hoạt động | Xem phần Hành động cho Đài phát thanh trực tuyến để biết mô tả. |
| album | Tên album của bài hát hiện đang phát. Xem thêm thuộc tính title1. |
| nghệ sĩ | Tên nghệ sĩ của bản nhạc hiện đang phát. Xem thêm thuộc tính title1. |
| ắc quy | Hiển thị nếu máy nghe nhạc có bộ pin. Bao gồm các thuộc tính: · mức – trạng thái sạc, phần trăm · đang sạc – 1 nếu hiện đang sạc · biểu tượng - URL của hình ảnh người chơi cho biết trạng thái sạc hiện tại |
|
có thểDi chuyểnPhát lại |
Đúng nếu có thể di chuyển nội dung đang phát hoặc đang tạm dừng sang trình phát khác. |
|
canSeek |
Nếu là 1 thì có thể duyệt qua bản nhạc hiện tại, trong phạm vi 0..totlen, bằng cách sử dụng tham số seek tới /Play. Ví dụample: /Play?seek=34. |
| db | Mức âm lượng tính bằng dB. |
| Tên nhóm | Tên nhóm. Người chơi phải là người chơi chính trong nhóm. |
| nhóm Khối lượng | Mức âm lượng của nhóm. Người chơi phải là người chơi chính trong nhóm. |
| hình ảnh | URL của hình ảnh liên quan đến âm thanh hiện tại (album, đài phát thanh, đầu vào, v.v.). Nếu |
| Thuộc tính phản hồi | Sự miêu tả |
| cái URL bắt đầu bằng /Artwork có thể dẫn đến chuyển hướng. Thêm tham số/khóa theo dõi chuyển hướng = 1 khi lấy lại hình ảnh có thể tránh được việc chuyển hướng. | |
| tắt tiếng | Trạng thái tắt tiếng. Đặt thành 1 nếu âm lượng bị tắt tiếng. |
| muteDb | nếu trình phát bị tắt tiếng thì mục này sẽ chứa âm lượng không tắt tiếng tính bằng dB. |
| tắt tiếng | Nếu ther bị tắt tiếng, thì mức âm lượng này sẽ được hiển thị. Giá trị từ 0 đến 100. |
| tên | Tiêu đề của bản nhạc đang phát. Xem thêm thuộc tính title1. |
| thông báourl | URL để nhận thông báo bật lên. |
| id | ID hàng đợi phát duy nhất. Nó khớp với thuộc tính id của phản hồi /Playlist. Nếu hàng đợi phát thay đổi, số này cũng sẽ thay đổi. |
| thoát khỏi | ID cài đặt trước duy nhất. Nó khớp với thuộc tính prid trong phản hồi /Presets. Nếu một cài đặt trước bị thay đổi, số này sẽ thay đổi, cho biết bất kỳ phản hồi nào được lưu trong bộ nhớ đệm cho /Presets đều phải được xóa. |
| chất lượng | Chất lượng âm thanh nguồn phát: · cd – âm thanh không mất dữ liệu ở chất lượng CD · hd – âm thanh không mất dữ liệu với độ phân giải cao hơn chất lượng CD hoặc samptốc độ 88200 giâyampít hơn/nhiều hơn · dolbyAudio – DolbyDigital hoặc AC3 · mqa – giải mã âm thanh MQA hợp lệ · mqaAuthored – âm thanh được giải mã MQA-Authored hợp lệ Giá trị số là tốc độ bit gần đúng của chất lượng nguồn âm thanh nén file. |
|
lặp lại |
0, 1 hoặc 2. 0 có nghĩa là lặp lại hàng đợi phát, 1 có nghĩa là lặp lại một bản nhạc và 2 có nghĩa là lặp lại tắt |
| giây | Số giây mà bản nhạc âm thanh hiện tại đã được phát. Giá trị này không được sử dụng trong phép tính etag và tiến trình sẽ không tự nó tạo ra kết quả trả về từ một lệnh gọi thăm dò dài. Máy khách được yêu cầu tăng vị trí phát lại, khi trạng thái là phát hoặc phát trực tuyến, dựa trên khoảng thời gian kể từ phản hồi. |
| dịch vụ | ID dịch vụ của âm thanh hiện tại. Đây không phải là giá trị để hiển thị trong giao diện người dùng, vì |
| Thuộc tính phản hồi | Sự miêu tả |
| chuỗi thực tế có thể khác với tên dịch vụ chính thức. | |
| Biểu tượng dịch vụ | URL của biểu tượng dịch vụ hiện tại. |
| xáo trộn | 0 hoặc 1. 0 nghĩa là tắt xáo trộn và 1 nghĩa là bật xáo trộn. |
| ngủ | Số phút còn lại trước khi bộ hẹn giờ ngủ được kích hoạt. |
| bài hát | Vị trí của bản nhạc hiện tại trong hàng đợi phát. Xem thêm luồngUrl. |
| tình trạng | Trạng thái hiện tại của người chơi. Có thể là đang phát, tạm dừng, dừng, phát trực tuyến, kết nối, v.v. /Play có thể được sử dụng để tiếp tục khi ở trạng thái tạm dừng nhưng không thể sử dụng khi ở trạng thái dừng. play và stream nên được coi là có cùng ý nghĩa. Cũng xem streamUrl. |
|
trạm hình ảnh |
URL Đối với hình ảnh của một đài phát thanh, nếu âm thanh hiện tại là một đài phát thanh, ví dụ: đài phát thanh Deezer. Nó có thể giống với hình ảnh. |
| định dạng luồng | Định dạng của âm thanh. |
| suốiUrl | Sự hiện diện của phần tử này nên được coi là một cờ và nội dung của nó là một giá trị mờ. Nếu có, nó biểu thị: · hàng đợi phát không phải là nguồn âm thanh hiện tại (bài hát không liên quan) · xáo trộn và lặp lại không liên quan và nên được xóa khỏi bất kỳ giao diện người dùng nào nếu có thể · tiếp theo và trước đó không khả dụng (nhưng cũng xem các hành động) |
| syncStat | ID duy nhất để chỉ ra bất kỳ thay đổi nào trong phản hồi /SyncStatus. ID này khớp với thuộc tính syncStat của phản hồi /SyncStatus. ID này thay đổi bất cứ khi nào có thay đổi trong Trạng thái Đồng bộ. |
| tiêu đề1 | Dòng thông tin đầu tiên mô tả âm thanh hiện tại. title1, title2 và title3 PHẢI được sử dụng làm văn bản của bất kỳ giao diện người dùng nào hiển thị ba dòng siêu dữ liệu đang phát. Không sử dụng các giá trị như album, nghệ sĩ và tên. |
| tiêu đề2 | Dòng thông tin thứ hai mô tả âm thanh hiện tại. |
| tiêu đề3 | Dòng thông tin thứ ba mô tả âm thanh hiện tại. |
| totlen | Tổng chiều dài của tuyến đường hiện tại, tính bằng giây. |
| tiêu đề hai dòng 1 | Dòng đầu tiên trong hai dòng mô tả âm thanh hiện tại. twoline_title1 & twoline_title2, nếu có, PHẢI được sử dụng làm văn bản của bất kỳ giao diện người dùng nào hiển thị hai |
| Thuộc tính phản hồi | Sự miêu tả |
| các dòng siêu dữ liệu đang phát. | |
| tiêu đề hai dòng 2 | Dòng thứ hai trong hai dòng mô tả âm thanh hiện tại. |
| âm lượng | Mức âm lượng của người chơi tính theo phần trămtage; -1 nghĩa là âm lượng của trình phát được cố định. |
| giây | Số giây mà bản âm thanh hiện tại đã được phát. |
Example
http://192.168.1.100:11000/Status
Nhận trạng thái phát lại của trình phát.
http://192.168.1.100:11000/Status?timeout=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Lấy trạng thái phát lại của trình phát bằng phương pháp thăm dò dài. Kết quả chỉ được trả về trước thời gian chờ 100 giây nếu trạng thái của trình phát đã thay đổi. Nếu không, kết quả sẽ được trả về sau 100 giây.
2.2 Trạng thái đồng bộ hóa nhóm và người chơi
Sự miêu tả
Truy vấn SyncStatus trả về thông tin người chơi và thông tin nhóm người chơi. Truy vấn này trả về nhiều thuộc tính phản hồi, một số trong đó không áp dụng cho tài liệu này. Các phản hồi không có tài liệu nên được bỏ qua.
Lời yêu cầu
/SyncStatus?timeout=giây&etag=etag-giá trị
| Các tham số | Sự miêu tả |
| thời gian chờ | Tham số tùy chọn được sử dụng với chế độ thăm dò dài. Đây là khoảng thời gian thăm dò tính bằng giây. Khoảng thời gian thăm dò được khuyến nghị là 180 giây. |
| etag | Tham số tùy chọn được sử dụng với thăm dò dài. Đây là etag thuộc tính từ phản hồi lệnh gọi /SyncStatus trước đó. |
Phản ứng
<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″> 192.168.1.100
…..
LƯU Ý: không phải tất cả các thuộc tính phản hồi đều được liệt kê trong bảng sau. Các yếu tố khác có thể xuất hiện và nên bỏ qua.
| Thuộc tính phản hồi | Sự miêu tả |
| ắc quy | Hiển thị nếu máy nghe nhạc có bộ pin. Bao gồm các thuộc tính: · mức – trạng thái sạc, phần trăm · đang sạc – 1 nếu hiện đang sạc · biểu tượng - URL của hình ảnh người chơi cho biết trạng thái sạc hiện tại |
| thương hiệu | Tên thương hiệu của người chơi. |
| db | Mức âm lượng tính bằng dB. |
| etag | Tag của phản hồi /SyncStatus, được sử dụng để thăm dò dài. |
| nhóm | Tên nhóm. |
| biểu tượng | URL có chứa hình ảnh biểu tượng người chơi. |
| id | Địa chỉ IP và cổng của người chơi. |
| đã khởi tạo | True nghĩa là trình phát đã được thiết lập, false nghĩa là trình phát cần được thiết lập. Trình phát phải được thiết lập bằng ứng dụng BluOS Controller. |
| máy Mac | ID duy nhất của người chơi cho giao diện mạng. Có thể là địa chỉ MAC. |
| bậc thầy | Địa chỉ IP của người chơi chính. Chỉ hiển thị nếu người chơi là người chơi phụ trong nhóm. Thuộc tính: · port – số cổng. · kết nối lại – đúng nếu cố gắng kết nối lại với người chơi chính |
| người mẫu | ID mô hình người chơi. |
| tên người mẫu | Tên mô hình người chơi. |
| tắt tiếng | Đặt thành 1 nếu âm lượng bị tắt tiếng. |
| muteDb | Nếu trình phát bị tắt tiếng thì đây là mức âm lượng không tắt tiếng tính bằng dB. |
| Thuộc tính phản hồi | Sự miêu tả |
| tắt tiếng | Nếu trình phát bị tắt tiếng, thì đây là mức âm lượng không tắt tiếng (0..100). |
| tên | Tên người chơi. |
| schemaVersion | Phiên bản lược đồ phần mềm. |
| nô lệ | Địa chỉ IP của người chơi phụ. Chỉ hiển thị nếu người chơi là người chơi chính của một nhóm. Có thể có nhiều người chơi phụ. Thuộc tính: · id – địa chỉ IP · cổng – số cổng |
|
syncStat |
ID của trạng thái đồng bộ. ID này sẽ thay đổi bất cứ khi nào bất kỳ mục nào trong phản hồi /SyncStatus thay đổi. Khớp với phần tử trong phản hồi /Trạng thái. |
| âm lượng | Mức âm lượng trên thang điểm 0..100. -1 nghĩa là âm lượng cố định. |
| vùng | Tên của nhóm cố định. |
| zoneMaster | Nếu người chơi là người chơi chính trong một nhóm cố định, tùy chọn này sẽ được đặt thành đúng. |
| zoneSlave | Nếu người chơi là người chơi thứ cấp trong một nhóm cố định, tùy chọn này sẽ được đặt thành đúng. |
Example
http://192.168.1.100:11000/SyncStatus
Lấy trạng thái của người chơi và nhóm người chơi.
http://192.168.1.100:11000/SyncStatus?timeout=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
Lấy trạng thái người chơi và nhóm của người chơi bằng phương pháp thăm dò dài. Kết quả chỉ được trả về trước thời gian chờ 100 giây nếu trạng thái của người chơi đã thay đổi. Nếu không, kết quả sẽ được trả về sau 100 giây.
Kiểm soát âm lượng
Điều chỉnh mức âm lượng của trình phát. Cũng được dùng để tắt tiếng trình phát.
3.1 Thiết lập âm lượng
Sự miêu tả
Yêu cầu này truy vấn hoặc thiết lập âm lượng của trình phát.
Tất cả các biến thể lệnh, dù sử dụng mức 0..100, tham số dB tuyệt đối hay dB tương đối, đều bị giới hạn ở các giá trị tạo ra mức âm lượng nằm trong phạm vi âm lượng khả dụng đã cấu hình, thường là -80..0. Có thể điều chỉnh phạm vi âm lượng bằng ứng dụng BluOS Controller, trên trang Cài đặt -> Trình phát -> Âm thanh.
Truy vấn hỗ trợ thăm dò dài (không minh họa bên dưới).
Lời yêu cầu
/Âm lượng
/Âm lượng?cấp độ=cấp độ&tell_slaves=bật_tắt
/Âm lượng?tắt tiếng=bật_tắt&tắt_lời_nô_lệ=bật_tắt
/Âm lượng?abs_db=db&tell_slaves=bật_tắt
/Volume?db=delta-db&tell_slaves=on_off
| Các tham số | Sự miêu tả |
| mức độ | Thiết lập mức âm lượng tuyệt đối của trình phát. Đây là một số nguyên từ 0 đến 100. |
| tell_slaves | Áp dụng cho người chơi trong nhóm. Nếu đặt thành 0, chỉ người chơi hiện tại được chọn mới thay đổi âm lượng. Nếu đặt thành 1, tất cả người chơi trong nhóm sẽ thay đổi âm lượng. |
| tắt tiếng | Nếu đặt thành 0, trình phát sẽ bị tắt tiếng. Nếu đặt thành 1, trình phát sẽ được bật tiếng. |
| abs_db | Đặt âm lượng bằng thang dB. |
| db | Thực hiện thay đổi âm lượng tương đối bằng thang âm lượng dB. db có thể là số dương hoặc số âm. |
Phản ứng
<volume db=”-49.9″ mute=”0″ offsetDb=”0″ etag=”6213593a6132887e23fe0476b9ab2cba”>15</volume>
| Thuộc tính phản hồi | Sự miêu tả |
| Thuộc tính phản hồi | Sự miêu tả |
| db | Mức âm lượng tính bằng dB. |
| tắt tiếng | 1 nếu người chơi bị tắt tiếng, 0 nếu người chơi được bật tiếng. |
| muteDb | Nếu trình phát bị tắt tiếng thì đây là mức âm lượng không tắt tiếng tính bằng dB. |
| tắt tiếng | Nếu trình phát bị tắt tiếng, thì đây là mức âm lượng không tắt tiếng (0..100). |
| âm lượng | Mức âm lượng hiện tại: 0..100 hoặc -1 đối với âm lượng cố định. |
Example
http://192.168.1.100:11000/Volume?level=15
Đặt mức âm lượng của trình phát ở mức 15 (trên 100).
http://192.168.1.100:11000/Volume? tell_slaves=1&db=2
Tăng âm lượng của trình phát chính 192.168.1.100 và tất cả các trình phát phụ trong nhóm đó thêm 2 dB.
http://192.168.1.100:11000/Volume?mute=1
Tắt tiếng người chơi.
3.2 Tăng âm lượng
Sự miêu tả
Yêu cầu này làm tăng âm lượng lên một mức dB nhất định (giá trị điển hình là 2dB).
Lời yêu cầu
/Volume?db=db_value
| Các tham số | Sự miêu tả |
| db | Các bước tăng âm lượng tính bằng dB (giá trị điển hình là 2dB) |
Phản ứng
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>
| Thuộc tính phản hồi | Sự miêu tả |
| db | Mức âm lượng tính bằng dB. |
| tắt tiếng | 1 nếu người chơi bị tắt tiếng, 0 nếu người chơi không bị tắt tiếng |
| Thuộc tính phản hồi | Sự miêu tả |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?db=2
Tăng âm lượng thêm 2dB.
3.3 Giảm âm lượng
Sự miêu tả
Yêu cầu này làm giảm âm lượng xuống một mức dB nhất định (giá trị điển hình là -2dB).
Lời yêu cầu
/Volume?db=-db_value
| Các tham số | Sự miêu tả |
| db | Các bước tăng âm lượng tính bằng dB (giá trị điển hình -2dB) |
Phản ứng
<volume db=”-25″ mute=”0″ offsetDb=”6″ etag=”a071a168fac1c879b1de291720c8a4b8″>27</volume>
| Thuộc tính phản hồi | Sự miêu tả |
| db | Mức âm lượng tính bằng dB |
| tắt tiếng | 1 nếu người chơi bị tắt tiếng, 0 nếu người chơi không bị tắt tiếng |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?db=-2
Giảm âm lượng đi 2dB.
3.4 Tắt tiếng
Sự miêu tả
Lời yêu cầu
/Âm lượng?tắt tiếng=1
| Các tham số | Sự miêu tả |
| tắt tiếng | Đặt thành 1 để tắt tiếng người chơi |
Phản ứng
<volume muteDb=”-43.1″ db=”100″
muteVolume=”11″
tắt tiếng = "1"
offsetDb=”0″
etag=”2105bed56563d9da46942a696cfadd63″>0</volume
>
| Thuộc tính phản hồi | Sự miêu tả |
| muteDb | Mức âm lượng tính bằng dB trước khi tắt tiếng |
| db | Mức âm lượng tính bằng dB |
| tắt tiếng | Mức âm lượng tính theo phần trăm trước khi tắt tiếng |
| tắt tiếng | 1 có nghĩa là người chơi bị tắt tiếng |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?mute=1
3.5 Tắt tiếng
Sự miêu tả
Yêu cầu này sẽ bật tiếng cho người chơi.
Lời yêu cầu
/Âm lượng?tắt tiếng=0
| Các tham số | Sự miêu tả |
| tắt tiếng | Đặt thành 0 để bỏ tắt tiếng người chơi |
Phản ứng
<volume db=”-43.1″ mute=”0″ offsetDb=”0″ etag=”e72d53db17baa526ebb5ee9c26060b1f”>11</volume>
| Thuộc tính phản hồi | Sự miêu tả |
| db | Mức âm lượng tính bằng dB |
| tắt tiếng | 0 có nghĩa là người chơi không bị tắt tiếng |
| offsetDb | |
| etag |
Example
http://192.168.1.100:11000/Volume?mute=0
Kiểm soát phát lại
Các lệnh này được sử dụng để điều khiển phát lại cơ bản. Các lệnh bao gồm phát, tạm dừng, dừng, bỏ qua, quay lại, xáo trộn và lặp lại.
4.1 Chơi
Sự miêu tả
Bắt đầu phát lại nguồn âm thanh hiện tại. Các tham số tùy chọn cho phép chuyển đến các bản âm thanh và chọn đầu vào trước khi bắt đầu phát lại âm thanh.
Lời yêu cầu
/Chơi
/Play?seek=giây
/Play?seek=giây&id=trackid
/Chơi?url=encodedStreamURL
| Các tham số | Sự miêu tả |
| tìm kiếm | Nhảy đến vị trí đã chỉ định trong track hiện tại. Chỉ hợp lệ nếu phản hồi /Status bao gồm . Không thể sử dụng với các tham số inputType và index. |
| encodedStreamURL | URL của âm thanh tùy chỉnh được phát trực tuyến. Nó phải là URL được mã hóa. |
Phản ứng
chơi
suối
| Thuộc tính phản hồi | Sự miêu tả |
|
tình trạng |
Trạng thái sau khi thực hiện lệnh. Xem thuộc tính trạng thái phản hồi /Status để biết thêm chi tiết. |
Example
http://192.168.1.100:11000/Play
Bắt đầu phát lại âm thanh của bản nhạc hiện tại.
http://192.168.1.100:11000/Play?seek=55
Bắt đầu phát lại âm thanh ở giây thứ 55 của bản nhạc hiện tại.
http://192.168.1.100:11000/Play?seek=55&id=4
Bắt đầu phát âm thanh ở giây thứ 55 của bản nhạc số 5 trong hàng đợi.
192.168.1.125:11000/Chơi?url=https%3A%2F%2Fwww%2Esoundhelix%2Ecom%2Fexamples%2Fmp3%
2FSoundHelix-Bài hát-1%2Emp3
Bắt đầu phát lại âm thanh của tệp âm thanh mp3 trực tuyến.
4.2 Tạm dừng
Sự miêu tả
Tạm dừng âm thanh đang phát.
Nếu báo thức đang phát và có thời gian chờ, thì thời gian chờ báo thức sẽ bị hủy.
Lời yêu cầu
/Tạm dừng
/Tạm dừng?chuyển đổi=1
| Các tham số | Sự miêu tả |
| chuyển đổi | Nếu đặt thành 1, thì trạng thái tạm dừng hiện tại sẽ được chuyển đổi. |
Phản ứng
tạm dừng
| Thuộc tính phản hồi | Sự miêu tả |
| tình trạng | Trạng thái sau khi thực hiện lệnh. Xem thuộc tính trạng thái phản hồi /Status để biết thêm chi tiết. |
Example
http://192.168.1.100:11000/Pause
Tạm dừng âm thanh đang phát.
4.3 Dừng
Sự miêu tả
Dừng âm thanh đang phát hiện tại. Nếu báo thức đang phát và có thời gian chờ, thì thời gian chờ báo thức sẽ bị hủy Yêu cầu
/Dừng lại
| Các tham số | Sự miêu tả |
| Không có |
Phản ứng
dừng lại
| Thuộc tính phản hồi | Sự miêu tả |
| tình trạng | “dừng” có nghĩa là âm thanh hiện tại đã dừng. |
Example
http://192.168.1.100:11000/Stop
Dừng âm thanh đang phát.
4.4 Bỏ qua
Sự miêu tả
Chuyển đến bản âm thanh tiếp theo trong hàng đợi phát
Khi phát từ hàng đợi phát, nó sẽ chuyển sang bài hát tiếp theo trong hàng đợi. Nếu bài hát hiện tại là bài hát cuối cùng trong hàng đợi, lệnh /Skip sẽ chuyển đến bài hát đầu tiên trong hàng đợi. Nó sẽ chuyển sang bài hát tiếp theo hoặc bài hát đầu tiên trong hàng đợi bất kể trạng thái của cài đặt lặp lại.
Để xác định xem bạn có đang sử dụng hàng đợi phát hay không, hãy xác minh rằng không cóUrl> mục nhập trong phản hồi /Trạng thái.
Sau đó bạn có thể sử dụng lệnh /Skip.
Bạn cũng có thể bỏ qua một số bản nhạc trên một số đài phát thanh trực tuyến. Những bản nhạc này được xử lý bằng lệnh /Action.
Một số nguồn như TuneIn và Optical Input không hỗ trợ tùy chọn bỏ qua. Các nguồn này sẽ cóURL> mục nhập nhưng không có tên hành động bỏ qua trong phản hồi /Status.
Lời yêu cầu
/Nhảy
| Các tham số | Sự miêu tả |
| Không có |
Phản ứng
21
| Thuộc tính phản hồi | Sự miêu tả |
| id | ID bài hát sau khi thực hiện lệnh bỏ qua. Tham khảo thuộc tính bài hát /Status response để biết chi tiết. |
Example
http://192.168.1.100:11000/Skip
Chuyển sang bài hát tiếp theo.
4.5 Quay lại
Sự miêu tả
Nếu một bản nhạc đang phát và đã phát trong hơn bốn giây thì bản nhạc đó sẽ quay lại đầu bản nhạc đó.
Nếu không, lệnh quay lại sẽ trở về bài hát trước đó trong danh sách phát hiện tại. Nếu đang ở bài hát đầu tiên trong danh sách phát, lệnh quay lại sẽ trở về bài hát cuối cùng. Lệnh này sẽ trở về bài hát trước đó hoặc bài hát đầu tiên trong danh sách phát bất kể trạng thái cài đặt lặp lại.
Để xác định xem bạn có đang sử dụng hàng đợi phát hay không, hãy xác minh rằng không cóUrl> phần tử trong phản hồi /Status.
Sau đó bạn có thể sử dụng lệnh /Back.
Bạn cũng có thể quay lại các bản nhạc của một số đài phát thanh trực tuyến. Việc này được xử lý bằng lệnh /Action.
Một số nguồn như TuneIn và Optical Input không hỗ trợ tùy chọn quay lại. Các nguồn này sẽ cóUrl> phần tử nhưng không có tên hành động bỏ qua trong phản hồi /Status.
Lời yêu cầu
/Trở lại
| Các tham số | Sự miêu tả |
| Không có |
Phản ứng
19
| Thuộc tính phản hồi | Sự miêu tả |
| id | ID bài hát sau khi thực hiện lệnh back. Tham khảo thuộc tính bài hát /Status response để biết chi tiết. |
4.6 Xáo trộn
Sự miêu tả
Lệnh xáo trộn tạo một hàng đợi mới bằng cách xáo trộn hàng đợi hiện tại. Hàng đợi ban đầu (chưa xáo trộn) sẽ được giữ lại để khôi phục khi lệnh xáo trộn bị tắt.
Lời yêu cầu
/Trộn?trạng thái=0|1
| Các tham số | Sự miêu tả |
| tình trạng | · 0 để tắt tính năng xáo trộn · 1 để kích hoạt xáo trộn. Không có hiệu lực nếu hàng đợi đã ở trạng thái xáo trộn. Xem /Phản hồi trạng thái yếu tố. |
Phản ứng
| Thuộc tính phản hồi | Sự miêu tả |
| đã sửa đổi | 1 có nghĩa là hàng đợi đã được sửa đổi kể từ khi được tải. 0 có nghĩa là không. |
| chiều dài | Tổng số bản nhạc trong hàng đợi hiện tại. |
| xáo trộn | Trạng thái xáo trộn. 1 nghĩa là hàng đợi hiện tại đang bị xáo trộn. 0 nghĩa là hàng đợi hiện tại không bị xáo trộn. |
| id | ID hàng đợi hiện tại. ID này sẽ thay đổi bất cứ khi nào hàng đợi phát được sửa đổi. |
Example
http://192.168.1.100:11000/Shuffle?state=1
Xáo trộn hàng đợi phát hiện tại.
4.7 Lặp lại
Sự miêu tả
Thiết lập các tùy chọn lặp lại. Lặp lại có ba trạng thái: 0 nghĩa là lặp lại hàng đợi hiện tại, 1 nghĩa là lặp lại bản nhạc hiện tại và 2 nghĩa là không lặp lại. Tất cả các lần lặp lại đều không xác định, tức là không dừng lại.
Lời yêu cầu
/Lặp lại?trạng thái=0|1|2
| Các tham số | Sự miêu tả |
| tình trạng | · 0 để lặp lại toàn bộ hàng đợi phát · 1 để lặp lại bản nhạc hiện tại · 2 để tắt chế độ lặp lại |
Phản ứng
| Thuộc tính phản hồi | Sự miêu tả |
| chiều dài | Tổng số bản nhạc trong hàng đợi phát hiện tại. |
| id | ID hàng đợi hiện tại. ID này sẽ thay đổi bất cứ khi nào hàng đợi phát được sửa đổi. |
| lặp lại | Trạng thái lặp lại hiện tại. |
Example
http://192.168.1.100:11000/Repeat?state=1
Lặp lại bản nhạc đang phát.
4.8 Hành động cho các đài phát thanh trực tuyến
Sự miêu tả
Các hành động cho phép bạn tua đi, tua lại, yêu thích và cấm các bản nhạc trên một số đài phát thanh phát trực tuyến nhất định, chẳng hạn như Slacker, Radio Paradise hoặc Amazon Music Prime Stations. Các đài phát thanh phát trực tuyến không tải các bản nhạc vào hàng đợi phát. Thay vào đó, chúng cung cấp URL mà bạn có thể sử dụng để thực hiện chức năng mong muốn.
Nút Skip sẽ chuyển sang bài hát tiếp theo. Nút Back sẽ chuyển về bài hát trước đó. Nút Love sẽ đánh dấu bài hát là đã thích trong dịch vụ âm nhạc. Nút Ban sẽ chuyển sang bài hát tiếp theo và đánh dấu bài hát là không thích trong dịch vụ âm nhạc.
Nếu có mộtUrl> nhập vào phản hồi /Status và một hành động thích hợp, bạn có thể thực hiện các chức năng này. Hành động sẽ chứa URL được sử dụng để thực hiện hành động.
Đây là một ví dụamptừ phản hồi /Status của người chơi đang chơi radio Slacker:
<action name=”skip” url=”/Hành động?dịch vụ=Slacker&skip=4799148″/>
<action icon=”/images/loveban/love.png” name=”love” notification=”Track marked as favorite” state=”1″ text=”Love” url=”/Hành động?dịch vụ=Slacker&love=4799148″/>
<action icon=”/images/loveban/ban.png” name=”ban” notification=”Track banned from this
trạm” trạng thái=”-1″ văn bản=”Cấm” url=”/Hành động?dịch vụ=Slacker&ban=4799148″/>
Trong ví dụ nàyample, back không khả dụng, nhưng skip, love và ban thì có thể.
Lời yêu cầu
/Hành động?dịch vụ=tên-dịch-vụ&hành-động=hành-động-URL
Ghi chú: Các chi tiết yêu cầu cụ thể (điểm cuối và tham số) được cung cấp bởi phần tử. Các lệnh trong Exampphần bên dưới đều sử dụng /Action nhưng có thể sử dụng bất kỳ URI nào.
| Các tham số | Sự miêu tả |
| Được cung cấp trong yếu tố. |
Phản ứng
Đối với phản hồi, bạn sẽ nhận được xác nhận hành động. Đối với thao tác bỏ qua và quay lại, bạn sẽ nhận được:
Vì tình yêu bạn nhận được:
1
Khi bị cấm, bạn sẽ nhận được:
0
| Thuộc tính phản hồi | Sự miêu tả |
| phản ứng | Nếu phần tử gốc của phản hồi là thì nút văn bản là thông báo hiển thị cho người dùng. Nếu một phần tử gốc thay thế được trả về và bao gồm một thuộc tính thông báo thì thông báo đó sẽ được hiển thị. |
Example
http://192.168.1.100:11000/Action?service=Slacker&skip=10965139
Chuyển sang bản nhạc radio Slacker tiếp theo.
http://192.168.1.100:11000/Action?service=Slacker&ban=33332284
Cấm bản nhạc radio Slacker đang phát và chuyển sang bản nhạc tiếp theo.
Quản lý hàng đợi chơi
Một chế độ hoạt động của trình phát là tải các bản nhạc vào hàng đợi phát, sau đó phát các bản nhạc từ hàng đợi phát đó. Các lệnh này cho phép bạn view và quản lý hàng đợi phát.
5.1 Liệt kê các bản nhạc
Sự miêu tả
Trả về trạng thái hàng đợi phát hoặc trả về thông tin về tất cả các bản nhạc trong hàng đợi phát.
Không nên sử dụng truy vấn này mà không có tham số độ dài hoặc tham số bắt đầu và kết thúc, nếu không phản hồi có thể rất dài.
Lời yêu cầu
/Danh sách phát
/Danh sách phát?độ dài=1
/Playlist?start=first&end=last (lấy một phần của hàng đợi, thường dùng để phân trang)
| Các tham số | Sự miêu tả |
| chiều dài = 1 | Chỉ trả về các thuộc tính cấp cao nhất và không có thông tin chi tiết về bản nhạc. |
| bắt đầu | Mục đầu tiên trong hàng đợi để đưa vào phản hồi, bắt đầu từ 0. |
| kết thúc | Mục nhập cuối cùng trong hàng đợi để đưa vào phản hồi. |
Phản ứng
Đối với trạng thái hàng đợi phát:
13
243
1
Để có danh sách hàng đợi phát:
2002
Anne-Marie
2002
Deezer:487381362
| Thuộc tính phản hồi | Sự miêu tả |
| tên | Tên hàng đợi phát hiện tại. |
| đã sửa đổi | 0 nghĩa là hàng đợi chưa được sửa đổi kể từ khi được tải. 1 nghĩa là hàng đợi đã được sửa đổi kể từ khi được tải. |
| chiều dài | tổng số bản nhạc trong hàng đợi hiện tại |
| id | ID duy nhất cho trạng thái hàng đợi hiện tại (ví dụ: 1054). Nó giống như trong /Phản hồi trạng thái. |
| bài hát | Bài hát được tạo thành từ một số thành phần phụ: · albumid = id của album chứa bài hát · dịch vụ = dịch vụ âm nhạc của bản nhạc · artistid = id của nghệ sĩ bài hát · songid = id bài hát · id = vị trí track trong hàng đợi hiện tại. Nếu track hiện đang được chọn, id track sẽ giống với trong /Phản hồi trạng thái. · tiêu đề = tên bài hát · nghệ thuật = tên nghệ sĩ · alb = tên album |
Example
http://192.168.1.100:11000/Playlist
Liệt kê tất cả các bản nhạc trong hàng đợi phát.
http://192.168.1.100:11000/Playlist?length=1
5.2 Xóa một bản nhạc
Sự miêu tả
Xóa một bản nhạc khỏi hàng đợi phát hiện tại.
Lời yêu cầu
/Xóa?id=vị trí
| Các tham số | Sự miêu tả |
| id | ID bài hát sẽ bị xóa khỏi hàng đợi phát hiện tại. |
Phản ứng
9
| Thuộc tính phản hồi | Sự miêu tả |
| đã xóa | Vị trí trong hàng đợi của bản nhạc cần xóa. |
Example
http://192.168.1.100:11000/Delete?id=9
Xóa bản nhạc ở vị trí thứ 9 trong hàng đợi phát.
5.3 Di chuyển một bản nhạc
Sự miêu tả
Di chuyển một bản nhạc trong hàng đợi phát hiện tại.
Lời yêu cầu
/Di chuyển?mới=điểm đến&cũ=nguồn gốc
| Các tham số | Sự miêu tả |
| mới | Vị trí mới trên đường đua đang được di chuyển. |
| cũ | Vị trí cũ của đường ray đang được di chuyển. |
Phản ứng
đã di chuyển
| Thuộc tính phản hồi | Sự miêu tả |
| đã di chuyển | Chỉ ra rằng đường đua đã được di chuyển. |
Example
http://192.168.1.100:11000/Move?new=8&old=2
Di chuyển bản nhạc ở vị trí 2 đến vị trí 8 trong hàng đợi phát.
5.4 Xóa hàng đợi
Sự miêu tả
Xóa tất cả các bản nhạc khỏi hàng đợi phát hiện tại
Lời yêu cầu
/Thông thoáng
| Các tham số | Sự miêu tả |
| Không có |
Phản ứng
| Thuộc tính phản hồi | Sự miêu tả |
| đã sửa đổi | 0 nghĩa là hàng đợi không bị thay đổi kể từ khi tải, 1 nghĩa là hàng đợi bị thay đổi kể từ khi tải. |
| chiều dài | Tổng số bản nhạc trong hàng đợi hiện tại. |
| id | ID duy nhất cho hàng đợi hiện tại. |
Example
http://192.168.1.100:11000/Clear
Thao tác này sẽ xóa tất cả các bản nhạc khỏi hàng đợi phát.
5.5 Lưu hàng đợi
Sự miêu tả
Lưu hàng đợi phát dưới dạng danh sách phát BluOS có tên.
Lời yêu cầu
/Lưu?tên=tên_danh_sách_phát
| Các tham số | Sự miêu tả |
| tên | Tên hàng đợi phát đã lưu. |
Phản ứng
126
| Thuộc tính phản hồi | Sự miêu tả |
| mục nhập | Tổng số bản nhạc trong hàng đợi phát đã lưu. |
Example
http://192.168.1.100:11000/Save?name=Dinner+Music
Thao tác này sẽ lưu hàng đợi phát nhạc thành “Nhạc bữa tối”.
Cài đặt trước
Yêu cầu cài đặt trước cho phép bạn liệt kê tất cả cài đặt trước của trình phát, tải cài đặt trước và tăng/giảm cài đặt trước. Cài đặt trước phải được thêm và xóa bằng ứng dụng BluOS Controller. Cài đặt trước có thể bao gồm các đài phát thanh, danh sách phát và đầu vào (ví dụ:
Bluetooth, analog, quang, HDMI ARC).
6.1 Danh sách cài đặt trước
Sự miêu tả
Liệt kê tất cả các cài đặt trước trên trình phát BluOS hiện tại.
Lời yêu cầu
/Cài đặt trước
| Các tham số | Sự miêu tả |
| Không có |
Phản ứng
<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=”/Tải?dịch vụ=Thủy triều&id=fd3f797e-
a3e9-4de9-a1e2-b5adb6a57cc7″ image=”/Artwork?service=Tidal&playlistimage=afacfc12-24034caf-a5c5-a2af28d811c8″/> </presets>
| Thuộc tính phản hồi | Sự miêu tả |
| kiêu ngạo | Một ID duy nhất của các cài đặt trước của người chơi. Nó giống như trong /Phản hồi trạng thái. |
| tên | Tên được đặt trước. |
| id | ID cài đặt trước. |
| url | Cài đặt trước URL. Đó là nguồn được cài đặt trước URL được sử dụng để tải cài đặt trước. |
| hình ảnh | Hình ảnh URL của cài đặt trước. Nếu URL bắt đầu bằng /Artwork có thể dẫn đến chuyển hướng. Thêm tham số/khóa theo dõi chuyển hướng = 1 khi lấy lại hình ảnh có thể tránh được việc chuyển hướng. |
Example
http://192.168.1.100:11000/Presets
Liệt kê tất cả các cài đặt trước trên trình phát.
6.2 Tải cài đặt trước
Sự miêu tả
Bắt đầu phát một cài đặt trước. Bạn có thể chọn một số cài đặt trước cụ thể, cũng như cài đặt trước tiếp theo hoặc trước đó. Các số cài đặt trước không nhất thiết phải theo thứ tự, nghĩa là bạn có thể có các cài đặt trước 1, 2, 3, 5, 7 và 8. Các cài đặt trước sẽ lặp lại từ trên xuống dưới và từ dưới lên trên.
Lời yêu cầu
/Preset?id=presetId|-1|+1
| Các tham số | Sự miêu tả |
| id | Số ID của cài đặt trước cần tải. Danh sách ID cài đặt trước khả dụng có thể được tìm thấy bằng lệnh Hiển thị cài đặt trước. Nếu id cài đặt trước là +1, nó sẽ tải cài đặt trước tiếp theo. Nếu id cài đặt trước là -1, nó sẽ tải cài đặt trước đó. |
Phản ứng
Nếu cài đặt trước là danh sách các bản nhạc, nó sẽ trả về số lượng bản nhạc của cài đặt trước đã tải.
60
Nếu cài đặt trước là radio, nó sẽ trả về trạng thái luồng.
suối
| Thuộc tính phản hồi | Sự miêu tả |
| dịch vụ | tên dịch vụ của cài đặt trước đã tải |
| mục nhập | số lượng bản nhạc được tải trước |
Example
http://192.168.1.100:11000/Preset?id=4
Tải cài đặt trước với ID cài đặt trước là 4.
http://192.168.1.100:11000/Preset?id=+1
Duyệt và tìm kiếm nội dung
Phần này mô tả các lệnh để duyệt và tìm kiếm nội dung dịch vụ âm nhạc.
7.1 Duyệt nội dung âm nhạc
Sự miêu tả
Điều hướng qua các nguồn nhạc có sẵn cũng như các mục nhập và danh sách phát.
Phần tử gốc cho phản hồi là trừ khi có phản hồi lỗi. Hầu hết các kết quả là một chuỗi . Trong một số trường hợp, kết quả là một chuỗi , mỗi phần tử chứa một chuỗi nếu . Tất cả các giá trị được cung cấp bằng thuộc tính. Không có nút văn bản nào.
Kết quả của lệnh gọi /Browse có thể là lỗi được bao bọc trong phần tử gốc. Chi tiết về lỗi được cung cấp trong một và không hoặc nhiều hơn các nút văn bản.
Lời yêu cầu
/Duyệt?key=giá trị khóa
/Duyệt?key=key-value&withContextMenuItems=1
| Các tham số | Sự miêu tả |
| chìa khóa | Tham số tùy chọn. Việc thiếu tham số này sẽ dẫn đến việc duyệt cấp cao nhất. Trả về thông tin cho các cấp độ khác ngoài cấp độ cao nhất /Browse. Sử dụng giá trị được lấy từ giá trị thuộc tính "browseKey", "nextKey", "parentKey" hoặc "contextMenuKey" từ phản hồi trước đó. Lưu ý: khóa-giá trị phải là URL được mã hóa |
| vớiContextMenuItems | Tham số tùy chọn. Giá trị luôn là 1. Tham số này được sử dụng để lấy menu ngữ cảnh nội tuyến khi duyệt kết quả danh sách phát, album, bản nhạc, đài phát thanh, nghệ sĩ, v.v. |
Phản ứng
Phản hồi duyệt cấp cao nhất:
<item image=”/images/InputIcon.png” text=”Optical Input”
chơiURL="/Chơi?url=Capture%3Ahw%3A1%2C0%2F1%2F25%2F2%2Finput1″ inputType=”spdif”
loại=”âm thanh”/>
Phản hồi duyệt cấp độ khác:
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
service=”Deezer” searchKey=”Deezer:Tìm kiếm” type=”menu”>
mục browseKey=”/Playlists?service=Deezer&genre=0&category=toplist” text=”Danh sách phát phổ biến”
loại=”liên kết”/>
loại=”liên kết”/>
loại=”liên kết”/>
mục browseKey=”/Bài hát?service=Deezer&genre=0&category=toplist” text=”Bài hát phổ biến”
loại=”liên kết”/>
| Thuộc tính phản hồi | Sự miêu tả |
| Tham khảo bảng phần tử/thuộc tính bên dưới |
Example
GHI CHÚ: tất cả các tham số chính phải được mã hóa UTF-8.
http://192.168.1.100:11000/Browse
Có trình duyệt ở cấp độ cao nhất không?
http://192.168.1.100:11000/Browse?key=Tidal%3A
Có duyệt cấp độ thứ hai, trả về các danh mục Tidal.
http://192.168.1.100:11000/Browse?key=Tidal%3AmenuGroup%2F3
Có duyệt cấp độ thứ ba, trả về các tiểu thể loại Tidal Masters (Nhóm 3).
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters
Có trình duyệt cấp độ thứ tư, trả về bộ album Tidal Masters đầu tiên.
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters%26 start%3D30%26end%3D79
Có thêm một trình duyệt cấp độ thứ tư nữa, trả về bộ album Tidal Masters thứ hai.
| Yếu tố | Thuộc tính (và giá trị) | Sự miêu tả | |
| Biểu tượng dịch vụ | URI cho biểu tượng của dịch vụ hiện đang được duyệt. | ||
| Tên dịch vụ | Tên của dịch vụ hiện đang được duyệt để người dùng hiển thị. | ||
| tìm kiếmKey | Giá trị sử dụng cho tham số khóa của yêu cầu /Browse để tìm kiếm dịch vụ hiện tại (hoặc một phần sâu hơn của hệ thống phân cấp). Ngoài ra, yêu cầu phải có tham số aq chứa thuật ngữ tìm kiếm. | ||
| nextKey | Giá trị sử dụng cho tham số khóa cho yêu cầu /Browse để lấy trang mục tiếp theo cho mục hiện tại view. Kích thước khối phân trang không nằm trong tầm kiểm soát của người dùng API và không nên cố gắng phân tích hoặc thao tác các tham số truy vấn của giá trị này. | ||
| parentKey | Giá trị sử dụng cho tham số khóa cho yêu cầu /Browse để điều hướng ngược lên hệ thống phân cấp nếu điều hướng ngược mặc định bị ghi đè. | ||
| kiểu | thực đơn | Một nút điều hướng có khả năng chứa nhiều loại mục khác nhau. Thông thường, nút này chỉ chứa các mục liên kết hoặc âm thanh. | |
| contextMenu | Danh sách các mục có loại được chỉ định. | ||
| nghệ sĩ | |||
| Yếu tố | Thuộc tính (và giá trị) | Sự miêu tả | |
| các nhà soạn nhạc | |||
| album | |||
| danh sách phát | |||
| theo dõi | |||
| thể loại | |||
| các phần | Các phần theo thứ tự chữ cái. | ||
| mặt hàng | Danh sách kết quả chung. Thường là sự kết hợp giữa các nút menu (type=”link”) và các mục radio (type=”audio”). | ||
| thư mục | Có thể chứa các mục thư mục con, bản nhạc và danh sách phát. | ||
| chữ | Tiêu đề cho danh mục. | ||
| nextKey | Giá trị sử dụng cho tham số khóa trong yêu cầu /Browse để lấy trang mục tiếp theo cho danh mục. | ||
| parentKey | Giá trị sử dụng cho tham số khóa cho yêu cầu /Browse để điều hướng ngược lên hệ thống phân cấp nếu điều hướng ngược mặc định bị ghi đè. | ||
| kiểu | liên kết | Một nút chung trong hệ thống phân cấp duyệt dẫn đến các nút tiếp theo | |
| âm thanh | Một nút có thể được chơi trực tiếp | ||
| nghệ sĩ | Một vật phẩm đại diện cho một nghệ sĩ | ||
| Yếu tố | Thuộc tính (và giá trị) | Sự miêu tả | |
| nhà soạn nhạc | Một mục đại diện cho một nhà soạn nhạc | ||
| album | Một mục đại diện cho một album hoặc bộ sưu tập tương tự | ||
| danh sách phát | Một mục đại diện cho danh sách phát hoặc bộ sưu tập tương tự | ||
| theo dõi | Một mục đại diện cho một bản nhạc duy nhất | ||
| chữ | Một nút văn bản thuần túy. | ||
| phần | Một phần theo thứ tự chữ cái. | ||
| thư mục | Duyệt một thư mục trong một thư mục. | ||
| chữ | Dòng chính hoặc dòng đầu tiên của mô tả mục | ||
| văn bản2 | Dòng thứ hai | ||
| hình ảnh | Một biểu tượng hoặc tác phẩm nghệ thuật cho sản phẩm. Nếu hình ảnh bắt đầu bằng
/Artwork có thể dẫn đến chuyển hướng. Thêm tham số/khóa theo dõi chuyển hướng = 1 khi lấy lại hình ảnh có thể tránh được việc chuyển hướng. |
||
| duyệtKey | Giá trị sử dụng cho tham số khóa cho yêu cầu /Browse tiếp theo để đi xuống thứ bậc. | ||
| chơiURL | Một URI có thể được gọi trực tiếp để kích hoạt hành động phát mặc định cho mục đang xét. Thông thường, hành động này là để xóa hàng đợi và bắt đầu phát. | ||
| tự động phátURL | Một URI có thể được gọi trực tiếp để thêm một bản nhạc vào hàng đợi và phát bản nhạc đó, đồng thời thêm các bản nhạc tiếp theo từ đối tượng chứa (chẳng hạn như album) vào mục tự động điền | ||
| Yếu tố | Thuộc tính (và giá trị) | Sự miêu tả |
| phần của hàng đợi phát. | ||
| contextMenuKey | Giá trị sử dụng cho tham số chính của yêu cầu /Browse để có được kết quả là menu ngữ cảnh của các hành động liên quan đến mục. | |
| hoạt độngURL | Một URI có thể được gọi trực tiếp để thực hiện hành động đã chỉ định. |
Các mục menu ngữ cảnh có thể có các giá trị sau cho thuộc tính type.
| Thuộc tính | ||
| Sự miêu tả | ||
| yêu thích | -thêm vào | Thêm mục vào mục yêu thích (hoặc mục tương đương) |
| -xóa bỏ | Xóa mục khỏi mục yêu thích của người dùng | |
| thêm vào | Thêm vào hàng đợi phát | |
| thêm vào | -hiện nay | Thêm vào hàng đợi phát sau bản nhạc hiện tại và phát ngay |
| -Kế tiếp | Thêm vào hàng đợi phát sau bản nhạc hiện tại | |
| -cuối cùng | Thêm vào cuối hàng đợi phát | |
| thêmTất cả | -hiện nay | Thêm đối tượng nhiều bản nhạc vào hàng đợi phát và phát ngay |
| -Kế tiếp | Thêm đối tượng đa rãnh vào hàng đợi phát sau rãnh hiện tại hoặc đối tượng đa rãnh | |
| -cuối cùng | Thêm đối tượng đa rãnh vào cuối hàng đợi phát | |
| playRadio | Phát một đài phát thanh liên quan đến mục đó | |
| xóa bỏ | Xóa đối tượng (thường là danh sách phát). Cần yêu cầu người dùng xác nhận. |
Khi duyệt với tham số “withContextMenuItem=1”, kết quả sẽ chứa menu ngữ cảnh nội tuyến.
Example
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26genre%3D0%26category %3Dtoplist&withContextMenuItems=1
Có yêu cầu Deezer => Hot => Album phổ biến với menu ngữ cảnh nội tuyến không?
Phản ứng
Phản hồi chứa nội tuyến cho mỗi mục.
<item text=”Essonne History X” contextMenuKey=”Deezer:contextMenu/Album?albumid=693798541″
chơiURL=”/Thêm?dịch vụ=Deezer&albumid=693798541&playnow=1″ ảnh=”/Ảnh minh họa?dịch vụ=Deezer&albumid=693798541″
browseKey="Deezer:Album?artist=Ziak&album=Essonne%20History%20X&albumid=693798541" text2="Ziak" type="album">
<item text=”Favorite” type=”favourite-add” actionURL=”/AddFavourite?service=Deezer&albumid=693798541″/>
<item text=”Play now” type=”add-now”
hoạt độngURL=”/Thêm?dịch vụ=Deezer&playnow=1&clear=0&shuffle=0&where=nextAlbum&albumid=693798541″/>
<item text=”Shuffle” type=”add-shuffle”
hoạt độngURL=”/Thêm?dịch vụ=Deezer&shuffle=1&playnow=1&where=nextAlbum&albumid=693798541″/>
<item text=”Add next” type=”addAll-next” actionURL=”/Thêm?dịch vụ=Deezer&playnow=-1&where=nextAlbum&albumid=693798541″/>
<item text=”Add last” type=”addAll-last” actionURL=”/Thêm?dịch vụ=Deezer&playnow=-1&where=last&albumid=693798541″/>
…
Ghi chú và gợi ý thực hiện
Thuộc tính loại của một mục được cung cấp như một gợi ý có thể giúp đưa ra nhiều tùy chọn hiển thị khác nhau.
Khả năng duyệt nội dung của một mục được biểu thị bằng thuộc tính browseKey. Khả năng phát (toàn bộ) một mục được biểu thị bằng thuộc tính playURL (và có thể cũng tự động phátURL) thuộc tính. Một mục có thể có cả thuộc tính browseKey và thuộc tính playURL thuộc tính.
Khi cả hai cùng chơiURL và tự động phátURL có sẵn các thuộc tính, việc sử dụng thuộc tính nào làm tùy chọn phát mặc định sẽ tùy thuộc vào sở thích của người dùng.
Giá trị URI thường là URI tương đối với thành phần đường dẫn tuyệt đối. URI tương đối được phân giải thành URI tuyệt đối theo RFC 3986.
Các giá trị thuộc tính browseKey, contextMenuKey và searchKey sẽ luôn được mã hóa theo URI (phần trăm thoát) khi được sử dụng làm giá trị của tham số khóa cho yêu cầu /Browse, cũng như bất kỳ tham số yêu cầu nào khác.
Khi đi xuống hệ thống phân cấp duyệt, có thể hữu ích khi tiêu đề trang UI hiển thị một số loại breadcrumb, có thể sử dụng tiêu đề (văn bản) của nút cha và nút ông bà.
Có thể hữu ích khi cung cấp menu ngữ cảnh cho mục cha khi duyệt các mục con.
Có thể hữu ích khi xem xét loại cha mẹ khi quyết định cách hiển thị con cái.
7.2 Tìm kiếm nội dung âm nhạc
Sự miêu tả
Lệnh tìm kiếm trong một dịch vụ.
Lời yêu cầu
/Duyệt?key=key-value&q=searchText
| Các tham số | Sự miêu tả |
| chìa khóa | Giá trị được lấy từ giá trị thuộc tính “searchKey” từ phản hồi trước đó |
| q | Chuỗi tìm kiếm. Thực hiện tìm kiếm trong ngữ cảnh được chỉ định bởi tham số khóa (lấy từ thuộc tính searchKey của phản hồi). Nếu không có tham số khóa, hãy thực hiện tìm kiếm cấp cao nhất. |
Phản ứng
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
service=”Deezer” searchKey=”Deezer:Tìm kiếm” type=”menu”>
Trả về kết quả tìm kiếm cấp cao nhất. Để tìm kiếm thêm Nghệ sĩ, Album, Bài hát hoặc Danh sách phát, cần sử dụng lệnh duyệt với khóa là "browseKey".
Ví dụample, để xem kết quả tìm kiếm của Album, hãy gửi lệnh:
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26expr%3Dmichael
Phản hồi sẽ giống như phản hồi cho lệnh /Browse thông thường.
| Thuộc tính phản hồi | Sự miêu tả |
| Tham khảo bảng phần tử/thuộc tính trong lệnh Browse |
Example
http://192.168.1.100:11000/Browse?key=Deezer:Search&q=michael Tìm kiếm “michael” trong dịch vụ âm nhạc Deezer.
Nhóm người chơi
Phần này mô tả các lệnh để nhóm và hủy nhóm người chơi mặc định. BluOS cũng hỗ trợ nhóm cố định, nhưng tính năng này nằm ngoài phạm vi tài liệu này.
BluOS sử dụng thuật ngữ "primary player" và "secondary player". "Primary player" là trình phát chính trong nhóm. Trình phát chính được dùng để chọn nguồn nhạc. Chỉ có một trình phát chính. Một trình phát phụ được gắn vào trình phát chính. Có thể có nhiều trình phát phụ.
Nếu người chơi là người chơi phụ, nhiều yêu cầu, nếu được chuyển đến người chơi phụ, sẽ được chuyển tiếp nội bộ đến người chơi chính. Các yêu cầu này bao gồm /Status, Kiểm soát Phát lại, Quản lý Hàng đợi Phát và các yêu cầu Duyệt và Tìm kiếm Nội dung.
8.1 Người chơi nhóm hai
Sự miêu tả
Nhóm một người chơi phụ với một người chơi chính.
Lời yêu cầu
/AddSlave?slave=secondaryPlayerIP&port=secondaryPlayerPort&group=GroupName
| Các tham số | Sự miêu tả |
| nô lệ | Địa chỉ IP của người chơi thứ cấp. |
| cảng | Số cổng của đầu phát phụ. Số cổng mặc định là 11000. Các đầu phát như NAD CI580, có bốn đầu phát với một IP, sử dụng nhiều cổng. |
| nhóm | TÙY CHỌN, tên nhóm. Nếu không được cung cấp, BluOS sẽ tự động đặt tên nhóm mặc định. |
Phản ứng
| Thuộc tính phản hồi | Sự miêu tả |
| cảng nô lệ | Số cổng của người chơi thứ cấp vừa được nhóm lại. |
| Id | ID của người chơi phụ vừa được nhóm lại. |
Example
http://192.168.1.100:11000/AddSlave?slave=192.168.1.153&port=11000
Nhóm này nhóm người chơi 192.168.1.153 đến người chơi 192.168.1.100. Người chơi 192.168.1.100 là người chơi chính.
8.2 Thêm nhiều người chơi vào một nhóm
Sự miêu tả
Nhóm hai hoặc nhiều người chơi thành một người chơi chính.
Lời yêu cầu
/AddSlave?slaves=secondaryPlayerIPs&ports=secondaryPlayerPorts
| Các tham số | Sự miêu tả |
| nô lệ | Địa chỉ IP của người chơi phụ sẽ được thêm vào người chơi chính. Địa chỉ IP được phân tách bằng dấu phẩy. |
| cổng | Các cổng của người chơi phụ sẽ được thêm vào người chơi chính. Số cổng được phân tách bằng dấu phẩy. |
Phản ứng
| Thuộc tính phản hồi | Sự miêu tả |
| cảng | Cổng của người chơi thứ cấp được nhóm lại. |
| Id | ID của người chơi phụ được nhóm lại. |
Example
http://192.168.1.100:11000/AddSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Nhóm người chơi phụ 192.168.1.153 và 192.168.1.120 đến người chơi chính 192.168.1.100.
8.3 Loại bỏ một người chơi khỏi nhóm
Xóa một người chơi khỏi nhóm. Nếu xóa một người chơi phụ khỏi nhóm, người chơi phụ đó sẽ bị tách khỏi nhóm. Nếu xóa người chơi chính khỏi nhóm từ 3 người chơi trở lên, người chơi chính sẽ bị tách khỏi nhóm và những người chơi phụ còn lại sẽ tạo thành một nhóm mới.
Lời yêu cầu
/RemoveSlave?slave=secondaryPlayerIP&port=secondaryPlayerPort
| Các tham số | Sự miêu tả |
| nô lệ | Địa chỉ IP của người chơi (phụ) sẽ được thêm vào người chơi khác (chính). |
| cảng | Cổng của người chơi (phụ) sẽ được thêm vào người chơi khác (chính). |
Phản ứng
<SyncStatus icon=”/images/players/P300_nt.png” volume=”4″ modelName=”PULSE” name=”PULSE0278″ model=”P300″
thương hiệu=”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″>
| Thuộc tính phản hồi | Sự miêu tả |
| Xem /SyncStatus để biết chi tiết. |
Example
http://192.168.1.100:11000/RemoveSlave?slave=192.168.1.153&port=11000
Tách người chơi 192.168.1.153 khỏi nhóm có người chơi chính 192.168.1.100
8.4 Loại bỏ nhiều người chơi khỏi một nhóm
Sự miêu tả
Loại bỏ hai hoặc nhiều người chơi khỏi một nhóm.
Lời yêu cầu
/RemoveSlave?slaves=secondaryPlayerIPs&ports=secondaryPlayerPorts
| Các tham số | Sự miêu tả |
| nô lệ | Địa chỉ IP của người chơi phụ sẽ bị xóa khỏi người chơi chính. Địa chỉ IP được phân tách bằng dấu phẩy. |
| Các tham số | Sự miêu tả |
| cổng | Các cổng của người chơi phụ sẽ bị xóa khỏi người chơi chính. Số cổng được phân tách bằng dấu phẩy. |
Phản ứng
<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>
| Thuộc tính phản hồi | Sự miêu tả |
| Xem /SyncStatus để biết chi tiết. |
Example
http://192.168.1.100:11000/RemoveSlave?slaves=192.168.1.153,192.168.1.120&ports=11000,11000
Xóa người chơi 192.168.1.153 và 192.168.1.120 khỏi nhóm có người chơi chính 192.168.1.100.
Khởi động lại trình phát
Phần này mô tả lệnh khởi động lại mềm cho trình phát.
9.1 Khởi động lại trình phát
Sự miêu tả
Khởi động lại nhẹ nhàng một trình phát.
Lời yêu cầu
Lệnh POST /reboot với tham số yes (bất kỳ giá trị nào)
| Các tham số | Sự miêu tả |
| Đúng | Bất kỳ giá trị nào (ví dụ 1). |
Phản ứng
Cài đặt đã được cập nhật
Đang khởi động lại. Vui lòng đóng cửa sổ này.
Vui lòng chờ…
Example
curl -d yes=1 192.168.1.100/khởi động lại
Chuông cửa
Phần này mô tả lệnh để chuông cửa của người chơi reo.
10.1 Chuông cửa
Sự miêu tả
Kích hoạt chuông cửa.
Lời yêu cầu
http://PLAYERIP:PORT/Doorbell?play=1
| Các tham số | Sự miêu tả |
| chơi | Chơi chuông cửa (luôn là 1) |
Phản ứng
| Thuộc tính phản hồi | Sự miêu tả |
| cho phép | Chỉ ra tiếng chuông |
| âm lượng | Âm lượng chuông |
| kêu vang | Âm thanh chuông |
Example
http://192.168.1.100:11000/Doorbell?play=1 play doorbell chime
Nhập trực tiếp
Phần này mô tả các lệnh để chọn nguồn đầu vào trực tiếp.
11.1 Lựa chọn đầu vào chủ động
Sự miêu tả
Chọn nguồn đầu vào đang hoạt động. Lệnh này hoạt động với các đầu vào đang hoạt động xuất hiện trong phản hồi cho /RadioBrowse?service=Capture. Lệnh này chỉ hỗ trợ chọn đầu vào BluOS HUB.
Lời yêu cầu
/Chơi?url=URL_giá trị
| Các tham số | Sự miêu tả |
| url | Các URL thuộc tính từ phản hồi tới /RadioBrowse?service=Capture |
Phản ứng
suối
| Thuộc tính phản hồi | Sự miêu tả |
| tình trạng | Chỉ ra rằng đầu vào đang phát |
Example
Bước 1. Lấy URL_giá trị cho tham số url
Yêu cầu: http://192.168.1.100:11000/RadioBrowse?service=Capture
Phản ứng:
<item playerName=”Tick
Đánh dấu” text=”Bluetooth” inputType=”bluetooth” id=”input2″ URL=”Chụp%3Abluez%3Abluetooth” image=” /images/BluetoothIcon.png” type=”audio”/>
<item playerName=”Tick Tick” text=”Analog
Đầu vào” 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
Đầu vào” 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
Đánh dấu” text=”Spotify” id=”Spotify” URL=”Spotify%3Aplay” image=”/Sources/images/SpotifyIcon.png” dịch vụ
Loại=”Dịch vụ đám mây” loại=”âm thanh”/>
<remoteitem playerName=”Test Hub” text=”Analog Input” inputType=”analog” id=”hub192168114911000input0″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput0″
hình ảnh = "/hình ảnh/chụp/i
c_analoginput.png”
loại=”âm thanh”/>
<remoteitem playerName=”Test Hub” text=”Coaxial Input” inputType=”spdif” id=”hub192168114911000input3″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput3″
hình ảnh = "/hình ảnh/chụp/ic
_opticalinput.png”
loại=”âm thanh”/>
<remoteitem playerName=”Test Hub” text=”HDMI ARC” inputType=”arc” id=”hub192168114911000input4″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput4″
hình ảnh = "/hình ảnh/chụp/ic
_tv.png”
loại=”âm thanh”/>
<remoteitem playerName=”Test Hub” text=”Optical Input” inputType=”spdif” id=”hub192168114911000input2″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput2″
hình ảnh = "/hình ảnh/chụp/ic
_opticalinput.png”
loại=”âm thanh”/>
<remoteitem playerName=”Test Hub” text=”Phono Input” inputType=”phono” id=”hub192168114911000input1″
URL=”Hub%3A%2F%2F192.168.1.149%3A11000%2Finput1″
hình ảnh = "/hình ảnh/chụp/ic
_vinyl.png”
loại=”âm thanh”/>
Bước 2. Phát Đầu vào tương tự trên máy nghe nhạc
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
Ghi chú: Đảm bảo các nguồn được kết nối và không bị ẩn.
11.2 Lựa chọn đầu vào bên ngoài
Sự miêu tả
Lựa chọn nguồn đầu vào bên ngoài. Đôi khi, các đầu vào bên ngoài không hoạt động có thể không hiển thị trong phản hồi.
/RadioBrowse?service=Capture. Lệnh này hoạt động cho cả lựa chọn đầu vào đang hoạt động và không hoạt động. Lệnh này được khuyến nghị cho lựa chọn đầu vào bên ngoài CI.
Yêu cầu (Phần mềm BluOS mới hơn v3.8.0 và cũ hơn v4.2.0)
/Play?inputIndex=IndexId
| Các tham số | Sự miêu tả |
| đầu vàoIndex | Chỉ mục (bắt đầu bằng 1) của các đầu vào xuất hiện trong phản hồi cho /Settings?id=capture&shcemaVersion=32 (32 là phiên bản lược đồ mới nhất) theo thứ tự số. Bluetooth không được tính. |
Phản ứng
suối
| Thuộc tính phản hồi | Sự miêu tả |
| tình trạng | Chỉ ra rằng đầu vào đang phát |
Example
Bước 1. Lấy giá trị inputIndex
Yêu cầu: http://192.168.1.100:11000/Settings?id=capture&schemaVersion=32
Phản ứng:
<menuGroup icon=”/images/settings/ic_capture.png” url= “/cài đặt” id = “chụp”
displayName="Tùy chỉnh nguồn">
<setting icon=”/images/settings/ic_bluetooth.png” refresh=”true” url= “/chế độ âm thanh”
id=”bluetooth” displayName=”Bluetooth” value=”3″ name=”bluetoothAutoplay” description=”Đã tắt” explanation=”Chế độ thủ công cho phép bạn chuyển đổi giữa các nguồn trong ngăn điều hướng. Chế độ tự động sẽ chuyển sang nguồn Bluetooth khi thiết bị Bluetooth được kết nối bắt đầu phát âm thanh. Sau đó, bạn có thể chuyển đổi giữa các nguồn trong ngăn điều hướng. Chế độ khách sẽ chuyển sang nguồn Bluetooth khi thiết bị Bluetooth được kết nối bắt đầu phát âm thanh. Nếu bạn chuyển sang nguồn khác, Bluetooth sẽ ngắt kết nối. Nguồn Bluetooth sẽ không hiển thị trong ngăn điều hướng. Chế độ vô hiệu hóa sẽ xóa nguồn khỏi ngăn điều hướng và không cho phép thiết bị khác kết nối với Đầu phát dưới dạng Bluetooth.
nguồn.” class=”list”>
…
<menuGroup icon=”/images/capture/ic_analoginput.png” url= “/cài đặt” id = “captureinput0”
displayName=”Tương tự
Đầu vào”>
<menuGroup icon=”/images/capture/ic_opticalinput.png” url= “/cài đặt” id = “đầu vào chụp 1”
displayName="Đầu vào quang học">
Phản hồi hiển thị Bluetooth, Đầu vào Analog và Đầu vào Quang. Bluetooth bị loại trừ, do đó giá trị inputIndex là 1 cho Đầu vào Analog và giá trị inputIndex là 2 cho Đầu vào Quang.
Bước 2. Phát đầu vào quang học trên máy nghe nhạc.
http://192.168.1.100:11000/Play?InputId=2
Yêu cầu (Phần mềm BluOS v4.2.0 hoặc mới hơn)
/Play?inputTypeIndex=$typeIndex
| Các tham số | Sự miêu tả |
| đầu vàoTypeIndex | typeIndex có định dạng là chỉ số loại của một đầu vào. Dưới đây là danh sách các đầu vào kiểu: spdif (Đầu vào quang học) analog (Đầu vào Analog, Đầu vào Đường truyền) coax (Đầu vào Đồng trục) bluetooth vòng cung (HDMI ARC) máy tính phono (Vinyl) tai (HDMI eARC) aesebu (AES/EBU) cân bằng (Balanced In) micrô (Đầu vào micrô) Các chỉ số bắt đầu từ 1. Khi có nhiều hơn một đầu vào cùng loại, đầu vào 1 có chỉ số 1, đầu vào 2 có chỉ số 2, v.v. |
Phản ứng
suối
| Thuộc tính phản hồi | Sự miêu tả |
| tình trạng | Chỉ ra rằng đầu vào đang phát |
Example
Yêu cầu: http://192.168.1.100:11000/Play?inputTypeIndex=spdif-2 để chọn Đầu vào quang 2
Phản ứng: suối
Bluetooth
Phần này mô tả lệnh để thay đổi chế độ Bluetooth.
12.1 Thay đổi chế độ Bluetooth
Sự miêu tả
Thay đổi chế độ Bluetooth: Thủ công, Tự động, Khách, Tắt.
Lời yêu cầu
/audiomodes?bluetoothAutoplay=giá trị
| Các tham số | Sự miêu tả |
|
bluetoothTự động phát |
Chế độ Bluetooth giá trị 0 nghĩa là Thủ công, 1 nghĩa là Tự động, 2 nghĩa là Khách, 3 nghĩa là Vô hiệu hóa. |
Không có phản hồi
Example
Yêu cầu: http://192.168.1.100:11000/audiomodes?bluetoothAutoplay=3 để tắt bluetooth
Phụ lục
13.1 Giao thức khám phá dịch vụ Lenbrook
Giới thiệu
Các phương pháp khám phá phổ biến như mDNS và SSDP sử dụng và phụ thuộc vào giao tiếp đa hướng UDP. Hầu hết các sản phẩm Lenbrook hiện tại đều sử dụng mDNS để khám phá. Thật không may, chúng tôi nhận thấy một số lượng lớn khách hàng của chúng tôi có mạng gia đình mà lưu lượng đa hướng không hoạt động chính xác và thiết bị của chúng tôi không thể được khám phá một cách đáng tin cậy. Điều này đã dẫn đến nhiều sản phẩm bị trả lại và khiếu nại từ các nhà phân phối của chúng tôi.
Để giải quyết vấn đề này, chúng tôi đã tạo ra một giao thức khám phá tùy chỉnh có tên là LSDP, sử dụng UDP broadcast. Thử nghiệm ban đầu cho thấy giao thức này đáng tin cậy hơn nhiều so với khám phá dựa trên mDNS.
Giao thức kết thúcview
Một mục tiêu của giao thức này là tương đối đơn giản. Nó có thể được sử dụng trong các thiết bị nhúng có bộ nhớ rất hạn chế.
Giao thức sử dụng tất cả các gói tin phát sóng UDP đến và đi từ cổng UDP 11430. Cổng này đã được đăng ký với IANA và được chỉ định cho Lenbrook sử dụng LSDP kể từ ngày 27 tháng 3 năm 2014.
Ở trạng thái ổn định, mỗi nút có dịch vụ quảng cáo sẽ phát đi một thông báo khoảng mỗi phút.
Khi khởi động và khi danh sách dịch vụ hoặc các tham số mạng thay đổi, bảy gói tin sẽ được phát sóng với các khoảng thời gian ngắn để cho phép phát hiện ban đầu và lan truyền các thay đổi nhanh hơn. Đối với các nút quảng cáo dịch vụ, bảy gói tin ban đầu này sẽ bao gồm một thông báo Thông báo. Đối với các nút đang cố gắng phát hiện dịch vụ, bảy gói tin ban đầu sẽ bao gồm một thông báo Truy vấn. Đối với các dịch vụ không còn khả dụng, bảy gói tin này sẽ bao gồm một thông báo Xóa.
Các gói tin ban đầu này được gửi bảy lần do tính chất không đáng tin cậy của các gói tin UDP. Trong trường hợp hiếm hoi, cả bảy gói tin đều gặp sự cố, dịch vụ vẫn sẽ được phát hiện sau một thời gian từ các thông báo Announce định kỳ một phút.
Nếu một nút nhận được tin nhắn Truy vấn cho một lớp dịch vụ mà nó đang quảng cáo, nút đó sẽ phản hồi bằng tin nhắn Thông báo sau một khoảng thời gian trễ ngẫu nhiên ngắn và đặt lại thời gian chờ Thông báo hiện tại.
Tiêu đề gói tin và tất cả các khối tin nhắn đều bao gồm các trường độ dài. Điều này mang lại sự linh hoạt hơn và cho phép thực hiện các thay đổi tương thích ngược trong tương lai. Các trường bổ sung hoặc loại tin nhắn có thể được thêm vào trong tương lai mà các triển khai cũ hơn có thể bỏ qua khi phân tích cú pháp. Nếu chúng ta quyết định thực hiện một thay đổi không tương thích ngược, cũng có một trường phiên bản trong tiêu đề gói tin có thể được tăng dần.
Giao thức này cũng cho phép các bản ghi TXT được đưa vào các quảng cáo dịch vụ tương tự như các bản ghi TXT được sử dụng
với mDNS. Điều này mang lại sự linh hoạt đáng kể cho việc bổ sung siêu dữ liệu tùy ý vào dịch vụ
quảng cáo mà không thay đổi giao thức.
Chi tiết giao thức
Thời gian
Tất cả các gói tin được gửi phải được lên lịch ngẫu nhiên hoặc trì hoãn để giúp tránh xung đột.
- Thời gian khởi động gói tin: 7 gói tin tại một thời điểm = [0, 1, 2, 3, 5, 7, 10 giây] + (0 đến 250ms ngẫu nhiên). Đây là thời gian tuyệt đối, không phải thời gian trễ. Cả 7 gói tin sẽ được gửi trong vòng khoảng 10 giây.
- Thời gian thông báo chính: 57 giây + (0 đến 6 giây ngẫu nhiên)
- Độ trễ phản hồi truy vấn: (0 đến 750ms ngẫu nhiên)
ID nút
Mỗi nút phải có một ID duy nhất, có thể được sử dụng để nhận dạng nút. ID duy nhất này được bao gồm trong các thông báo Thông báo và Xóa. Máy khách có thể sử dụng giá trị này làm khóa chính khi lưu trữ giá trị và để nhận dạng duy nhất một nút. ID duy nhất này có thể là địa chỉ MAC, nhưng phải giống nhau cho mỗi giao diện nếu một nút có nhiều giao diện mà nó đang quảng cáo.
Cấu trúc gói
Mỗi gói tin bắt đầu bằng một tiêu đề gói tin, theo sau là một số khối tin nhắn tùy ý. Mỗi khối tin nhắn bắt đầu bằng một trường độ dài để có thể bỏ qua các tin nhắn không được nhận dạng. Trừ khi có quy định khác, tất cả các giá trị số nhiều byte sẽ được lưu trữ theo kiểu big endian (byte có trọng số cao nhất được đặt trước). Trừ khi có quy định khác, tất cả các số đều là giá trị không dấu. Ví dụ:ampmột byte có thể có giá trị từ 0 đến 255.
Tiêu đề gói
| Cánh đồng | Byte | Sự miêu tả |
| Chiều dài | 1 | Tổng chiều dài của tiêu đề bao gồm cả trường này. |
| Từ ngữ kỳ diệu | 4 | Trường này sẽ là bốn byte ASCII của “LSDP”. Điều này giúp chúng tôi xác định các gói tin được sử dụng để không cần phải cố gắng phân tích dữ liệu ngẫu nhiên từ một nguồn không mong muốn. |
| Phiên bản giao thức | 1 | Phiên bản giao thức. Nếu có bất kỳ thay đổi nào trong tương lai đối với giao thức không tương thích ngược với phiên bản này |
| Cánh đồng | Byte Sự miêu tả | |
| sẽ được thay đổi. Phiên bản hiện tại là 1. | ||
Tin nhắn truy vấn
| Cánh đồng | ||
| Byte | Sự miêu tả | |
| Chiều dài | 1 | Tổng độ dài của tin nhắn bao gồm cả trường này. |
| Loại tin nhắn | 1 | “Q” = 0x51: Truy vấn tiêu chuẩn cho phản hồi phát sóng. “R” = 0x52: Truy vấn cho phản hồi đơn hướng. |
| Đếm | 1 | Số lượng lớp cần truy vấn. |
| Lớp 1 | 2 | Mã định danh lớp 16 bit (2 byte). |
| … | Lặp lại trường trước đó cho mỗi lớp bổ sung. | |
Thông báo tin nhắn
Tiêu đề thông báo
| Cánh đồng | ||
| Byte | Sự miêu tả | |
| Chiều dài | 1 | Tổng độ dài của tin nhắn bao gồm tiêu đề thông báo đầy đủ và bản ghi thông báo. |
| Loại tin nhắn | 1 | “A” = 0x41 |
| Độ dài ID nút | 1 | Độ dài của trường ID nút. |
| ID nút | Biến đổi | ID nút duy nhất của nút gửi thông báo. Thông thường, đây là địa chỉ MAC của một trong các giao diện nút. |
| Độ dài địa chỉ | 1 | Độ dài của trường Địa chỉ. Đối với IPv4, độ dài này là 4. |
| Cánh đồng | ||
| Byte | Sự miêu tả | |
| Địa chỉ | Biến đổi | Địa chỉ IP của nút. |
| Đếm | 1 | Số lượng hồ sơ thông báo cần theo dõi. |
Thông báo kỷ lục
| Cánh đồng | Byte | Sự miêu tả |
| Lớp học | 2 | Mã định danh lớp 16 bit (2 byte). |
|
Số lượng TXT |
1 |
Số lượng bản ghi TXT cần theo dõi. Nếu bằng 0, các trường sau sẽ bị bỏ qua. |
| Khóa 1 Độ dài | 1 | Độ dài của tên khóa. |
| Chìa khóa 1 | Biến đổi | Tên khóa. |
| Giá trị 1 Chiều dài | 1 | Độ dài của văn bản giá trị. |
| Giá trị 1 | Biến đổi | Văn bản giá trị. |
|
… |
Lặp lại 4 trường trước đó cho mỗi bản ghi TXT bổ sung. |
Xóa tin nhắn
| Cánh đồng | ||
| Byte | Sự miêu tả | |
| Chiều dài | 1 | Tổng độ dài của tin nhắn bao gồm cả trường này. |
| Loại tin nhắn | 1 | “D” = 0x44 |
| Độ dài ID nút | 1 | Độ dài của trường ID nút. |
| ID nút | Biến đổi | ID nút duy nhất của nút gửi tin nhắn. Thông thường, đây là địa chỉ MAC của một trong các nút. |
| Cánh đồng | ||
| Byte | Sự miêu tả | |
| các giao diện. | ||
| Đếm | 1 | Số lớp học tiếp theo. |
| Lớp 1 | 2 | Mã định danh lớp 16 bit (2 byte). |
| … | Lặp lại trường trước đó cho mỗi lớp bổ sung. | |
Bài tập ID lớp
| ID lớp | Sự miêu tả | Tương đương mDNS |
| 0x0001 | Trình phát BluOS | _musc._tcp |
| 0x0002 | Máy chủ BluOS | _muss._tcp |
| 0x0003 | BluOS Player (phụ trong các trình phát đa vùng như CI580) | _musp._tcp |
| 0x0004 | sovi-mfg được sử dụng để thử nghiệm sản xuất. | _sovi-mfg._tcp |
| 0x0005 | bàn phím sovi | _sovi-keypad._tcp |
| 0x0006 | BluOS Player (cặp slave) | _musz._tcp |
| 0x0007 | Xa Web Ứng dụng (AVR OSD Web Trang) | _xa-web-ui._tcp |
| 0x0008 | Trung tâm BluOS | _mush._tcp |
| 0xFFFF | Tất cả các lớp – Có thể sử dụng với Tin nhắn truy vấn. |
Lưu ý 1:
Toàn bộ gói LSDP cần được xử lý như dữ liệu nhị phân.
Lưu ý 2:
Nếu một Tin nhắn thông báo không thể chứa tất cả thông tin của các nút (đặc biệt là CI580), nó sẽ tách thành 2 hoặc nhiều Tin nhắn thông báo, trong đó mỗi Tin nhắn chứa Tiêu đề và Bản ghi và mỗi Tin nhắn chứa toàn bộ thông tin của nút.
API tích hợp tùy chỉnh BluOS phiên bản 1.7
Tài liệu / Tài nguyên
 |
API tích hợp tùy chỉnh BluOS T 778 [tập tin pdf] Hướng dẫn sử dụng T 778, T 778 API tích hợp tùy chỉnh, T 778, API tích hợp tùy chỉnh, API tích hợp, API |