DIVUS VISION API програм хангамж

Үзүүлэлтүүд

• Бүтээгдэхүүн: DIVUS VISION API
• Үйлдвэрлэгч: DIVUS GmbH
• Хувилбар: 1.00 REV0 1 – 20240528
• Байршил: Pillhof 51, Eppan (BZ), Итали

Бүтээгдэхүүний мэдээлэл

DIVUS VISION API нь DIVUS VISION системтэй харилцахад зориулагдсан програм хангамжийн хэрэгсэл юм. Энэ нь хэрэглэгчдэд MQTT протоколыг ашиглан систем доторх янз бүрийн элементүүдэд хандах, хянах боломжийг олгодог.

Түгээмэл асуултууд

Асуулт: Би DIVUS VISION API-г компьютер эсвэл автоматжуулалтын технологийн талаар урьдчилж мэдлэггүйгээр ашиглаж болох уу?

Хариулт: Энэхүү гарын авлагыг API-ийн үр ашигтай хэрэглээг хангах үүднээс эдгээр чиглэлээр өмнөх мэдлэгтэй хэрэглэгчдэд зориулан боловсруулсан болно.

ЕРӨНХИЙ МЭДЭЭЛЭЛ

• DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) - Итали

Үйлдлийн заавар, гарын авлага, программ хангамж нь зохиогчийн эрхээр хамгаалагдсан. Бүх эрх хуулиар хамгаалагдсан. Хуулбарлах, хуулбарлах, орчуулах, бүхэлд нь болон хэсэгчлэн орчуулахыг хориглоно. Үл хамаарах зүйл нь хувийн хэрэгцээнд зориулж програм хангамжийн нөөц хуулбарыг бий болгоход хамаарна.
Гарын авлагыг мэдэгдэлгүйгээр өөрчлөх боломжтой. Энэ баримт бичиг болон нийлүүлсэн хадгалах хэрэгсэлд агуулагдах өгөгдөл нь алдаагүй, зөв ​​гэдэгт бид баталгаа өгөхгүй. Сайжруулах зөвлөмж, алдааны талаархи зөвлөмжийг үргэлж хүлээж авах болно. Гэрээнүүд нь энэхүү гарын авлагын тодорхой хавсралтад мөн хамаарна. Энэхүү баримт бичигт заасан тэмдэглэгээ нь гуравдагч этгээд өөрийн зорилгоор ашиглах нь эзэмшигчийн эрхийг зөрчиж болзошгүй барааны тэмдэг байж болно. Хэрэглэгчийн заавар: Анх удаа ашиглахын өмнө энэ гарын авлагыг уншиж, цаашид лавлах зорилгоор аюулгүй газар хадгална уу. Зорилтот бүлэг: Энэхүү гарын авлагыг компьютер болон автоматжуулалтын технологийн талаар өмнөх мэдлэгтэй хэрэглэгчдэд зориулан бичсэн болно.

ИЛТГЭЛИЙН КОНВЕНЦ

Танилцуулга

ЕРӨНХИЙ ТАНИЛЦУУЛГА

Энэхүү гарын авлагад VISION API (Application Programming Interface) - VISION-г гадаад системээс хаяглаж, удирдах боломжтой интерфейсийг тайлбарласан болно.
гэх мэт системүүдийг практикийн хувьд ашиглаж болно гэсэн үг

• MQTT Explorer (https://www.microsoft.com/store/… – туршилт хийх),
• Гэрийн туслах (https://www.home-assistant.io/) эсвэл
• Зангилаа-УЛААН (https://nodered.org/)

VISION-ийн удирддаг элементүүдийг хянах эсвэл статусыг нь унших. Хандалт, харилцаа холбоо нь MQTT протоколоор явагддаг бөгөөд энэ нь бие даасан функц эсвэл функцүүдийн багцыг шийдвэрлэх эсвэл тэдгээрт гарсан өөрчлөлтийн талаар мэдээлэл авах зорилгоор сэдвүүдийг ашигладаг. Энэ зорилгоор MQTT серверийг (брокер) ашигладаг бөгөөд энэ нь аюулгүй байдал болон оролцогчдод мессежийг удирдах/ түгээх ажлыг гүйцэтгэдэг. Энэ тохиолдолд MQTT сервер нь DIVUS KNX IQ дээр шууд байрладаг бөгөөд энэ зорилгоор тусгайлан тохируулагдсан байдаг. VISION API-г програмчлалын мэдлэггүйгээр ч ашиглаж болох ч энэ функц нь ахисан түвшний хэрэглэгчдэд тохиромжтой.

УРЬДЧИЛСАН ШААРДЛАГА

VISION гарын авлагад тайлбарласны дагуу API хэрэглэгч үүнийг ашиглах боломжтой байхын тулд эхлээд анхдагчаар идэвхжүүлсэн байх ёстой бөгөөд API хандалт нь зөвхөн Api хэрэглэгчийн баталгаажуулалтын өгөгдлийг ашиглан ажилладаг. Хэрэглэгчийн эрхийн хувьд энэ функцийг идэвхжүүлэхийг дараа нь бүх зүйл дээр эсвэл тус тусдаа элемент дээр тохируулж болно. 0-р бүлгийг үзнэ үү. Мэдээжийн хэрэг, танд гаднаас хянахыг хүсч буй элементүүдийг бүрэн тохируулсан, тэдгээртэй холболтыг амжилттай туршсан VISION төсөл хэрэгтэй. API-ээр дамжуулан бие даасан элементүүдийг хаяглахын тулд тэдгээрийн элементийн ID-г мэдэх шаардлагатай: энэ нь элементийн тохиргооны маягтын доод хэсэгт харагдана.

АЮУЛГҮЙ БАЙДАЛ

Аюулгүй байдлын үүднээс API хандалтыг зөвхөн дотоодоос хийх боломжтой (өөрөөр хэлбэл үүлэнгээр биш). Тиймээс API хандалтыг идэвхжүүлэх үед аюулгүй байдлын эрсдэл бага байна. Гэсэн хэдий ч, аюулгүй байдалд хамааралтай элементүүдийг идэвхжүүлэх эсвэл API хандалтыг шууд хориглох ёсгүй.

MQTT, ТҮҮНИЙ НӨХЦӨЛ – ТОВЧ ТАЙЛБАР

• MQTT-д төвлөрсөн удирдлага, бүх мессежийг түгээх үүрэг нь брокерын үүрэг юм. Хэдийгээр MQTT сервер болон MQTT брокер нь ижил утгатай биш боловч (сервер гэдэг нь MQTT үйлчлүүлэгчид тоглож болох үүргийн өргөн нэр томьёо юм) MQTT серверийг дурьдсан үед энэ гарын авлагад брокерийг үргэлж хэлдэг. DIVUS KNX IQ нь өөрөө энэ гарын авлагын хүрээнд MQTT брокер / MQTT серверийн үүргийг гүйцэтгэдэг.
• MQTT сервер нь сэдвүүдийг ашигладаг: өгөгдлийг ангилах, удирдах, нийтлэх шаталсан бүтэц.
• Хэвлэлийн гол зорилго нь сэдвүүдээр дамжуулан бусад оролцогчдод өгөгдлийг нээлттэй болгох явдал юм. Хэрэв та утгыг өөрчлөхийг хүсвэл хүссэн сэдвээ хүссэн утгын өөрчлөлтийн хамт нийтлэх үйлдлийг ашиглан бичнэ. Зорилтот төхөөрөмж эсвэл MQTT сервер нь түүнд нөлөөлж буй хүссэн өөрчлөлтийг уншиж, зохих ёсоор хэрэгжүүлдэг. Өөрчлөлт хэрэгжсэн эсэхийг шалгахын тулд та захиалсан бодит цагийн сэдвийг харж, өөрчлөлт тэнд тусгагдсан эсэхийг харах боломжтой - хэрэв бүх зүйл сайн болсон бол.
• Үйлчлүүлэгчид сонирхож буй сэдвүүдийг сонгодог: үүнийг захиалга гэж нэрлэдэг. Сэдвийн доор/доор үнэ цэнэ өөрчлөгдөх бүрд бүх захиалсан үйлчлүүлэгчид мэдээлэл өгдөг, өөрөөр хэлбэл ямар нэг зүйл өөрчлөгдсөн эсэх, одоогийн үнэ цэнэ ямар байгааг тодорхой асуух шаардлагагүй.
• Та сэдэвт client_id гэж нэрлэгддэг өвөрмөц мөрийг оруулснаар MQTT сервертэй тусдаа холбооны суваг нээх (эсвэл хаяглах) боломжтой. Client_id-г утгыг боловсруулахын тулд сэдэвт ашиглах ёстой. Энэ нь өөрчлөлт бүрийн гарал үүслийг тодорхойлоход үйлчилдэг бөгөөд аливаа алдаа гарахад тусалдаг бөгөөд бусад үйлчлүүлэгчдэд нөлөөлөхгүй, учир нь серверийн харгалзах хариултууд, алдааны кодууд болон мессежүүд нь зөвхөн ижил client_id-тэй сэдэвт хүрдэг (ингэснээр зөвхөн тэр үйлчлүүлэгч). client_id нь 0-9, az, AZ, “-“, “_” тэмдэгтүүдийн дурын хослолоос бүрдэх өвөрмөц тэмдэгтийн мөр юм.
• Ерөнхийдөө DIVUS KNX IQ-ийн MQTT серверийн захиалах сэдвүүд нь түлхүүр үгийн статусыг агуулдаг бол нийтлэх сэдвүүд нь түлхүүр үгийн хүсэлтийг агуулдаг. Статустай хүмүүс гадаад үнэ цэнийн өөрчлөлт гарсан даруйд эсвэл үйлчлүүлэгч өөрөө нийтлэлээр дамжуулан үнэ цэнийн өөрчлөлтийг хүссэн, амжилттай хэрэгжсэн даруйд автоматаар шинэчлэгддэг. Нийтлэлд зориулж буйг (хүсэлт/) авах төрлийн ба (хүсэлт/) багц гэж хуваадаг.
• Утгын өөрчлөлт болон бусад нэмэлт параметрүүдийг ачаалал гэж нэрлэгддэг сэдэвт нэмдэг. Тусдаа элементүүдийн параметрүүд (элементийн дугаар, нэр, төрөл, функц)

Үйлчлүүлэгч нь хүсэлт гаргаж, дараа нь өгөгдлийг өөрчилдөг MQTT ба үйлчлүүлэгч-серверийн сонгодог загвар хоёрын гол ялгаа нь захиалах, нийтлэх үзэл баримтлалд төвлөрдөг. Оролцогчид өгөгдлийг нийтэлж, бусдад нээлттэй болгож, сонирхсон хүмүүс үүнийг захиалж болно. Энэхүү архитектур нь мэдээллийн солилцоог багасгах, сонирхогч бүх талуудыг шинэчилсэн хэвээр байлгах боломжийг олгодог. Дэлгэрэнгүй мэдээллийг эндээс авна уу: мөн тусгай параметрүүдийг (uuid, шүүлтүүр) энд ашиглах болно. Хэд хэдэн сонголт байгаа ч энэ гарын авлагад ачааллыг JSON форматаар харуулсан болно. JSON нь ямар ч бүтцийн өгөгдлийг илэрхийлэхийн тулд хаалт, таслалыг ашигладаг бөгөөд ингэснээр дамжуулах өгөгдлийн багцын хэмжээг багасгадаг. Ачааллын талаарх дэлгэрэнгүй мэдээллийг дараа нь гарын авлагаас олж болно.

• Тусгай зорилгоор функцийн төрлөөр шүүж болно, жишээ нь зөвхөн асаах/унтраах, өөрөөр хэлбэл 1 битийн унтраалгыг хаяглах. Ачаалал дахь шүүлтүүрийн параметрийг энэ зорилгоор ашигладаг. Шүүлтүүрийг одоогоор зөвхөн функцийн төрлөөр хийх боломжтой.
• Тусдаа элементүүдийг шийдвэрлэхийн тулд тэдгээрийн элементийн ID шаардлагатай. Үүнийг элементийн шинж чанаруудын цэсний VISION дотроос олж болно, эсвэл MQTT Explorer-ийн ерөнхий бүртгэл дэх боломжтой элемент бүрийн өмнө гарч буй өгөгдлөөс шууд уншиж болно (элементүүдийг элементийн ID-аар цагаан толгойн дарааллаар жагсаасан).

API хандалтын тохиргоо

API ХЭРЭГЛЭГЧИЙН ХЭРЭГЛЭЭНД ЗОРИУЛСАН ХАРААГ ТОХИРУУЛАХ

VISION-д администраторын хувьд Configuration – User/API Access Management хэсэгт очоод Users/API access дээр дараад API User дээр хулганы баруун товчийг дарж (эсвэл удаан дарж) засварлах цонхыг нээнэ. Тэнд та эдгээр параметрүүд болон өгөгдлийг олох болно

• Идэвхжүүлэх (шалгах нүд)
  • Энд хэрэглэгч эхлээд идэвхжсэн байна. Өгөгдмөл идэвхгүй байна
• Хэрэглэгчийн нэр
  • Энэ мөр нь API-ээр нэвтрэхэд шаардлагатай - эндээс хуулж авна уу
• Нууц үг
  • Энэ мөр нь API-ээр нэвтрэхэд шаардлагатай - эндээс хуулж авна уу
• Зөвшөөрөл
  • VISION элементүүдийн утгыг унших, бичих үндсэн эрхийг энд тодорхойлж болно, өөрөөр хэлбэл энд тодорхойлсон зүйл нь одоо байгаа болон ирээдүйн бүх элементүүдэд хамаарна. Хэрэв та зөвхөн бие даасан элементүүдэд хандахыг хүсвэл эдгээр үндсэн эрхийг өөрчлөх ёсгүй

ХУВИЙН ЭЛЕМЕНТҮҮДИЙН ЗӨВШӨӨРӨЛ

Бүх төсөлд API хандалт өгөхгүй, зөвхөн хүссэн элементүүдэд хандахыг зөвлөж байна. Дараах байдлаар үргэлжлүүлнэ үү

1. VISION-д администратороор нэвтэрнэ үү
2. хүссэн элементээ сонгоод түүний тохиргооны цэсийг нээнэ үү (хулганы баруун товчийг дарж эсвэл дарж байгаад дараа нь Тохиргоо)
3. "Ерөнхий - Зөвшөөрөл" цэсний "Өгөгдмөл зөвшөөрлийг хүчингүй болгох" гэснийг идэвхжүүлж, зөвшөөрлийн матрицыг харуулсан "Зөвшөөрөл" дэд зүйл рүү очно уу.
4. хяналтын зөвшөөрлийг энд идэвхжүүлж, энэ нь бас идэвхжүүлдэг view шууд зөвшөөрөл. Хэрэв та зөвхөн API хандалтаар дамжуулан өгөгдлийг уншихыг хүсвэл үүнийг идэвхжүүлэхэд хангалттай view зөвшөөрөл.
5. хандахыг хүссэн бүх элементийн хувьд ижил процедурыг давтана уу

MQTT-ээр холбогдох

ТАНИЛЦУУЛГА

Хуучин хүний ​​хувьдample, бид DIVUS KNX IQ-ийн MQTT API-ээр дамжуулан Windows, Mac болон Linux-д ашиглах боломжтой MQTT Explorer (1.1-р бүлгийг үзнэ үү) хэмээх харьцангуй энгийн, үнэгүй програм хангамжаар дамжуулан нэвтрэх боломжийг харуулах болно. MQTT-ийн талаархи үндсэн мэдлэг, туршлага гэсэн үг.

ХОЛБОЛТОЙД ШААРДЛАГАТАЙ ӨГӨГДӨЛ

Өмнө дурьдсанчлан (2.1 хэсгийг үзнэ үү) API хэрэглэгчийн хэрэглэгчийн нэр, нууц үг шаардлагатай. Энд нэг төгсгөл байнаview Холболт үүсгэхээс өмнө цуглуулах ёстой бүх өгөгдлөөс:

• Хэрэглэгчийн нэр API хэрэглэгчийн дэлгэрэнгүй хуудаснаас уншина уу
• Нууц үг API хэрэглэгчийн дэлгэрэнгүй хуудаснаас уншина уу
• IP хаягийг Ерөнхий - Сүлжээ - Ethernet (эсвэл синхрончлогчоор) хэсэгт эхлүүлэгчийн тохиргооноос уншина уу.
• Порт 8884 (энэ портыг энэ зорилгоор нөөцөлсөн)

MQTT EXPLORER-ТЭЙ АНХНЫ ХОЛБОО БОЛОН GENERAL SUBSCRIBE

Ер нь MQTT нь захиалах, нийтлэх үйл ажиллагааг ялгадаг. MQTT Explorer нь эхний холболт хийгдсэн үед боломжтой бүх сэдвүүдэд (сэдэв #) автоматаар бүртгүүлэх замаар үүнийг хялбаршуулдаг. Үүний үр дүнд, боломжтой бүх элементүүдэд хүргэдэг мод (жишээлбэл, API хэрэглэгчийн хандалт) амжилттай холболт хийсний дараа MQTT Explorer цонхны зүүн талд шууд харагдах болно. Цаашид бүртгүүлэх сэдвүүдийг оруулах эсвэл #-г илүү тодорхой сэдвээр солихын тулд холболтын цонхны Нарийвчилсан хэсэгт очно уу. Баруун дээд талд харуулсан сэдэв нь иймэрхүү харагдаж байна:

Энд 7f4x0607849x444xxx256573x3x9x983 нь API хэрэглэгчийн нэр бөгөөд objects_list нь боломжтой бүх элементүүдийг агуулдаг. Энэ сэдэв нь үргэлж шинэчлэгдэж байдаг, өөрөөр хэлбэл аливаа утгын өөрчлөлтийг тэнд бодит цаг хугацаанд тусгадаг. Хэрэв та зөвхөн тусдаа элементүүдэд бүртгүүлэхийг хүсвэл objects_list/-ийн дараа хүссэн элементийн ID-г оруулна уу.

Тайлбар: Энэ төрлийн захиалга нь KNX-ийн санал хүсэлтийн хаягийн цаана байгаа логиктой ойролцоо байна; Энэ нь элементүүдийн одоогийн төлөвийг харуулах бөгөөд хүссэн өөрчлөлтүүд амжилттай хэрэгжсэн эсэхийг шалгахад ашиглагдаж болно. Хэрэв та зөвхөн өгөгдлийг уншихыг хүсч байгаа ч өөрчлөхгүй бол энэ төрлийн захиалга хангалттай.

Ганц энгийн элемент нь JSON тэмдэглэгээнд иймэрхүү харагдаж байна

Тайлбар: Бүх утгууд дээр дурдсан синтакстай байна, жишээ нь { “утга”: “1” } захиалах сэдвүүдийн гаралт, харин утгыг өөрчлөхийн тулд (өөрөөр хэлбэл сэдвүүдийг нийтлэхийн тулд) шууд ачаалалд бичнэ – хаалт болон "утга"-г орхигдуулсан, жишээ нь "onoff": "1".

Нарийвчилсан тушаалууд

ТАНИЛЦУУЛГА

Ерөнхийдөө 3 төрлийн сэдэв байдаг:

1. Боломжтой элементүүдийг харж, бодит цагийн үнэ цэнийн өөрчлөлтийг авахын тулд сэдвүүдийг захиалаарай
2. (-д) хариулт авахын тулд сэдвүүдийг захиалаарайүйлчлүүлэгчид ) хүсэлтийг нийтлэх
3. Элементүүдийг утгаараа авах эсвэл тохируулах сэдвүүдийг нийтлэх

Бид дараа нь энд үзүүлсэн дугаарлалт (жишээлбэл, 1, 2, 3 төрлийн сэдвүүд) ашиглан эдгээр төрлүүдийг дурдах болно. Дэлгэрэнгүй мэдээллийг дараагийн хэсэг болон бүлэгт үзнэ үү. 4.2.

Боломжтой элементүүдийг харж, бодит цагийн үнэ цэнийн өөрчлөлтийг авахын тулд СЭДВИЙГ ЗАХИАЛААРАЙ

Эдгээрийг аль хэдийн тайлбарласан болно

ҮЙЛЧЛҮҮЛЭГЧДИЙН ХИЙХ ХҮСЭЛТИЙН ХАРИУГ АВАХ СЭДВИЙГ ЗАХИАЛААРАЙ

Энэ төрлийн сэдвүүд нь сонголттой байдаг. Үүнийг зөвшөөрдөг

• дурын client_id ашиглан MQTT сервертэй өвөрмөц холбооны суваг нээх. Энэ талаар дэлгэрэнгүйг бүлэгт. 4.2.2
• Харгалзах захиалгын сэдвээр нийтлэх хүсэлтийн үр дүнг авах: алдааны код болон мессежээр амжилт эсвэл бүтэлгүйтэл.

Хариулт авах эсвэл нийтлэх тушаалыг тохируулах өөр өөр сэдвүүд байдаг. Харгалзах ялгаа Та өөрийн системд шаардлагатай сэдвүүдийг шууд олж авсны дараа энэ алхамыг устгаж, нийтлэх сэдвүүдийг шууд ашиглахаар шийдэж болно.

 ҮНЭ ЦЭНЭТЭЙ ЭЛЕМЕНТҮҮДИЙГ АВАХ БУЮУ ТОХИРУУЛАХ СЭДВИЙГ НИЙТЛҮҮЛ.

Эдгээр сэдвүүд нь бүртгүүлэхтэй төстэй замыг ашигладаг - цорын ганц өөрчлөлт нь бүртгүүлэхэд ашигласан "статус" -ын оронд "хүсэлт" гэсэн үг юм. Сэдвийн бүрэн замыг дараа бүлэгт үзүүлэв. 4.2.2\ Get сэдэв нь MQTT серверийн элементүүд болон утгуудыг унших хүсэлт гаргана. Ачаалал нь элементүүдийн функцын төрлөөс хамааран шүүж болно. Тогтоосон сэдэв нь элементийн зарим хэсгийг өөрчлөх хүсэлтийг түүний ачаалалд дэлгэрэнгүй харуулна.

ТУШААЛ БА ХАРИЛЦАХ ХАРИУУДЫН угтвар

 ТОВЧ ТАЙЛБАР

MQTT сервер рүү илгээсэн бүх тушаалууд нь нийтлэг эхний хэсэгтэй байдаг, тухайлбал:

ДЭЛГЭРЭНГҮЙ ТАЙЛБАР

Бодит цагийн сэдвүүд (төрөл 1) ерөнхий угтвартай (дээрхийг харна уу), дараа нь

or

Тохиромжтой командын хувьд ачаалал нь хүссэн өөрчлөлтийг (өөрөөр хэлбэл элементийн функцүүдийн утгыг өөрчилсөн) агуулсан байх тул гол үүрэг гүйцэтгэдэг нь ойлгомжтой. Анхааруулга: KNX тал дээр асуудал үүсгэж болзошгүй тул 3-р төрлийн командуудад хадгалах сонголтыг хэзээ ч бүү ашиглаарай.

EXAMPLE: НЭГ ЭЛЕМЕНТИЙН ҮНЭ ЦЭВЭРИЙГ ӨӨРЧЛӨХИЙГ ХЭВЛЭХ

Хамгийн энгийн тохиолдол бол ерөнхий захиалагчийн үзүүлсэн элементүүдийн аль нэгийн утгыг өөрчлөхийг хүсэх явдал юм.
Ерөнхийдөө MQTT-ээр дамжуулан VISION функцийг өөрчлөх/шилжүүлэх нь 3 алхамаас бүрдэх бөгөөд бүгдийг нь зайлшгүй хийх шаардлагагүй, гэхдээ бид үүнийг тайлбарласны дагуу хийхийг зөвлөж байна.

1. Бидний засварлахыг хүссэн функцийг агуулсан сэдвийг захиалгат client_id ашиглан захиалсан болно
2. Засварлах сэдвийг 1-д сонгосон client_id ашиглан хүссэн өөрчлөлтийн хамт ачааллын хамт нийтлэнэ.
3. Шалгахын тулд та (1.) сэдвийн хариултыг харж болно, өөрөөр хэлбэл (2.) ажилласан эсэх
4. Өөрчлөлт хийх үед бүх утгууд шинэчлэгддэг ерөнхий бүртгэлд бүх зүйл хэвийн болсон тохиолдолд та хүссэн утгын өөрчлөлтийг харж болно.

Үүнийг хийх алхамууд нь:

1. "Divus" гэх мэт client_id-г сонгоод API хэрэглэгчийн нэрийн дараах замд оруулна уу
   Энэ бол MQTT сервертэй өөрийн харилцааны сувагт бүртгүүлэх бүрэн сэдэв юм. Энэ нь таны илгээх гэж буй өөрчлөлтийн хариуг хаана хүлээж байгааг серверт хэлж өгнө. a-г тодорхойлсон статус/тогтоосон хэсгийг анхаарна уу. энэ нь захиалах сэдэв мөн b. Энэ нь төрөл командуудыг тохируулах хариултуудыг авах болно.
2. Нийтлэх сэдэв нь статус-хүсэлтийн түлхүүр үгсийг солихоос бусад тохиолдолд ижил байх болно
3. Өөрчлөлт юунаас бүрдэх ёстойг ачааны ачаалалд бичнэ. Энд зарим хуучин байнаamples.
   • Асаах/унтраах функцтэй элементийг унтраах (1 бит):
   • Асаах/унтраах функцтэй элементийг асааж байна (1 бит). Нэмж дурдахад, хэрэв ижил үйлчлүүлэгчээс хэд хэдэн ийм тушаалуудыг эхлүүлсэн бол uuid параметрийг ("өвөрмөц ID", ихэвчлэн 128-8-4-4-4 оронтой hex хэлбэрээр форматлагдсан 12 битийн стринг) ашиглаж болно. харгалзах асуулгад хариу өгөх, учир нь энэ параметрийг (хэрэв асуулгад байгаа бол) мөн хариултаас олж болно.
   • Бүдгэрүүлэгчийг асааж, гэрэлтүүлгийг 50% болгож тохируулж байна
   • Дээр үзүүлсэн болон захиалсан сэдвийн хариулт (яг бол түүний ачаалал) нь жишээ нь.ample.
     Дээрх хариулт бол эксampЭлемент нь бүдгэрүүлэх функцгүй хэдий ч зөв ачаалалтай тохиолдолд le. Хэрэв ачааллыг зөв тайлбарлахгүйн тулд илүү ноцтой асуудал гарвал хариу дараах байдлаар харагдах болно (жишээ нь:
     Алдааны код, мессежийн тайлбарын хувьд ерөнхийдөө http шиг 200 код эерэг хариулт, 400 код сөрөг байна.

EXAMPLE: ОЛОН ЭЛЕМЕНТИЙН ҮНЭ ЦЭНГҮҮДИЙГ ӨӨРЧЛӨХИЙГ ХЭВЛЭГЧ

Уг процедур нь нэг элементийг өөрчлөхийн тулд өмнө үзүүлсэнтэй төстэй юм. Ялгаа нь та сэдвүүдээс element_id-г орхиж, дараа нь ачааллын доторх өгөгдлийн өмнө element_id-ийн багцыг зааж өгнө. Доорх синтакс болон бүтцийг харна уу.

АСУУЛГА ДАХЬ ФУНКЦИЙН ТӨРЛӨӨР ШҮҮГДҮҮЛ

Ачаалал дахь шүүлтүүрийн параметр нь зөвхөн элементийн хүссэн функцийг (функцуудыг) шийдвэрлэх боломжийг олгодог. Шилжүүлэгч эсвэл бүдэгрүүлэгчийн асаах/унтраах функцийг "унтраах" гэж нэрлэдэгample, харгалзах шүүлтүүрийг дараах байдлаар тодорхойлно.

Хариулт нь иймэрхүү харагдана, жишээ ньample

Дөрвөлжин хаалт нь та хэд хэдэн функцээр шүүж болно гэдгийг харуулж байна, жишээ нь

дараах хариултыг хүргэж байна.

Хавсралт

АЛДААНЫ КОД

MQTT холболтын алдаа нь тоон код үүсгэдэг. Дараах хүснэгт нь үүнийг задлахад тусална.

АШИГЛАЛТЫН АЧААЛЫН ҮЗҮҮЛЭЛТҮҮД

Ачаалал нь контекстээс хамааран өөр өөр параметрүүдийг дэмждэг. Дараах хүснэгтэд ямар параметрүүд ямар сэдвээр тохиолдож болохыг харуулав

ХУВИЛБАРЫН ТАЙЛБАР

• ХУРАЛ 1.00

Мэдээ:

• Анхны хэвлэл

Баримт бичиг / нөөц

	DIVUS VISION API програм хангамж [pdf] Хэрэглэгчийн гарын авлага VISION API програм хангамж, API програм хангамж, програм хангамж
	DIVUS Vision API програм хангамж [pdf] Хэрэглэгчийн гарын авлага Vision API Програм хангамж, Алсын хараа, API Програм хангамж, Програм хангамж

Лавлагаа

• Хэрэглэгчийн гарын авлага