스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

스마트 홈 EnergyStorage 특성 스키마

action.devices.traits.EnergyStorage: 이 특성은 배터리에 에너지를 저장하고 충전할 수 있는 기기 또는 다른 기기를 충전할 수 있는 기기에 속합니다.

기기 속성

이 특성이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

속성 유형 설명
queryOnlyEnergyStorage Boolean

필수.

기기가 저장된 에너지 수준 및 선택적으로 활성 충전 상태 (isRechargeable 속성에 따라 다름)에 관한 쿼리만 지원하고 충전 시작 및 중지는 지원하지 않는 경우 true입니다.

energyStorageDistanceUnitForUX String

(기본값: "KILOMETERS")

사용자의 응답에 사용됩니다.

지원 값:

KILOMETERS
MILES
isRechargeable Boolean

(기본값: false)

기기를 충전할 수 있는 경우 true로 설정합니다. 이는 기기가 capacityUntilFull, isCharging 및 선택적으로 isPluggedIn 상태를 보고할 수 있으며 Charge 명령어를 수락할 수 있음을 나타냅니다.

충전 기기

{
  "isRechargeable": true,
  "queryOnlyEnergyStorage": false
}

현재 충전 수준을 마일 단위로 표시하는 충전식 기기

{
  "isRechargeable": true,
  "energyStorageDistanceUnitForUX": "MILES",
  "queryOnlyEnergyStorage": false
}

현재 충전 수준 보고만 지원하는 충전 불가능한 기기

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": true
}

기기 상태

이 특성이 있는 기기는 QUERY 작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

상태 유형 설명
descriptiveCapacityRemaining String

필수.

에너지 용량 수준에 관한 정성적 설명 숫자 용량 데이터가 없는 경우에 해당합니다. 숫자 용량 데이터도 사용할 수 있는 경우 가능하면 데이터를 설명하는 것보다 우선으로 사용합니다.

지원 값:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining 배열

기기가 현재 보유하고 있는 에너지 용량에 대한 정보를 보유하는 단위/값 쌍의 배열입니다. 예: 내 <기기>의 거리는 얼마야 또는 내 <기기>의 배터리 잔량

[item, ...] 객체

단위 및 값 쌍의 잔여 용량

rawValue 정수

필수.

용량 값입니다.

unit String

필수.

용량 단위입니다.

지원 값:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull 배열

기기가 완전히 충전될 때까지 용량 정보를 포함하는 단위/값 쌍의 배열입니다. 예: <기기>가 완전히 충전될 때까지 걸리는 시간

[item, ...] 객체

충전 완료까지 수용 인원

rawValue 정수

필수.

용량 값입니다.

unit String

필수.

용량 단위입니다.

지원 값:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
isCharging Boolean

기기가 현재 충전 중인지 여부

isPluggedIn Boolean

기기가 현재 전원에 연결되어 있는지 여부를 나타냅니다. 기기를 전원에 연결할 수는 있지만 충전 중이 아닙니다.

충전 기기

{
  "descriptiveCapacityRemaining": "HIGH",
  "capacityRemaining": [
    {
      "rawValue": 36000,
      "unit": "SECONDS"
    },
    {
      "rawValue": 90,
      "unit": "PERCENTAGE"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 120,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

현재 충전 수준을 마일 단위로 표시하는 충전식 기기

{
  "descriptiveCapacityRemaining": "CRITICALLY_LOW",
  "capacityRemaining": [
    {
      "rawValue": 12,
      "unit": "MILES"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 6000,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

현재 충전 수준 보고만 지원하는 충전 불가능한 기기

{
  "descriptiveCapacityRemaining": "LOW"
}

기기 명령어

이 특성이 있는 기기는 EXECUTE 작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

action.devices.commands.Charge

충전을 시작하거나 중지합니다.

이 명령어에는
{
  "isRechargeable": true
}
속성이 필요합니다.

매개변수

매개변수 유형 설명
charge Boolean

필수.

충전을 시작하려면 True, 충전을 중지하려면 False로 설정합니다.

충전 시작하기

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

충전 중지 명령어

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

기기 오류

오류 및 예외의 전체 목록을 참조하세요.

deviceUnplugged: 사용자가 전원에 연결되지 않은 기기를 충전하려고 했습니다.