DIVUS-VISION-لوګو......

د DIVUS VISION API سافټویر

DIVUS-VISION-API-Software-PRODUCT

مشخصات

  • محصول: د DIVUS VISION API
  • جوړونکی: DIVUS GmbH
  • نسخه: 1.00 REV0 1 - 20240528
  • ځای: Pillhof 51، Eppan (BZ)، ایټالیا

د محصول معلومات

د DIVUS VISION API د سافټویر وسیله ده چې د DIVUS VISION سیسټمونو سره د مداخلې لپاره ډیزاین شوې. دا کاروونکو ته اجازه ورکوي چې د MQTT پروتوکولونو په کارولو سره په سیسټم کې مختلف عناصرو ته لاسرسی او کنټرول کړي.

FAQ

پوښتنه: ایا زه کولی شم د کمپیوټر یا اتومات ټیکنالوژۍ دمخه پوهه پرته د DIVUS VISION API وکاروم؟

ځواب: لارښود د هغو کاروونکو لپاره جوړ شوی چې په دې برخو کې پخوانۍ پوهه لري ترڅو د API مؤثره کارونې ډاډ ترلاسه کړي.

عمومي معلومات

  • DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) – ایټالیا

عملیاتي لارښوونې، لارښودونه او سافټویر د کاپي حق لخوا خوندي دي. ټول حقونه خوندي دي. کاپي کول، نقل کول، ژباړل، په بشپړه یا برخه کې ژباړل جواز نلري. یو استثنا د شخصي کارونې لپاره د سافټویر بیک اپ کاپي رامینځته کولو باندې پلي کیږي.
لارښود پرته له خبرتیا د بدلون تابع دی. موږ نشو تضمین کولی چې پدې سند کې موجود معلومات او د ذخیره کولو میډیا چمتو شوي له خطا پاک او سم دي. د سمون لپاره وړاندیزونه او همدارنګه د غلطیو په اړه اشارې تل ښه راغلاست دي. تړونونه د دې لارښود په ځانګړو ضمیمو کې هم پلي کیږي. په دې سند کې نومونه کیدای شي سوداګریزې نښې وي چې د دریمې ډلې لخوا د دوی د خپلو موخو لپاره کارول کیدای شي د دوی د مالکینو حقونه تر پښو لاندې کړي. د کارونکي لارښوونې: مهرباني وکړئ دا لارښود د لومړي ځل لپاره کارولو دمخه ولولئ او د راتلونکي حوالې لپاره یې په خوندي ځای کې وساتئ. د هدف ګروپ: لارښود د هغه کاروونکو لپاره لیکل شوی چې د کمپیوټر او اتومات ټیکنالوژۍ پخوانۍ پوهه لري.

د پریزنټیشن کنوانسیونونهDIVUS-VISION-API-سافټویر-انځر (1)

پیژندنه

عمومي پیژندنه

دا لارښود د VISION API (د غوښتنلیک پروګرام کولو انٹرفیس) تشریح کوي - یو انٹرفیس چې له لارې VISION د بهرني سیسټمونو څخه په نښه او کنټرول کیدی شي.
په عملي شرایطو کې، دا پدې مانا ده چې تاسو کولی شئ سیسټمونه وکاروئ لکه

د VISION لخوا اداره شوي عناصر کنټرول کول یا د دوی وضعیت لوستل. لاسرسی او ارتباط د MQTT پروتوکول له لارې ترسره کیږي، کوم چې د انفرادي دندو یا دندو سیټونو په نښه کولو یا د بدلونونو په اړه د خبرتیا لپاره تش په نامه موضوعات کاروي. د دې هدف لپاره د MQTT سرور (بروکر) کارول کیږي، کوم چې امنیت او ګډون کونکو ته د پیغامونو مدیریت/توزیع اداره کوي. په دې حالت کې، د MQTT سرور مستقیم په DIVUS KNX IQ کې موقعیت لري او د دې هدف لپاره په ځانګړي ډول ترتیب شوی. که څه هم د VISION API د پروګرام کولو پوهې پرته هم کارول کیدی شي، دا فعالیت د پرمختللو کاروونکو لپاره مناسب دی.

شرطونه

لکه څنګه چې د VISION لارښود کې تشریح شوي، د API کاروونکي باید لومړی د ډیفالټ لخوا فعال شي ترڅو د دې کارولو وړ وي د API لاسرسی یوازې د Api کاروونکو تصدیق کولو ډیټا په کارولو سره کار کوي. تر هغه ځایه چې د کارونکي حقونه پورې اړه لري، د دې فعالیت فعالیت بیا په ټولو یا انفرادي عناصرو کې تنظیم کیدی شي. Chap.0 وګورئ. البته ، تاسو د VISION پروژې ته هم اړتیا لرئ په کوم کې چې هغه عناصر چې تاسو یې غواړئ له بهر څخه کنټرول کړئ په بشپړ ډول تنظیم شوي او له دوی سره پیوستون په بریالیتوب سره ازمول شوی. د API له لارې د انفرادي عناصرو په نښه کولو وړتیا لپاره، د دوی عنصر ID باید وپیژندل شي: دا د عنصر د ترتیباتو فورمې په پای کې ښودل کیږي

امنیت

د امنیتي دلیلونو لپاره، د API لاسرسی یوازې په محلي توګه ممکن دی (یعنې د بادل له لارې نه). د API لاسرسي فعالولو پرمهال د امنیت خطر کم دی. په هرصورت، د امنیت اړونده عناصر باید فعال نشي یا په ښکاره توګه د API لاسرسي لپاره رد نه شي.

MQTT او د هغې شرایط – لنډ وضاحت

  • DIVUS-VISION-API-سافټویر-انځر (2)په MQTT کې، د ټولو پیغامونو د مرکزي مدیریت او توزیع رول د بروکر دی. که څه هم د MQTT سرور او MQTT بروکر مترادف ندي (سرور د هغه رول لپاره پراخه اصطلاح ده چې د MQTT پیرودونکي هم لوبولی شي) ، بروکر تل پدې لارښود کې معنی لري کله چې د MQTT سرور ذکر شوی وي. د DIVUS KNX IQ پخپله د دې لارښود په شرایطو کې د MQTT بروکر / MQTT سرور رول لوبوي.
  • DIVUS-VISION-API-سافټویر-انځر (3)د MQTT سرور نومول شوي موضوعات کاروي: یو درجه بندي جوړښت چې معلومات یې طبقه بندي، اداره او خپاره شوي.
  • DIVUS-VISION-API-سافټویر-انځر (4)خپرول د موضوعاتو له لارې نورو ګډون کونکو ته د معلوماتو چمتو کول لومړني هدف لري. که تاسو غواړئ یو ارزښت بدل کړئ، تاسو د مطلوب ارزښت بدلون سره یوځای مطلوب موضوع ته ولیکئ، د خپرولو عمل په کارولو سره. د هدف وسیله یا د MQTT سرور مطلوب بدلون لوستل کوي چې دا اغیزه کوي او د هغې مطابق یې غوره کوي. د دې لپاره چې وګورئ چې بدلون پلي شوی، تاسو کولی شئ د ګډون شوي ریښتیني وخت موضوع وګورئ ترڅو وګورئ چې بدلون هلته منعکس شوی - که هرڅه سم کار کړی وي.
  • DIVUS-VISION-API-سافټویر-انځر (5)پیرودونکي هغه موضوعات غوره کوي چې دوی یې خوښوي: دې ته ګډون ویل کیږي. هرکله چې ارزښت په یوه موضوع کې / لاندې بدل شي، ټول ګډون کونکي پیرودونکي خبر شوي - د بیلګې په توګه پرته له دې چې په واضح ډول پوښتنه وکړي چې ایا یو څه بدل شوی یا اوسنی ارزښت څه دی.
  • DIVUS-VISION-API-سافټویر-انځر (6)تاسو کولی شئ د MQTT سرور سره یو جلا ارتباطي چینل خلاص کړئ (یا پته) په موضوع کې د client_id په نوم کوم ځانګړي تار ته دننه کولو سره. client_id باید په موضوع کې د ارزښتونو پروسس کولو لپاره وکارول شي. دا د هر بدلون اصلي پیژندنه کوي، د هر ډول غلطیو سره مرسته کوي او په نورو مراجعینو اغیزه نه کوي، ځکه چې د سرور څخه ورته ځوابونه، د هر ډول غلطی کوډونو او پیغامونو په شمول، یوازې د ورته مراجعینو_id سره موضوع ته رسیږي (او په دې توګه یوازې هغه پیرودونکي). client_id یو ځانګړی کرکټر تار دی چې د 0-9، az، AZ، ​​"-"، "_" حروفونو هر ترکیب څخه جوړ دی.
  • DIVUS-VISION-API-سافټویر-انځر (7)په عموم کې، د DIVUS KNX IQ د MQTT سرور ګډون موضوعات د کلیدي ټکي حالت لري، پداسې حال کې چې د خپریدو موضوع د کلیدي کلمې غوښتنه لري. هغه کسان چې وضعیت لري په اوتومات ډول تازه کیږي کله چې د بهرني ارزښت بدلون شتون ولري یا هرڅومره ژر چې د پیرودونکي لخوا د خپرولو له لارې د ارزښت بدلون غوښتنه شوې وي او په بریالیتوب سره پلي کیږي. د خپرولو لپاره نور بیا د ډول (غوښتنې/) ترلاسه کولو او د ډول (غوښتنې/) سیټ کې ویشل شوي.
  • DIVUS-VISION-API-سافټویر-انځر (8)د ارزښت بدلونونه او نور اختیاري پیرامیټونه د تش په نامه تادیاتو سره موضوع ته اضافه شوي. د انفرادي عناصرو پیرامیټرې (عنصر-id، نوم، ډول، دندې)

د MQTT او د کلاسیک مراجعینو-سرور ماډل ترمنځ اصلي توپیر، چیرته چې پیرودونکي غوښتنه کوي او بیا ډاټا بدلوي، د ګډون او خپرولو مفکورې باندې متمرکز دی. ګډونوال کولی شي معلومات خپاره کړي، دا نورو ته چمتو کوي، څوک چې لیوالتیا لري کولی شي ګډون وکړي. دا جوړښت دا ممکنه کوي چې د معلوماتو تبادله کمه کړي او بیا هم ټولې ښکیلې خواوې تازه وساتي. دلته د توضیحاتو په اړه نور معلومات: او ځانګړي پیرامیټونه (uuid، فلټرونه) باید دلته وکارول شي. که څه هم ډیری اختیارونه شتون لري، تادیه په دې لارښود کې د JSON په بڼه ښودل شوي. JSON د هر جوړښت ډیټا نمایندګي کولو لپاره بریکٹ او کوما کاروي او پدې توګه د لیږدولو لپاره د ډیټا پاکټونو اندازه کموي. د تادیاتو په اړه نور توضیحات وروسته په لارښود کې موندل کیدی شي.

  • DIVUS-VISION-API-سافټویر-انځر (9)د ځانګړو موخو لپاره، دا ممکنه ده چې د فعالیت د ډول سره سم فلټر کړئ، د بیلګې په توګه یوازې د فعال / بند په توګه د 1-bit سویچونو پته کول. د دې هدف لپاره په تادیه کې د فلټر پیرامیټر کارول کیږي. فلټر کول اوس مهال یوازې د فعالیت ډول لخوا امکان لري.
  • DIVUS-VISION-API-سافټویر-انځر (10)د انفرادي عناصرو په نښه کولو وړتیا لپاره، د دوی عنصر ID ته اړتیا ده. دا په VISION کې د عنصر ملکیتونو مینو کې موندل کیدی شي یا هم مستقیم د ډیټا څخه لوستل کیدی شي چې د MQTT اکسپلورر عمومي ګډون کې د هر موجود عنصر مخې ته ښودل کیږي (هغه عناصر چې د عنصر ID لخوا په الفبا کې لیست شوي دي).

DIVUS-VISION-API-سافټویر-انځر (11)

د API لاسرسي لپاره ترتیب

د API کارونکي لاسرسي لپاره د لید ترتیب کول

په VISION کې د مدیر په توګه ، تنظیم کولو ته لاړشئ - د کارن/API لاسرسي مدیریت ، په کاروونکو/API لاسرسي کلیک وکړئ او د ترمیم کړکۍ خلاصولو لپاره د API کارونکي (یا فشار او ساتل) باندې ښي کلیک وکړئ. هلته به تاسو دا پیرامیټونه او ډاټا ومومئ

  • فعال کړئ (چک باکس)
    • کارن لومړی دلته فعال شوی. ډیفالټ غیر فعال دی
  • کارن نوم
    • دا تار د API له لارې د لاسرسي لپاره اړین دی - له دې ځایه یې کاپي کړئ
  • رمز
    • دا تار د API له لارې د لاسرسي لپاره اړین دی - له دې ځایه یې کاپي کړئ
  • اجازې
    • د VISION عناصرو ارزښتونو لوستلو او لیکلو لپاره اصلي حقونه دلته تعریف کیدی شي، یعنې هغه څه چې دلته تعریف شوي په ټولو موجوده او راتلونکو عناصرو باندې تطبیق کیږي. که تاسو یوازې انفرادي عناصرو ته د لاسرسي اجازه غواړئ، تاسو باید دا اصلي حقونه بدل نه کړئ

د انفرادي عناصرو اجازه

دا سپارښتنه کیږي چې تاسو ټولې پروژې ته API لاسرسی مه ورکوئ، مګر یوازې مطلوب عناصرو ته. په لاندې ډول عمل وکړئ

  1. VISION ته د مدیر په توګه ننوتل
  2. مطلوب عنصر غوره کړئ او د هغې د ترتیباتو مینو پرانیزئ (ښي کلیک وکړئ یا فشار وساتئ، بیا ترتیبات)
  3. په مینو کې د ننوتلو عمومي - اجازې لاندې ، "د ډیفالټ اجازې بیرته راګرځول" فعال کړئ او بیا د فرعي توکي اجازې ته لاړشئ ، کوم چې د اجازې میټریکس ښیې.DIVUS-VISION-API-سافټویر-انځر (12)
  4. دلته د کنټرول اجازه فعاله کړئ، کوم چې دا هم فعالوي view مستقیم اجازه. که تاسو یوازې د API لاسرسي له لارې ډاټا لوستل غواړئ ، نو دا د فعالولو لپاره کافي دي view اجازه
  5. د ټولو عناصرو لپاره ورته کړنلاره تکرار کړئ چې تاسو یې لاسرسی غواړئ

د MQTT له لارې اړیکه

پیژندنه

د پخواني په توګهampل، موږ به د DIVUS KNX IQ د MQTT API له لارې د نسبتا ساده، وړیا سافټویر سره چې د MQTT اکسپلورر په نوم یادیږي لاسرسی وښایه (چپ 1.1 وګورئ)، کوم چې د وینډوز، ماک او لینکس لپاره شتون لري. د MQTT سره یو بنسټیز پوهه او تجربه معنی لري.

د پیوستون لپاره اړین معلومات

لکه څنګه چې مخکې یادونه وشوه (د 2.1 برخه وګورئ)، د API کارونکي کارن نوم او پټنوم اړین دي. دلته یو اوور دیview د ټولو معلوماتو څخه چې باید د پیوستون رامینځته کیدو دمخه راټول شي:

  • د کارن نوم د API کارونکي په تفصیل پاڼه کې ولولئ
  • پاسورډ د API کارونکي په تفصیل پاڼه کې ولولئ
  • د IP پته د عمومي - شبکه - ایترنیټ (یا د ترکیب له لارې) لاندې د لانچر تنظیماتو کې ولولئ
  • پورټ 8884 (دا بندر د دې هدف لپاره ساتل شوی دی)

د MQTT اکسپلورر او عمومي ګډون سره لومړی اړیکه

عموما، MQTT د ګډون او خپرولو فعالیتونو ترمنځ توپیر کوي. د MQTT اکسپلورر دا په اتوماتيک ډول د ټولو موجودو موضوعاتو (موضوع #) د ګډون کولو له لارې ساده کوي کله چې لومړی اړیکه جوړه شي. د پایلې په توګه، هغه ونه چې ټولو موجودو عناصرو ته لار هواروي (د بیلګې په توګه د API کاروونکي لاسرسی ورکړل شوی) د بریالي ارتباط وروسته د MQTT اکسپلورر کړکۍ په ښي خوا کې لیدل کیدی شي. د نورو ګډون کولو موضوعاتو داخلولو لپاره یا د نورو مشخصو موضوع سره # ځای په ځای کولو لپاره ، د پیوستون کړکۍ کې پرمختللي ته لاړشئ. په پورتنۍ ښي خوا کې ښودل شوې موضوع داسې ښکاري:DIVUS-VISION-API-سافټویر-انځر (13)

چیرې چې 7f4x0607849x444xxx256573x3x9x983 د API کارن نوم دی او د objects_list ټول موجود عناصر لري. دا موضوع تل تازه ساتل کیږي د بیلګې په توګه د ارزښت هر ډول بدلونونه په ریښتیني وخت کې منعکس کیږي. که تاسو یوازې د انفرادي عناصرو ګډون کول غواړئ، د مطلوب عنصر عنصر ID د objects_list/ وروسته دننه کړئ.

یادونه: دا ډول ګډون په عموم ډول د KNX فیډبیک پتې ترشا منطق سره مطابقت لري؛ دا د عناصرو اوسنی حالت ښیي او کیدای شي د دې لپاره وکارول شي چې ایا مطلوب بدلونونه په بریالیتوب سره پلي شوي. که تاسو یوازې ډاټا لوستل غواړئ مګر بدل نه کړئ، دا ډول ګډون کافی دی.

یو واحد ساده عنصر د JSON نوټیشن کې ورته ورته ښکاريDIVUS-VISION-API-سافټویر-انځر (14)

یادونه: ټول ارزښتونه پورته ښودل شوي ترکیب لري د بیلګې په توګه { "ارزښت": "1" } د ګډون کولو موضوعاتو د محصول په توګه، پداسې حال کې چې ارزښت په مستقیم ډول په تادیه کې لیکل کیږي ترڅو ارزښت بدل کړي (د بیلګې په توګه د خپرونو موضوعاتو لپاره) - بریکٹ او "ارزښت" پریښودل شوي د بیلګې په توګه "آن آف": "1".

پرمختللي امرونه

پیژندنه

په عمومي ډول درې ډوله موضوعات دي:

  1. د موجود عناصرو لیدلو او د ریښتیني وخت ارزښت بدلونونو ترلاسه کولو لپاره موضوع (موضوع) کې ګډون وکړئ
  2. د ځوابونو ترلاسه کولو لپاره موضوع (موضوع) کې ګډون وکړئمشتریان ) غوښتنې خپروي
  3. د خپلو ارزښتونو سره د عناصرو د ترلاسه کولو یا تنظیم کولو لپاره موضوع (موضوعات) خپاره کړئ

موږ به وروسته دا ډولونو ته اشاره وکړو چې دلته ښودل شوي شمیرې (د بیلګې په توګه د 1، 2، 3 ډولونو موضوعات). نور جزئیات په لاندې برخو او فصل کې. 4.2.

د شته عناصرو د لیدلو او په ریښتیني وخت کې د ارزښت بدلونونو ترلاسه کولو لپاره موضوعات سبسکرایب کړئ

دا لا دمخه تشریح شوي

د مراجعینو د خپرولو غوښتنو ته د ځوابونو ترلاسه کولو لپاره موضوعات ګډون وکړئ

دا ډول موضوعات اختیاري دي. دا اجازه ورکوي

  • د خپل سري client_id په کارولو سره د MQTT سرور سره یو ځانګړی ارتباطي چینل خلاص کړئ. د دې په اړه نور په فصل کې. 4.2.2
  • په اړونده سبسکرایب موضوع کې د خپرولو غوښتنو پایله ترلاسه کړئ: د خطا کوډ او پیغام سره بریا یا ناکامي.

د خپرولو امرونو ترلاسه کولو یا تنظیم کولو لپاره د ځوابونو ترلاسه کولو لپاره مختلف موضوعات شتون لري. اړوند توپیر په کېDIVUS-VISION-API-سافټویر-انځر (15) یوځل چې تاسو د خپل سیسټم لپاره اړین موضوعات په مستقیم ډول ترلاسه کړئ، تاسو ممکن پریکړه وکړئ چې دا مرحله لرې کړئ او په مستقیم ډول د خپرونو موضوع وکاروئ.

 د خپلو ارزښتونو سره د عناصرو د ترلاسه کولو یا تنظیم کولو لپاره موضوعات خپاره کړئ

دا موضوعات د ګډون لپاره ورته لاره کاروي - یوازینی بدلون د "حالت" په ځای کې د "غوښتنې" کلمه ده چې د ګډون لپاره کارول کیږي. د موضوع بشپړې لارې وروسته په فصل کې ښودل شوي. 4.2.2\ د ترلاسه کولو موضوع به د MQTT سرور عناصرو او ارزښتونو لوستلو غوښتنه وکړي. تادیه کیدای شي د عناصرو د فعالیت ډول پر بنسټ د فلټر کولو لپاره وکارول شي. یوه ټاکل شوې موضوع به د عنصر ځینې برخې بدلولو غوښتنه وکړي، لکه څنګه چې د هغې په تادیه کې توضیح شوي.

د امرونو او ورته ځوابونو لپاره مخکینی

 لنډ وضاحت

ټول حکمونه چې د MQTT سرور ته لیږل کیږي یو عام ابتدايي برخه لري، یعنې:

DIVUS-VISION-API-سافټویر-انځر (16)

تفصیلي توضیحات

د ریښتیني وخت موضوعات (ډول 1) به عمومي مخفف ولري (پورته وګورئ) بیا وروسته

DIVUS-VISION-API-سافټویر-انځر (17)

orDIVUS-VISION-API-سافټویر-انځر (18)

د ټاکل شوي کمانډونو لپاره، تادیه په ښکاره ډول اصلي رول لوبوي ځکه چې دا به مطلوب بدلونونه ولري (د بیلګې په توګه د عنصر دندو لپاره بدل شوي ارزښتونه). یو خبرداری: هیڅکله په خپل ډول 3 کمانډونو کې د ساتلو اختیار مه کاروئ ځکه چې دا ممکن د KNX اړخ کې ستونزې رامینځته کړي.

EXAMPLE: د یو واحد عنصر ارزښت بدلولو لپاره خپور کړئ

ترټولو ساده قضیه دا ده چې غواړئ د یو عنصر ارزښت بدل کړئ چې د عمومي ګډون لخوا ښودل شوي.
په عمومي توګه، د MQTT له لارې د VISION فعالیت بدلول / بدلول 3 مرحلې لري، چې ټول یې اړین ندي، مګر بیا هم موږ وړاندیز کوو لکه څنګه چې تشریح شوي.

  1. هغه موضوع چې هغه فنکشن لري چې موږ یې ترمیم کول غواړو د دودیز client_id په کارولو سره ګډون کوي
  2. د سمون لپاره موضوع په 1 کې غوره شوي client_id په کارولو سره د مطلوب بدلونونو سره د تادیې سره یوځای خپره شوې.
  3. د چک کولو لپاره، تاسو بیا کولی شئ ځواب په موضوع کې وګورئ (1.) - د بیلګې په توګه (2.) کار کړی که نه
  4. په عمومي ګډون کې، چیرې چې ټول ارزښتونه تازه کیږي کله چې بدلونونه رامینځته کیږي، تاسو کولی شئ د مطلوب ارزښت بدلونونه وګورئ که هرڅه سم کار وکړي.

د دې کولو لپاره ګامونه دا دي:

  1. یو client_id غوره کړئ د بیلګې په توګه "Divus" او دا د API کارونکي نوم وروسته په لاره کې دننه کړئDIVUS-VISION-API-سافټویر-انځر (19)
    دا د MQTT سرور سره ستاسو د خپل مخابراتو چینل کې ګډون کولو لپاره بشپړ موضوع ده. دا سرور ته وايي چیرې چې تاسو د هغه بدلونونو ځوابونو تمه لرئ چې تاسو یې لیږل غواړئ. حالت/سیټ برخه ته پام وکړئ کوم چې a تعریفوي. چې دا د ګډون موضوع ده او ب. چې دا به د ډول کمانډونو تنظیم کولو ځوابونه ترلاسه کړي.
  2. د خپرولو موضوع به یو شان وي پرته له دې چې د وضعیت غوښتنې کلیدي بدلولو څخهDIVUS-VISION-API-سافټویر-انځر (20)
  3. هغه څه چې بدلون باید پکې شامل وي په تادیه کې لیکل شوي. دلته ځینې پخواني ديamples.
    • د یو عنصر بندول چې آن / آف فعالیت لري (1 بټ):DIVUS-VISION-API-سافټویر-انځر (21)
    • د یو عنصر بدلول چې آن/بند فعالیت لري (1 بټ). برسېره پردې، که چیرې د ورته مراجعینو څخه ډیری ورته کمانډونه پیل شي، د uuid پیرامیټر ("منفرد ID"، معمولا د 128-bit تار بڼه ده چې د 8-4-4-4-12 ډیجیټونو هیکس په توګه کارول کیږي) د ټاکلو لپاره کارول کیدی شي. د اړوندې پوښتنې ځواب، لکه څنګه چې دا پیرامیټر - که په پوښتنه کې موجود وي - په ځواب کې هم موندل کیدی شي.DIVUS-VISION-API-سافټویر-انځر (22)
    • چالان کول او د یو تیاره روښانتیا 50٪ ته ټاکلDIVUS-VISION-API-سافټویر-انځر (23)
    • پورته ښودل شوي او ګډون شوي موضوع ته ځواب (د دې تادیه ، دقیق وي) بیا د مثال لپارهample.DIVUS-VISION-API-سافټویر-انځر (24)
      پورته ځواب یو پخوانی دیample د سم پیلډ په حالت کې، که څه هم عنصر د کمولو فعالیت نلري. که چیرې ډیرې جدي ستونزې شتون ولري چې د تادیې بار په سمه توګه تشریح نشي، ځواب به داسې ښکاري (د بیلګې په توګه):DIVUS-VISION-API-سافټویر-انځر (25)
      د خطا کوډونو او پیغامونو د توضیح لپاره مګر په عموم کې، لکه د HTTP لپاره، 200 کوډونه مثبت ځوابونه دي پداسې حال کې چې 400 منفي دي.

EXAMPLE: د څو عناصرو ارزښتونو بدلولو لپاره خپرول

کړنلاره د یو واحد عنصر بدلولو لپاره مخکې ښودل شوي ورته ورته ده. توپیر دا دی چې تاسو د موضوعاتو څخه عنصر_id لرې کړئ او بیا د تادیې دننه ډیټا مخې ته د عنصر_ids سیټ په ګوته کړئ. لاندې نحو او جوړښت وګورئ.DIVUS-VISION-API-سافټویر-انځر (26)

په پوښتنو کې د فعالیت ډول لخوا فلټر کړئ

په پایلوډ کې د فلټر پیرامیټر یوازې د عنصر مطلوب فعالیت (فعالیتونو) ته اجازه ورکوي چې په ګوته شي. د سویچ یا ډیمر فعال / بند فعالیت د مثال لپاره "onoff" بلل کیږيample، او اړونده فلټر په دې ډول تعریف شوی:DIVUS-VISION-API-سافټویر-انځر (27)

ځواب بیا داسې ښکاري، د مثال لپارهampleDIVUS-VISION-API-سافټویر-انځر (28)DIVUS-VISION-API-سافټویر-انځر (29)

مربع بریکٹ دا په ګوته کوي چې تاسو کولی شئ د څو دندو لخوا هم فلټر کړئ، د بیلګې په توګهDIVUS-VISION-API-سافټویر-انځر (30)

د دې په څیر ځواب ته لارښوونه کوي:DIVUS-VISION-API-سافټویر-انځر (31)

ضمیمه

د تیروتنې کوډونه

د MQTT مخابراتو کې تېروتنې د عددي کوډ پایله ده. لاندې جدول د دې په ماتولو کې مرسته کوي.DIVUS-VISION-API-سافټویر-انځر (32)

د پایلوډ پیرامیټرونه

تادیه د شرایطو پورې اړه لري د مختلف پیرامیټونو ملاتړ کوي. لاندې جدول ښیې چې کوم پیرامیټونه په کومو موضوعاتو کې واقع کیدی شي

DIVUS-VISION-API-سافټویر-انځر (33) DIVUS-VISION-API-سافټویر-انځر (34) DIVUS-VISION-API-سافټویر-انځر (35)

نسخه یادښتونه

  • نسخه 1.00

خبرونه:

• لومړی خپرونه

اسناد / سرچینې

د DIVUS VISION API سافټویر [pdf] د کارونکي لارښود
VISION API سافټویر، API سافټویر، سافټویر
د DIVUS ویژن API سافټویر [pdf] د کارونکي لارښود
د ویژن API سافټویر، ویژن، API سافټویر، سافټویر

حوالې

یو نظر پریږدئ

ستاسو بریښنالیک پته به خپره نشي. اړین ساحې په نښه شوي *