API ការរួមបញ្ចូលផ្ទាល់ខ្លួន

T 778 Custom Integration API

ព័ត៌មានដែលមាននៅក្នុងសៀវភៅណែនាំនេះគឺជាទ្រព្យសម្បត្តិរបស់ Lenbrook Industries ។
វាត្រូវបានបម្រុងទុកសម្រាប់ការប្រើប្រាស់ប្រកបដោយវិជ្ជាជីវៈ។ Lenbrook Industries មិនទទួលខុសត្រូវចំពោះភាពត្រឹមត្រូវនៃពិធីការនោះទេ។ ពិធីការត្រូវបានផ្តល់ជូន "ដូចដែលនៅមាន" ជាមួយនឹងកំហុសទាំងអស់ និងដោយគ្មានការធានាគ្រប់ប្រភេទ ទាំងការបង្ហាញ ឬបង្កប់ន័យ។

គោលការណ៍ប្រើប្រាស់ API

តាមរយៈការចូលប្រើ APIs អ្នកយល់ព្រមនឹងគោលការណ៍ប្រើប្រាស់ API នេះ ("គោលការណ៍") និងលក្ខខណ្ឌរបស់យើង។ យើងផ្តល់ APIs ទាំងនេះ ដើម្បីអនុញ្ញាតឱ្យក្រុមហ៊ុន និងមនុស្សបង្កើត និងទទួលបានអត្ថប្រយោជន៍ពីសេវាកម្មរបស់យើង ដោយបង្កើតកម្មវិធី សេវាកម្ម ឬម៉ូឌុលដែលភ្ជាប់ទៅវេទិការបស់យើង ឬមានសិទ្ធិចូលប្រើទិន្នន័យនៅក្នុងវេទិការបស់យើងតាមរយៈ APIs របស់យើង (ជា "ការរួមបញ្ចូល")។ គោលការណ៍នេះគឺ ហើយនឹងត្រូវបានចាត់ទុកជាផ្នែកនៃលក្ខខណ្ឌរបស់យើង។
កម្មវិធីត្រូវបានផ្តល់ជូន “AS IS” ដោយគ្មានការធានាលើប្រភេទណាមួយ បង្ហាញ ឬបង្កប់ន័យ រួមទាំង ប៉ុន្តែមិនកំណត់ចំពោះការធានានៃភាពអាចធ្វើជំនួញ សម្បទាសម្រាប់គោលបំណងជាក់លាក់ និងមិនមានការរំលោភបំពាន។ គ្មានព្រឹត្តិការណ៍ណាមួយដែលអ្នកនិពន្ធ ឬអ្នករក្សាសិទ្ធិត្រូវទទួលខុសត្រូវចំពោះការទាមទារ ការខូចខាត ឬទំនួលខុសត្រូវផ្សេងទៀតទេ ទោះជានៅក្នុងសកម្មភាពនៃកិច្ចសន្យា ការធ្វើទារុណកម្ម ឬបើមិនដូច្នេះទេ ដែលកើតឡើងពី ចេញពី ឬពាក់ព័ន្ធនឹងកម្មវិធី ឬការប្រើប្រាស់ ឬការដោះស្រាយផ្សេងទៀតនៅក្នុងកម្មវិធី។
ការប្រើប្រាស់ដែលបានអនុញ្ញាត
អ្នកមិនអាចប្រើ API ដើម្បីផ្ញើសារឥតបានការ ឬធ្វើសកម្មភាពណាមួយដែលបំពានគោលការណ៍ប្រើប្រាស់ដែលអាចទទួលយកបានរបស់យើង និងលក្ខខណ្ឌប្រើប្រាស់ស្តង់ដាររបស់យើង។ អ្នកនឹងអនុវត្តតាមច្បាប់ដែលអាចអនុវត្តបានទាំងអស់ (រួមទាំងច្បាប់ឯកជនភាព និងច្បាប់គ្រប់គ្រងការនាំចេញរបស់សហរដ្ឋអាមេរិក GPR និងបទប្បញ្ញត្តិរបស់អឺរ៉ុប និងច្បាប់ និងបទប្បញ្ញត្តិទណ្ឌកម្មសេដ្ឋកិច្ច)។ អ្នកនឹងធ្វើតាមឯកសារទាំងអស់ដែលយើងផ្តល់សម្រាប់ APIs ។ អ្នក​នឹង​មិន​ព្យាយាម​ hack ឬ​ផ្លាស់​ប្តូរ​របៀប​ដែល​មុខងារ​របស់​សេវាកម្ម​នោះ​ទេ។ យើងអាចត្រួតពិនិត្យការប្រើប្រាស់ APIs របស់អ្នកសម្រាប់ការអនុលោមតាមច្បាប់ទាំងនេះ ហើយយើងអាចបដិសេធអ្នកចូលប្រើ API ប្រសិនបើអ្នកបំពានគោលការណ៍នេះ។
ឯកជនភាព
របស់អ្នក។ ការរួមបញ្ចូលត្រូវតែបង្ហាញគោលការណ៍ឯកជនភាពសម្រាប់អ្នកប្រើប្រាស់ដែលរៀបរាប់លម្អិតអំពីព័ត៌មានដែលអ្នកនឹងប្រមូលពីពួកគេនៅពេលពួកគេប្រើការរួមបញ្ចូល។ អ្នកនឹងចូលប្រើទិន្នន័យរបស់អ្នកប្រើក្នុងកម្រិតដែលអនុញ្ញាតដោយអ្នកប្រើប្រាស់ និងបានពន្យល់នៅក្នុងគោលការណ៍ឯកជនភាពរបស់អ្នក។ អ្នកត្រូវតែលុបទិន្នន័យរបស់អ្នកប្រើភ្លាមៗ ប្រសិនបើអ្នកប្រើស្នើសុំការលុប ឬបញ្ចប់គណនីរបស់ពួកគេជាមួយអ្នក។
សន្តិសុខ
អ្នកនឹងអនុវត្ត និងរក្សាវិធានការសុវត្ថិភាពបច្ចេកទេស និងស្ថាប័នសមស្រប ដើម្បីការពារ និងរក្សាសុវត្ថិភាព សុចរិតភាព និងសម្ងាត់នៃទិន្នន័យ។ វិធានការសុវត្ថិភាពទាំងនេះនឹងរារាំងការចូលប្រើដោយគ្មានការអនុញ្ញាត ឬការបង្ហាញទិន្នន័យផ្ទាល់ខ្លួន ឬសម្ងាត់ដែលអ្នកដំណើរការ។
កម្មសិទ្ធិ
យើងជាម្ចាស់សិទ្ធិ ចំណងជើង និងការចាប់អារម្មណ៍ទាំងអស់នៅក្នុងសេវាកម្ម និង APIs រួមទាំងសិទ្ធិកម្មសិទ្ធិបញ្ញា សញ្ញាសម្គាល់ កូដ និងលក្ខណៈពិសេសទាំងអស់។ អ្នកនឹងមិនបំពាន បញ្ច្រាសវិស្វករ ឬចម្លងកូដ ការរចនា ឬខ្លឹមសាររបស់យើងទេ។ អ្នកនឹងមិនចូលប្រើ APIs របស់យើងដើម្បីប្រកួតប្រជែងជាមួយសេវាកម្មរបស់យើងទេ។ សិទ្ធិទាំងឡាយណាដែលមិនត្រូវបានផ្តល់ដោយគោលការណ៍នេះ នឹងត្រូវបានរារាំង ដូច្នេះប្រសិនបើអ្នកមិនឃើញវានៅទីនេះទេ នោះវាមិនមែនជាសិទ្ធិទេដែលយើងកំពុងអនុញ្ញាត។
ការប្រើប្រាស់ម៉ាក
អ្នក​មិន​អាច​ប្រើ​ឈ្មោះ និង​សញ្ញា​សម្គាល់​របស់​យើង (មាន​ន័យ​ថា ឡូហ្គោ ម៉ាក និង​រូបភាព​រក្សាសិទ្ធិ​របស់​យើង) តាម​មធ្យោបាយ​ណា​មួយ​ឡើយ។ អ្នក​មិន​អាច​កែប្រែ ឬ​លុប​ការ​ជូន​ដំណឹង​ដែល​មាន​កម្មសិទ្ធិ​នៅ​ក្នុង​សញ្ញា​សម្គាល់​របស់​យើង​ឡើយ។ អ្នក​នឹង​មិន​ប្រើ​ឈ្មោះ​ឬ​សញ្ញា​សម្គាល់​របស់​យើង​នៅ​ក្នុង​ឈ្មោះ​សមាហរណកម្ម​ឬ​និមិត្តសញ្ញា​របស់​អ្នក​ឬ​នៅ​ក្នុង​វិធី​ណា​មួយ​ដែល​មាន​ន័យ​ថា​ការ​គាំទ្រ​ដោយ​យើង​។
ការប្រើប្រាស់សញ្ញាសម្គាល់ជាក់ស្តែង
គោលការណ៍ណែនាំទាំងនេះពន្យល់ពីរបៀបដែលអ្នកត្រូវតែអនុវត្តនូវឈ្មោះ សញ្ញាសម្គាល់ និងទ្រព្យសម្បត្តិម៉ាករបស់យើងគ្រប់ពេលវេលា។ ការប្រើប្រាស់របស់អ្នកបង្ហាញពីការយល់ព្រមរបស់អ្នកចំពោះគោលការណ៍ណែនាំទាំងនេះ ហើយអ្នកយល់ថាការប្រើប្រាស់របស់អ្នកក្នុងការបំពានគោលការណ៍ណែនាំទាំងនេះនឹងនាំឱ្យមានការបញ្ចប់ដោយស្វ័យប្រវត្តិនូវការអនុញ្ញាតរបស់អ្នកក្នុងការប្រើប្រាស់ឈ្មោះ សញ្ញាសម្គាល់ និងទ្រព្យសម្បត្តិម៉ាករបស់យើង។

• ការប្រើប្រាស់ឈ្មោះ សញ្ញាសម្គាល់ និងទ្រព្យសម្បត្តិម៉ាករបស់យើងត្រូវតែមានការអនុញ្ញាតជាលាយលក្ខណ៍អក្សរយ៉ាងច្បាស់។
• កុំផ្លាស់ប្តូរ កែប្រែ បង្ខូចទ្រង់ទ្រាយ ចម្លង ឬធ្វើត្រាប់តាមទ្រព្យសម្បត្តិម៉ាករបស់យើងតាមមធ្យោបាយណាមួយ រួមទាំងការផ្លាស់ប្តូរពណ៌ ការបង្វិល និង/ឬលាតសន្ធឹង។ ម្យ៉ាងវិញទៀត ទ្រព្យសម្បត្តិម៉ាករបស់យើងត្រូវតែរក្សាទុកក្នុងទម្រង់ដើមរបស់វា។
• កុំផ្តល់ឈ្មោះ សញ្ញាសម្គាល់ និងទ្រព្យសម្បត្តិម៉ាករបស់យើងឱ្យមានភាពលេចធ្លោហួសហេតុ បើប្រៀបធៀបទៅនឹងឈ្មោះ និងនិមិត្តសញ្ញារបស់អ្នក។
• កុំបង្ហាញឈ្មោះ សញ្ញាសម្គាល់ និងទ្រព្យសម្បត្តិម៉ាករបស់យើងនៅក្បែរ ឬក្នុងទម្រង់នៃទីផ្សារប្រកួតប្រជែងណាមួយ ដោយគ្មានការយល់ព្រមពីយើង។
• ការប្រើប្រាស់របស់អ្នកមិនត្រូវបំភាន់អ្នកប្រើប្រាស់ចំពោះការឧបត្ថម្ភ ភាពពាក់ព័ន្ធ ឬការគាំទ្រដល់ក្រុមហ៊ុនរបស់អ្នក ឬផលិតផល ឬសេវាកម្មរបស់អ្នក។
• ឈ្មោះ សញ្ញាសម្គាល់ និងទ្រព្យសម្បត្តិម៉ាករបស់យើង គឺជាកម្មសិទ្ធិផ្តាច់មុខរបស់យើង។ សុច្ឆន្ទៈទាំងអស់ដែលកើតចេញពីការប្រើប្រាស់របស់អ្នកនឹងជាផលប្រយោជន៍របស់យើងតែមួយគត់។ អ្នកនឹងមិនចាត់វិធានការណាមួយដែលផ្ទុយនឹងសិទ្ធិ ឬកម្មសិទ្ធិរបស់យើងឡើយ។
• ឈ្មោះ ស្លាកសញ្ញា និងទ្រព្យសម្បត្តិម៉ាករបស់យើងត្រូវតែប្រើប្រាស់ក្នុងលក្ខណៈដែលគួរឱ្យគោរព ហើយមិនអាចប្រើក្នុងវិធីដែលបង្កគ្រោះថ្នាក់ដល់យើង ផលិតផល ឬសេវាកម្មរបស់យើង ឬក្នុងលក្ខណៈដែលតាមគំនិតរបស់យើង កាត់បន្ថយ ឬបំផ្លាញកេរ្តិ៍ឈ្មោះរបស់យើង ឬសុច្ឆន្ទៈក្នុងនាម ម៉ាក និងទ្រព្យសម្បត្តិយីហោរបស់យើង។ ម្យ៉ាងវិញទៀត សូមកុំភ្ជាប់ទ្រព្យសម្បត្តិរបស់យើងជាមួយសកម្មភាពខុសច្បាប់ ឬខុសច្បាប់ ឬប្រើប្រាស់វាក្នុងមធ្យោបាយបោកប្រាស់ ឬបង្កគ្រោះថ្នាក់។

Exampការប្រើប្រាស់ដែលអាចទទួលយកបាន៖
"[ឈ្មោះផលិតផលរបស់អ្នក] (ត្រូវគ្នាជាមួយ / ដំណើរការជាមួយ BluOS)"
Examples នៃការប្រើប្រាស់មិនអាចទទួលយកបាន។
"[ឈ្មោះផលិតផលរបស់អ្នក] - BluOS"
“BluOS – [ឈ្មោះផលិតផលរបស់អ្នក]”
"[ឈ្មោះផលិតផលរបស់អ្នក] - ដំណើរការដោយ BluOS"
ទីផ្សារ និងសេចក្តីប្រកាសព័ត៌មាន
បន្ទាប់ពីពាក្យសុំរបស់អ្នកត្រូវបានអនុម័ត វាអាចត្រូវបានចុះបញ្ជីនៅលើរបស់យើង។ web លក្ខណៈសម្បត្តិ។ ជាទូទៅ យើងនឹងមិនសហការផ្សព្វផ្សាយសេចក្តីប្រកាសព័ត៌មាន ឬរួមចំណែកដល់ការធ្វើទីផ្សាររួមគ្នានៃកម្មវិធីរបស់អ្នកទេ។
មុនពេលអ្នកចែកចាយសេចក្តីប្រកាសព័ត៌មានអំពីកម្មវិធីរបស់អ្នក សូមប្រាកដថាអ្នកទាក់ទងមកពួកយើងតាមរយៈ [EMAIL]។ ប្រសិនបើអ្នកនឹងនិយាយអំពី BluOS នោះយើងនឹងត្រូវការម្តងទៀតview ការចេញផ្សាយ។ យើងសូមណែនាំឱ្យទាក់ទងជាមួយសេចក្តីប្រកាសព័ត៌មានចុងក្រោយរបស់អ្នកឱ្យបានឆាប់តាមដែលអាចធ្វើទៅបាន។
ការបដិសេធ
ដល់វិសាលភាពអតិបរមាដែលច្បាប់អនុញ្ញាត យើងផ្តល់ APIs ដូចមាន។ នោះមានន័យថាយើងមិនផ្តល់ការធានាគ្រប់ប្រភេទ ទាំងការបង្ហាញ ឬដោយបង្កប់ន័យ រួមទាំង ប៉ុន្តែមិនកំណត់ចំពោះភាពអាចធ្វើជំនួញ និងសម្បទាសម្រាប់គោលបំណងជាក់លាក់ណាមួយឡើយ។
បច្ចុប្បន្នភាព
យើងអាចធ្វើបច្ចុប្បន្នភាព ឬកែប្រែ APIs និងគោលការណ៍នេះពីពេលមួយទៅពេលមួយដោយប្រកាសការផ្លាស់ប្តូរនៅលើគេហទំព័រនេះ ឬជូនដំណឹងដល់អ្នកតាមរយៈអ៊ីមែល។ ការផ្លាស់ប្តូរទាំងនេះអាចប៉ះពាល់ដល់ការប្រើប្រាស់ API របស់អ្នក ឬវិធីដែលការរួមបញ្ចូលរបស់អ្នកធ្វើអន្តរកម្មជាមួយ API ។ ប្រសិនបើយើងធ្វើការផ្លាស់ប្តូរដែលមិនអាចទទួលយកបានសម្រាប់អ្នក អ្នកគួរតែឈប់ប្រើ APIs។
ការសម្ងាត់
អ្នកអាចមានសិទ្ធិចូលប្រើព័ត៌មានសម្ងាត់ កម្មសិទ្ធិ និងមិនមែនសាធារណៈជាក់លាក់ចំពោះ APIs ("ព័ត៌មានសម្ងាត់")។ អ្នកអាចប្រើព័ត៌មាននេះសម្រាប់តែបង្កើតជាមួយ APIs ប៉ុណ្ណោះ។ អ្នកនឹងមិនបង្ហាញព័ត៌មានសម្ងាត់ដល់នរណាម្នាក់ដោយគ្មានការយល់ព្រមជាលាយលក្ខណ៍អក្សររបស់យើងទេ ហើយអ្នកនឹងការពារព័ត៌មានសម្ងាត់ពីការប្រើប្រាស់ និងការលាតត្រដាងដោយគ្មានការអនុញ្ញាត តាមរបៀបដូចគ្នាដែលអ្នកនឹងការពារព័ត៌មានសម្ងាត់ផ្ទាល់ខ្លួនរបស់អ្នក។
សំណង
អ្នកនឹងផ្តល់សំណង និងរក្សាពួកយើង និងក្រុមរបស់យើងដោយមិនបង្កគ្រោះថ្នាក់ពីការខាតបង់ណាមួយ (រួមទាំងថ្លៃមេធាវី) ដែលបណ្តាលមកពីការទាមទាររបស់ភាគីទីបីដែលទាក់ទងនឹងការប្រើប្រាស់ API របស់អ្នក។
សល់
គោលការណ៍នេះមិនបង្កើត ឬបង្កប់ន័យភាពជាដៃគូ ទីភ្នាក់ងារ ឬការបណ្តាក់ទុនរួមគ្នាណាមួយឡើយ។ គោលការណ៍នេះនឹងអនុវត្តសម្រាប់ដរាបណាអ្នកប្រើ APIs ឬរហូតដល់ត្រូវបានបញ្ចប់ដោយអនុលោមតាមលក្ខខណ្ឌរបស់យើង។ ក្នុងករណីមានជម្លោះរវាងគោលការណ៍នេះ និងលក្ខខណ្ឌប្រើប្រាស់ស្តង់ដារ លក្ខខណ្ឌប្រើប្រាស់ស្តង់ដារត្រូវគ្រប់គ្រង។
© 2025 LENBROOK INDUSTRIES LIMITED
633 Granite Court, Pickering, Ontario, Canada L1W 3K1
រក្សាសិទ្ធិគ្រប់យ៉ាង
គ្មានផ្នែកណាមួយនៃការបោះពុម្ពផ្សាយនេះអាចត្រូវបានផលិតឡើងវិញ រក្សាទុក ឬបញ្ជូនតាមទម្រង់ណាមួយដោយគ្មានការអនុញ្ញាតជាលាយលក្ខណ៍អក្សរពី Lenbrook Industries Limited ឡើយ។ ខណៈពេលដែលរាល់ការខិតខំប្រឹងប្រែងត្រូវបានធ្វើឡើងដើម្បីធានាថាខ្លឹមសារមានភាពត្រឹមត្រូវនៅពេលបោះពុម្ព លក្ខណៈពិសេស និងលក្ខណៈជាក់លាក់អាចនឹងមានការផ្លាស់ប្តូរដោយគ្មានការជូនដំណឹងជាមុន។

ប្រវត្តិកែប្រែ
កំណែ	កាលបរិច្ឆេទ	ការពិពណ៌នា
1.0	១០/១០/២០២៣	ការចេញផ្សាយដំបូង
1.2	១០/១០/២០២៣	បានបន្ថែមការចាប់ផ្ដើមឡើងវិញទន់ កណ្ដឹងទ្វារ កម្រិតសំឡេងឡើង/ចុះ ផ្លាស់ទីបទជាជួរ និងពាក្យបញ្ជាបញ្ចូលដោយផ្ទាល់។ បានបន្ថែមកំណត់ចំណាំទៅឧបសម្ព័ន្ធ LSDP ។
1.4	១០/១០/២០២៣	បានបន្ថែមពាក្យបញ្ជាបិទ; កែប្រែពាក្យបញ្ជាបញ្ចូលដោយផ្ទាល់សម្រាប់ HUB; បានធ្វើបច្ចុប្បន្នភាពពាក្យបញ្ជា Play ដើម្បីចាក់អូឌីយ៉ូផ្ទាល់ខ្លួនដែលបានចាក់ផ្សាយ។
1.5	១០/១០/២០២៣	បានបន្ថែមពាក្យបញ្ជាប៊្លូធូស; បានធ្វើបច្ចុប្បន្នភាព LSDP ដើម្បីបន្ថែមថ្នាក់ 5 ទៅ 8; បានបន្ថែម "ការប្រើប្រាស់ជាក់ស្តែងនៃម៉ាក" នៅក្នុងគោលការណ៍ប្រើប្រាស់ API ។
1.6	១០/១០/២០២៣	បានបន្ថែមកំណត់សម្គាល់សម្រាប់ / ស្ថានភាពសម្រាប់អ្នកលេងជាក្រុមនៅក្នុងផ្នែកទី 2; បន្ថែម /Play?seek=seconds គឺ=trackid ក្នុង sect 4.1;
1.7	១០/១០/២០២៣	បានធ្វើបច្ចុប្បន្នភាពផ្នែក 8.3 ឧampឡេ; បានបន្ថែមសំណើរុករកម៉ឺនុយបរិបទក្នុងបន្ទាត់ ឧample នៅក្នុងផ្នែក 7.1; បានបន្ថែមពាក្យបញ្ជាការជ្រើសរើសការបញ្ចូលដោយផ្ទាល់ថ្មីនៅក្នុងផ្នែក 11.2; បានធ្វើបច្ចុប្បន្នភាពផ្នែក 6.1 ដើម្បីបន្ថែមគុណលក្ខណៈ "រូបភាព" សម្រាប់ការកំណត់ជាមុន។ បានបន្ថែម "followRedirects=1" មតិយោបល់សម្រាប់គុណលក្ខណៈរូបភាពទាំងអស់; បានធ្វើបច្ចុប្បន្នភាពការពន្យល់នៃការលេងគុណលក្ខណៈURL ហើយបន្ថែមឥឡូវនេះនៅក្នុងផ្នែក 7.1

សេចក្តីផ្តើម

BluOS™ គឺជាប្រព័ន្ធប្រតិបត្តិការកម្រិតខ្ពស់ និងកម្មវិធីគ្រប់គ្រងតន្ត្រីដែលអនុញ្ញាតឱ្យអ្នកចូលប្រើ និងចាក់តន្ត្រីគ្មានការបាត់បង់រហូតដល់ 24-bit/192kHz ទៅកាន់គ្រប់បន្ទប់ដោយប្រើបណ្តាញផ្ទះរបស់អ្នក។ BluOS អាចត្រូវបានរកឃើញនៅក្នុងផលិតផលពី Bluesound, NAD Electronics, DALI Loudspeakers និងផ្សេងទៀត។
ឯកសារនេះត្រូវបានបង្កើតឡើងដើម្បីជួយអ្នកអភិវឌ្ឍន៍ និងអ្នករួមបញ្ចូលប្រព័ន្ធដែលកំពុងធ្វើការនៅក្នុងទីផ្សារសមាហរណកម្មផ្ទាល់ខ្លួន (CI) ។ វាមានសំណុំរងនៃសំណើ API ដែលបានចងក្រងជាឯកសារនៅក្នុង BluOS API Control Protocol ពេញលេញ។
សំណើទាំងអស់ដែលបានពិពណ៌នានៅក្នុងឯកសារនេះត្រូវបានផ្ញើជាសំណើ HTTP GET។ ប៉ារ៉ាម៉ែត្រគឺជាស្តង់ដារ URL ឈ្មោះដែលបានអ៊ិនកូដ / គូតម្លៃ។ អ្នកលេង BluOS ទទួលបានពាក្យបញ្ជាទាំងនេះ ហើយបន្ទាប់មកឆ្លើយតបជាមួយនឹងទិន្នន័យ XML ដែលបានអ៊ិនកូដ UTF-8 ។
សំណើទាំងអស់មានទម្រង់ http:// : / កន្លែងណា៖

• player_ip គឺជាអាសយដ្ឋាន IP របស់អ្នកលេង BluOS (ឧ. 192.168.1.100)
• ច្រក គឺជាច្រក TC ដែលប្រើសម្រាប់ទំនាក់ទំនង។ ច្រក 11000 ត្រូវបានប្រើសម្រាប់អ្នកលេង BluOS ទាំងអស់ លើកលែងតែ CI580 ។ CI580 មានថ្នាំងស្ទ្រីមចំនួនបួនក្នុងតួមួយ ដែលថ្នាំង 1 ប្រើច្រក 11000 ថ្នាំង 2 ប្រើច្រក 11010 ថ្នាំង 3 ប្រើច្រក 11020 និងថ្នាំង 4 ប្រើច្រក 11030 ។ ច្រកពិតប្រាកដដែលត្រូវប្រើគួរតែត្រូវបានរកឃើញដោយការប្រើប្រាស់ពិធីការ MDNS ដោយប្រើសេវាកម្ម និង muscp.t.
• សំណើគឺជាពាក្យបញ្ជា BluOS ពិតប្រាកដ ឬសំណួរ (ឧ. លេង)

ចំណាំ៖ ឯកសារនេះនឹងប្រើប្រាស់ http://192.168.1.100:11000 ក្នុងនាមជាអ្នកលេង IP និងច្រកនៅក្នុង examples ។

សំណួរស្ថានភាព

សំណួរស្ថានភាពត្រូវបានប្រើដើម្បីសួរអ្នកលេង BluOS ។
BluOS ផ្តល់យន្តការពីរសម្រាប់ធ្វើសំណួរស្ថានភាព។ ការ​បោះឆ្នោត​ទៀងទាត់ និង​ការ​បោះឆ្នោត​រយៈពេល​វែង។ ការស្ទង់មតិទៀងទាត់ ត្រឡប់លទ្ធផលសំណួរភ្លាមៗ។ ការស្ទង់មតិដ៏វែងរក្សាការតភ្ជាប់សម្រាប់រយៈពេលជាក់លាក់មួយ ហើយបង្ហាញលទ្ធផលសំណួរនៅពេលដែលព័ត៌មានបានផ្លាស់ប្តូរ ឬអស់ពេល។ ការស្ទង់មតិរយៈពេលវែងអាចកាត់បន្ថយចំនួននៃការហៅទូរស័ព្ទទៅកាន់អ្នកលេងយ៉ាងច្រើន។
នៅពេលដែលការបោះឆ្នោតយូរមិនត្រូវបានគេប្រើប្រាស់ នោះអតិថិជនគួរតែដាក់កម្រិតអត្រាបោះឆ្នោតរបស់ពួកគេទៅនឹងសំណើមួយដងរៀងរាល់ 30 វិនាទី។ នៅពេលដែលការស្ទង់មតិរយៈពេលយូរត្រូវបានប្រើប្រាស់ នោះអតិថិជនមិនត្រូវធ្វើការស្នើសុំពីរជាប់គ្នាសម្រាប់ធនធានដូចគ្នាតិចជាងមួយវិនាទីដាច់ពីគ្នានោះទេ បើទោះបីជាសំណើដំបូងត្រឡប់មកវិញក្នុងរយៈពេលតិចជាងមួយវិនាទីក៏ដោយ។
សំណើ​បោះ​ឆ្នោត​វែង​មាន​ប៉ារ៉ាម៉ែត្រ​ពីរ៖ អស់​ពេល និង etag. អស់ពេលគឺជារយៈពេលនៃសំណើបោះឆ្នោតវែង និង etag ត្រូវបានយកចេញពីការឆ្លើយតបពីមុន (គុណលក្ខណៈនៅក្នុងធាតុឫសនៃការឆ្លើយតប) ។
ជាទូទៅ វាគ្រាន់តែជាការចាំបាច់ដើម្បីឱ្យមានការស្ទង់មតិរយៈពេលវែងសកម្មសម្រាប់ / ស្ថានភាព ឬ / SyncStatus មួយ។ ការឆ្លើយតប /ស្ថានភាពរួមមានធាតុមួយ ( ) ដែលបង្ហាញថាតើ /SyncStatus បានផ្លាស់ប្តូរឬអត់។ /SyncStatus គួរតែត្រូវបានស្ទង់មតិ ប្រសិនបើមានតែឈ្មោះ កម្រិតសំឡេង និងស្ថានភាពក្រុមរបស់អ្នកលេងដែលចាប់អារម្មណ៍។ /ស្ថានភាពគួរតែត្រូវបានស្ទង់មតិ ប្រសិនបើស្ថានភាពចាក់សារថ្មីបច្ចុប្បន្នត្រូវការ។
នៅពេលដែលអ្នកលេងត្រូវបានដាក់ជាក្រុម អ្នកលេងចម្បងគឺជាអ្នកលេងសំខាន់នៅក្នុងក្រុម។ អ្នកលេងបន្ទាប់បន្សំត្រូវបានភ្ជាប់ទៅនឹងអ្នកលេងបឋម។ ការឆ្លើយតប /ស្ថានភាពរបស់អ្នកលេងបន្ទាប់បន្សំ គឺជាច្បាប់ចម្លងនៃអ្នកលេងចម្បង។ ការស្ទង់មតិរយៈពេលយូរ /SyncStatus គឺចាំបាច់ដើម្បីតាមដានកម្រិតសំឡេងរបស់អ្នកលេងបន្ទាប់បន្សំនីមួយៗ។
2.1 ស្ថានភាពចាក់សារថ្មី។
ការពិពណ៌នា
សំណួរ/ចំណុចបញ្ចប់ស្ថានភាព កម្រិតសំឡេង និងព័ត៌មានចាក់សារថ្មី។ សំណួរនេះត្រឡប់គុណលក្ខណៈឆ្លើយតបជាច្រើន,
ដែលមួយចំនួនមិនអាចអនុវត្តបានចំពោះឯកសារនេះ។ ការឆ្លើយតបដែលមិនមានឯកសារគួរតែត្រូវបានមិនអើពើ។
ស្នើសុំ
/ស្ថានភាព?timeout=វិនាទី&etag=etag- តម្លៃ

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
អស់ពេល	ប៉ារ៉ាម៉ែត្រស្រេចចិត្តប្រើជាមួយការបោះឆ្នោតវែង។ ចន្លោះពេលបោះឆ្នោតដែលបានណែនាំគឺ 100 វិនាទី ហើយគួរត្រូវបានកំណត់ត្រឹមអត្រា 60 វិនាទី ឬច្រើនជាងនេះ ហើយកុំលឿនជាង 10 វិនាទី។
etag	ប៉ារ៉ាម៉ែត្រស្រេចចិត្តប្រើជាមួយការបោះឆ្នោតវែង។ នេះគឺជា អ៊ីtag គុណលក្ខណៈពី

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
	ការឆ្លើយតបការហៅទូរស័ព្ទពីមុន / ស្ថានភាព។

ការឆ្លើយតប
<status etag=”4e266c9fbfba6d13d1a4d6ff4bd2e1e6″>
÷ (ប្រណីត)
លោក Ed Sheeran
ពិត
១
១៥៩
Deezer: 142986206
/Artwork?service=Deezer&songid=Deezer%3A142986206
0
១៨៧
១
ល្អឥតខ្ចោះ
១០៥៤
0
320000
២
Deezer
/Sources/images/DeezerIcon.png
0
៨

១៩
ផ្អាក
MP3 320 kb/s
៥
ល្អឥតខ្ចោះ
លោក Ed Sheeran
÷ (ប្រណីត)
២៦៣
៤
៣៥

ចំណាំ៖ មិនមែនគ្រប់លក្ខណៈឆ្លើយតបទាំងអស់ត្រូវបានរាយក្នុងតារាងខាងក្រោមទេ។ ធាតុផ្សេងទៀតអាចមានវត្តមាន ហើយគួរតែត្រូវបានគេមិនអើពើ។

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
etag	គុណលក្ខណៈនៃធាតុឫសឆ្លើយតប។ តម្លៃស្រអាប់ដែលប្រើជាមួយការបោះឆ្នោតរយៈពេលវែង ដើម្បីរកមើលការផ្លាស់ប្តូរការឆ្លើយតប ប្រសិនបើតម្លៃមិនបានផ្លាស់ប្តូរចាប់តាំងពីការឆ្លើយតបពីមុន នោះការឆ្លើយតបត្រូវបានធានាថាមិនមានការផ្លាស់ប្តូរទេ (ប៉ុន្តែសូមមើលផងដែរនូវវិនាទីខាងក្រោម)
នៅសល់វិនាទីនៃការជូនដំណឹង	ប្រសិនបើការចាក់សារថ្មីជាលទ្ធផលនៃសំឡេងរោទិ៍ នោះគឺជារយៈពេលប៉ុន្មានវិនាទីមុនពេលវានឹងឈប់។
សកម្មភាព	សូម​មើល​សកម្មភាព​សម្រាប់​ការ​ផ្សាយ​ស្ថានីយ​វិទ្យុ​សម្រាប់​ការ​ពណ៌នា។
អាល់ប៊ុម	ឈ្មោះអាល់ប៊ុមនៃបទសកម្មបច្ចុប្បន្ន។ សូមមើលគុណលក្ខណៈ title1 ផងដែរ។
សិល្បករ	ឈ្មោះសិល្បករនៃបទសកម្មបច្ចុប្បន្ន។ សូមមើលគុណលក្ខណៈ title1 ផងដែរ។
ថ្ម	បង្ហាញថាតើអ្នកលេងមានកញ្ចប់ថ្ម។ រួមបញ្ចូលគុណលក្ខណៈ៖ · កម្រិត - ស្ថានភាពនៃបន្ទុក, ភាគរយ · ការសាកថ្ម - 1 ប្រសិនបើកំពុងសាកថ្ម · រូបតំណាង URL រូបភាពអ្នកលេងដែលបង្ហាញពីស្ថានភាពបន្ទុកបច្ចុប្បន្ន
canMovePlayback	ជាការពិតប្រសិនបើវាអាចផ្លាស់ទីមាតិកាដែលកំពុងចាក់ឬផ្អាកទៅអ្នកលេងផ្សេងទៀត។
អាចស្វែងរក	ប្រសិនបើ 1 នោះ​វា​អាច​កាត់​តាម​បទ​បច្ចុប្បន្ន​ក្នុង​ជួរ 0..totlen ដោយ​ប្រើ​ប៉ារ៉ាម៉ែត្រ​ស្វែងរក​ទៅ /Play ។ សម្រាប់អតីតample: /Play?seek=34 ។
db	កម្រិតសំឡេងក្នុង dB ។
ឈ្មោះក្រុម	ឈ្មោះក្រុម។ អ្នកលេងត្រូវតែជាអ្នកលេងចម្បងនៅក្នុងក្រុម។
បរិមាណក្រុម	កម្រិតសំឡេងនៃក្រុម។ អ្នកលេងត្រូវតែជាអ្នកលេងចម្បងនៅក្នុងក្រុម។
រូបភាព	URL នៃរូបភាពដែលភ្ជាប់ជាមួយអូឌីយ៉ូបច្ចុប្បន្ន (អាល់ប៊ុម ស្ថានីយ៍ បញ្ចូល។ល។)។ ប្រសិនបើ

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
	នេះ។ URL ចាប់ផ្តើមជាមួយ / Artwork វាអាចបណ្តាលឱ្យមានការប្តូរទិស។ ការបន្ថែមប៉ារ៉ាម៉ែត្រ/សោ followRedirects=1 នៅពេលទាញយករូបភាពអាចជៀសវាងការបញ្ជូនបន្ត។
ស្ងាត់	បិទស្ថានភាព។ កំណត់ទៅ 1 ប្រសិនបើកម្រិតសំឡេងត្រូវបានបិទ។
muteDb	ប្រសិន​បើ​អ្នក​លេង​ត្រូវ​បាន​បិទ​សំឡេង នោះ​វា​មាន​កម្រិត​សំឡេង​ដែល​មិន​បាន​បិទ​ជា dB ។
បិទសំឡេង	ប្រសិនបើវាត្រូវបានបិទ នោះវាមានកម្រិតសំឡេងដែលមិនបានបិទ។ តម្លៃគឺពី 0 ទៅ 100 ។
ឈ្មោះ	ចំណងជើងនៃបទអូឌីយ៉ូដែលកំពុងចាក់បច្ចុប្បន្ន។ សូមមើលគុណលក្ខណៈ title1 ផងដែរ។
ជូនដំណឹង។url	URL សម្រាប់ការជូនដំណឹងលេចឡើង។
id	លេខសម្គាល់ជួរលេងតែមួយគត់។ វាត្រូវគ្នានឹងគុណលក្ខណៈលេខសម្គាល់នៃការឆ្លើយតប /Playlist ។ ប្រសិនបើជួរលេងត្រូវបានផ្លាស់ប្តូរ លេខនេះនឹងផ្លាស់ប្តូរ។
បំបាត់	លេខសម្គាល់កំណត់ជាមុនតែមួយគត់។ វាត្រូវគ្នានឹងគុណលក្ខណៈ Prid នៅក្នុងការឆ្លើយតប /Presets។ ប្រសិនបើការកំណត់ជាមុនត្រូវបានផ្លាស់ប្តូរ លេខនេះនឹងផ្លាស់ប្តូរដែលបង្ហាញថាការឆ្លើយតបក្នុងឃ្លាំងសម្ងាត់ណាមួយចំពោះ / ការកំណត់ជាមុនគួរតែត្រូវបានសម្អាត។
គុណភាព	គុណភាព​នៃ​ការ​ចាក់​អូឌីយ៉ូ​ប្រភព៖ · ស៊ីឌី - អូឌីយ៉ូមិនបាត់បង់នៅគុណភាពស៊ីឌី · hd - អូឌីយ៉ូមិនបាត់បង់ជាមួយនឹងគុណភាពបង្ហាញខ្ពស់ដែលគុណភាពស៊ីឌីឬ sampអត្រា 88200 samples/s ឬច្រើនជាងនេះ។ · DolbyAudio - DolbyDigital ឬ AC3 · mqa - សំឡេង MQA ត្រឹមត្រូវ។ · mqaAuthored – ត្រឹមត្រូវ MQA-Authored audio decoded តម្លៃជាលេខគឺជាអត្រាប៊ីតប្រហាក់ប្រហែលនៃគុណភាពប្រភពអូឌីយ៉ូដែលបានបង្ហាប់ file.
ធ្វើម្តងទៀត	0, 1, ឬ 2. 0 មាន​ន័យ​ថា​ការ​ចាក់​ជួរ​ម្តង​ទៀត, 1 មាន​ន័យ​ថា​ធ្វើ​ឡើង​វិញ​មួយ​បទ, និង 2 មាន​ន័យ​ថា​ចាក់​ឡើងវិញ​បិទ
វិនាទី	ចំនួនវិនាទីដែលបទអូឌីយ៉ូបច្ចុប្បន្នត្រូវបានចាក់។ តម្លៃនេះមិនត្រូវបានប្រើក្នុងការគណនា etag ហើយការវិវឌ្ឍនឹងមិនបណ្តាលឱ្យមានការត្រឡប់មកវិញពីការហៅបោះឆ្នោតដ៏យូរនោះទេ។ អតិថិជនត្រូវបានតម្រូវឱ្យបង្កើនទីតាំងចាក់សារឡើងវិញ នៅពេលដែលស្ថានភាពកំពុងចាក់ ឬស្ទ្រីម ដោយផ្អែកលើចន្លោះពេលចាប់តាំងពីការឆ្លើយតប។
សេវាកម្ម	លេខសម្គាល់សេវាកម្មនៃអូឌីយ៉ូបច្ចុប្បន្ន។ នេះ​មិន​មែន​ជា​តម្លៃ​សម្រាប់​ការ​បង្ហាញ​ក្នុង UI ដូច​ជា​

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
	ខ្សែអក្សរពិតប្រាកដអាចខុសគ្នាពីឈ្មោះសេវាកម្មផ្លូវការ។
រូបតំណាងសេវាកម្ម	URL នៃរូបតំណាងសេវាកម្មបច្ចុប្បន្ន។
សាប់	0 ឬ 1. 0 មានន័យថាសាប់បិទ ហើយ 1 មានន័យថាសាប់នៅលើ។
គេង	នាទីដែលនៅសេសសល់មុនពេលកម្មវិធីកំណត់ម៉ោងគេងសកម្ម។
ចម្រៀង	ទីតាំងនៃបទបច្ចុប្បន្ននៅក្នុងជួរចាក់។ សូមមើលស្ទ្រីមផងដែរ។Url.
រដ្ឋ	ស្ថានភាពអ្នកលេងបច្ចុប្បន្ន។ វាអាចជាការលេង ផ្អាក បញ្ឈប់ ស្ទ្រីម ការតភ្ជាប់។ល។ /Play អាច​ត្រូវ​បាន​ប្រើ​ដើម្បី​បន្ត​នៅ​ពេល​ដែល​ស្ថិត​ក្នុង​ស្ថានភាព​ផ្អាក ប៉ុន្តែ​មិន​មែន​នៅ​ពេល​ដែល​ស្ថិត​ក្នុង​ស្ថានភាព​បញ្ឈប់​។ ការលេង និងស្ទ្រីមគួរតែត្រូវបានចាត់ទុកថាមានអត្ថន័យដូចគ្នា។ សូមមើលស្ទ្រីមផងដែរ។Url.
រូបភាពស្ថានីយ៍	URL សម្រាប់រូបភាពនៃស្ថានីយ៍វិទ្យុ ប្រសិនបើអូឌីយ៉ូបច្ចុប្បន្នជាស្ថានីយ៍វិទ្យុ ឧទាហរណ៍ វិទ្យុ Deezer ។ វាអាចដូចគ្នានឹងរូបភាព។
ទម្រង់ស្ទ្រីម	ទម្រង់អូឌីយ៉ូ។
ស្ទ្រីមUrl	វត្តមានរបស់ធាតុនេះគួរតែត្រូវបានចាត់ទុកជាទង់ជាតិ និងមាតិការបស់វាជាតម្លៃស្រអាប់។ ប្រសិនបើមានវត្តមានវាបង្ហាញថា: · ជួរលេងមិនមែនជាប្រភពនៃអូឌីយ៉ូបច្ចុប្បន្នទេ (បទចម្រៀងមិនពាក់ព័ន្ធ) · ការសាប់ និងធ្វើម្តងទៀតមិនពាក់ព័ន្ធទេ ហើយគួរតែត្រូវបានដកចេញពី UI ណាមួយប្រសិនបើអាចធ្វើទៅបាន ·បន្ទាប់និងមុនមិនមានទេ (ប៉ុន្តែសូមមើលផងដែរនូវសកម្មភាព)
syncStat	លេខសម្គាល់តែមួយគត់ដើម្បីបង្ហាញពីការផ្លាស់ប្តូរណាមួយនៅក្នុងការឆ្លើយតប /SyncStatus ។ វាត្រូវគ្នានឹងគុណលក្ខណៈ syncStat នៃការឆ្លើយតប /SyncStatus ។ វាផ្លាស់ប្តូរនៅពេលណាដែលមានការផ្លាស់ប្តូរនៅក្នុងស្ថានភាពសមកាលកម្ម។
ចំណងជើង 1	ខ្សែទីមួយនៃព័ត៌មានដែលពិពណ៌នាអំពីអូឌីយ៉ូបច្ចុប្បន្ន។ ចំណងជើង 1 ចំណងជើង 2 និងចំណងជើង 3 ត្រូវតែប្រើជាអត្ថបទនៃ UI ណាមួយដែលបង្ហាញបីបន្ទាត់នៃទិន្នន័យមេតាដែលកំពុងលេងឥឡូវនេះ។ កុំប្រើតម្លៃដូចជាអាល់ប៊ុម សិល្បករ និងឈ្មោះ។
ចំណងជើង 2	ខ្សែទីពីរនៃព័ត៌មានពណ៌នាអំពីអូឌីយ៉ូបច្ចុប្បន្ន។
ចំណងជើង 3	ខ្សែទី 3 នៃព័ត៌មានដែលពិពណ៌នាអំពីអូឌីយ៉ូបច្ចុប្បន្ន។
totlen	ប្រវែងសរុបនៃបទបច្ចុប្បន្នគិតជាវិនាទី។
twoline_title1	បន្ទាត់ទីមួយនៃពីរដែលពិពណ៌នាអំពីអូឌីយ៉ូបច្ចុប្បន្ន។ twoline_title1 & twoline_title2 ប្រសិនបើមានវត្តមាន ត្រូវតែប្រើជាអត្ថបទនៃ UI ណាមួយដែលបង្ហាញពីរ

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
	បន្ទាត់នៃទិន្នន័យមេតាដែលកំពុងលេងឥឡូវនេះ។
twoline_title2	ខ្សែទីពីរនៃពីរដែលពិពណ៌នាអំពីអូឌីយ៉ូបច្ចុប្បន្ន។
កម្រិតសំឡេង	កម្រិតសំឡេងអ្នកលេងគិតជាភាគរយtagអ៊ី; -1 មានន័យថាបរិមាណអ្នកលេងថេរ។
វិនាទី	ចំនួនវិនាទីដែលបទអូឌីយ៉ូបច្ចុប្បន្នត្រូវបានចាក់។

Example
http://192.168.1.100:11000/Status
ទទួលបានស្ថានភាពចាក់សារថ្មីរបស់អ្នកលេង។
http://192.168.1.100:11000/Status?អស់ពេល=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
ទទួលបានស្ថានភាពចាក់សារថ្មីរបស់អ្នកលេងដោយប្រើការបោះឆ្នោតរយៈពេលវែង។ លទ្ធផល​មួយ​ត្រូវ​បាន​ត្រឡប់​មុន​ពេល​អស់​រយៈពេល 100 វិនាទី​ប៉ុណ្ណោះ​ប្រសិន​បើ​ស្ថានភាព​របស់​អ្នក​លេង​បាន​ផ្លាស់​ប្តូរ។ បើមិនដូច្នោះទេលទ្ធផលនឹងត្រលប់មកវិញបន្ទាប់ពី 100 វិនាទី។
2.2 ស្ថានភាពសមកាលកម្មអ្នកលេង និងក្រុម
ការពិពណ៌នា
សំណួរ SyncStatus ត្រឡប់ព័ត៌មានអ្នកលេង និងព័ត៌មានក្រុមអ្នកលេង។ សំណួរនេះត្រឡប់គុណលក្ខណៈឆ្លើយតបជាច្រើន ដែលមួយចំនួនមិនអនុវត្តចំពោះឯកសារនេះទេ។ ការឆ្លើយតបដែលមិនមានឯកសារគួរតែត្រូវបានមិនអើពើ។
ស្នើសុំ
/SyncStatus?timeout=seconds&etag=etag- តម្លៃ

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
អស់ពេល	ប៉ារ៉ាម៉ែត្រស្រេចចិត្តប្រើជាមួយការបោះឆ្នោតវែង។ វាជាចន្លោះពេលបោះឆ្នោតគិតជាវិនាទី។ ចន្លោះពេលបោះឆ្នោតដែលបានណែនាំគឺ 180 វិនាទី។
etag	ប៉ារ៉ាម៉ែត្រស្រេចចិត្តប្រើជាមួយការបោះឆ្នោតវែង។ នេះគឺជា អ៊ីtag គុណលក្ខណៈពីការឆ្លើយតបការហៅទូរសព្ទ / SyncStatus ពីមុន។

ការឆ្លើយតប
<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:78″> 192.168.1.100


....

ចំណាំ៖ មិនមែនគ្រប់លក្ខណៈឆ្លើយតបទាំងអស់ត្រូវបានរាយក្នុងតារាងខាងក្រោមទេ។ ធាតុផ្សេងទៀតអាចមានវត្តមាន ហើយគួរតែត្រូវបានគេមិនអើពើ។

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
ថ្ម	បង្ហាញថាតើអ្នកលេងមានកញ្ចប់ថ្ម។ រួមបញ្ចូលគុណលក្ខណៈ៖ · កម្រិត - ស្ថានភាពនៃបន្ទុក, ភាគរយ · ការសាកថ្ម - 1 ប្រសិនបើកំពុងសាកថ្ម · រូបតំណាង URL រូបភាពអ្នកលេងដែលបង្ហាញពីស្ថានភាពបន្ទុកបច្ចុប្បន្ន
ម៉ាក	ឈ្មោះម៉ាកអ្នកលេង។
db	កម្រិតសំឡេងក្នុង dB ។
etag	Tag នៃការឆ្លើយតប /SyncStatus ប្រើសម្រាប់ការស្ទង់មតិរយៈពេលយូរ។
ក្រុម	ឈ្មោះក្រុម។
រូបតំណាង	URL ដែលមានរូបភាពរូបតំណាងអ្នកលេង។
id	អ្នកលេង IP និងច្រក។
បានចាប់ផ្តើម	ពិតមានន័យថាអ្នកលេងបានដំឡើងរួចហើយ មិនពិតមានន័យថាអ្នកលេងត្រូវការការដំឡើង។ អ្នកលេងត្រូវតែត្រូវបានដំឡើងជាមួយនឹងកម្មវិធី BluOS Controller ។
ម៉ាក់	លេខសម្គាល់អ្នកលេងតែមួយគត់សម្រាប់ចំណុចប្រទាក់បណ្តាញ។ អាចជាអាសយដ្ឋាន MAC ។
មេ	អាសយដ្ឋាន IP អ្នកលេងមេ។ មានវត្តមានតែក្នុងករណីអ្នកលេងជាអ្នកលេងបន្ទាប់បន្សំក្នុងក្រុមប៉ុណ្ណោះ។ គុណលក្ខណៈ៖ · ច្រក - លេខច្រក។ · ការភ្ជាប់ឡើងវិញ – ពិត ប្រសិនបើព្យាយាមភ្ជាប់ឡើងវិញទៅអ្នកលេងបឋម
គំរូ	លេខសម្គាល់ម៉ូដែលអ្នកលេង។
ឈ្មោះម៉ូដែល	ឈ្មោះម៉ូដែលអ្នកលេង។
ស្ងាត់	កំណត់ទៅ 1 ប្រសិនបើកម្រិតសំឡេងត្រូវបានបិទ។
muteDb	ប្រសិនបើអ្នកលេងត្រូវបានបិទ នោះនេះគឺជាកម្រិតសំឡេងដែលមិនបានបិទនៅក្នុង dB។

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
បិទសំឡេង	ប្រសិនបើអ្នកលេងត្រូវបានបិទ នោះនេះគឺជាកម្រិតសំឡេងដែលមិនបិទសំឡេង (0..100)។
ឈ្មោះ	ឈ្មោះអ្នកលេង។
កំណែគ្រោងការណ៍	កំណែគ្រោងការណ៍កម្មវិធី។
ទាសករ	អាសយដ្ឋាន IP អ្នកលេងបន្ទាប់បន្សំ។ មានវត្តមានតែប្រសិនបើអ្នកលេងគឺជាអ្នកលេងចម្បងនៃក្រុមមួយ។ អាចមានអ្នកលេងបន្ទាប់បន្សំជាច្រើន។ គុណលក្ខណៈ៖ · លេខសម្គាល់ - អាសយដ្ឋាន IP · ច្រក - លេខច្រក
syncStat	លេខសម្គាល់នៃស្ថានភាពសមកាលកម្ម។ វាត្រូវបានផ្លាស់ប្តូរនៅពេលណាដែលធាតុណាមួយនៅក្នុងការឆ្លើយតប /SyncStatus ត្រូវបានផ្លាស់ប្តូរ។ ផ្គូផ្គងជាមួយ ធាតុនៅក្នុង / ការឆ្លើយតបស្ថានភាព។
កម្រិតសំឡេង	កម្រិតសំឡេងនៅលើមាត្រដ្ឋាន 0..100 ។ -1 មានន័យថាបរិមាណថេរ។
តំបន់	ឈ្មោះក្រុមថេរ។
zoneMaster	ប្រសិនបើអ្នកលេងគឺជាអ្នកលេងចម្បងនៅក្នុងក្រុមថេរ នេះត្រូវបានកំណត់ទៅពិត។
zoneSlave	ប្រសិនបើអ្នកលេងគឺជាអ្នកលេងបន្ទាប់បន្សំនៅក្នុងក្រុមថេរ នេះត្រូវបានកំណត់ទៅពិត។

Example
http://192.168.1.100:11000/SyncStatus
ទទួលបានស្ថានភាពអ្នកលេង និងក្រុមរបស់អ្នកលេង។
http://192.168.1.100:11000/SyncStatus?អស់ពេល=100&etag=4e266c9fbfba6d13d1a4d6ff4bd2e1e6
ទទួលបានស្ថានភាពអ្នកលេង និងក្រុមរបស់អ្នកលេងដោយប្រើការបោះឆ្នោតរយៈពេលវែង។ លទ្ធផល​មួយ​ត្រូវ​បាន​ត្រឡប់​មុន​ពេល​អស់​រយៈពេល 100 វិនាទី​ប៉ុណ្ណោះ​ប្រសិន​បើ​ស្ថានភាព​របស់​អ្នក​លេង​បាន​ផ្លាស់​ប្តូរ។ បើមិនដូច្នោះទេលទ្ធផលនឹងត្រលប់មកវិញនៅ 100 វិនាទី។

ការគ្រប់គ្រងកម្រិតសំឡេង

លៃតម្រូវកម្រិតសំឡេងរបស់អ្នកលេង។ ប្រើដើម្បីបិទសំឡេងអ្នកលេងផងដែរ។
3.1 កំណត់កម្រិតសំឡេង
ការពិពណ៌នា
សំណួរសំណើនេះ ឬកំណត់កម្រិតសំឡេងអ្នកលេង។
វ៉ារ្យ៉ង់ពាក្យបញ្ជាទាំងអស់ មិនថាប្រើកម្រិត 0..100, absolute dB ឬប៉ារ៉ាម៉ែត្រ dB ដែលទាក់ទងទេ ត្រូវបានដាក់កម្រិតចំពោះតម្លៃដែលបណ្តាលឱ្យមានកម្រិតមួយនៅក្នុងជួរកម្រិតសំឡេងដែលបានកំណត់រចនាសម្ព័ន្ធ ដែលជាធម្មតាគឺ -80..0 ។ ជួរកម្រិតសំឡេងអាចត្រូវបានកែតម្រូវដោយប្រើកម្មវិធី BluOS Controller នៅលើការកំណត់ -> Player -> ទំព័រអូឌីយ៉ូ។
សំណួរគាំទ្រការស្ទង់មតិដ៏វែង (មិនបង្ហាញខាងក្រោម)។
ស្នើសុំ
/ បរិមាណ
/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	ធ្វើការផ្លាស់ប្តូរកម្រិតសំឡេងដែលទាក់ទងដោយប្រើមាត្រដ្ឋានកម្រិតសំឡេង dB ។ db អាចជាលេខវិជ្ជមាន ឬអវិជ្ជមាន។

ការឆ្លើយតប
<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
កំណត់កម្រិតសំឡេងអ្នកលេងទៅ 15 (ក្នុងចំណោម 100) ។
http://192.168.1.100:11000/Volume? tell_slaves=1&db=2
បង្កើនបរិមាណអ្នកលេងមេ 192.168.1.100 ហើយអ្នកលេងបន្ទាប់បន្សំទាំងអស់នៅក្នុងក្រុមនោះ 2 dB ។
http://192.168.1.100:11000/Volume?mute=1
បិទអ្នកលេង។
3.2 កម្រិតសំឡេងឡើង
ការពិពណ៌នា
សំណើនេះបង្កើនបរិមាណដោយ dB ជាក់លាក់ (តម្លៃធម្មតាគឺ 2dB) ។
ស្នើសុំ
/Volume?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
បង្កើនកម្រិតសំឡេង 2dB ។
3.3 កម្រិតសំឡេងចុះក្រោម
ការពិពណ៌នា
សំណើនេះបន្ថយកម្រិតសំឡេងដោយ dB ជាក់លាក់ (តម្លៃធម្មតាគឺ -2dB) ។
ស្នើសុំ
/Volume?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
បន្ថយកម្រិតសំឡេង 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 មានន័យថាអ្នកលេងមិនត្រូវបានបិទ
offsetDb
etag

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

ការគ្រប់គ្រងការចាក់ឡើងវិញ

ពាក្យបញ្ជាទាំងនេះត្រូវបានប្រើសម្រាប់ការគ្រប់គ្រងការចាក់សារថ្មីជាមូលដ្ឋាន។ ពាក្យ​បញ្ជា​រួម​មាន លេង ផ្អាក ឈប់ រំលង ថយ​ក្រោយ សាប់ និង​ធ្វើ​ម្តងទៀត។
4.1 លេង
ការពិពណ៌នា
ចាប់ផ្តើមការចាក់សារថ្មីនៃប្រភពអូឌីយ៉ូបច្ចុប្បន្ន។ ប៉ារ៉ាម៉ែត្រស្រេចចិត្តអនុញ្ញាតឱ្យលោតចូលទៅក្នុងបទអូឌីយ៉ូ និងបញ្ចូលមួយដែលត្រូវជ្រើសរើស មុនពេលចាប់ផ្តើមចាក់អូឌីយ៉ូ។
ស្នើសុំ
/ លេង
/Play?seek=វិនាទី
/Play?seek=seconds&id=trackid
/ លេង?url=អ៊ិនកូដស្ទ្រីមURL

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
ស្វែងរក	លោតទៅទីតាំងដែលបានបញ្ជាក់នៅក្នុងបទបច្ចុប្បន្ន។ មានសុពលភាពលុះត្រាតែការឆ្លើយតប/ស្ថានភាពរួមបញ្ចូល . មិន​អាច​ប្រើ​ជាមួយ​ប៉ារ៉ាម៉ែត្រ inputType និង​សន្ទស្សន៍។
ស្ទ្រីមដែលបានអ៊ិនកូដURL	URL នៃស្ទ្រីមអូឌីយ៉ូផ្ទាល់ខ្លួន។ វាត្រូវតែមាន URL បានអ៊ិនកូដ។

ការឆ្លើយតប
លេង
ស្ទ្រីម

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
រដ្ឋ	ស្ថានភាពបន្ទាប់ពីប្រតិបត្តិពាក្យបញ្ជា។ សូមមើល/Status response state attribute សម្រាប់ព័ត៌មានលម្អិតបន្ថែម។

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
ចាប់​ផ្ដើម​ការ​ចាក់​សំឡេង​នៅ​ពេល 55 វិនាទី​ចូល​ទៅ​ក្នុង​បទ​លេខ 5 ក្នុង​ជួរ។
192.168.1.125:11000/ចាក់?url=https%3A%2F%2Fwww%2Esoundhelix%2Ecom%2Fexamples%2Fmp3%
2FSoundHelix-Song-1%2Emp3
ចាប់ផ្តើមការចាក់អូឌីយ៉ូនៃអូឌីយ៉ូ mp3 តាមអ៊ីនធឺណិត។
4.2 ផ្អាក
ការពិពណ៌នា
ផ្អាកការលេងអូឌីយ៉ូបច្ចុប្បន្ន។
ប្រសិនបើម៉ោងរោទិ៍កំពុងលេង ហើយវាអស់ម៉ោង នោះម៉ោងរោទិ៍ត្រូវបានលុបចោល។
ស្នើសុំ
/ ផ្អាក
/Pause?toggle=1

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
បិទបើក	ប្រសិនបើកំណត់ទៅ 1 នោះស្ថានភាពផ្អាកបច្ចុប្បន្នត្រូវបានបិទបើក។

ការឆ្លើយតប
ផ្អាក

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
រដ្ឋ	ស្ថានភាពបន្ទាប់ពីប្រតិបត្តិពាក្យបញ្ជា។ សូមមើល/Status response state attribute សម្រាប់ព័ត៌មានលម្អិតបន្ថែម។

Example
http://192.168.1.100:11000/Pause
ផ្អាកការលេងអូឌីយ៉ូបច្ចុប្បន្ន។
១០ ឈប់
ការពិពណ៌នា
បញ្ឈប់ការលេងអូឌីយ៉ូបច្ចុប្បន្ន។ ប្រសិនបើម៉ោងរោទិ៍កំពុងលេង ហើយអស់ម៉ោង នោះម៉ោងរោទ៍ត្រូវបានលុបចោលសំណើ
/ ឈប់

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
គ្មាន

ការឆ្លើយតប
ឈប់

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
រដ្ឋ	"បញ្ឈប់" មានន័យថាសំឡេងបច្ចុប្បន្នត្រូវបានបញ្ឈប់។

Example
http://192.168.1.100:11000/Stop
បញ្ឈប់ការចាក់អូឌីយ៉ូបច្ចុប្បន្ន។
4.4 រំលង
ការពិពណ៌នា
រំលងទៅបទអូឌីយ៉ូបន្ទាប់នៅក្នុងជួរចាក់
នៅពេលចាក់ពីជួរលេង វានឹងរំលងទៅបទបន្ទាប់ក្នុងជួរ។ ប្រសិនបើ​បទ​បច្ចុប្បន្ន​ជា​បទ​ចុងក្រោយ​ក្នុង​ជួរ ការ​ហៅ​ទូរសព្ទ/រំលង​នឹង​ទៅ​បទ​ដំបូង​ក្នុង​ជួរ។ . វានឹងរំលងទៅបទបន្ទាប់ ឬដំបូងក្នុងជួរ ដោយមិនគិតពីស្ថានភាពនៃការកំណត់ម្តងទៀត។
ដើម្បីកំណត់ថាតើអ្នកកំពុងប្រើជួរលេង សូមផ្ទៀងផ្ទាត់ថាមិនមានទេ។Url> ធាតុនៅក្នុង / ការឆ្លើយតបស្ថានភាព។
បន្ទាប់មកអ្នកអាចប្រើពាក្យបញ្ជា /Skip ។
អ្នកក៏អាចរំលងបទសម្រាប់ស្ថានីយ៍វិទ្យុដែលកំពុងផ្សាយមួយចំនួនផងដែរ។ ទាំងនេះត្រូវបានគ្រប់គ្រងដោយពាក្យបញ្ជា /Action ។
ប្រភពមួយចំនួនដូចជា TuneIn និង Optical Input មិនគាំទ្រជម្រើសរំលងទេ។ ប្រភពទាំងនេះនឹងមាន កURL> ធាតុប៉ុន្តែគ្មានឈ្មោះសកម្មភាពរំលងនៅក្នុងការឆ្លើយតប / ស្ថានភាព។
ស្នើសុំ
/ រំលង

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
គ្មាន

ការឆ្លើយតប
21

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
id	លេខសម្គាល់បទបន្ទាប់ពីប្រតិបត្តិពាក្យបញ្ជារំលង។ សូមមើលគុណលក្ខណៈបទចម្រៀងឆ្លើយតបស្ថានភាពសម្រាប់ព័ត៌មានលម្អិត។

Example
http://192.168.1.100:11000/Skip
រំលងទៅបទបន្ទាប់។
4.5 ថយក្រោយ
ការពិពណ៌នា
ប្រសិនបើបទមួយកំពុងលេង ហើយបានចាក់លើសពី 4 វិនាទី នោះត្រលប់មកវិញនឹងត្រលប់ទៅការចាប់ផ្តើមនៃបទវិញ។
បើមិនដូច្នេះទេ ពាក្យបញ្ជាថយក្រោយនឹងទៅបទចម្រៀងមុនក្នុងបញ្ជីចាក់បច្ចុប្បន្ន។ ប្រសិនបើនៅលើបទចម្រៀងដំបូងនៅក្នុងបញ្ជីចាក់ការហៅត្រឡប់មកវិញនឹងទៅបទចម្រៀងចុងក្រោយ។ វានឹងទៅបទមុន ឬដំបូងក្នុងជួរដោយមិនគិតពីស្ថានភាពនៃការកំណត់ឡើងវិញ
ដើម្បីកំណត់ថាតើអ្នកកំពុងប្រើជួរលេង សូមផ្ទៀងផ្ទាត់ថាមិនមានទេ។Url> ធាតុនៅក្នុងការឆ្លើយតប / ស្ថានភាព។
បន្ទាប់មកអ្នកអាចប្រើពាក្យបញ្ជា /Back ។
អ្នកក៏អាចត្រឡប់ទៅបទសម្រាប់ស្ថានីយ៍វិទ្យុដែលកំពុងផ្សាយមួយចំនួនផងដែរ។ ទាំងនេះត្រូវបានគ្រប់គ្រងដោយពាក្យបញ្ជា /Action ។
ប្រភពមួយចំនួនដូចជា TuneIn និង Optical Input មិនគាំទ្រជម្រើសខាងក្រោយទេ។ ប្រភពទាំងនេះនឹងមាន កUrl> ធាតុ ប៉ុន្តែគ្មានឈ្មោះសកម្មភាពរំលងនៅក្នុងការឆ្លើយតប / ស្ថានភាព។
ស្នើសុំ
/ ត្រឡប់មកវិញ

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
គ្មាន

ការឆ្លើយតប
19

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
id	លេខសម្គាល់បទបន្ទាប់ពីប្រតិបត្តិពាក្យបញ្ជាខាងក្រោយ។ សូមមើលគុណលក្ខណៈបទចម្រៀងឆ្លើយតបស្ថានភាពសម្រាប់ព័ត៌មានលម្អិត។

4.6 សាប់
ការពិពណ៌នា
ពាក្យបញ្ជាសាប់បង្កើតជួរថ្មីដោយសាប់ជួរបច្ចុប្បន្ន។ ជួរដើម (មិនត្រូវបានសាប់) ត្រូវបានរក្សាទុកសម្រាប់ការស្តារឡើងវិញ នៅពេលដែលការសាប់ត្រូវបានបិទ។
ស្នើសុំ
/Shuffle?state=0|1

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
រដ្ឋ	· 0 ដើម្បីបិទការសាប់ · 1 ដើម្បីបើកការសាប់។ មិន​មាន​ប្រសិទ្ធភាព​ទេ ប្រសិន​បើ​ជួរ​ស្ថិត​នៅ​ក្នុង​ស្ថានភាព​សាប់​រួច​ហើយ។ មើល / ស្ថានភាពឆ្លើយតប ធាតុ។

ការឆ្លើយតប

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
កែប្រែ	1 មានន័យថា ជួរត្រូវបានកែប្រែចាប់តាំងពីត្រូវបានផ្ទុក។ 0 មានន័យថាមិនមែនទេ។
ប្រវែង	ចំនួនបទសរុបក្នុងជួរបច្ចុប្បន្ន។
សាប់	ស្ថានភាពសាប់។ 1 មានន័យថាជួរបច្ចុប្បន្នត្រូវបានសាប់។ 0 មានន័យថា ជួរបច្ចុប្បន្នមិនត្រូវបានសាប់ទេ។
id	លេខសម្គាល់ជួរបច្ចុប្បន្ន។ វាផ្លាស់ប្តូរនៅពេលណាដែលជួរលេងត្រូវបានកែប្រែ។

Example
http://192.168.1.100:11000/Shuffle?state=1
សាប់​ជួរ​លេង​បច្ចុប្បន្ន។
៤ ធ្វើម្តងទៀត
ការពិពណ៌នា
កំណត់ជម្រើសម្តងទៀត។ ធ្វើម្តងទៀតមានបីរដ្ឋ; 0 មាន​ន័យ​ថា​ធ្វើ​ជួរ​បច្ចុប្បន្ន​ឡើងវិញ, 1 មានន័យ​ថា​ធ្វើ​ឡើង​វិញ​បទ​បច្ចុប្បន្ន​និង 2 មាន​ន័យ​ថា​មិន​ធ្វើ​ឡើង​វិញ​។ ការនិយាយឡើងវិញទាំងអស់គឺគ្មានកំណត់ ពោលគឺវាមិនឈប់ទេ។
ស្នើសុំ
/Repeat?state=0|1|2

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
រដ្ឋ	· 0 ដើម្បីធ្វើឡើងវិញនូវជួរលេងទាំងមូល · 1 ដើម្បីធ្វើឡើងវិញនូវបទបច្ចុប្បន្ន · 2 ដើម្បីបិទម្តងទៀត

ការឆ្លើយតប

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
ប្រវែង	ចំនួនបទសរុបនៅក្នុងជួរចាក់បច្ចុប្បន្ន។
id	លេខសម្គាល់ជួរបច្ចុប្បន្ន។ វាផ្លាស់ប្តូរនៅពេលណាដែលជួរលេងត្រូវបានកែប្រែ។
ធ្វើម្តងទៀត	ស្ថានភាពបច្ចុប្បន្នឡើងវិញ។

Example
http://192.168.1.100:11000/Repeat?state=1
ចាក់ឡើងវិញនូវបទដែលកំពុងលេងបច្ចុប្បន្ន។
4.8 សកម្មភាពសម្រាប់ស្ថានីយ៍វិទ្យុស្ទ្រីម
ការពិពណ៌នា
សកម្មភាពអនុញ្ញាតឱ្យអ្នករំលងទៅមុខ ថយក្រោយ ស្រឡាញ់ និងហាមឃាត់បទនៅលើស្ថានីយ៍វិទ្យុដែលកំពុងជ្រើសរើស ដូចជា Slacker ឬ Radio Paradise ឬ Amazon Music Prime Stations។ ស្ទ្រីមស្ថានីយ៍វិទ្យុមិនផ្ទុកបទទៅក្នុងជួរចាក់ទេ។ ផ្ទុយទៅវិញ ពួកគេផ្តល់ ក URL ដែលអ្នកអាចប្រើដើម្បីសម្រេចមុខងារដែលចង់បាន។
រំលងនឹងទៅបទបន្ទាប់។ ត្រលប់ក្រោយនឹងទៅបទមុន។ ស្នេហានឹងដាក់ទង់បទដែលចូលចិត្តនៅក្នុងសេវាកម្មតន្ត្រី។ Ban នឹងរំលងទៅបទបន្ទាប់ ហើយដាក់ទង់ថាបទមិនចូលចិត្តនៅក្នុងសេវាកម្មតន្ត្រី។
ប្រសិនបើមានUrl> ធាតុនៅក្នុងការឆ្លើយតប /ស្ថានភាព និងសកម្មភាពសមស្រប អ្នកអាចធ្វើមុខងារទាំងនេះបាន។ សកម្មភាពនឹងមាន URL ដែលត្រូវបានប្រើដើម្បីប្រតិបត្តិសកម្មភាព។
នេះគឺជាអតីតample ពី / ការឆ្លើយតបស្ថានភាពរបស់អ្នកលេងដែលលេងវិទ្យុ Slacker៖


<action name=”skip” url=”/Action?service=Slacker&skip=4799148″/>
<action icon=”/images/loveban/love.png” name=”love” notification=”Track marked as favorite” state=”1″ text=”Love” url=”/Action?service=Slacker&love=4799148″/>
<action icon=”/images/loveban/ban.png” name=”ban” notification=”Track banned from this
ស្ថានីយ៍” រដ្ឋ =”-1″ អត្ថបទ = “ហាមឃាត់” url=”/Action?service=Slacker&ban=4799148″/>

នៅក្នុងនេះ អតីតample, back is not available, but skip, love and ban is possible.
ស្នើសុំ
/Action?service=service-name&action=action-URL
ចំណាំ៖ ព័ត៌មានលម្អិតនៃសំណើជាក់លាក់ (ចំណុចបញ្ចប់ និងប៉ារ៉ាម៉ែត្រ) ត្រូវបានផ្តល់ដោយរៀងៗខ្លួន ធាតុ។ ពាក្យបញ្ជានៅក្នុង Exampផ្នែកខាងក្រោមប្រើ / សកម្មភាពទាំងអស់ ប៉ុន្តែ URI ណាមួយអាចធ្វើទៅបាន។

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
	ផ្តល់ជូននៅក្នុង ធាតុ។

ការឆ្លើយតប
សម្រាប់ការឆ្លើយតប អ្នកទទួលបានការទទួលស្គាល់សកម្មភាព។ សម្រាប់ការរំលង និងត្រឡប់មកវិញ អ្នកទទួលបាន៖


សម្រាប់សេចក្តីស្រឡាញ់អ្នកទទួលបាន:
១
សម្រាប់ការហាមប្រាមអ្នកទទួលបាន៖
1

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
ការឆ្លើយតប	ប្រសិនបើធាតុឫសនៃការឆ្លើយតបគឺ បន្ទាប់មកថ្នាំងអត្ថបទគឺជាការជូនដំណឹងដើម្បីបង្ហាញដល់អ្នកប្រើប្រាស់។ ប្រសិនបើធាតុ root ជំនួសត្រូវបានត្រឡប់ និង រួមបញ្ចូលគុណលក្ខណៈជូនដំណឹង បន្ទាប់មកការជូនដំណឹងនោះគួរតែត្រូវបានបង្ហាញ។

Example
http://192.168.1.100:11000/Action?service=Slacker&skip=10965139
រំលងទៅបទវិទ្យុ Slacker បន្ទាប់។
http://192.168.1.100:11000/Action?service=Slacker&ban=33332284
ហាមឃាត់បទវិទ្យុ Slacker ដែលកំពុងចាក់បច្ចុប្បន្ន ហើយរំលងទៅបទបន្ទាប់។

 លេងការគ្រប់គ្រងជួរ

របៀប​មួយ​នៃ​ការ​ដំណើរការ​របស់​អ្នក​លេង​គឺ​ដើម្បី​ផ្ទុក​បទ​ទៅ​ក្នុង​ជួរ​លេង​ ហើយ​បន្ទាប់​មក​លេង​បទ​ពី​ជួរ​លេង​នោះ។ ពាក្យបញ្ជាទាំងនេះអនុញ្ញាតឱ្យអ្នកធ្វើ view និងគ្រប់គ្រងជួរលេង។
5.1 បញ្ជីបទ
ការពិពណ៌នា
ទាំង​ត្រឡប់​ស្ថានភាព​ជួរ​លេង ឬ​ត្រឡប់​ព័ត៌មាន​លើ​បទ​ទាំងអស់​ក្នុង​ជួរ​លេង។
វាមិនត្រូវបានណែនាំឱ្យប្រើសំណួរនេះដោយគ្មានប្រវែង ឬប៉ារ៉ាម៉ែត្រចាប់ផ្តើម និងបញ្ចប់ទេ ព្រោះបើមិនដូច្នេះទេ ការឆ្លើយតបដ៏វែងឆ្ងាយអាចត្រូវបានបង្កើត។
ស្នើសុំ
/ បញ្ជីចាក់
/Playlist?length=1
/Playlist?start=first&end=last (ទៅ​យក​ផ្នែក​នៃ​ជួរ​សម្រាប់​ការ​ដាក់​ទំព័រ​ជា​ធម្មតា)

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
ប្រវែង = ១	ត្រឡប់​មក​វិញ​គ្រាន់​តែ​លក្ខណៈ​កម្រិត​កំពូល​និង​មិន​មាន​ព័ត៌មាន​លម្អិត​បទ​។
ចាប់ផ្តើម	ធាតុដំបូងនៅក្នុងជួរដើម្បីរួមបញ្ចូលក្នុងការឆ្លើយតប ដោយចាប់ផ្តើមពី 0 ។
ចប់	ធាតុចុងក្រោយនៅក្នុងជួរដើម្បីបញ្ចូលក្នុងការឆ្លើយតប។

ការឆ្លើយតប
សម្រាប់ស្ថានភាពជួរលេង៖

១៣
243

១

សម្រាប់​បញ្ជី​ជួរ​លេង៖


២០០២
អាន់-ម៉ារី
២០០២
Deezer: 487381362

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
ឈ្មោះ	ឈ្មោះជួរលេងបច្ចុប្បន្ន។
កែប្រែ	0 មានន័យថា ជួរមិនត្រូវបានកែប្រែទេ ចាប់តាំងពីវាត្រូវបានផ្ទុក។ 1 មានន័យថា ជួរត្រូវបានកែប្រែចាប់តាំងពីវាត្រូវបានផ្ទុក។
ប្រវែង	ចំនួនបទសរុបក្នុងជួរបច្ចុប្បន្ន
id	លេខសម្គាល់តែមួយគត់សម្រាប់ស្ថានភាពជួរបច្ចុប្បន្ន (ឧទាហរណ៍ 1054) ។ វាដូចគ្នាទៅនឹង នៅក្នុង / ការឆ្លើយតបស្ថានភាព។
ចម្រៀង	បទ​ចម្រៀង​ត្រូវ​បាន​បង្កើត​ឡើង​ដោយ​ធាតុ​រង​មួយ​ចំនួន​: · albumid = លេខសម្គាល់នៃអាល់ប៊ុមដែលបទគឺនៅក្នុង · សេវាកម្ម = សេវាកម្មតន្ត្រីនៃបទ · artistid = លេខសម្គាល់របស់សិល្បករបទ · songid = លេខសម្គាល់បទចម្រៀង · id = ទីតាំងតាមដានក្នុងជួរបច្ចុប្បន្ន។ ប្រសិន​បើ​បទ​ត្រូវ​បាន​ជ្រើសរើស​បច្ចុប្បន្ន លេខ​សម្គាល់​បទ​គឺ​ដូច​គ្នា។ នៅក្នុង / ការឆ្លើយតបស្ថានភាព។ · ចំណងជើង = ឈ្មោះបទ ·សិល្បៈ = ឈ្មោះសិល្បករ · alb = ឈ្មោះអាល់ប៊ុម

Example
http://192.168.1.100:11000/Playlist
រាយបញ្ជីបទទាំងអស់នៅក្នុងជួរចាក់។
http://192.168.1.100:11000/Playlist?length=1
5.2 លុបបទមួយ។
ការពិពណ៌នា
ដកបទមួយចេញពីជួរចាក់បច្ចុប្បន្ន។
ស្នើសុំ
/លុប?id=ទីតាំង

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
id	លេខសម្គាល់បទនៃបទដែលត្រូវលុបចេញពីជួរចាក់បច្ចុប្បន្ន។

ការឆ្លើយតប
៩

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
បានលុប	ទីតាំងនៅក្នុងជួរនៃបទដែលត្រូវដកចេញ។

Example
http://192.168.1.100:11000/Delete?id=9
ដកបទនៅទីតាំង 9 ក្នុងជួរលេង។
5.3 ផ្លាស់ទីបទមួយ។
ការពិពណ៌នា
ផ្លាស់ទីបទមួយនៅក្នុងជួរចាក់បច្ចុប្បន្ន។
ស្នើសុំ
/Move?new=destination&old=origin

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
ថ្មី។	ទីតាំងថ្មីនៅលើផ្លូវកំពុងត្រូវបានផ្លាស់ប្តូរ។
ចាស់	ទីតាំងចាស់នៃផ្លូវកំពុងត្រូវបានផ្លាស់ប្តូរ។

ការឆ្លើយតប
ផ្លាស់ទី

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
ផ្លាស់ទី	បង្ហាញថាផ្លូវត្រូវបានផ្លាស់ទី។

Example
http://192.168.1.100:11000/Move?new=8&old=2
ផ្លាស់ទីបទនៅទីតាំង 2 ទៅទីតាំង 8 ក្នុងជួរលេង។
5.4 ជម្រះជួរ
ការពិពណ៌នា
ជម្រះបទទាំងអស់ពីជួរចាក់បច្ចុប្បន្ន
ស្នើសុំ
/ ច្បាស់

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
គ្មាន

ការឆ្លើយតប

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
កែប្រែ	0 មាន​ន័យ​ថា​ជួរ​មិន​ត្រូវ​បាន​កែប្រែ​ចាប់​តាំង​ពី​បាន​ផ្ទុក, 1 មាន​ន័យ​ថា​ជួរ​ត្រូវ​បាន​កែប្រែ​ចាប់​តាំង​ពី​បាន​ផ្ទុក​។
ប្រវែង	ចំនួនបទសរុបក្នុងជួរបច្ចុប្បន្ន។
id	លេខសម្គាល់តែមួយគត់សម្រាប់ជួរបច្ចុប្បន្ន។

Example
http://192.168.1.100:11000/Clear
វាដកបទទាំងអស់ចេញពីជួរចាក់។
5.5 រក្សាទុកជួរ
ការពិពណ៌នា
រក្សាទុកជួរលេងជាបញ្ជីចាក់ BluOS ដែលមានឈ្មោះថា។
ស្នើសុំ
/Save?name=playlist_name

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
ឈ្មោះ	ឈ្មោះជួរលេងដែលបានរក្សាទុក។

ការឆ្លើយតប

១២៦

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
ធាតុ	ចំនួនបទសរុបនៅក្នុងជួរចាក់ដែលបានរក្សាទុក។

Example
http://192.168.1.100:11000/Save?name=Dinner+Music
វារក្សាទុកជួរលេងជា "តន្ត្រីអាហារពេលល្ងាច"។

ការកំណត់ជាមុន

សំណើកំណត់ជាមុនអនុញ្ញាតឱ្យអ្នករាយបញ្ជីការកំណត់ជាមុនទាំងអស់របស់អ្នកលេង ផ្ទុកការកំណត់ជាមុន និងជំហានឡើង/ចុះការកំណត់ជាមុន។ ការកំណត់ជាមុនត្រូវតែបន្ថែម និងលុបដោយប្រើកម្មវិធី BluOS Controller។ ការកំណត់ជាមុនអាចរួមបញ្ចូលស្ថានីយ៍វិទ្យុ បញ្ជីចាក់ និងធាតុបញ្ចូល (ឧ
ប៊្លូធូស, អាណាឡូក, អុបទិក, HDMI ARC) ។
6.1 បញ្ជីកំណត់ជាមុន
ការពិពណ៌នា
រាយបញ្ជីការកំណត់ជាមុនទាំងអស់នៅលើកម្មវិធីចាក់ BluOS បច្ចុប្បន្ន។
ស្នើសុំ
/ ការកំណត់ជាមុន

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
គ្មាន

ការឆ្លើយតប

<preset id=”6″ name=”Serenity” url=”RadioParadise:/42:4/ភាពស្ងប់ស្ងាត់”
image=”https://img.radioparadise.com/channels/0/42/cover_512x512/0.jpg”/>
<preset id=”7″ name=”1980s Alternative Rock Classics” url=”/Load?service=Tidal&amp;id=fd3f797e-
a3e9-4de9-a1e2-b5adb6a57cc7″ image=”/Artwork?service=Tidal&amp;playlistimage=afacfc12-24034caf-a5c5-a2af28d811c8″/> </presets>

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
មោទនភាព	លេខសម្គាល់តែមួយគត់នៃការកំណត់ជាមុនរបស់អ្នកលេង។ វាដូចគ្នាទៅនឹង នៅក្នុង / ការឆ្លើយតបស្ថានភាព។
ឈ្មោះ	ឈ្មោះកំណត់ជាមុន។
id	លេខសម្គាល់ដែលបានកំណត់ជាមុន។
url	កំណត់ជាមុន URL. វាជាប្រភពកំណត់ជាមុន URL ប្រើដើម្បីផ្ទុកការកំណត់ជាមុន។
រូបភាព	រូបភាព URL នៃការកំណត់ជាមុន។ ប្រសិនបើ URL ចាប់ផ្តើមជាមួយ / Artwork វាអាចបណ្តាលឱ្យមានការប្តូរទិស។ ការបន្ថែមប៉ារ៉ាម៉ែត្រ/សោ followRedirects=1 នៅពេលទាញយករូបភាពអាចជៀសវាងការបញ្ជូនបន្ត។

Example
http://192.168.1.100:11000/Presets
រាយបញ្ជីការកំណត់ជាមុនទាំងអស់នៅលើអ្នកលេង។
6.2 ផ្ទុកការកំណត់ជាមុន
ការពិពណ៌នា
ចាប់ផ្តើមលេងការកំណត់ជាមុន។ អ្នកអាចជ្រើសរើសលេខកំណត់ជាមុនជាក់លាក់ ក៏ដូចជាការកំណត់ជាមុនបន្ទាប់ ឬពីមុន។ លេខដែលបានកំណត់ជាមុន មិនចាំបាច់មានលំដាប់លំដោយទេ ពោលគឺអ្នកអាចកំណត់ជាមុន 1,2,3 5 និង 7។ ការកំណត់ជាមុនរង្វិលជុំពីកំពូលទៅបាត និងពីក្រោមទៅកំពូល។
ស្នើសុំ
/preset?id=presetId|-1|+1

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
id	លេខសម្គាល់នៃការកំណត់ជាមុនដែលត្រូវផ្ទុក។ បញ្ជីនៃលេខសម្គាល់ដែលបានកំណត់ជាមុនដែលមានគឺត្រូវបានរកឃើញដោយប្រើពាក្យបញ្ជា Show Presets ។ ប្រសិនបើលេខសម្គាល់ដែលបានកំណត់ជាមុនគឺ +1 វានឹងផ្ទុកការកំណត់ជាមុនបន្ទាប់។ ប្រសិនបើលេខសម្គាល់ដែលបានកំណត់ជាមុនគឺ -1 វានឹងផ្ទុកការកំណត់ជាមុនពីមុន។

ការឆ្លើយតប
ប្រសិន​បើ​ការ​កំណត់​ទុក​ជា​មុន​គឺ​ជា​បញ្ជី​បទ វា​ត្រឡប់​ចំនួន​បទ​នៃ​ការ​កំណត់​ទុក​ជា​មុន​ដែល​បាន​ផ្ទុក។

១២៦

ប្រសិនបើការកំណត់ជាមុនជាវិទ្យុ វាត្រឡប់ស្ថានភាពស្ទ្រីម។
ស្ទ្រីម

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
សេវាកម្ម	ឈ្មោះសេវាកម្មនៃការកំណត់ជាមុនដែលបានផ្ទុក
ធាតុ	ចំនួនបទនៃការកំណត់ជាមុនដែលបានផ្ទុក

Example
http://192.168.1.100:11000/Preset?id=4
ផ្ទុកការកំណត់ជាមុនជាមួយលេខសម្គាល់កំណត់ជាមុន 4 ។
http://192.168.1.100:11000/Preset?id=+1

ការរុករក និងស្វែងរកមាតិកា

ផ្នែកនេះពិពណ៌នាអំពីពាក្យបញ្ជាសម្រាប់ការរុករក និងស្វែងរកមាតិកាសេវាកម្មតន្ត្រី។
7.1 រកមើលមាតិកាតន្ត្រី
ការពិពណ៌នា
រុករកតាមប្រភពតន្ត្រីដែលមាន ក៏ដូចជាធាតុចូល និងបញ្ជីចាក់។
ធាតុដើមសម្រាប់ការឆ្លើយតបគឺ លុះត្រាតែមានការឆ្លើយតបកំហុស។ លទ្ធផលភាគច្រើនគឺជាលំដាប់នៃ . ក្នុងករណីខ្លះលទ្ធផលគឺជាលំដាប់នៃ ដែលនីមួយៗមានលំដាប់ if . តម្លៃទាំងអស់ត្រូវបានផ្តល់ជូនដោយប្រើគុណលក្ខណៈ។ មិនមានថ្នាំងអត្ថបទទេ។
លទ្ធផល​នៃ​ការ​ហៅ​ទូរសព្ទ​/Browse អាច​ជា​កំហុស​ដែល​បាន​ភ្ជាប់​ក្នុង​ ធាតុឫស។ ព័ត៌មានលម្អិតនៃកំហុសត្រូវបានផ្តល់ជូនក្នុងមួយ និងសូន្យ ឬច្រើនជាងនេះ។ ថ្នាំងអត្ថបទ។
ស្នើសុំ
/Browse?key=key-value
/Browse?key=key-value&withContextMenuItems=1

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
គន្លឹះ	ប៉ារ៉ាម៉ែត្រស្រេចចិត្ត។ អវត្ដមាននៃប៉ារ៉ាម៉ែត្រនេះនឹងបណ្តាលឱ្យមានការរុករកកម្រិតកំពូល។ ត្រឡប់​ព័ត៌មាន​សម្រាប់​កម្រិត​ផ្សេង​ពី​កម្រិត​កំពូល/Browse។ ប្រើតម្លៃដែលយកចេញពីតម្លៃគុណលក្ខណៈ "browseKey", "nextKey", "parentKey" ឬ "contextMenuKey" ពីការឆ្លើយតបពីមុន។ ចំណាំ៖ តម្លៃគន្លឹះត្រូវតែជា URL បានអ៊ិនកូដ
ជាមួយContextMenuItems	ប៉ារ៉ាម៉ែត្រស្រេចចិត្ត។ តម្លៃគឺតែងតែ 1. ប៉ារ៉ាម៉ែត្រ​នេះ​ត្រូវ​បាន​ប្រើ​ដើម្បី​ទទួល​បាន​ម៉ឺនុយ​បរិបទ​ក្នុង​បន្ទាត់ ពេល​ទទួល​បាន​លទ្ធផល​រកមើល​បញ្ជី​ចាក់ អាល់ប៊ុម បទ ស្ថានីយ សិល្បករ ជាដើម។

ការឆ្លើយតប
ការឆ្លើយតបការរុករកកម្រិតកំពូល៖



<item image=”/images/InputIcon.png” text=”Optical Input”
លេងURL=”/លេង?url=Capture%3Ahw%3A1%2C0%2F1%2F25%2F2%2Finput1″ inputType=”spdif”
type="audio"/>




ការឆ្លើយតបការរុករកកម្រិតផ្សេងទៀត៖
<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=”បញ្ជីចាក់ពេញនិយម”
type="link" />

type="link" />

type="link" />
item browseKey=”/Songs?service=Deezer&genre=0&category=toplist” text=”ចម្រៀងពេញនិយម”
type="link" />

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
សូមមើលតារាងធាតុ/គុណលក្ខណៈខាងក្រោម

Example
ចំណាំ៖ ប៉ារ៉ាម៉ែត្រសំខាន់ៗទាំងអស់ត្រូវតែត្រូវបានអ៊ិនកូដ UTF-8 ។
http://192.168.1.100:11000/Browse
រុករកកម្រិតកំពូល។
http://192.168.1.100:11000/Browse?key=Tidal%3A
រុករកកម្រិតទីពីរ ត្រឡប់ប្រភេទ Tidal ។
http://192.168.1.100:11000/Browse?key=Tidal%3AmenuGroup%2F3
ធ្វើការរុករកកម្រិតទីបី ត្រឡប់ប្រភេទរង Tidal Masters (ក្រុមទី 3)។
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters
ធ្វើការរុករកកម្រិតទី 4 ដោយត្រលប់មកវិញនូវអាល់ប៊ុម Tidal Masters ដំបូង។
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DTidal%26category%3Dmasters%26 start%3D30%26end%3D79
ធ្វើការរុករកកម្រិតទី 4 ផ្សេងទៀត ដោយត្រឡប់ឈុតទីពីរនៃអាល់ប៊ុម Tidal Masters ។

ធាតុ	គុណលក្ខណៈ (និងតម្លៃ)		ការពិពណ៌នា
	រូបតំណាងសេវាកម្ម		URI សម្រាប់រូបតំណាងសម្រាប់សេវាកម្មដែលកំពុងត្រូវបានរុករក។
	ឈ្មោះសេវាកម្ម		ឈ្មោះសេវាដែលកំពុងត្រូវបានរុករកសម្រាប់បង្ហាញអ្នកប្រើប្រាស់។
	គ្រាប់ចុចស្វែងរក		តម្លៃដែលត្រូវប្រើសម្រាប់ប៉ារ៉ាម៉ែត្រគន្លឹះទៅកាន់ /Browse សំណើដើម្បីស្វែងរកសេវាកម្មបច្ចុប្បន្ន (ឬផ្នែកជ្រៅនៃឋានានុក្រម)។ លើសពីនេះ សំណើត្រូវមានប៉ារ៉ាម៉ែត្រ aq ដែលមានពាក្យស្វែងរក។
	គ្រាប់ចុចបន្ទាប់		តម្លៃ​ដែល​ត្រូវ​ប្រើ​សម្រាប់​ប៉ារ៉ាម៉ែត្រ​គន្លឹះ​ចំពោះ​សំណើ /Browse ដើម្បី​ទទួល​បាន​ទំព័រ​បន្ទាប់​នៃ​ធាតុ​សម្រាប់​បច្ចុប្បន្ន view. ទំហំកំណាត់ទំព័រមិនស្ថិតក្រោមការគ្រប់គ្រងរបស់អ្នកប្រើ API ហើយគ្មានការព្យាយាមណាមួយត្រូវធ្វើដើម្បីញែក ឬរៀបចំប៉ារ៉ាម៉ែត្រសំណួរនៃតម្លៃនេះទេ។
	parentKey		តម្លៃដែលត្រូវប្រើសម្រាប់ប៉ារ៉ាម៉ែត្រគន្លឹះទៅនឹងសំណើ /Browse ដើម្បីរុករកបម្រុងទុកឋានានុក្រម ប្រសិនបើការរុករកត្រឡប់មកវិញលំនាំដើមគួរតែត្រូវបានបដិសេធ។
	ប្រភេទ	ម៉ឺនុយ	ថ្នាំង​រុករក​ដែល​អាច​មាន​ការ​លាយ​បញ្ចូល​គ្នា​នៃ​ប្រភេទ​ធាតុ​ណាមួយ។ ជា​ទូទៅ​នឹង​មាន​តែ​តំណ ឬ​ធាតុ​សំឡេង​ប៉ុណ្ណោះ។
		ម៉ឺនុយបរិបទ	បញ្ជីនៃធាតុនៃប្រភេទដែលបានបញ្ជាក់។
		សិល្បករ

ធាតុ	គុណលក្ខណៈ (និងតម្លៃ)		ការពិពណ៌នា
		អ្នកនិពន្ធ
		អាល់ប៊ុម
		បញ្ជីចាក់
		បទ
		ប្រភេទ
		ផ្នែក	ផ្នែកអក្ខរក្រម។
		ធាតុ	បញ្ជីលទ្ធផលទូទៅ។ ជា​ទូទៅ​មាន​ការ​លាយ​បញ្ចូល​គ្នា​នៃ​ថ្នាំង​ម៉ឺនុយ (type=”link”) និង​ធាតុ​វិទ្យុ (type=”audio”)។
		ថតឯកសារ	អាចមានថតរង បទ និងធាតុបញ្ជីចាក់។
	អត្ថបទ		ក្បាលសម្រាប់ប្រភេទ។
	គ្រាប់ចុចបន្ទាប់		តម្លៃដែលត្រូវប្រើសម្រាប់ប៉ារ៉ាម៉ែត្រគន្លឹះទៅនឹងសំណើរ /Browse ដើម្បីទទួលបានទំព័របន្ទាប់នៃធាតុសម្រាប់ប្រភេទ។
	parentKey		តម្លៃដែលត្រូវប្រើសម្រាប់ប៉ារ៉ាម៉ែត្រគន្លឹះទៅនឹងសំណើ /Browse ដើម្បីរុករកបម្រុងទុកឋានានុក្រម ប្រសិនបើការរុករកត្រឡប់មកវិញលំនាំដើមគួរតែត្រូវបានបដិសេធ។
	ប្រភេទ	តំណ	ថ្នាំងទូទៅនៅក្នុងឋានានុក្រមរុករកដែលនាំទៅដល់ថ្នាំងបន្ថែមទៀត
		អូឌីយ៉ូ	ថ្នាំងដែលអាចចាក់ដោយផ្ទាល់
		សិល្បករ	វត្ថុតំណាងឱ្យសិល្បករ

ធាតុ	គុណលក្ខណៈ (និងតម្លៃ)		ការពិពណ៌នា
		អ្នកនិពន្ធ	ធាតុតំណាងឱ្យអ្នកតែង
		អាល់ប៊ុម	ធាតុដែលតំណាងឱ្យអាល់ប៊ុម ឬបណ្តុំស្រដៀងគ្នា
		បញ្ជីចាក់	ធាតុដែលតំណាងឱ្យបញ្ជីចាក់ ឬបណ្តុំស្រដៀងគ្នា
		បទ	ធាតុដែលតំណាងឱ្យបទតែមួយ
		អត្ថបទ	ថ្នាំងអត្ថបទធម្មតា។
		ផ្នែក	ផ្នែកអក្ខរក្រម។
		ថតឯកសារ	ថតក្នុងថតឯកសាររុករក។
	អត្ថបទ		បន្ទាត់សំខាន់ ឬទីមួយនៃការពិពណ៌នាធាតុ
	អត្ថបទ ២		ជួរទីពីរ
	រូបភាព		រូបតំណាង ឬស្នាដៃសិល្បៈសម្រាប់ធាតុ។ ប្រសិនបើរូបភាពចាប់ផ្តើមជាមួយ / ការងារសិល្បៈ វាអាចបណ្តាលឱ្យមានការបញ្ជូនបន្ត។ ការបន្ថែមប៉ារ៉ាម៉ែត្រ/សោ followRedirects=1 នៅពេលទាញយករូបភាពអាចជៀសវាងការបញ្ជូនបន្ត។
	គន្លឹះរុករក		តម្លៃដែលត្រូវប្រើសម្រាប់ប៉ារ៉ាម៉ែត្រគន្លឹះទៅកាន់សំណើ /Browse បន្តបន្ទាប់ដើម្បីចុះឋានានុក្រម។
	លេងURL		URI ដែលអាចត្រូវបានហៅដោយផ្ទាល់ដើម្បីហៅសកម្មភាពលេងលំនាំដើមសម្រាប់ធាតុដែលចោទសួរ។ ជាធម្មតា នេះគឺដើម្បីជម្រះជួរ ហើយចាប់ផ្តើមលេងវា។
	លេងដោយស្វ័យប្រវត្តិURL		URI ដែលអាចត្រូវបានហៅដោយផ្ទាល់ដើម្បីបន្ថែមបទមួយទៅជួរ ហើយចាក់វា ហើយបន្ថែមបទជាបន្តបន្ទាប់ពីវត្ថុដែលមាន (ដូចជាអាល់ប៊ុម) ទៅការបំពេញដោយស្វ័យប្រវត្តិ

ធាតុ	គុណលក្ខណៈ (និងតម្លៃ)	ការពិពណ៌នា
		ផ្នែកនៃជួរលេង។
	contextMenuKey	តម្លៃដែលត្រូវប្រើសម្រាប់ប៉ារ៉ាម៉ែត្រគន្លឹះទៅនឹងសំណើរ /Browse ដើម្បីទទួលបានលទ្ធផលដែលជា context-menu នៃសកម្មភាពដែលទាក់ទងនឹងធាតុ។
	សកម្មភាពURL	URI ដែលអាចត្រូវបានហៅដោយផ្ទាល់ដើម្បីអនុវត្តសកម្មភាពដែលបានបញ្ជាក់។

ធាតុម៉ឺនុយបរិបទអាចមានតម្លៃដូចខាងក្រោមសម្រាប់គុណលក្ខណៈប្រភេទ។

គុណលក្ខណៈ
		ការពិពណ៌នា
សំណព្វ	- បន្ថែម	បន្ថែមធាតុជាចំណូលចិត្ត (ឬសមមូល)
	- លុប	យកធាតុចេញពីចំណូលចិត្តរបស់អ្នកប្រើ
បន្ថែម		បន្ថែមទៅជួរលេង
បន្ថែម	-ឥឡូវ​នេះ	បន្ថែមទៅជួរចាក់បន្ទាប់ពីបទបច្ចុប្បន្ន ហើយចាក់ឥឡូវនេះ
	- បន្ទាប់	បន្ថែមទៅជួរចាក់បន្ទាប់ពីបទបច្ចុប្បន្ន
	- ចុងក្រោយ	បន្ថែមទៅចុងបញ្ចប់នៃជួរលេង
បន្ថែមទាំងអស់។	-ឥឡូវ​នេះ	បន្ថែមវត្ថុពហុបទទៅជួរលេង ហើយលេងឥឡូវនេះ
	- បន្ទាប់	បន្ថែមវត្ថុពហុបទទៅជួរចាក់បន្ទាប់ពីបទបច្ចុប្បន្ន ឬវត្ថុពហុបទ
	- ចុងក្រោយ	បន្ថែមវត្ថុពហុបទទៅចុងបញ្ចប់នៃជួរលេង
លេងវិទ្យុ		ចាក់ស្ថានីយ៍វិទ្យុទាក់ទងនឹងធាតុ

លុប

លុបវត្ថុ (ជាធម្មតាបញ្ជីចាក់)។ ការបញ្ជាក់របស់អ្នកប្រើប្រាស់គួរតែត្រូវបានស្នើសុំ

នៅពេលរុករកជាមួយប៉ារ៉ាម៉ែត្រ “withContextMenuItem=1” លទ្ធផលនឹងមានម៉ឺនុយបរិបទក្នុងជួរ។
Example
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26genre%3D0%26category %3Dtoplist&withContextMenuItems=1
តើសំណើ Deezer => What's Hot => អាល់ប៊ុមពេញនិយមដែលមានម៉ឺនុយបរិបទក្នុងជួរ។
ការឆ្លើយតប
ការឆ្លើយតបមាននៅក្នុងជួរ សម្រាប់ធាតុនីមួយៗ។

<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”>
<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=”/Add?service=Deezer&playnow=-1&where=last&albumid=693798541″/>


…

កំណត់ចំណាំ និងការណែនាំអំពីការអនុវត្ត
គុណលក្ខណៈ​ប្រភេទ​របស់​វត្ថុ​ត្រូវ​បាន​ផ្ដល់​ជា​តម្រុយ​ដែល​អាច​ជួយ​សម្រួល​ដល់​ជម្រើស​ការ​បង្ហាញ​ផ្សេងៗ។
សមត្ថភាពក្នុងការរកមើលមាតិកានៃធាតុត្រូវបានចង្អុលបង្ហាញដោយវត្តមាននៃគុណលក្ខណៈ browseKey ។ សមត្ថភាពក្នុងការលេងធាតុ (ទាំងមូល) ត្រូវបានចង្អុលបង្ហាញដោយវត្តមាននៃការលេងURL (ហើយក៏អាចលេងដោយស្វ័យប្រវត្តិផងដែរ។URL) គុណលក្ខណៈ។ ធាតុមួយអាចមានទាំងលក្ខណៈ browseKey និងការលេងURL គុណលក្ខណៈ។
ពេលទាំងពីរលេងURL និងការលេងដោយស្វ័យប្រវត្តិURL គុណលក្ខណៈអាចរកបាន មួយណាដែលត្រូវប្រើជាជម្រើសលេងលំនាំដើមគួរតែជាកម្មវត្ថុនៃចំណូលចិត្តរបស់អ្នកប្រើ។
តម្លៃ URI ជាទូទៅនឹងជា URI ដែលទាក់ទងជាមួយសមាសធាតុផ្លូវដាច់ខាត។ URIs ដែលទាក់ទងត្រូវបានដោះស្រាយទៅជា URIs ដាច់ខាតយោងទៅតាម RFC 3986។
browseKey, contextMenuKey និង searchKey តម្លៃគុណលក្ខណៈតែងតែត្រូវបានអ៊ិនកូដ URI (ជាភាគរយគេចចេញ) នៅពេលប្រើជាតម្លៃនៃប៉ារ៉ាម៉ែត្រគន្លឹះទៅនឹងសំណើរ /Browse ដូចនឹងប៉ារ៉ាម៉ែត្រសំណើផ្សេងទៀតដែរ។
នៅពេលចុះក្រោមឋានានុក្រមរុករក វាអាចមានប្រយោជន៍សម្រាប់បឋមកថាទំព័រ UI ដើម្បីបង្ហាញប្រភេទនៃ breadcrumb មួយចំនួន ប្រហែលជាប្រើចំណងជើង (អត្ថបទ) នៃថ្នាំងមេ និងជីដូនជីតា។
វាអាចមានប្រយោជន៍ក្នុងការធ្វើឱ្យមានម៉ឺនុយបរិបទសម្រាប់មាតាបិតានៅពេលរកមើលកូនរបស់វា។
វាអាចមានប្រយោជន៍ក្នុងការពិចារណាអំពីប្រភេទនៃឪពុកម្តាយនៅពេលសម្រេចចិត្តពីរបៀបបង្ហាញកូនរបស់វា។
7.2 ស្វែងរកមាតិកាតន្ត្រី
ការពិពណ៌នា
ពាក្យបញ្ជាដើម្បីស្វែងរកក្នុងសេវាកម្ម។
ស្នើសុំ
/Browse?key=key-value&q=searchText

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
គន្លឹះ	តម្លៃ​ដែល​ត្រូវ​បាន​យក​ពី​តម្លៃ​គុណលក្ខណៈ "searchKey" ពី​ការ​ឆ្លើយតប​មុន​
q	ខ្សែអក្សរស្វែងរក។ អនុវត្តការស្វែងរកនៃបរិបទដែលបានបញ្ជាក់ដោយប៉ារ៉ាម៉ែត្រគន្លឹះ (យកពីគុណលក្ខណៈ searchKey ពីការឆ្លើយតប)។ អវត្ដមាននៃប៉ារ៉ាម៉ែត្រសំខាន់ ធ្វើការស្វែងរកកម្រិតកំពូល។

ការឆ្លើយតប
<browse sid=”16″ serviceIcon=”/Sources/images/DeezerIcon.png” serviceName=”Deezer”
service=”Deezer” searchKey=”Deezer:Search” type=”menu”>





ត្រឡប់កម្រិតកំពូលនៃលទ្ធផលស្វែងរក។ សម្រាប់លទ្ធផលស្វែងរកបន្ថែមនៃសិល្បករ អាល់ប៊ុម ចម្រៀង ឬបញ្ជីចាក់ ពាក្យបញ្ជារុករកដោយប្រើ "browseKey" ជាគន្លឹះត្រូវបានទាមទារ។
សម្រាប់អតីតample ដើម្បីមើលលទ្ធផលស្វែងរករបស់អាល់ប៊ុម សូមផ្ញើពាក្យបញ្ជា៖
http://192.168.1.100:11000/Browse?key=%2FAlbums%3Fservice%3DDeezer%26expr%3Dmichael
ការឆ្លើយតបនឹងដូចគ្នានឹងការឆ្លើយតបទៅនឹងពាក្យបញ្ជាធម្មតា / រកមើល។

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
យោងទៅតារាងធាតុ/គុណលក្ខណៈនៅក្នុងពាក្យបញ្ជារកមើល

Example
http://192.168.1.100:11000/Browse?key=Deezer:Search&q=michael ស្វែងរក "michael" នៅក្នុងសេវាកម្មតន្ត្រី Deezer ។

ការដាក់ក្រុមអ្នកលេង

ផ្នែកនេះពិពណ៌នាអំពីពាក្យបញ្ជាសម្រាប់ការដាក់ក្រុមអ្នកលេងលំនាំដើម និងការបំបែកក្រុម។ BluOS ក៏គាំទ្រការដាក់ជាក្រុមថេរផងដែរ ដែលវាហួសវិសាលភាពសម្រាប់ឯកសារនេះ។
BluOS ប្រើពាក្យព្យញ្ជនៈបឋម និងអ្នកលេងបន្ទាប់បន្សំ។ អ្នកលេងសំខាន់គឺជាអ្នកលេងសំខាន់នៅក្នុងក្រុម។ កម្មវិធីចាក់ចម្បងត្រូវបានប្រើដើម្បីជ្រើសរើសប្រភពតន្ត្រី។ មានអ្នកលេងបឋមតែមួយគត់។ អ្នកលេងបន្ទាប់បន្សំត្រូវបានភ្ជាប់ទៅនឹងអ្នកលេងបឋម។ អាចមានអ្នកលេងបន្ទាប់បន្សំជាច្រើន។
ប្រសិនបើអ្នកលេងជាអ្នកលេងបន្ទាប់បន្សំ នោះសំណើជាច្រើនប្រសិនបើត្រូវបានដឹកនាំទៅអ្នកលេងបន្ទាប់បន្សំ នឹងត្រូវបានបញ្ជូនខាងក្នុងទៅអ្នកលេងចម្បង។ ទាំងនេះរួមមាន /ស្ថានភាព ការគ្រប់គ្រងការចាក់សារថ្មី ការគ្រប់គ្រងជួរលេង និងសំណើរុករក និងស្វែងរកមាតិកា។
8.1 ក្រុមអ្នកលេងពីរនាក់
ការពិពណ៌នា
ដាក់អ្នកលេងបន្ទាប់បន្សំមួយក្រុមទៅអ្នកលេងបឋម។
ស្នើសុំ
/AddSlave?slave=secondaryPlayerIP&port=secondaryPlayerPort&group=GroupName

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
ទាសករ	អាសយដ្ឋាន IP របស់អ្នកលេងបន្ទាប់បន្សំ។
ច្រក	លេខច្រករបស់អ្នកលេងបន្ទាប់បន្សំ។ លេខច្រកលំនាំដើមគឺ 11000។ អ្នកលេងដូចជា NAD CI580 ដែលមានអ្នកលេងបួននាក់ដែលមាន IP តែមួយ ប្រើច្រកច្រើន។
ក្រុម	ជាជម្រើស ឈ្មោះក្រុម។ ប្រសិនបើមិនបានផ្តល់ទេ BluOS នឹងផ្តល់ឈ្មោះក្រុមលំនាំដើម។

ការឆ្លើយតប

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
ច្រកទាសករ	លេខច្រកនៃអ្នកលេងបន្ទាប់បន្សំដែលទើបតែត្រូវបានដាក់ជាក្រុម។
Id	លេខសម្គាល់អ្នកលេងបន្ទាប់បន្សំដែលទើបតែត្រូវបានដាក់ជាក្រុម។

Example
http://192.168.1.100:11000/AddSlave?slave=192.168.1.153&port=11000
អ្នកលេងក្រុមនេះ 192.168.1.153 ទៅអ្នកលេង 192.168.1.100 ។ អ្នកលេង 192.168.1.100 គឺជាអ្នកលេងចម្បង។
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
ក្រុមអ្នកលេងបន្ទាប់បន្សំ 192.168.1.153 និង 192.168.1.120 ដល់អ្នកលេងបឋម 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″
ម៉ាក = "Bluesound" អ៊ីtag=”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 ពីក្រុមដែលមានអ្នកលេងបឋម 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
លុបអ្នកលេង 192.168.1.153 និង 192.168.1.120 ចេញពីក្រុមដែលមានអ្នកលេងចម្បង 192.168.1.100។

អ្នកលេងចាប់ផ្ដើមឡើងវិញ

ផ្នែកនេះពិពណ៌នាអំពីពាក្យបញ្ជាសម្រាប់ការចាប់ផ្ដើមឡើងវិញទន់របស់អ្នកលេង។
9.1 ចាប់ផ្ដើមអ្នកលេងឡើងវិញ
ការពិពណ៌នា
ចាប់ផ្តើមអ្នកលេងឡើងវិញដោយទន់។
ស្នើសុំ
ពាក្យបញ្ជា POST / ចាប់ផ្ដើមឡើងវិញជាមួយប៉ារ៉ាម៉ែត្របាទ (តម្លៃណាមួយ)

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
បាទ	តម្លៃណាមួយ (ឧទាហរណ៍ 1) ។

ការឆ្លើយតប
បានធ្វើបច្ចុប្បន្នភាពការកំណត់
កំពុងដំណើរការឡើងវិញ។ សូមបិទបង្អួចនេះ។
សូមរង់ចាំ…
Example
curl -d yes=1 192.168.1.100/ចាប់ផ្ដើមឡើងវិញ

កណ្តឹងទ្វារ

ផ្នែកនេះពិពណ៌នាអំពីពាក្យបញ្ជាសម្រាប់កណ្ដឹងទ្វាររបស់អ្នកលេង។
10.1 សំឡេងរោទិ៍កណ្ដឹងទ្វារ
ការពិពណ៌នា
ធ្វើឱ្យកណ្ដឹងទ្វារសកម្ម។
ស្នើសុំ
http://PLAYERIP:PORT/Doorbell?play=1

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
លេង	លេងកណ្ដឹងទ្វារ (1 ជានិច្ច)

ការឆ្លើយតប

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
បើក	ចង្អុលបង្ហាញសំឡេងរោទិ៍
កម្រិតសំឡេង	កម្រិតសំឡេងរោទិ៍
កណ្ដឹង	សំឡេងរោទិ៍

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
ការឆ្លើយតប៖

<item playerName=”Tick
ធីក” text=”ប៊្លូធូស” inputType=”ប៊្លូធូស” id=”បញ្ចូល2″ URL=”Capture%3Abluez%3Abluetooth” image=”/images/BluetoothIcon.png” type=”audio”/>
<item playerName=”Tick Tick” text=”Analog
បញ្ចូល” 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
បញ្ចូល” 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
ធីក” text=”Spotify” id=”Spotify” URL=”Spotify%3Aplay” image=”/ប្រភព/រូបភាព/SpotifyIcon.png” សេវា
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"/>


ជំហានទី 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
ចំណាំ៖ ត្រូវប្រាកដថាប្រភពត្រូវបានភ្ជាប់ និងមិនត្រូវបានលាក់។
11.2 ការជ្រើសរើសការបញ្ចូលខាងក្រៅ
ការពិពណ៌នា
ការជ្រើសរើសប្រភពបញ្ចូលខាងក្រៅ។ ពេលខ្លះការបញ្ចូលខាងក្រៅអសកម្មអាចនឹងមិនបង្ហាញក្នុងការឆ្លើយតបទៅ
/RadioBrowse?service=ចាប់យក។ ពាក្យបញ្ជានេះដំណើរការសម្រាប់ទាំងការជ្រើសរើសធាតុបញ្ចូលសកម្ម និងអសកម្ម។ វាត្រូវបានណែនាំសម្រាប់ជម្រើសបញ្ចូលខាងក្រៅ CI ។
សំណើ (កម្មវិធីបង្កប់ BluOS ថ្មីជាង v3.8.0 និងចាស់ជាង v4.2.0)
/Play?inputIndex=IndexId

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
សន្ទស្សន៍​បញ្ចូល	លិបិក្រម (ចាប់ផ្តើមដោយ 1) នៃធាតុបញ្ចូលដែលលេចឡើងក្នុងការឆ្លើយតបទៅនឹង /Settings?id=capture&shcemaVersion=32 (32 គឺជាកំណែគ្រោងការណ៍ចុងក្រោយបំផុត) តាមលំដាប់លេខ។ ប៊្លូធូសត្រូវបានដកចេញ។

ការឆ្លើយតប
ស្ទ្រីម

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
រដ្ឋ	បង្ហាញថាការបញ្ចូលកំពុងលេង

Example
ជំហានទី 1. ទទួលបានតម្លៃ inputIndex
សំណើ៖ http://192.168.1.100:11000/Settings?id=capture&schemaVersion=32
ការឆ្លើយតប៖

<menuGroup icon=”/images/settings/ic_capture.png” url= "/ ការកំណត់" លេខសម្គាល់ = "ការចាប់យក"
displayName=”ប្ដូរប្រភពតាមបំណង”>
<setting icon=”/images/settings/ic_bluetooth.png” refresh=”true” url=”/audiomodes”
id=”bluetooth” displayName=”Bluetooth” value=”3″ name=”bluetoothAutoplay” description=”Disabled” explanation=”Manual mode អនុញ្ញាតឱ្យអ្នកប្តូររវាងប្រភពនៅក្នុងថតរុករក។ របៀបស្វ័យប្រវត្តិប្តូរទៅប្រភពប៊្លូធូស នៅពេលឧបករណ៍ប៊្លូធូសដែលបានភ្ជាប់ចាប់ផ្តើមចាក់សំឡេង។ បន្ទាប់មក អ្នកអាចប្តូររវាងប្រភពនៅក្នុងថតរុករក។ របៀបភ្ញៀវប្តូរទៅប្រភពប៊្លូធូស នៅពេលឧបករណ៍ប៊្លូធូសដែលបានភ្ជាប់ចាប់ផ្តើមចាក់សំឡេង។ ប្រសិនបើអ្នកប្តូរទៅប្រភពផ្សេងទៀត ប៊្លូធូសនឹងផ្តាច់។ ប្រភពប៊្លូធូសមិនបង្ហាញនៅក្នុងថតរុករកទេ។ Disabled ដកប្រភពចេញពីថតរុករក ហើយមិនអនុញ្ញាតឱ្យឧបករណ៍ផ្សេងទៀតភ្ជាប់ទៅអ្នកលេងជាប៊្លូធូសទេ
ប្រភព។” class="list">
…

<menuGroup icon=”/images/capture/ic_analoginput.png” url=”/setting” id=”captureinput0″
displayName=”អាណាឡូក
បញ្ចូល">

<menuGroup icon=”/images/capture/ic_opticalinput.png” url=”/setting” id=”capture-input1″
displayName=”ការបញ្ចូលអុបទិក”>


ការឆ្លើយតបបង្ហាញពីប៊្លូធូស ការបញ្ចូលអាណាឡូក និងការបញ្ចូលអុបទិក។ ប៊្លូធូសត្រូវបានដកចេញ ដូច្នេះតម្លៃ inputIndex គឺ 1 សម្រាប់ការបញ្ចូលអាណាឡូក ហើយតម្លៃ inputIndex គឺ 2 សម្រាប់ការបញ្ចូលអុបទិក។'
ជំហានទី 2. ចាក់បញ្ចូលអុបទិកនៅលើអ្នកលេង។
http://192.168.1.100:11000/Play?InputId=2
សំណើ (កម្មវិធីបង្កប់ BluOS v4.2.0 ឬថ្មីជាងនេះ)
/Play?inputTypeIndex=$typeIndex

ប៉ារ៉ាម៉ែត្រ

ការពិពណ៌នា

លិបិក្រមបញ្ចូលប្រភេទ

typeIndex មានទម្រង់ ប្រភេទ-សន្ទស្សន៍ នៃការបញ្ចូលមួយ។ នេះគឺជាបញ្ជីនៃការបញ្ចូល ប្រភេទ: spdif (ការបញ្ចូលអុបទិក) អាណាឡូក (ការបញ្ចូលអាណាឡូក, បន្ទាត់ចូល) ប៊្លូធូស (Coaxial Input) ធ្នូ (HDMI ARC) earc (HDMI eARC) phono (Vinyl) កុំព្យូទ័រ aesebu (AES/EBU) មានតុល្យភាព (តុល្យភាពក្នុង) មីក្រូហ្វូន (បញ្ចូលមីក្រូហ្វូន) នេះ។ សន្ទស្សន៍ ចាប់ផ្តើមពី 1. នៅពេលដែលមានធាតុបញ្ចូលច្រើនជាងមួយប្រភេទដូចគ្នា បញ្ចូល 1 មាន សន្ទស្សន៍ 1, បញ្ចូល 2 មាន សន្ទស្សន៍ 2, ហើយដូច្នេះនៅលើ។

ការឆ្លើយតប
ស្ទ្រីម

គុណលក្ខណៈឆ្លើយតប	ការពិពណ៌នា
រដ្ឋ	បង្ហាញថាការបញ្ចូលកំពុងលេង

Example
សំណើ៖ http://192.168.1.100:11000/Play?inputTypeIndex=spdif-2 ដើម្បីជ្រើសរើសការបញ្ចូលអុបទិក 2
ការឆ្លើយតប៖ ស្ទ្រីម

ប៊្លូធូស

ផ្នែកនេះពិពណ៌នាអំពីពាក្យបញ្ជាដើម្បីផ្លាស់ប្តូររបៀបប៊្លូធូស។
12.1 ផ្លាស់ប្តូររបៀបប៊្លូធូស
ការពិពណ៌នា
ប្តូររបៀបប៊្លូធូស៖ ដោយដៃ, ស្វ័យប្រវត្តិ, ភ្ញៀវ, បិទ។
ស្នើសុំ
/audiomodes?bluetoothAutoplay=value

ប៉ារ៉ាម៉ែត្រ	ការពិពណ៌នា
ប៊្លូធូសលេងដោយស្វ័យប្រវត្តិ	របៀបប៊្លូធូស តម្លៃ 0 មានន័យថា Manual, 1 មានន័យថា Automatic, 2 មានន័យថា Guest, 3 មានន័យថា Disabled។

គ្មានការឆ្លើយតប
Example
សំណើ៖ http://192.168.1.100:11000/audiomodes?bluetoothAutoplay=3 ដើម្បីបិទប៊្លូធូស

ឧបសម្ព័ន្ធ

13.1 ពិធីការរកឃើញសេវាកម្ម Lenbrook
សេចក្តីផ្តើម
វិធីសាស្ត្ររកឃើញដ៏ពេញនិយមដូចជា mDNS និង SSDP ប្រើប្រាស់ និងពឹងផ្អែកលើ UDP multicast communication ។ ផលិតផល Lenbrook បច្ចុប្បន្នភាគច្រើនប្រើ mDNS សម្រាប់ការរកឃើញ។ ជាអកុសល យើងបានរកឃើញថា អតិថិជនរបស់យើងមួយចំនួនធំមានបណ្តាញផ្ទះ ដែលចរាចរណ៍ពហុខាសមិនដំណើរការត្រឹមត្រូវ ហើយឧបករណ៍របស់យើងមិនអាចត្រូវបានរកឃើញដោយភាពជឿជាក់។ នេះ​បាន​ធ្វើ​ឱ្យ​មាន​ការ​ត្រឡប់​ផលិតផល​ជា​ច្រើន​និង​ការ​ត្អូញត្អែរ​ពី​អ្នក​ចែក​ចាយ​របស់​យើង​។
ដើម្បីដោះស្រាយបញ្ហានេះ យើងបានបង្កើតពិធីការរកឃើញផ្ទាល់ខ្លួនមួយហៅថា LSDP ដែលប្រើប្រាស់ការផ្សាយ UDP ។ ការធ្វើតេស្តដំបូងបានបង្ហាញថាវាមានភាពជឿជាក់ជាងការរកឃើញដោយផ្អែកលើ mDNS ។
ពិធីការចប់view
គោលដៅមួយនៃពិធីការនេះគឺមានភាពសាមញ្ញ។ វាអាចត្រូវបានប្រើនៅក្នុងឧបករណ៍ដែលបានបង្កប់ដែលមានអង្គចងចាំមានកម្រិតខ្លាំង។
ពិធីការប្រើកញ្ចប់ផ្សាយ UDP ទាំងអស់ទៅ និងមកពីច្រក UDP 11430។ ច្រកនេះត្រូវបានចុះឈ្មោះជាមួយ IANA ហើយត្រូវបានចាត់ឱ្យទៅ Lenbrook សម្រាប់ការប្រើប្រាស់ LSDP គិតត្រឹមថ្ងៃទី 27 ខែមីនា ឆ្នាំ 2014។
ស្ថិត​ក្នុង​ស្ថានភាព​ស្ថិរភាព​ថ្នាំង​នីមួយៗ​ដែល​មាន​សេវាកម្ម​ផ្សាយ​ពាណិជ្ជកម្ម​ផ្សាយ​សារ​ប្រកាស​ប្រមាណ​ជា​រៀងរាល់​នាទី។
នៅពេលចាប់ផ្តើម ហើយនៅពេលដែលបញ្ជីសេវាកម្ម ឬប៉ារ៉ាម៉ែត្របណ្តាញផ្លាស់ប្តូរកញ្ចប់ព័ត៌មានចំនួនប្រាំពីរនឹងត្រូវបានផ្សាយជាមួយនឹងចន្លោះពេលខ្លី ដើម្បីអនុញ្ញាតឱ្យការរកឃើញដំបូង និងការផ្លាស់ប្តូរដើម្បីផ្សព្វផ្សាយកាន់តែលឿន។ សម្រាប់សេវាកម្មផ្សាយពាណិជ្ជកម្មថ្នាំង កញ្ចប់ទាំងប្រាំពីរដំបូងទាំងនេះនឹងរួមបញ្ចូលសារប្រកាស។ សម្រាប់ថ្នាំងដែលព្យាយាមស្វែងរកសេវាកម្ម កញ្ចប់ប្រាំពីរដំបូងនឹងរួមបញ្ចូលសារសំណួរ។ សម្រាប់សេវាកម្មដែលមិនមានទៀតទេ កញ្ចប់ទាំងប្រាំពីរគួរតែរួមបញ្ចូលសារលុប។
កញ្ចប់ព័ត៌មានដំបូងទាំងនេះត្រូវបានផ្ញើចំនួន 7 ដងដោយសារតែលក្ខណៈមិនគួរឱ្យទុកចិត្តនៃកញ្ចប់ UDP ។ ក្នុង​ករណី​ដែល​មិន​ទំនង​សេវា​បរាជ័យ​ទាំង​ប្រាំពីរ​កញ្ចប់​នឹង​នៅ​តែ​ត្រូវ​បាន​រក​ឃើញ​បន្ទាប់​ពី​មួយ​រយៈ​ពី​ការ​ប្រកាស​សារ​តាម​កាលកំណត់​មួយ​នាទី។
ប្រសិនបើថ្នាំងទទួលបានសារសំណួរសម្រាប់ថ្នាក់សេវាកម្ម វាជាការផ្សាយពាណិជ្ជកម្ម វានឹងឆ្លើយតបជាមួយនឹងសារប្រកាសបន្ទាប់ពីការពន្យាពេលចៃដន្យខ្លីមួយ ហើយកំណត់ពេលវេលានៃការប្រកាសបច្ចុប្បន្នរបស់វាឡើងវិញ។
បឋមកថាកញ្ចប់ព័ត៌មាន និងប្លុកសារទាំងអស់ រួមបញ្ចូលវាលប្រវែង។ នេះផ្តល់នូវភាពបត់បែនបន្ថែម និងអនុញ្ញាតឱ្យមានការផ្លាស់ប្តូរដែលត្រូវគ្នាពីក្រោយដែលនឹងត្រូវបានធ្វើឡើងនាពេលអនាគត។ វាលបន្ថែម ឬប្រភេទសារអាចត្រូវបានបន្ថែមនៅពេលអនាគត ដែលការអនុវត្តចាស់ៗអាចរំលងនៅពេលញែក។ ប្រសិនបើ​យើង​សម្រេច​ចិត្ត​ធ្វើ​ការ​ផ្លាស់​ប្តូរ​មិន​ត្រូវ​គ្នា​ថយ​ក្រោយ វា​ក៏​មាន​វាល​កំណែ​នៅ​ក្នុង​បឋមកថា​កញ្ចប់​ដែល​អាច​ត្រូវ​បាន​បង្កើន។
ពិធីការនេះក៏អនុញ្ញាតឱ្យបញ្ចូលកំណត់ត្រា TXT ជាមួយនឹងការផ្សាយពាណិជ្ជកម្មសេវាកម្មស្រដៀងទៅនឹងកំណត់ត្រា TXT ដែលបានប្រើ
ជាមួយ mDNS ។ នេះផ្តល់នូវភាពបត់បែនយ៉ាងសំខាន់សម្រាប់ទិន្នន័យមេតាដែលបំពានបន្ថែមដែលត្រូវបញ្ចូលជាមួយសេវាកម្ម
ការផ្សាយពាណិជ្ជកម្មដោយមិនផ្លាស់ប្តូរពិធីការ។
ព័ត៌មានលម្អិតអំពីពិធីការ
ពេលវេលា
រាល់កញ្ចប់ព័ត៌មានដែលបានផ្ញើគួរតែត្រូវបានកំណត់ពេលដោយចៃដន្យ ឬការពន្យារពេល ដើម្បីជួយជៀសវាងការប៉ះទង្គិច។

• ពេលវេលាកញ្ចប់ចាប់ផ្តើម៖ 7 កញ្ចប់នៅពេល = [0, 1, 2, 3, 5, 7, 10s] + (0 ទៅ 250ms ចៃដន្យ)។ ទាំងនេះគឺជាពេលវេលាដាច់ខាត មិនមែនជាការពន្យារពេលទេ។ កញ្ចប់ទាំង 7 គួរតែត្រូវបានផ្ញើក្នុងរយៈពេលប្រហែល 10 វិនាទី។
• រយៈពេលប្រកាសចម្បង៖ 57s + (0 ទៅ 6s ចៃដន្យ)
• ការពន្យាពេលការឆ្លើយតបរបស់សំណួរ៖ (ចៃដន្យពី 0 ទៅ 750ms)

លេខសម្គាល់ថ្នាំង
ថ្នាំងនីមួយៗត្រូវមានលេខសម្គាល់តែមួយគត់ដែលអាចត្រូវបានប្រើដើម្បីកំណត់អត្តសញ្ញាណថ្នាំង។ លេខសម្គាល់តែមួយគត់ត្រូវបានរួមបញ្ចូលក្នុងប្រកាស និងលុបសារ។ អតិថិជនអាចប្រើតម្លៃនេះជាកូនសោចម្បងនៅពេលរក្សាទុកតម្លៃ និងដើម្បីកំណត់អត្តសញ្ញាណថ្នាំងដោយឯកឯង។ លេខសម្គាល់តែមួយគត់នេះអាចជាអាសយដ្ឋាន MAC ប៉ុន្តែគួរតែដូចគ្នាសម្រាប់ចំណុចប្រទាក់នីមួយៗ ប្រសិនបើថ្នាំងមានចំណុចប្រទាក់ច្រើនដែលវាត្រូវបានផ្សាយពាណិជ្ជកម្ម។
រចនាសម្ព័ន្ធកញ្ចប់
កញ្ចប់ព័ត៌មាននីមួយៗចាប់ផ្តើមដោយបឋមកថាកញ្ចប់ព័ត៌មានតាមពីក្រោយដោយចំនួនប្លុកសារដែលបំពាន។ ប្លុកសារនីមួយៗចាប់ផ្តើមដោយវាលប្រវែង ដូច្នេះសារដែលមិនស្គាល់អាចត្រូវបានរំលង។ លុះត្រាតែបានបញ្ជាក់បើមិនដូច្នេះទេ តម្លៃលេខពហុបៃទាំងអស់ត្រូវរក្សាទុកធំ (បៃដែលសំខាន់មុនគេ)។ លុះត្រាតែបានបញ្ជាក់ផ្សេងពីនេះ លេខទាំងអស់គឺជាតម្លៃដែលមិនបានចុះហត្ថលេខា។ សម្រាប់អតីតampប្រវែងមួយបៃអាចមានតម្លៃពី 0 ដល់ 255 ។
ក្បាលកញ្ចប់

វាល	បៃ	ការពិពណ៌នា
ប្រវែង	1	ប្រវែងសរុបនៃបឋមកថារួមទាំងវាលនេះ។
ពាក្យវេទមន្ត	4	វាលនេះនឹងក្លាយជាបៃ ASCII បួននៃ "LSDP" ។ វាជួយយើងកំណត់អត្តសញ្ញាណកញ្ចប់ព័ត៌មានដែលមានបំណងប្រើប្រាស់ ដូច្នេះយើងមិនចាំបាច់ព្យាយាមញែកទិន្នន័យចៃដន្យពីប្រភពដែលមិនរំពឹងទុកមួយចំនួននោះទេ។
ពិធីសារកំណែ	1	កំណែនៃពិធីការ។ ប្រសិនបើការផ្លាស់ប្តូរនាពេលអនាគតត្រូវបានធ្វើឡើងចំពោះពិធីការដែលថយក្រោយមិនត្រូវគ្នានឹងកំណែនេះ។

វាល	បៃ ការពិពណ៌នា
		នឹងត្រូវបានផ្លាស់ប្តូរ។ កំណែបច្ចុប្បន្នគឺ 1 ។

សារសួរ

វាល
	បៃ	ការពិពណ៌នា
ប្រវែង	1	ប្រវែងសរុបនៃសារ រួមទាំងវាលនេះ។
ប្រភេទសារ	1	“Q” = 0x51៖ សំណួរស្តង់ដារសម្រាប់ការឆ្លើយតបការផ្សាយ។ “R” = 0x52៖ សំណួរសម្រាប់ការឆ្លើយតប unicast ។
រាប់	1	ចំនួនថ្នាក់ដែលត្រូវសួរ។
ថ្នាក់ 1	2	លេខសម្គាល់ថ្នាក់ 16 ប៊ីត (2 បៃ) ។
…		ធ្វើវាលពីមុនម្តងទៀតសម្រាប់ថ្នាក់បន្ថែមនីមួយៗ។

ប្រកាសសារ
ប្រកាសបឋមកថា

វាល
	បៃ	ការពិពណ៌នា
ប្រវែង	1	ប្រវែងសរុបនៃសារ រួមទាំងបឋមកថាប្រកាសពេញលេញ និងកំណត់ត្រាប្រកាស។
ប្រភេទសារ	1	"A" = 0x41
ប្រវែងលេខសម្គាល់ថ្នាំង	1	ប្រវែងនៃវាលលេខសម្គាល់ថ្នាំង។
លេខសម្គាល់ថ្នាំង	អថេរ	លេខសម្គាល់ថ្នាំងតែមួយគត់នៃ node ផ្ញើការប្រកាស។ ជាធម្មតានេះគឺជាអាសយដ្ឋាន MAC នៃចំណុចប្រទាក់ថ្នាំងមួយ។
ប្រវែងអាសយដ្ឋាន	1	វាលប្រវែងអាសយដ្ឋាន។ សម្រាប់ IPv4 នេះនឹងមាន 4 ។

វាល
	បៃ	ការពិពណ៌នា
អាស័យដ្ឋាន	អថេរ	អាសយដ្ឋាន IP របស់ថ្នាំង។
រាប់	1	ចំនួននៃការប្រកាសកំណត់ត្រាដែលត្រូវធ្វើតាម។

ប្រកាសកំណត់ត្រា

វាល	បៃ	ការពិពណ៌នា
ថ្នាក់	2	លេខសម្គាល់ថ្នាក់ 16 ប៊ីត (2 បៃ) ។
ចំនួន TXT	1	ចំនួនកំណត់ត្រា TXT ដែលត្រូវធ្វើតាម។ ប្រសិនបើសូន្យ វាលខាងក្រោមត្រូវបានលុបចោល។
ប្រវែងគន្លឹះ 1	1	ប្រវែងនៃឈ្មោះគន្លឹះ។
គន្លឹះ ៣៧	អថេរ	ឈ្មោះគន្លឹះ។
តម្លៃ 1 ប្រវែង	1	ប្រវែងនៃអត្ថបទតម្លៃ។
តម្លៃ ១	អថេរ	អត្ថបទតម្លៃ។
…		ធ្វើម្តងទៀតនូវវាល 4 មុនសម្រាប់កំណត់ត្រា TXT បន្ថែមនីមួយៗ។

លុបសារ

វាល
	បៃ	ការពិពណ៌នា
ប្រវែង	1	ប្រវែងសរុបនៃសារ រួមទាំងវាលនេះ។
ប្រភេទសារ	1	"D" = 0x44
ប្រវែងលេខសម្គាល់ថ្នាំង	1	ប្រវែងនៃវាលលេខសម្គាល់ថ្នាំង។
លេខសម្គាល់ថ្នាំង	អថេរ	លេខសម្គាល់ថ្នាំងតែមួយគត់នៃ node ផ្ញើសារ។ ជាធម្មតានេះគឺជាអាសយដ្ឋាន MAC នៃ nodes មួយ។

វាល
	បៃ	ការពិពណ៌នា
		ចំណុចប្រទាក់។
រាប់	1	ចំនួនថ្នាក់ដែលត្រូវអនុវត្តតាម។
ថ្នាក់ 1	2	លេខសម្គាល់ថ្នាក់ 16 ប៊ីត (2 បៃ) ។
…		ធ្វើវាលពីមុនម្តងទៀតសម្រាប់ថ្នាក់បន្ថែមនីមួយៗ។

កិច្ចការលេខសម្គាល់ថ្នាក់

លេខសម្គាល់ថ្នាក់	ការពិពណ៌នា	mDNS សមមូល
0x0001	អ្នកលេង BluOS	_musc._tcp
0x0002	ម៉ាស៊ីនមេ BluOS	_muss._tcp
0x0003	BluOS Player (បន្ទាប់បន្សំនៅក្នុងអ្នកលេងច្រើនតំបន់ដូចជា CI580)	_musp._tcp
0x0004	sovi-mfg ប្រើសម្រាប់ការធ្វើតេស្តផលិតកម្ម។	_sovi-mfg._tcp
0x0005	ក្តារចុចសូវី	_sovi-keypad._tcp
0x0006	អ្នកលេង BluOS (pair slave)	_musz._tcp
0x0007	ពីចម្ងាយ Web កម្មវិធី (AVR OSD Web ទំព័រ)	_ពីចម្ងាយ-web-ui._tcp
0x0008	មជ្ឈមណ្ឌល BluOS	_mush._tcp
0xFFFF	ថ្នាក់ទាំងអស់ - អាចប្រើបានជាមួយសារសំណួរ។

ចំណាំ 1:
កញ្ចប់ព័ត៌មាន LSDP ទាំងមូលត្រូវតែត្រូវបានចាត់ទុកជាទិន្នន័យគោលពីរ។
ចំណាំ 2:
ប្រសិនបើសារប្រកាសមួយមិនអាចផ្ទុកព័ត៌មានថ្នាំងទាំងអស់ (ជាពិសេស CI580) នោះវានឹងបំបែកជា 2 ឬច្រើនសារប្រកាសដោយសារនីមួយៗមានបឋមកថា និងកំណត់ត្រា ហើយសារនីមួយៗផ្ទុកព័ត៌មានរបស់ថ្នាំងទាំងមូល។

BluOS Custom Integration API កំណែ 1.7

ឯកសារ/ធនធាន

BluOS T 778 API ការរួមបញ្ចូលផ្ទាល់ខ្លួន [pdf] សៀវភៅណែនាំអ្នកប្រើប្រាស់ T 778, T 778 Custom Integration API, T 778, Custom Integration API, Integration API, API

ឯកសារយោង

• សៀវភៅណែនាំអ្នកប្រើប្រាស់