Skriv scriptbaserede automatiseringer med redigeringsværktøjet til scripts

Med redigeringsværktøjet til scripts kan du skrive dine egne automatiseringer med henblik på at oprette avancerede rutiner for husstanden via Google Home til nettet eller i Google Home-appen. Hvis du vil skrive scriptautomatiseringer, skal du have lidt grundlæggende oplysninger om YAML-scriptsproget, hvordan du strukturerer dit script, og hvordan du bruger de komponenter, der udgør dit script.

Redigeringsværktøjet til scripts er i øjeblikket tilgængeligt via Offentligt preview. Du kan få adgang til redigeringsværktøjet til scripts via Google Home til nettet eller i Google Home-mobilappen, når du har tilmeldt dig Offentligt preview.

• Opret avanceret styring af smartenheder i hjemmet med redigeringsværktøjet til scripts
• Understøttede aktiveringsfunktioner, betingelser og handlinger
• Gå til codelab for at se et eksempel på, hvordan du opretter dit første script
• Øvelser i at skrive en scriptbaseret automatisering og eksempler på scripts

Grundlæggende oplysninger om YAML-scriptsprog

Redigeringsværktøjet til scripts anvender YAML, der er et scriptsprog, som giver dig mulighed for at angive en "linje for linje"-vejledning til de ting, du vil have, at dine enheder gør, og hvornår du vil have dem til at gøre det. Denne vejledning er skrevet i form af nøgleværdipar.

Nøgleværdipar

YAML er skrevet som en serie af nøgleværdipar:

name: TV on lights off

I dette eksempel er nøglen = name og værdien = TV on lights off.

Nøglen er i bund og grund søgeordet for et element, du vil bruge. Hver nøgle skal være unik, men rækkefølgen af dine nøgler har ingen betydning. Hvert nøgleværdipar starter på en ny linje.

Den værdi, der er knyttet til en nøgle, kan være i form af flere forskellige 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-sprogsyntaks

Når du skriver scriptbaserede rutiner, skal du bruge disse formateringskoncepter:

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

weekdays:
- MONDAY
- THURSDAY

Skabelon for redigeringsværktøjet til scripts

Når du opretter en ny automatisering, giver redigeringsværktøjet til scripts dig en tom skabelon, hvor du kan skrive dit script ved hjælp af denne struktur:

Skabelonen er opdelt i 2 primære blokke: metadata og automatiseringer. Automatiseringer opdeles derefter yderligere i sektioner for aktiveringsfunktioner, betingelser og handlinger.

Metadata- og automatiseringsblokke

Skabelonen for redigeringsværktøjet til scripts indeholder 2 overordnede nøgler – eller blokke: metadata og automations.

Blokken metadata indeholder navnet og beskrivelsen af din automatisering. Disse data bruges udelukkende til at hjælpe dig med at identificere din automatisering.

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

Blokken automations er kernen i dit automatiseringsscript. Her definerer du din automatiseringsadfærd ved hjælp af aktiveringsfunktioner, betingelser og handlinger.

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

Du kan få flere oplysninger om, hvordan du bruger redigeringsværktøjet til scripts, ved at besøge codelab, se eksempler på scripts eller tjekke, hvordan du formaterer de individuelle aktiveringsfunktioner, betingelser og handlinger, i Google Homes udviklercenter.

Autofuldførelse

Redigeringsværktøjet til scripts vejleder dig i, hvordan du skriver dit script, ved at give dig forslag til autofuldførelse baseret på tilgængelige aktiveringsfunktioner, betingelser og handlinger, når:

• Markøren er placeret der, hvor der er gyldige muligheder. For eksempel efter "- type: ".
  • Du indtaster kode med gyldige forslag. Du kan se listen over foreslåede filtre, mens du skriver.

Du kan starte autofuldførelse manuelt ved hjælp af genvejen Ctrl + mellemrumstasten.

Tryk på Enter for at vælge et forslag på listen. Autofuldførelse udfylder yderligere felter baseret på den struktur, du vælger.

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

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

Aktiveringsfunktioner, betingelser og handlinger

Automatiseringer består af aktiveringsfunktioner, betingelser og handlinger for enheden. Disse komponenter definerer din automatiseringsadfærd.

Nogle aktiveringsfunktioner, betingelser og handlinger kræver en bestemt type sammenligningsnøgleværdipar som en hjælp til at fuldføre automatiseringslogikken og fortælle dit script, hvad du vil have evalueret. Værdien skal være en kompatibel datatype. Tilstanden on for en lampe kan f.eks. enten være true eller false. For at starte automatiseringen, hvis lyset er tændt, skal du bruge:

state: on
is: true

Nedenfor kan du se oplysninger om de forskellige aktiveringsfunktioner, betingelser og handlinger. Du kan se en komplet liste over aktiveringsfunktioner, betingelser og handlinger i Google Homes udviklercenter.

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

Ressourcer

Øv dig i at skrive et script

Kom godt i gang ved at oprette en meget enkel, men populær automatisering: "Sluk lyset, når fjernsynet tændes."

1. Åbn home.google.com/automations, og log ind på din konto.
2. Klik på Tilføj ny .
3. Udfyld metadataoplysningerne. I dette script er name = TV on lights off og description = Turn off lights when TV turns on. Sørg for at formatere dit script korrekt.

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

4. Hvis du vil tilføje aktiveringsfunktioner, skal du oprette en ny linje, indrykke den med 2 mellemrum eller trykke på Tab-tasten én gang og angive "starters: ". På den næste linje skal du derefter lave en indrykning igen og angive "- type: ".
   Tip!

   • Du kan oprette en ny linje ved at trykke på Shift Enter.
   • Hvis du vil inkludere flere aktiveringsfunktioner, skal hver aktivering begynde med en bindestreg og et mellemrum.

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

Bemærk! Redigeringsværktøjet til scripts hjælper dig med strukturen ved at give forslag til autofuldførelse baseret på tilgængelige aktiveringsfunktioner. Du kan vælge mellem forslagene ved at bruge piletasterne på dit tastatur til at markere et forslag og derefter trykke på Enter for at indsætte det.

5. Tilføj aktiveringsfunktionen device.state. Husk, at du skal bruge 3 nøgler: type, device og state for at anvende aktiveringsfunktionen device.state efterfulgt af mindst ét sammenligningsnøgleværdipar. Redigeringsværktøjet til scripts hjælper dig med strukturen ved at give forslag til autofuldførelse baseret på tilgængelige aktiveringsfunktioner, betingelser og handlinger. I dette script:
   • Type = device.state.OnOff. Dette er enhedens tilstand, som vil blive evalueret for at starte vores automatisering.
   • Device = Chromecast - Living Room. Dette er navnet på vores enhed, sådan som det vises i Google Home-appen.
   • State = on. On er det understøttede felt for State-data for enhedens OnOff-tilstand.
   • Sammenligningsnøgleværdipar = is: true. Værdien for denne sammenligningsnøgle er en primitiv datatype. Scriptet kører, hvis fjernsynet er tændt.

     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

     Til sammenligning kan vi se på et lignende script med en anden aktiveringsfunktion. I scriptet nedenfor starter automatiseringen, når lydstyrken er mellem 1 og 10, i stedet for når fjernsynet tændes. For at foretage denne ændring har vi erstattet tilstanden OnOff med Volume og ændret tilstanden til currentVolume, så den matcher den nye attribut. Vi har også ændret sammenligningsnøgleværdiparrene til 2 indlejrede par, der opretter et interval: greaterThan: 1 og lessThan: 10. Du kan se flere eksempler på denne komplette liste over aktiveringsfunktioner, som du kan bruge.

     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. Klik på Gem for at gemme dit script når som helst. Når du gemmer et script, validerer redigeringsværktøjet til scripts automatisk dit script og tjekker, om der er fejl. Et ugyldigt script kan ikke køre.
7. Føj nu en handling til dit script. Hvis du vil tilføje handlinger, skal du oprette en ny linje, indrykke den med 2 mellemrum eller trykke på Tab-tasten én gang og angive "actions: ". På den næste linje skal du derefter lave en indrykning igen og angive "- type ".
   Tip!

   • Du kan oprette en ny linje ved at trykke på Shift Enter.
   • Hvis du vil inkludere yderligere handlinger, skal hver handling starte med en bindestreg og et mellemrum.

   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 bruger handlingen device.command til at slukke vores lys. Hvis du vil bruge handlingen device.command, medtager vi følgende oplysninger:
   • Type = device.command.OnOff. Dette er navnet på kommandoen eller handlingen.
     Bemærk! Kommandoer kan have flere kommandoer indlejret under dine enheder, og hver kommando har sin egen tilstand.
   • Devices = En liste, der indeholder Floor Lamp - Living Room og Overhead Light - Living Room. Disse er navnene på vores lamper, sådan som de vises i Google Home-appen. Vi har angivet hver enhed på separate linjer, hvor hver begynder med en bindestreg, for at inkludere flere lamper.
   • Kommandoens tilsigtede tilstand = on: false. Denne linje beder vores lamper om at slukke.

     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. Klik på Gem for at gemme dit script. Hvis der ikke er nogen fejl, aktiveres dit script automatisk: Når dit fjernsyn tændes, slukkes lyset. Hvis du ikke er klar til at køre dit script endnu, kan du sætte dit script på pause ved at slå Aktivér fra.

Hvis du vil øve dig mere, kan du prøve at ændre nogle af dine scripts, så de bruger andreaktiveringsfunktioner, datatyper, flere handlinger eller en ekstrabetingelse som f.eks. time-between. Du kan også tjekke eksempler på scripts og codelab for at få flere oplysninger. Du kan få flere oplysninger om aktiveringsfunktioner, handlinger og betingelser i Google Homes udviklercenter.

Hjælp til scriptbaserede automatiseringer

• Få hjælp til scripts, og find ud af, hvad andre arbejder på, i Google-fællesskabet for hjemmestyring.
• Scripts skal anvende gyldig kode, før automatiseringer kan fungere. Hvis der er en fejl, vises der en meddelelse. Få flere oplysninger om fejl og advarsler i redigeringsværktøjet til scripts.
• Du kan validere din kode ved at klikke eller trykke på Valider i redigeringsværktøjet til scripts eller prøve at gemme dit script. Her er nogle almindelige fejl:
  • Sørg for, at du bruger det korrekte enhedsnavn med formatet Navn på enhed – Navn på rum. Hvis du er i tvivl, kan du tjekke navnet på din enhed i Google Home-appen.
  • Sørg for, at din enhed understøtter den funktion, du vil have den til at udføre. Du kan også bruge autofuldførelse til at finde tilgængelige valgmuligheder.
  • Sørg for at inkludere en handling. Handlinger er påkrævet, for at en automatisering kan køre.
• Hvis scriptet gemmes, men automatiseringen ikke fungerer som forventet, skal du manuelt tjekke, at hver komponent i dit script fungerer. Hvis du f.eks. har skrevet et script, der skal tænde lyset og justere lysstyrken ved solnedgang, kan du prøve at fuldføre disse opgaver med en Assistent-kommando for at tjekke, at de enkelte funktioner fungerer. Du kan også tjekke, at:
  • Din enhed er tilføjet eller tilknyttet i Google Home-appen.
  • Din enhed har forbindelse og er online.
  • Enhedsnavnet, aktiveringsfunktioner, betingelser og handlinger er skrevet korrekt.
    Bemærk! Producenter kan ændre enhedskarakteristika, når de foretager opdateringer, og dette kan medføre, at scripts holder op med at fungere. Du kan bruge autofuldførelse til at opdatere de berørte scripts.
  • Dit script har korrekt indrykning og formatering.
• Med Google Home til nettet kan du også få adgang til automatiseringslogs under dit script, så du kan se din historik for automatiseringer og identificere potentielle problemer. Få flere oplysninger om de typer meddelelser, du ser i automatiseringloggerne.
• Prøv at bruge den eksperimentelle funktion med generativ AI i redigeringsværktøjet til scripts til at beskrive den automatisering, du vil have. Funktionen opretter et udkast til et script, som du kan gennemgå og redigere.
• Få flere grundlæggende oplysninger om rutiner og om, hvordan du finder og løser problemer med dem.
• Få flere oplysninger om oprettelse og redigering af scriptbaserede automatiseringer.