錯誤和例外狀況

本文件列出官方支援的智慧型技術錯誤和例外情況 住宅裝置。請在意圖中使用這些指定的錯誤和例外狀況代碼 回覆或通知中 安裝完畢後，Google 助理會提醒使用者遇到與 偵測到的指令或裝置狀態如果回覆的格式不正確， errorCode，Google 助理會顯示一般錯誤訊息，例如： 「很抱歉，裝置目前無法使用。」

錯誤

當問題觸發或執行，或是該錯誤時，您應該傳回錯誤代碼 要求失敗。舉例來說，鎖門卡住了，無法 就會發生這個狀態的錯誤。此時，使用者應該會收到有關這個狀態的錯誤。

錯誤代碼可附加在裝置層級或全域層級。例如： 當使用者透過某個供應商供應多個燈具，並由中樞裝置控制時 使用者要求關閉所有燈具，供應商可能會傳回 裝置層級的錯誤，如果是單一燈具離線，則發生全域等級錯誤； 整個中樞裝置處於離線狀態，因此無法控制任何燈具。如果所有 裝置處於離線狀態，使用全域層級或裝置層級沒有差異 發生錯誤。裝置離線時，應將{"online": false}狀態回報為 reportState deviceOffline 錯誤代碼。

摘要說明：

• 全域層級錯誤：回應中的所有裝置含有相同錯誤
• 局部錯誤：混合回應包含錯誤和成功案例

，瞭解如何調查及移除這項存取權。

全域層級錯誤

下列 JSON 程式碼片段說明如何在 QUERY 或 EXECUTE 回應。

因中樞而造成的全域層級錯誤 deviceOffline 範例如下： 離線：

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "errorCode": "deviceOffline",
    "status" : "ERROR"
  }
}

因中樞而造成的全域層級錯誤 inSoftwareUpdate 範例如下： 更新中：

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "errorCode": "inSoftwareUpdate",
    "status" : "ERROR"
  }
}

裝置層級錯誤

QUERY 回應

下列 JSON 程式碼片段顯示如何在 QUERY 回應。

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "devices": {
      "device-id-1": {
        "errorCode": "deviceOffline",
        "status" : "ERROR"
      },
      "device-id-2": {
        "errorCode": "deviceOffline",
        "status" : "ERROR"
      }
    }
  }
}

執行回應

下列 JSON 程式碼片段顯示如何在 執行回應。

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [
      {
        "ids": [
          "device-id-1"
        ],
        "status": "ERROR",
        "errorCode": "deviceOffline"
      },
      {
        "ids": [
          "device-id-2"
        ],
        "status": "SUCCESS",
        "states": {
          "on": true,
          "online": true
        }
      }
    ]
  }
}

含有錯誤的通知

主動通知

下列 JSON 程式碼片段顯示如何在 主動式通知

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "agentUserId": "agent-user-id-1",
  "eventId": "unique-event-id-1",
  "payload": {
    "devices": {
      "notifications": {
        "device-id-1": {
          "RunCycle": {
            "priority": 0,
            "status": "FAILURE",
            "errorCode": "deviceDoorOpen"
          }
        }
      }
    }
  }
}

後續回應

下列 JSON 程式碼片段顯示如何在 後續追蹤回應

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "agentUserId": "agent-user-id-1",
  "eventId": "unique-event-id-1",
  "payload": {
    "devices": {
      "notifications": {
        "device-id-1": {
          "LockUnlock": {
            "priority": 0,
            "followUpResponse": {
              "status": "FAILURE",
              "errorCode": "deviceJammingDetected",
              "followUpToken": "PLACEHOLDER"
            }
          }
        }
      }
    }
  }
}

錯誤清單

下列錯誤會在裝置上產生相關聯的 TTS。

例外狀況

如果某個問題是與某個應用程式相關的問題或快訊， 指令指令可能會成功或失敗。

如果指令執行成功 (狀態 =「成功」)，請回報例外狀況 使用 StatusReport 特徵 (適用於目標以外的裝置)、 或傳回適當的 exceptionCode (適用於目標裝置)。

舉例來說，如果乾衣機 Lint 螢幕已滿，使用者仍可啟動 但最好提醒他們這個狀態同樣地， 裝置電力不足，並非空無一物，但你仍可執行一項指令 但應告知裝置電量過低。

如果指令因例外狀況而失敗，狀態應為「EXCEPTIONS」 並使用 StatusReport 特徵回報例外狀況。

與目標裝置相關的非封鎖例外狀況 (成功)

以鎖門為例：

前門門電池電力不足，正在鎖上前門

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["device-id-1"],
      "status": "SUCCESS",
      "states": {
        "on": true,
        "online": true,
        "isLocked": true,
        "isJammed": false,
        "exceptionCode": "lowBattery"
      }
    }]
  }
}

透過 StatusReport 處理其他裝置的非封鎖例外狀況 (成功)

本例是啟動保全系統：好，啟動保全系統。前窗戶已開啟。

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["device-id-1"],
      "status": "SUCCESS",
      "states": {
        "on": true,
        "online": true,
        "isArmed": true,
        "currentArmLevel": "L2",
        "currentStatusReport": [{
          "blocking": false,
          "deviceTarget": "sensor_id1",
          "priority": 0,
          "statusCode": "deviceOpen"
        }]
      }
    }]
  }
}

使用 StatusReport 封鎖另一部裝置的例外狀況

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "devices": {
      "device-id-1": {
        "on": true,
        "online": true,
        "status": "EXCEPTIONS",
        "currentStatusReport": [{
            "blocking": true,
            "deviceTarget": "device-id-1",
            "priority": 0,
            "statusCode": "lowBattery"
          },
          {
            "blocking": true,
            "deviceTarget": "front_window_id",
            "priority": 1,
            "statusCode": "deviceOpen"
          },
          {
            "blocking": true,
            "deviceTarget": "back_window_id",
            "priority": 1,
            "statusCode": "deviceOpen"
          }
        ]
      }
    }
  }
}

例外清單

以下例外狀況會在裝置上產生相關聯的 TTS。