Skriva automatiseringar med skriptredigeraren

Med skriptredigeraren kan du skriva egna automatiseringar och skapa avancerade hushållsrutiner med Google Home för webben eller i Google Home-appen. Om du vill skriva automatiseringsskript behöver du känna till grunderna i skriptspråket YAML, hur du strukturerar skriptet och hur du använder komponenterna som utgör skriptet.

Skriptredigeraren är för närvarande tillgänglig i den offentliga förhandsversionen. Du kan komma åt skriptredigeraren via Google Home för webben eller i den mobila Google Home-appen när du har gått med i programmet Offentlig förhandsversion.

• Skapa avancerade automatiseringar för smarta hem med skriptredigeraren
• Utlösare, villkor och åtgärder som stöds
• Besök vårt codelab om du vill ha anvisningar om hur du skapar ditt första skript
• Öva på att skriva automatiseringsskript och få exempelskript.

Grunderna i YAML-skriptspråket

I skriptredigeraren används YAML, ett flexibelt skriptspråk som du kan använda för att ange anvisningar för varje rad om vad du vill att dina enheter ska göra och när du vill att det ska hända. Dessa anvisningar är skrivna i form av nyckel-värdepar.

Nyckel-värdepar

YAML är skrivet som en serie nyckel-värdepar:

name: TV on lights off

I det här exemplet är nyckeln = name och värdet = TV on lights off.

Nyckeln är i grunden sökordet för ett element som du vill använda. Alla nycklar måste vara unika, men ordningen på nycklarna spelar ingen roll. Varje nyckel-värdepar börjar på en ny rad.

Det värde som är kopplat till en nyckel kan ha formen av flera olika 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

Språksyntax för YAML

Använd följande formateringskoncept när du skriver skript med rutiner:

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

weekdays:
- MONDAY
- THURSDAY

Mallen för skriptredigeraren

När du skapar en ny automatisering genererar skriptredigeraren en tom mall för dig att skriva skriptet i, med hjälp av den här strukturen:

Mallen är uppdelad i två huvudblock: metadata och automatiseringar. Automatiseringen delas sedan upp i delarna starters (utlösare), conditions (villkor) och actions (åtgärder).

Blocken metadata och automations

Skriptredigerarmallen innehåller två överordnade nycklar, eller block: metadata och automations.

Blocket metadata innehåller automatiseringens namn och beskrivning. Detta används endast för att hjälpa dig att identifiera automatiseringen.

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

Blocket automations är kärnan i ditt automatiseringsskript. Här definierar du automatiseringens beteende med hjälp av utlösare, villkor och åtgärder.

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

För att få en bättre inblick i hur du använder skriptredigeraren kan du besöka vårt codelab, titta på exempelskript eller lära dig hur du formaterar individuella utlösare, villkor och åtgärder i utvecklarcentret för Google Home.

Autoslutförande

Skriptredigeraren hjälper dig att skriva skriptet genom att tillhandahålla förslag på autoslutförande utifrån tillgängliga utlösare, villkor och åtgärder vid följande tillfällen:

• När markören finns där det finns giltiga alternativ, till exempel efter - type: .
  • När du skriver kod med giltiga förslag. Listan över förslag filtreras allt eftersom du skriver.

Du startar autoslutförande manuellt med kortkommandot Ctrl + blanksteg.

Tryck på Retur för att välja ett förslag i listan. Med autoslutförande så fylls ytterligare fält i baserat på den struktur du väljer.

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

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

Utlösare, villkor och åtgärder

Automatiseringar utgörs av enhetsutlösare, villkor och åtgärder. Dessa komponenter definierar automatiseringens beteenden.

Vissa utlösare, villkor och åtgärder kräver en specifik typ av nyckel-värdepar för jämförelse för att slutföra automatiseringslogiken och för att skriptet ska veta vad du vill utvärdera. Värdet måste vara en kompatibel datatyp. Till exempel kan lampans on-status vara antingen true eller false. Om du vill starta automatiseringen om lampan är tänd använder du följande:

state: on
is: true

Nedan finns information om de olika tillgängliga utlösarna, villkoren och åtgärderna. En fullständig lista över utlösare, villkor och åtgärder finns i utvecklarcentret för 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

Åtgärder

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

Resurser

Öva på att skriva ett skript

Vi börjar med att skapa en mycket enkel, men vanlig, automatisering: ”Släck lamporna när tv:n slås på”.

1. Öppna home.google.com/automations och logga in på ditt konto.
2. Klicka på Lägg till ny .
3. Fyll i metadata. I det här skriptet är namnet = TV on lights off och beskrivningen = Turn off lights when TV turns on. Kontrollera att du har formaterat skriptet korrekt.

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

4. För att lägga till utlösare skapar du en ny rad, gör ett indrag med två blanksteg eller en Tabb och anger starters: . Gör sedan ett nytt indrag på nästa rad och ange - type: .
   Tips!

   • Skapa en ny rad genom att trycka på Skift Retur.
   • Om du inkluderar flera utlösare ska varje utlösare börja med ett bindestreck och ett blanksteg.

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

Obs! Skriptredigeraren hjälper dig med strukturen genom att ge förslag på autoslutförande baserat på tillgängliga utlösare. Välj bland förslagen genom att använda piltangenterna på tangentbordet och tryck sedan på Retur för att infoga det.

5. Lägg till utlösaren device.state. Kom ihåg att du behöver tre nycklar för att använda device.state-utlösaren: type, device och state, följt av minst ett nyckel-värdepar för jämförelse. Skriptredigeraren hjälper dig med strukturen genom att ge förslag på autoslutförande baserat på tillgängliga utlösare, villkor och åtgärder. I det här skriptet:
   • Type = device.state.OnOff. Det här är enhetens status som utvärderas för att starta automatiseringen.
   • Device = Chromecast - Living Room. Det här är namnet på enheten så som det visas i Google Home-appen.
   • State = on. On är fältet som stöds eller statusdata för OnOff-enhetsstatusen.
   • The comparison key-value pair = is: true. Värdet för denna jämförelsenyckel är en primitiv datatyp. Skriptet körs om tv:n är 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

     Som jämförelse tar vi en titt på ett liknande skript med en annan utlösare. I skriptet nedan startar automatiseringen när volymen är mellan 1 och 10, snarare än när tv:n slås på. För att göra den här ändringen ersatte vi statusen OnOff med Volume och ändrade statusen till currentVolume för att matcha det nya attributet. Vi ändrade även nyckel-värdeparen för jämförelse till två kapslade par som skapar ett intervall: greaterThan: 1 och lessThan: 10. Här finns en fullständig lista över utlösare som du kan använda.

     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 klicka på Spara för att spara skriptet. När du sparar ett skript validerar skriptredigeraren automatiskt skriptet och letar efter fel. Ett ogiltigt skript kan inte köras.
7. Lägg nu till en åtgärd i skriptet. För att lägga till åtgärder skapar du en ny rad, gör ett indrag med två blanksteg eller en Tabb och anger actions: . Gör sedan ett nytt indrag på nästa rad och ange - type .
   Tips!

   • Skapa en ny rad genom att trycka på Skift Retur.
   • Om du inkluderar ytterligare åtgärder ska varje åtgärd börja med ett bindestreck och ett blanksteg.

   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. Vi använder åtgärden device.command för att släcka lamporna. För att använda åtgärden device.command inkluderar vi följande information:
   • Type = device.command.OnOff. Det här är namnet på kommandot eller åtgärden.
     Obs! Kommandon kan ha flera kapslade kommandon under dina enheter och varje kommando har sin egen status.
   • Devices = en lista med Floor Lamp - Living Room och Overhead Light - Living Room. Det här är namnen på våra lampor, så som de visas i Google Home-appen. Vi har angett flera lampor på separata rader och var och en börjar med ett bindestreck.
   • Kommandots önskade status = on: false. Den här raden säger till våra lampor att släckas.

     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. Klicka på Spara för att spara skriptet. Om det inte finns några fel aktiveras skriptet automatiskt. Lampan släcks när tv:n slås på. Om du inte vill att skriptet ska köras ännu kan du pausa skriptet genom att inaktivera Aktivera.

Om du vill öva mer kan du testa att ändra skriptet så att det använder olika utlösare, datatyper, flera åtgärder eller ytterligare villkor som time.between. Du kan även titta på exempelskript och kolla in codelab. Detaljerad information om utlösare, åtgärder och villkor finns i utvecklarcentret för Google Home.

Hjälp med automatiseringsskript

• Få hjälp med skript och ta reda på vad andra gör i communityn för hemautomatisering med Google Home.
• För att automatiseringar ska fungera måste skripten bestå av giltig kod. Om det finns ett fel visas ett meddelande. Läs mer om fel och varningar i skriptredigeraren.
• Validera koden genom att klicka eller trycka på Validera i skriptredigeraren eller försöka spara skriptet. Här är några vanliga fel:
  • Kontrollera att du använder rätt enhetsnamn i formatet Enhetsnamn – Rumsnamn. Om du är osäker kontrollerar du namnet på enheten i Google Home-appen.
  • Kontrollera att enheten har stöd för de funktioner du vill att den ska utföra. Du kan även använda autoslutförande för att se tillgängliga alternativ.
  • Se till att du anger en åtgärd. Åtgärder krävs för att en automatisering ska köras.
• Om skriptet sparas men automatiseringen inte fungerar som förväntat kontrollerar du manuellt att varje komponent i skriptet fungerar. Om du till exempel skrev ett skript för att tända lampan och ändra ljusstyrkan vid solnedgången kan du prova att utföra dessa uppgifter med ett assistentkommando för att bekräfta att varje enskild funktion fungerar. Du kan också kontrollera att
  • enheten läggs till eller länkas i Google Home-appen
  • enheten är ansluten och online
  • enhetens namn, utlösare, villkor och åtgärder är korrekt angivna
    Obs! Tillverkare kan ändra enheters egenskaper när de utför uppdateringar, vilket kan leda till att skript slutar fungera. Du kan använda autoslutförande för att uppdatera berörda skript.
  • skriptet har korrekt indrag och formatering.
• Med Google Home för webben kan du även komma åt automatiseringsloggar under skriptet för att kontrollera automatiseringens historik och identifiera potentiella problem. Läs mer om typer av meddelanden som visas i automatiseringsloggarna.
• Testa att beskriva önskad automatisering med skriptredigerarens experimentella generativa AI-funktion. Då skapas ett skript som du kan granska och redigera.
• Läs mer om grunderna i rutiner och hur du felsöker dem.
• Läs mer om hur du skapar och redigerar automatiseringar med skript.