কীভাবে স্মার্ট হোম অ্যাকশন তৈরি করতে হয় তা শেখার নতুন গন্তব্য Google হোম ডেভেলপার সেন্টারে স্বাগতম। দ্রষ্টব্য: আপনি অ্যাকশন কনসোলে নির্মাণ কাজ চালিয়ে যাবেন।

এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

action.devices.EXECUTE

এই উদ্দেশ্য স্মার্ট হোম ডিভাইসে চালানোর জন্য কমান্ড পাঠায়।

আপনার পূর্ণতা প্রতিটি কমান্ড প্রক্রিয়া করা উচিত, সংশ্লিষ্ট ডিভাইসে প্রেরণ, এবং EXECUTE প্রতিক্রিয়াতে নতুন অবস্থা ফিরিয়ে আনতে হবে।

একটি একক EXECUTE অভিপ্রায় একাধিক কমান্ড সহ একাধিক ডিভাইসকে লক্ষ্য করতে পারে। উদাহরণস্বরূপ, একটি ট্রিগার করা অভিপ্রায় আলোর সেটে উজ্জ্বলতা এবং রঙ উভয়ই সেট করতে পারে বা একাধিক লাইট প্রতিটি আলাদা রঙে সেট করতে পারে।

আরো বিস্তারিত জানার জন্য, ক্যোয়ারী এবং এক্সিকিউট দেখুন।

বিন্যাস অনুরোধ

ক্ষেত্র	টাইপ	বর্ণনা
`requestId`	স্ট্রিং	প্রয়োজন। অনুরোধের আইডি।
`inputs`	অ্যারে	প্রয়োজন। অভিপ্রায় অনুরোধের সাথে মিলে যাওয়া ইনপুটগুলির তালিকা৷
`[ item, ... ]`	অবজেক্ট	উদ্দেশ্য অনুরোধের সাথে যুক্ত টাইপ এবং পেলোড।
`intent`		প্রয়োজন। (ধ্রুবক মান: `"action.devices.EXECUTE"` ) উদ্দেশ্য অনুরোধের ধরন।
`payload`	অবজেক্ট	প্রয়োজন। চালনা অনুরোধ পেলোড.
`commands`	অ্যারে	প্রয়োজন। ডিভাইস লক্ষ্য এবং কমান্ড জোড়া তালিকা.
`[ item, ... ]`	অবজেক্ট	সংযুক্ত ডিভাইস টার্গেটে চালানোর জন্য কমান্ডের সেট।
`devices`	অ্যারে	প্রয়োজন। লক্ষ্য ডিভাইসের তালিকা.
`[ item, ... ]`	অবজেক্ট	চালানোর জন্য ডিভাইস লক্ষ্য.
`id`	স্ট্রিং	প্রয়োজন। SYNC এ প্রদত্ত আইডি অনুযায়ী ডিভাইস আইডি।
`customData`	অবজেক্ট	অস্বচ্ছ কাস্টমডেটা অবজেক্টটি SYNC-তে প্রদান করা হলে, এটি এখানে পাঠানো হয়।
`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`	অ্যারে	প্রতিটি বস্তুর প্রতিক্রিয়া বিবরণ সহ এক বা একাধিক ডিভাইস রয়েছে। NB এগুলি অনুরোধের মতো একইভাবে গোষ্ঠীভুক্ত নাও হতে পারে৷ উদাহরণস্বরূপ, অনুরোধটি 7টি আলো চালু করতে পারে, যার মধ্যে 3টি আলো সফল এবং 4টি ব্যর্থ হয়েছে, এইভাবে প্রতিক্রিয়াতে দুটি গ্রুপের সাথে।
`[ item, ... ]`	অবজেক্ট	ডিভাইস নির্বাহের ফলাফল।
`ids`	অ্যারে	প্রয়োজন। এই স্থিতির সাথে সম্পর্কিত ডিভাইস আইডিগুলির তালিকা৷
`[ item, ... ]`	স্ট্রিং	ডিভাইস আইডি।
`status`	স্ট্রিং	প্রয়োজন। সঞ্চালন অপারেশন ফলাফল. সমর্থিত মান: `SUCCESS` নিশ্চিত করুন যে কমান্ড সফল হয়েছে। `PENDING` কমান্ড সারিবদ্ধ কিন্তু সফল হবে বলে আশা করা হচ্ছে। `OFFLINE` টার্গেট ডিভাইস অফলাইন অবস্থায় আছে বা পৌঁছানো যাচ্ছে না। `EXCEPTIONS` একটি কমান্ডের সাথে যুক্ত একটি সমস্যা বা সতর্কতা আছে। কমান্ড সফল বা ব্যর্থ হতে পারে. আপনি যখন অন্য সংযুক্ত ডিভাইস সম্পর্কে অতিরিক্ত তথ্য পাঠাতে চান তখন এই অবস্থার ধরনটি সাধারণত সেট করা হয়৷ `ERROR` টার্গেট ডিভাইস কমান্ডটি সম্পাদন করতে অক্ষম।
`states`	অবজেক্ট	প্রতিটি বৈশিষ্ট্য স্কিমা রেফারেন্সে বর্ণিত প্রতি-বৈশিষ্ট্য রাজ্যের সাথে সারিবদ্ধ। যদি পাওয়া যায় তাহলে মৃত্যুদন্ড কার্যকর করার পরে এই রাজ্যগুলি।
`online`	বুলিয়ান	ডিভাইসটি অনলাইনে আছে কিনা তা নির্দেশ করে (অর্থাৎ পৌঁছানো যায়) বা না।
`errorCode`	স্ট্রিং	প্রিসেট ত্রুটি কোডগুলি থেকে প্রয়োজন হলে ERROR অবস্থা প্রসারিত করা হচ্ছে, যা ব্যবহারকারীদের কাছে উপস্থাপিত ত্রুটিগুলিকে ম্যাপ করবে৷

উদাহরণ

অভিপ্রায় প্রতিক্রিয়া চালান

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "on": true,
          "online": true
        }
      },
      {
        "ids": [
          "456"
        ],
        "status": "ERROR",
        "errorCode": "deviceTurnedOff"
      }
    ]
  }
}