스크립트 편집기로 스크립트 기반 자동화 작성하기

스크립트 편집기를 사용하면 웹용 Google Home이나 Google Home 앱에서 맞춤 자동화를 작성하여 고급 가족 루틴을 만들 수 있습니다. 스크립트 기반 자동화를 작성하려면 YAML 스크립트 언어, 스크립트 구성 방법, 스크립트 구성요소를 사용하는 방법에 대한 몇 가지 기본사항을 알아야 합니다.

스크립트 편집기는 현재 공개 미리보기에서 사용할 수 있습니다. 공개 미리보기에 가입한 후 웹용 Google Home 또는 모바일 Google Home 앱에서 스크립트 편집기에 액세스할 수 있습니다.

• 스크립트 편집기로 고급 스마트 홈 자동화 만들기
• 지원되는 시작 조건, 조건, 작업
• 예시를 통해 첫 스크립트를 만드는 방법을 안내하는 Codelab
• 스크립트 기반 자동화 작성을 위한 연습 및 스크립트 예

YAML 스크립트 언어 기본사항

스크립트 편집기는 기기에서 실행하려는 작업과 작업이 실행되기를 원하는 상황에 대한 지침을 한 줄씩 입력할 수 있는 유연한 스크립트 언어인 YAML을 사용합니다. 이러한 지침은 키-값 쌍 형식으로 작성됩니다.

키-값 쌍

YAML은 키-값 쌍의 모음으로 구성됩니다.

name: TV on lights off

이 예에서 키는 name, 값은 TV on lights off입니다.

기본적으로 키는 사용하려는 요소를 나타내는 키워드입니다. 각 키는 고유해야 하지만 키의 순서는 중요하지 않습니다. 각 키-값 쌍은 새 줄에서 시작됩니다.

키와 연결된 값은 여러 가지 유형의 데이터일 수 있습니다.

데이터 유형

actions:
  device: Light B - Living room
  state: on

weekdays:
- MONDAY
- THURSDAY

- type: time.schedule
  at: 10:00 am
  weekdays:
  - MONDAY
  - THURSDAY
- type: time.schedule
  at: SUNSET
  weekdays:
  - MONDAY
  - THURSDAY

YAML 언어 문법

스크립트 기반 루틴을 작성할 때는 다음과 같은 서식 개념을 사용하세요.

metadata:
  name: TV on lights off
  description: Turn off lights when TV turns on

weekdays:
- MONDAY
- THURSDAY

스크립트 편집기 템플릿

새 자동화를 만들 때 스크립트 편집기에서는 다음과 같은 구조를 사용하여 스크립트를 작성할 수 있는 빈 템플릿을 제공합니다.

템플릿은 metadata와 automations라는 두 가지 주요 블록으로 나뉘며, 자동화는 다시 starters, conditions, actions 섹션으로 분류됩니다.

metadata 및 automations 블록

스크립트 편집기 템플릿에는 metadata 및 automations라는 두 가지 최상위 상위 키 또는 블록이 포함되어 있습니다.

metadata 블록에는 자동화의 이름과 설명이 포함되지만 이는 사용자가 어떤 자동화인지 파악하는 것을 돕기 위해서만 사용됩니다.

metadata:
  name: TV time
  description: When TV is on, turn on lights

automations 블록은 자동화 스크립트의 핵심입니다. 여기에서 시작 조건, 조건, 작업을 사용하여 자동화의 동작을 정의합니다.

automations:
  starters:
    # e.g. Motion detected
  condition:
    # e.g. Between 2 times
  actions:
    # e.g. Turn on lights

스크립트 편집기를 사용하는 방법을 자세히 알아보려면 Codelab을 방문하거나, 예시 스크립트를 검토하거나, Google Home 개발자 센터에서 개별 시작 조건, 조건, 작업의 형식을 지정하는 방법을 알아보세요.

자동 완성

스크립트 편집기는 다음과 같은 경우에 사용 가능한 시작 조건, 조건, 작업을 기반으로 자동 완성 제안을 제공하여 스크립트 작성 과정을 안내해 줍니다.

• 유효한 옵션이 있는 위치에 커서가 위치합니다. 예를 들어 '- type: ' 뒤에 커서가 있습니다.
  • 사용자가 올바른 제안사항이 있는 코드를 입력합니다. 코드를 입력하면 제안 목록이 필터링됩니다.

Ctrl+스페이스 단축키를 사용해 자동 완성을 수동으로 시작할 수 있습니다.

Enter를 눌러 목록에서 제안사항을 선택합니다. 자동 완성 기능이 사용자가 선택한 구조에 따라 추가 필드를 채웁니다.

starters:
- device: LED lights - Living Room
- type:

starters:
- type: device.state.OnOff
- device:

시작 조건, 조건, 작업

자동화는 기기 시작 조건, 조건, 작업으로 구성됩니다. 이러한 구성요소가 자동화의 동작을 정의합니다.

일부 시작 조건, 조건, 작업에는 특정 유형의 비교 키-값 쌍이 있어야 자동화 로직을 완성하고 평가하려는 내용을 스크립트에 알릴 수 있습니다. 값은 호환되는 데이터 유형이어야 합니다. 예를 들어 조명의 on 상태는 true 또는 false입니다. 조명이 켜진 상태에서 자동화를 시작하려면 다음의 값을 사용하세요.

state: on
is: true

아래에서 다양한 시작 조건, 조건, 작업에 관한 세부정보를 확인할 수 있습니다. 모든 시작 조건, 조건, 작업을 확인하려면 Google Home 개발자 센터를 방문하세요.

starters:
- type: assistant.command.OkGoogle
  eventData: query
  is: party time

starters:
- type: device.event.DoorbellPress
  device: Doorbell - Front door

starters:
- type: device.event.PersonDetection
  device: Camera - Backyard 

starters:
- type:  device.state.Volume
  device: TV - Living room
  state:  currentVolume
  greaterThan: 1
  lessThan: 10 

starters:
- type: home.state.HomePresence
  state: homePresenceMode
  is: HOME

starters:
- type: time.schedule
  at: sunrise+30min
  weekdays:
  - MON
  - TUE

metadata:
  name: Open Blinds
  description: Open blinds in the morning after motion detected
automations:
  starters:
  - type: device.event.MotionDetection
    device: Camera - Hallway
    suppressFor: 20hours
  condition:
    type: time.between
    after: 5:00 
    before: 12:00
  actions:
  - type: device.command.OpenClose
    openPercent: 100
  devices:
  - Blinds1 - Living Room
  - Blinds2 - Family Room

type: or
conditions:
- type: time.between
  before: sunrise
  after: sunset
  weekdays:
  - MON
  - TUE
- type: device.state.Volume
  device: My TV - Living Room
  state: currentVolume
  greaterThan: 1
  lessThan: 10

condition:
  type: and
  conditions:
  - type: device.state.OnOff
    device: TV - Living Room
    state: on
    is: true
  - type: time.between
    after: 6:00 pm

condition:
  type: or
  conditions:
  - type: device.state.OnOff
    device: TV - Living Room
    state: on
    is: true
  - type: time.between
    after: 6:00 pm

condition:
  type: not
  condition:
    type: time.between
    after: 6:00pm
    before: 8:00pm

condition:
  type: device.state.TemperatureSetting
  device: My Thermostat - Living Room
  state: thermostatHumidityAmbient
  greaterThan: 55

condition:
  type: home.state.HomePresence
  state: homePresenceMode
  is: HOME

condition:
  type: time.between
  before: 10am
  weekdays:
  - SAT
  - SUN

actions:
- type: assistant.command.OkGoogle
  okGoogle: Turn on living room lights
  devices: My Speaker - Room Name 

actions:
- type: assistant.command.OkGoogle
  okGoogle: Turn off all lights
  devices: My Speaker - Room Name 

actions:
- type: assistant.command.Broadcast
  devices:
  - My Speaker 1 - Room Name
  - My Speaker 2 - Room Name
  message: It’s dinner time.

actions:
  type: device.command.OnOff
  devices: TV - Living room
  on: true

actions:
- type: device.command.OnOff
  devices: Light A - Living Room
  on: true
- type: time.delay
  for: 5min
- type: device.command.OnOff
  devices: Light A - Living Room
  on: false

actions:
- type: home.command.Notification
  members:
  - Alex - cloudysanfrancisco@gmail.com
  - Kim - jeffersonloveshiking@gmail.com
  title: It’s movie time!
  body: Join me in the living room
 

actions:
- type: device.command.OnOff
  devices: 
    - Bedside Lamp - Bedroom
    - Ceiling Light - Bedroom
  on: true
- type: time.delay
  for: 30sec
- type: device.command.OnOff
  devices: 
    - Bedside Lamp - Bedroom
    - Ceiling Light - Bedroom
  on: false

리소스

스크립트 작성 연습하기

먼저 간단하지만 많이 사용되는 자동화 기능인 'TV가 켜지면 조명 끄기'를 만들어 보겠습니다.

1. home.google.com/automations를 열고 계정에 로그인합니다.
2. 새로 추가 를 클릭합니다.
3. 메타데이터 정보를 작성합니다. 이 스크립트에서 name은 TV on lights off이고 description은 Turn off lights when TV turns on입니다. 스크립트의 형식을 올바르게 지정해야 합니다.

   metadata:
     name: TV on lights off
     description: Turn off lights when TV turns on.

4. 시작 조건을 추가하려면 새 줄을 만들고 공백을 두 번 입력하거나 Tab 키를 한 번 눌러 들여쓴 뒤 'starters: '를 입력합니다. 그런 후 다음 줄에서 다시 들여쓰고 '- type: '을 입력합니다.
   도움말:

   • 새 줄을 만들려면 Shift  Enter 키를 누릅니다.
   • 시작 조건을 여러 개 포함하려면 각 시작 조건을 하이픈과 공백으로 시작해야 합니다.

metadata:
  name:  TV on lights off
  description:  Turn off lights when TV turns on
automations:
  starters:
  - type:

참고: 스크립트 편집기는 사용 가능한 시작 조건을 기반으로 자동 완성 제안을 제공하여 스크립트 구성 과정을 도와줍니다. 제안 중에서 선택하려면 키보드의 화살표 키를 사용하여 선택한 후 Enter 키를 눌러 삽입합니다.

5. device.state 시작 조건을 추가합니다. device.state 시작 조건을 사용하려면 type, device, state라는 세 가지 키가 필요하며, 뒤에 한 개 이상의 비교 키-값 쌍이 있어야 합니다. 스크립트 편집기는 사용 가능한 시작 조건, 조건, 작업을 기반으로 자동 완성 제안을 제공하여 스크립트 구성 과정을 도와줍니다. 이 스크립트에서 각각의 키는 다음과 같습니다.
   • type은 device.state.OnOff입니다. 자동화를 시작하기 위해 확인하는 기기의 상태입니다.
   • device는 Chromecast - Living Room입니다. Google Home 앱에 표시되는 기기 이름입니다.
   • state는 on입니다. on은 OnOff 기기 상태에서 지원되는 필드 또는 상태 데이터입니다.
   • 비교 키-값 쌍은 is: true입니다. 이 비교 키의 값은 원시 데이터 유형입니다. TV가 켜지면 스크립트가 실행됩니다.

     metadata:
       name: TV on lights off
       description: Turn off lights when TV turns on
     automations:
       starters:
       - type: device.state.OnOff
         device: Chromecast - Living Room
         state: on
         is: true

     비교를 위해 다른 시작 조건을 사용하는 유사한 스크립트를 살펴보겠습니다. 아래 스크립트에서는 TV가 켜질 때가 아니라 볼륨이 1~10일 때 자동화가 시작됩니다. 이렇게 하기 위해 OnOff 상태를 Volume으로 교체하고 상태를 currentVolume으로 변경하여 새로운 속성과 일치하도록 했습니다. 또한 비교 키-값 쌍을 두 개의 중첩된 쌍으로 변경하여 범위(greaterThan: 1, lessThan: 10)를 만들었습니다. 더 많은 예를 확인하려면 시작 조건 목록을 참고하세요.

     metadata:
       name: TV on lights off
       description: Turn off lights when TV turns on
     automations:
       starters:
       - type: device.state.Volume
         device: Chromecast - Living Room
         state: currentVolume
         greaterThan: 1
         lessThan: 10

6. 언제든지 저장을 클릭하여 스크립트를 저장할 수 있습니다. 스크립트를 저장하면 스크립트 편집기가 자동으로 스크립트의 유효성을 검사하고 오류를 확인합니다. 잘못된 스크립트는 실행할 수 없습니다.
7. 이제 스크립트에 작업을 추가합니다. 작업을 추가하려면 새 줄을 만들고 공백을 두 번 입력하거나 Tab 키를 한 번 눌러 들여쓴 뒤 'actions: '를 입력합니다. 그런 후 다음 줄에서 다시 들여쓰고 '- type '을 입력합니다.
   도움말:

   • 새 줄을 만들려면 Shift  Enter 키를 누릅니다.
   • 추가 작업을 포함하려면 각 작업을 하이픈과 공백으로 시작해야 합니다.

   metadata:
     name: TV on lights off
     description: Turn off lights when TV turns on.
   automations:
     starters:
     - type: device.state.OnOff
       device: Chromecast - Living Room
       state: on
       is: true
     actions:
     - type:

8. 조명을 끄는 데 device.command 작업을 사용합니다. device.command 작업을 사용하기 위해 다음과 같은 정보를 포함시킵니다.
   • type은 device.command.OnOff입니다. 명령어 또는 작업의 이름입니다.
     참고: 기기 아래에 여러 개의 명령어가 중첩될 수 있으며, 각 명령어마다 상태가 있습니다.
   • devices는 Floor Lamp - Living Room 및 Overhead Light - Living Room이 포함된 목록입니다. Google Home 앱에 표시되는 조명 이름으로, 여러 개의 조명을 포함하기 위해 각각의 기기를 하이픈으로 시작하는 별도의 줄에 표시했습니다.
   • 명령어에서 목표하는 state는 on: false입니다. 이 줄은 조명을 끄라고 지시합니다.

     metadata:
       name: TV on lights off
       description: Turn off lights when TV turns on.
     automations:
       starters:
       - type: device.state.OnOff
         device: Chromecast - Living Room
         state: on
         is: true
       actions:
       - type: device.command.OnOff
         devices:
         - Floor Lamp - Living Room
         - Overhead Light - Living Room
         on: false

9. 저장을 클릭하여 스크립트를 저장합니다. 오류가 없으면 스크립트가 자동으로 활성화되어 TV를 켤 때마다 조명이 꺼집니다. 아직 스크립트를 실행할 준비가 되지 않았다면 활성화를 사용 중지하여 스크립트를 일시중지할 수 있습니다.

더 연습하려면 다른 시작 조건, 데이터 유형, 여러 개의 작업 또는 time.between과 같은 추가적인 조건을 사용하도록 스크립트 중 일부를 변경해 보시기 바랍니다. 예시 스크립트를 검토하고 Codelab에서 자세한 내용을 알아볼 수도 있습니다. 시작 조건, 작업, 조건에 관한 자세한 내용은 Google Home 개발자 센터를 참고하세요.

스크립트 기반 자동화에 관한 도움말

• Google 홈 자동화 커뮤니티에서 스크립트에 대한 도움말을 찾아보고 다른 사람들이 어떤 작업을 하고 있는지 알아보세요.
• 자동화가 작동하려면 스크립트에서 올바른 코드를 사용해야 합니다. 오류가 있으면 메시지가 표시됩니다. 스크립트 편집기의 오류 및 경고에 관해 자세히 알아보세요.
• 코드를 확인하려면 스크립트 편집기에서 확인을 클릭 또는 탭하거나 스크립트를 저장하세요. 다음은 몇 가지 일반적인 오류입니다.
  • Device name - Room name 형식으로 올바른 기기 이름을 사용해야 합니다. 잘 모르겠다면 Google Home 앱에서 기기 이름을 확인하세요.
  • 기기가 실행하려는 기능을 지원하는지 확인합니다. 자동 완성을 사용하여 사용 가능한 옵션을 찾을 수도 있습니다.
  • 작업을 포함해야 합니다. 자동화를 실행하려면 작업이 필요합니다.
• 스크립트는 저장되나 자동화가 예상대로 작동하지 않는 경우 스크립트의 각 구성요소가 작동하는지 수동으로 확인하세요. 예를 들어 해가 지면 조명을 켜고 조명의 밝기를 변경하는 스크립트를 작성한 경우, 어시스턴트 명령어로 이러한 작업을 완료하여 각각의 기능이 작동하는지 확인합니다. 다음 사항도 확인해 보세요.
  • Google Home 앱에 기기가 추가 또는 연결되어 있습니다.
  • 기기가 인터넷에 연결되어 있습니다.
  • 기기 이름, 시작 조건, 조건, 작업이 올바르게 작성되어 있습니다.
    참고: 제조업체에서 업데이트를 실행할 때 기기 특성을 변경할 수 있으며, 이로 인해 스크립트 작동이 중지될 수 있습니다. 자동 완성을 사용해 영향을 받는 스크립트를 업데이트할 수 있습니다.
  • 스크립트에 들여쓰기 및 서식이 올바르게 적용되어 있습니다.
• 웹용 Google Home을 사용하면 스크립트 아래에 있는 자동화 로그 에 액세스하여 자동화 기록을 확인하고 잠재적인 문제를 식별할 수 있습니다. 자동화 로그에 표시되는 메시지 유형을 자세히 알아보세요.
• 스크립트 편집기의 실험용 생성형 AI 기능을 사용하여 원하는 자동화를 설명하면 스크립트 초안이 생성되어 검토하고 수정할 수 있습니다.
• 루틴 기본 사항 및 문제 해결 방법에 관해 자세히 알아보세요.
• 스크립트 기반 자동화 생성 및 수정에 관해 자세히 알아보세요.