Skriv skriptbaserte automatiseringer med redigeringsverktøyet for skript

Med redigeringsverktøyet for skript kan du skrive dine egne automatiseringer for å lage avanserte husstandsrutiner med Google Home på nettet eller i Google Home-appen. Før du kan skrive skriptbaserte automatiseringer, må du ha grunnleggende kunnskap om YAML-skriptspråket, hvordan du strukturerer skript, og hvordan du bruker komponentene som utgjør skriptet.

Redigeringsverktøyet for skript er tilgjengelig i den offentlige forhåndsversjonen. Du kan åpne redigeringsverktøyet for skript med Google Home på nettet eller i Google Home-mobilappen etter at du har begynt å bruke den offentlige forhåndsversjonen.

• Opprett avanserte automatiseringer for smarthjem med redigeringsverktøyet for skript.
• Støttede aktiveringsfunksjoner, betingelser og handlinger
• Gå til kodelaben for å se et eksempel med en veiledning om hvordan du lager ditt første skript.
• Øvelser i å skrive skriptbaserte automatiseringer og eksempler på skript

Grunnleggende informasjon om YAML-skriptspråket

Redigeringsverktøyet for skript bruker YAML, som er et fleksibelt skriptspråk som gjør det mulig å legge inn instrukser linje for linje for ting du vil enhetene skal gjøre og når. Disse instruksjonene er skrevet i form av nøkkelverdi-par.

Nøkkel/verdi-par

YAML skrives som en serie med nøkkel/verdi-par:

name: TV on lights off

I dette eksempelet er nøkkelen = name og verdien = TV on lights off.

Nøkkelen er i bunn og grunn nøkkelordet for et element du vil bruke. Hver nøkkel må være unik, men rekkefølgen på nøklene har ingen betydning. Hvert nøkkel/verdi-par starter på en ny linje.

Verdien som er tilknyttet en nøkkel, kan være i form av flere ulike datatyper.

Datatyper

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-språksyntaks

Når du skriver skriptbaserte rutiner, kan du bruke disse formateringskonseptene:

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

weekdays:
- MONDAY
- THURSDAY

Malen for redigeringsverktøyet for skript

Når du oppretter en ny automatisering, gir redigeringsverktøyet for skript deg en tom mal til å skrive skriptet i ved hjelp av denne strukturen:

Malen er delt inn i to hovedblokker: metadata og automatiseringer. Automatiseringen blir deretter delt inn ytterligere i aktiveringsfunksjoner, betingelser og handlinger.

Metadata- og automatiseringsblokker

Malen for redigeringsverktøyet for skript inneholder to overordnede nøkler eller blokker: metadata og automations.

Metadata-blokken inneholder navnet til og beskrivelsen av automatiseringen. Den brukes bare for å identifisere automatiseringen.

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

Automations-blokken er kjernen i automatiseringsskriptet. Det er her du definerer hva automatiseringen gjør, med aktiveringsfunksjoner, betingelser og handlinger.

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

Du kan få en bedre forståelse av hvordan du bruker redigeringsverktøyet for skript, ved å gå til kodelaben, se eksempler på skript eller finne ut hvordan du formaterer aktiveringsfunksjoner, betingelser og handlinger enkeltvis i utviklersenteret for Google Home.

Autofullføring

Redigeringsverktøyet for skript hjelper deg med å skrive skriptet ditt ved å komme med forslag basert på tilgjengelige aktiveringsfunksjoner, betingelser og handlinger når

• markøren befinner seg på steder der det finnes gyldige alternativer – for eksempel etter «- type: »
  • du skriver inn kode med gyldige forslag – forslagsfilteret vises mens du skriver

du starter funksjonen for autofullføring manuelt med Ctrl+mellomrom-hurtigtasten

Trykk på Enter for å velge et forslag fra listen. Autofullføring fyller ut flere felt basert på strukturen du velger.

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

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

Aktiveringsfunksjoner, betingelser og handlinger

Automatiseringer består av aktiveringsfunksjoner, betingelser og handlinger. Disse komponentene definerer hvordan automatiseringen fungerer.

Enkelte aktiveringsfunksjoner, betingelser og handlinger krever en bestemt type nøkkel/verdi-par for sammenligning for å fullføre automatiseringslogikken og fortelle skriptet hva du vil ha evaluert. Verdien må være en kompatibel datatype. Lysets on-tilstand kan for eksempel være enten true eller false. For å starte automatiseringen hvis lyset er på, bruker du:

state: on
is: true

Nedenfor finner du informasjon om de ulike aktiveringsfunksjonene, betingelsene og handlingene som er tilgjengelige. Du finner en fullstendig liste over aktiveringsfunksjoner, betingelser og handlinger i utviklersenteret for 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

Handlinger

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 - [email protected]
  - Kim - [email protected]
  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

Ressurser

Øv deg på å skrive skript

For å komme i gang oppretter vi en veldig enkel, men populær automatisering: «Slå av lysene når TV-en slås på».

1. Åpne home.google.com/automations, og logg på kontoen din.
2. Klikk på Legg til ny .
3. Fyll ut metadataene. I dette skriptet er navn = TV on lights off og beskrivelsen = Turn off lights when TV turns on. Sjekk at du har formatert skriptet riktig.

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

4. For å legge til aktiveringsfunksjoner, opprett en ny linje, rykk inn linjen med to mellomrom eller trykk på tabulatortasten én gang, og skriv inn «starters: ». På den neste linjen rykker du inn igjen og skriver inn «- type: ».
   Tips:

   • For å opprette en ny linje, trykk på Shift  Enter.
   • For å inkludere flere aktiveringsfunksjoner må alle starte med en bindestrek og et mellomrom.

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

Merk: Redigeringsverktøyet for skript hjelper deg med strukturen ved å komme med forslag basert på tilgjengelige aktiveringsfunksjoner. For å velge blant forslagene, bruk piltastene på tastaturet til å velge et, og trykk på Enter for å sette det inn.

5. Legg til aktiveringsfunksjonen device.state. Husk at for å bruke en device.state-aktiveringsfunksjon trenger du tre nøkler: type, device og state etterfulgt av minst ett nøkkelverdi-par for sammenligning. Redigeringsverktøyet for skript hjelper deg med strukturen ved å komme med forslag basert på tilgjengelige aktiveringsfunksjoner, betingelser og handlinger. I dette skriptet:
   • Type = device.state.OnOff. Dette er enhetens tilstand som evalueres for å starte automatiseringen.
   • Enhet = Chromecast - Living Room. Dette er navnet på enheten slik det vises i Google Home-appen.
   • Tilstand = on. På er de støttede felt- eller tilstandsdataene for av/på-enhetstilstanden.
   • Nøkkelverdi-paret for sammenligning = is: true. Verdien for denne sammenligningsnøkkelen er en primitiv datatype. Skriptet kjøres hvis TV-en er på.

     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

     La oss se på et lignende skript med en annen aktiveringsfunksjon for å sammenligne. I skriptet nedenfor starter automatiseringen når volumet er mellom 1 og 10, og ikke når TV-en slås på. For å gjøre denne endringen erstattet vi OnOff-tilstanden med Volume og endret tilstanden til currentVolume for å passe med det nye attributtet. Vi har også endret nøkkel/verdi-parene for sammenligning til to flettede par som danner et område: greaterThan: 1 og lessThan: 10. Her er en komplett liste over aktiveringsfunksjoner du kan bruke.

     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. Du kan når som helst klikke på Lagre for å lagre skriptet. Når du lagrer skriptet, validerer redigeringsverktøyet for skript skriptet og ser etter feil automatisk. Et ugyldig skript kan ikke kjøres.
7. Legg til en handling i skriptet ditt. For å legge til handlinger, opprett en ny linje, rykk inn linjen med to mellomrom eller trykk på tabulatortasten én gang, og skriv inn «actions: ». På den neste linjen rykker du inn igjen og skriver inn «- type: ».
   Tips:

   • For å opprette en ny linje, trykk på Shift  Enter.
   • For å inkludere flere handlinger må hver handling begynne med en bindestrek og et mellomrom.

   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. For å slå av lysene bruker vi device.command-handlingen. For å bruke device.command-handlingen inkluderer vi følgende informasjon:
   • Type = device.command.OnOff. Dette er navnet på kommandoen eller handlingen.
     Merk: Kommandoer kan ha flere kommandoer flettet under enhetene dine, og hver kommando har sin egen tilstand.
   • Enheter = en liste som inneholder Floor Lamp - Living Room og Overhead Light - Living Room. Dette er navnene på lysene slik de vises i Google Home-appen. For å inkludere flere lys har vi oppført hver enhet på en egen linje og med bindestrek.
   • Kommandoens foretrukne tilstand er = on: false. Denne linjen forteller lysene at de skal slå seg av.

     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. Klikk på Lagre for å lagre skriptet. Hvis det ikke finnes noen feil, aktiveres skriptet automatisk. Når TV-en slås på, slås lyset av. Hvis du ikke er klar til å kjøre skriptet ennå, stopper du skriptet midlertidig ved å slå av Aktiver.

Hvis du vil øve mer, kan du prøve å endre deler av skriptet med andre aktiveringsfunksjoner, datatyper, flere handlinger eller flere betingelser som time.between. Du kan også gå gjennom eksempler på skript og ta en titt på kodelaben for å finne ut mer. Du finner detaljert informasjon om aktiveringsfunksjoner, handlinger og betingelser i utviklersenteret for Google Home.

Hjelp med skriptbaserte automatiseringer

• Få hjelp med skript og finn ut hva andre jobber med, i brukerfellesskapet for Google Home-automatisering.
• Skript må bruke gyldig kode for at automatiseringer skal fungere. Hvis det finnes feil, vises en melding. Finn ut mer om feil og varsler i redigeringsverktøyet for skript.
• For å validere koden, klikk eller trykk på Valider i redigeringsverktøyet for skript, eller prøv å lagre skriptet. Her er noen vanlige feil:
  • Sjekk at du bruker riktig enhetsnavn i formatet enhetsnavn – romnavn. Hvis du ikke er sikker, kan du sjekke navnet på enheten i Google Home-appen.
  • Sørg for at enheten støtter funksjonen du vil at den skal utføre. Du kan også bruke autofullføring til å finne tilgjengelige alternativer.
  • Sørg for at du inkluderer en handling. Automatiseringer trenger handlinger for å kunne kjøre.
• Hvis skriptet lagres, men automatiseringen ikke fungerer som forventet, må du sjekke manuelt at alle komponentene i skriptet fungerer. Hvis du for eksempel har skrevet et skript for å slå på lyset og endre lysstyrken ved solnedgang, kan du prøve å utføre disse oppgavene med en assistentkommando for å sjekke at hver enkelt funksjon fungerer. Du kan også sjekke at
  • enheten er lagt til eller tilknyttet i Google Home-appen
  • enheten er tilkoblet og på nettet
  • enhetsnavnet, aktiveringsfunksjonene, betingelsene og handlingene er skrevet på riktig måte
    Merk: Produsenter kan endre enhetsegenskaper når de utfører oppdateringer, og dette kan føre til at skript slutter å fungere. Du kan bruke autofullføring for å oppdatere berørte skript.
  • skriptet har riktig innrykk og formatering
• Med Google Home på nettet kan du sjekke Automatisering-loggene under skriptet for å sjekke automatiseringsloggen og identifisere mulige problemer. Finn ut mer om hvilke typer meldinger du ser i automatiseringsloggene.
• Prøv å bruke funksjonen for generativ AI (på forsøksstadiet) til redigeringsverktøyet for skript for å beskrive automatiseringen du vil ha, så lager den et utkast av et skript som du kan gå gjennom og redigere.
• Finn ut mer om grunnleggende informasjon om rutiner og hvordan du feilsøker dem.
• Finn ut mer om hvordan du oppretter og redigerer skriptede automatiseringer.