action.devices.EXECUTE
تُرسِل هذه intent أوامر لتنفيذها على الأجهزة المنزلية الذكية.
من المفترض أن يؤدي تنفيذ الطلب إلى معالجة كل أمر ونقله إلى الجهاز المناسب وعرض الحالة الجديدة في استجابة EXECUTE
.
يمكن أن يستهدف هدف EXECUTE
واحد أجهزة متعددة باستخدام أوامر متعددة.
على سبيل المثال، قد يتم ضبط مستوى السطوع واللون على مجموعة من المصابيح
أو إذا تم ضبط مصابيح متعددة على لون مختلف.
للتعرُّف على المزيد من التفاصيل، يُرجى الاطِّلاع على طلب البحث والتنفيذ.
تنسيق الطلب
الحقول | النوع | الوصف |
---|---|---|
requestId |
سلسلة |
إنّ هذه السمة مطلوبة. رقم تعريف الطلب. |
inputs |
المصفوفة |
إنّ هذه السمة مطلوبة. قائمة المدخلات التي تطابق طلب النية. |
[item, ...] |
الكائن |
اكتب الحمولة والحمولة المرتبطة بطلب intent. |
intent |
إنّ هذه السمة مطلوبة. (القيمة الثابتة: نوع طلب intent. |
|
payload |
الكائن |
إنّ هذه السمة مطلوبة. حمولة الطلب EXECUTE. |
commands |
المصفوفة |
إنّ هذه السمة مطلوبة. قائمة بأزواج الأجهزة والأهداف المستهدفة |
[item, ...] |
الكائن |
مجموعة من الأوامر للتنفيذ على أهداف الأجهزة المرفقة. |
devices |
المصفوفة |
إنّ هذه السمة مطلوبة. قائمة بالأجهزة المستهدفة. |
[item, ...] |
الكائن |
هدف الجهاز للتنفيذ. |
id |
سلسلة |
إنّ هذه السمة مطلوبة. رقم تعريف الجهاز، وفقًا للمعرّف المُقدم في SYNC. |
customData |
الكائن |
في حال توفير كائن customData المُعتِم في "المزامنة"، يتم إرساله هنا. |
execution |
المصفوفة |
إنّ هذه السمة مطلوبة. قائمة بالطلبات المطلوب تنفيذها على الأجهزة الهدف. |
[item, ...] |
الكائن |
أمر الجهاز. |
command |
سلسلة |
إنّ هذه السمة مطلوبة. الأمر الذي يتم تنفيذه، وعادةً ما يكون مصاحبًا لمعلّمات. |
params |
الكائن |
وتتماشى مع المعلّمات لكل أمر. |
أمثلة
طلب النية بالشراء
{ "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123", "customData": { "fooValue": 74, "barValue": true, "bazValue": "sheepdip" } }, { "id": "456", "customData": { "fooValue": 36, "barValue": false, "bazValue": "moarsheep" } } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
تنسيق الاستجابة
الحقول | النوع | الوصف |
---|---|---|
requestId |
سلسلة |
إنّ هذه السمة مطلوبة. رقم تعريف الطلب المقابل. |
payload |
الكائن |
إنّ هذه السمة مطلوبة. الحمولة في الاستجابة للنية بالشراء |
errorCode |
سلسلة |
رمز خطأ للعملية بأكملها لعمليات تعذُّر المصادقة وعدم توفّر نظام مطوّري البرامج. بالنسبة إلى الأخطاء الفردية في الأجهزة، يمكنك استخدام رمز الخطأ داخل كائن الجهاز. |
debugString |
سلسلة |
خطأ تفصيلي لن يتم عرضه للمستخدمين مطلقًا ولكن يمكن تسجيله أو استخدامه أثناء التطوير. |
commands |
المصفوفة |
يحتوي كل كائن على جهاز واحد أو أكثر مع تفاصيل الاستجابة. ملاحظة: قد لا يتم تجميع هذه العناصر بالطريقة نفسها التي تمّ بها تجميع الطلب. على سبيل المثال، قد يُشغّل الطلب 7 أضواء، وينتج عنها 3 مصابيح ناجحة ويفشل 4 مصابيح، وبالتالي يتم إرسال مجموعتَين إلى الاستجابة. |
[item, ...] |
الكائن |
نتيجة تنفيذ الجهاز. |
ids |
المصفوفة |
إنّ هذه السمة مطلوبة. قائمة بأرقام تعريف الأجهزة المقابلة لهذه الحالة. |
[item, ...] |
سلسلة |
رقم تعريف الجهاز |
status |
سلسلة |
إنّ هذه السمة مطلوبة. نتيجة عملية التنفيذ القيم المسموح بها
|
states |
الكائن |
تتم المحاذاة مع حالات كل سمة على حدة والتي تم وصفها في كل مرجع لمخطّط كل سمة. هذه هي الولايات التي تتم فيها عملية التنفيذ إذا كانت متوفّرة. |
online |
منطقي |
تشير هذه الخاصية إلى ما إذا كان الجهاز متصلاً بالإنترنت (أي يمكن الوصول إليه) أم لا. |
errorCode |
سلسلة |
توسيع حالة الخطأ إذا لزم الأمر من رموز الخطأ المعدّة مسبقًا، والتي ستربط بالأخطاء التي يتم تقديمها للمستخدمين. |
أمثلة
الرد على النية بالشراء
{ "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "on": true, "online": true } }, { "ids": [ "456" ], "status": "ERROR", "errorCode": "deviceTurnedOff" } ] } }