Bienvenue dans le centre Google Home pour les développeurs, la nouvelle destination pour apprendre à développer des actions pour la maison connectée. Remarque:Vous continuerez de créer des actions dans la console Actions.

Schéma Trait Trait Smart Home

action.devices.traits.StartStop : cette caractéristiques appartient aux appareils compatibles avec les opérations de démarrage et d'arrêt.

Le démarrage et l'arrêt d'un appareil ont une fonction semblable à l'allumage et à l'arrêt. Les appareils qui héritent de cette caractéristique fonctionnent différemment lorsqu'ils sont activés et démarrés. Certains lave-linge, par exemple, peuvent être allumés et leurs paramètres modifiés avant d'être lancés.

Contrairement aux appareils simplement dotés d'un état "allumé et éteint", certains appareils pouvant démarrer ou arrêter peuvent également s'interrompre lors d'une opération. Les appareils qui peuvent être suspendus cesseront de fonctionner, mais ils reprendront dans leur état précédent. La réactivation n'est pas le même que le démarrage/le redémarrage, quel que soit l'état actuel de l'appareil, l'opération est relancée depuis le début.

Certains appareils peuvent prendre en charge l'exécution dans certaines zones. Par exemple, un arroseur peut avoir différentes zones d'arrosage et permettre d'arroser individuellement des zones spécifiques, tandis que l'aspirateur peut permettre de nettoyer des pièces spécifiques.

ATTRIBUTS de l'appareil

Les appareils disposant de cette caractéristique peuvent signaler les attributs suivants lors de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs Type Description
pausable Booléen

(Par défaut : false)

Indique si l'appareil peut être mis en pause pendant l'opération.
availableZones Array

Indique les noms de zone acceptés. Les chaînes doivent être localisées comme défini par l'utilisateur. Cette liste n'est pas exclusive : les utilisateurs peuvent signaler les noms de leur choix.
[item, ...] Chaîne

Nom d'une zone où l'appareil de démarrage est pris en charge.

Exemples

Appareil pouvant être mis en pause et compatible avec plusieurs zones.

{
  "pausable": true,
  "availableZones": [
    "Kitchen",
    "Living room",
    "Office",
    "Bedroom"
  ]
}

Appareil STATES

Les entités dotées de cette caractéristique peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez Traitement des intents.

États Type Description
isRunning Booléen

Obligatoire.

Indique si l'appareil est en cours d'utilisation.
isPaused Booléen

Indique si l'appareil est explicitement mis en pause. Si cette valeur est "true", cela implique que la valeur de isRunning est "false", mais peut être réactivée.
activeZones Array

Indique les zones dans lesquelles l'appareil est en cours d'exécution, à partir de la liste de availableZones.
[item, ...] Chaîne

Nom de la zone.

Exemples

L'appareil est-il en pause ?

{
  "isRunning": false,
  "isPaused": true
}

L'appareil est-il en pause ?

{
  "isRunning": true,
  "isPaused": false
}

L'appareil fonctionne-t-il ?

{
  "isRunning": true,
  "isPaused": false,
  "activeZones": [
    "Kitchen",
    "Living room"
  ]
}

Appareil COMMANDS

Les appareils disposant de cette caractéristique peuvent répondre aux commandes suivantes dans le cadre de l'opération EXECUTE. Pour en savoir plus sur la gestion des intents EXECUTE, consultez Traitement des intents.

action.devices.commands.StartStop

Démarrez ou arrêtez l'appareil.

Paramètres

Paramètres Type Description
start Booléen

Obligatoire.

True pour démarrer l'appareil, false pour arrêter.
zone Chaîne

Indique la zone dans laquelle démarrer l'exécution.
multipleZones Array

Indique au moins deux zones dans lesquelles commencer à s'exécuter. Cet élément sera défini à la place de zone parameter..
[item, ...] Chaîne

Nom de la zone dans laquelle démarrer l'appareil.

Exemples

Démarrez l'appareil.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true
  }
}

Arrêtez l'appareil.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": false
  }
}

Démarrez l'appareil au bureau.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "zone": "office"
  }
}

Démarrez l'appareil dans la cuisine, la salle à manger et le salon.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "multipleZones": [
      "Kitchen",
      "Dining room",
      "Living room"
    ]
  }
}

action.devices.commands.PauseUnpause

Suspendez ou réactivez le fonctionnement d'un appareil.

Cette commande nécessite les attributs suivants :
{
  "pausable": true
}

Paramètres

Paramètres Type Description
pause Booléen

Obligatoire.

Vrai pour mettre en pause, faux pour réactiver.

Exemples

Mettez l'appareil en pause.

{
  "command": "action.devices.commands.PauseUnpause",
  "params": {
    "pause": true
  }
}

L'utilisateur a essayé de suspendre un appareil, mais celui-ci est suspendu.

Valeurs acceptées :

unpausableState

Exemples d'énoncés

de-DE

  • Bitte starte den Staubsauger im Wohnzimmer .
  • Geschirrspüler wieder anstellen
  • Staubsauger abschalten
  • Staubsauger pausieren
  • bitte starte die Waschmaschine
  • ist die Waschmaschine fertig

en-US

  • I need my roomba to start running in the den
  • is the vacuum running
  • pause the dryer now
  • start the dryer now
  • stop the dishwasher
  • unpause the dishwasher

es-ES

  • dime si ha acabado el lavavajillas
  • parar la lavadora
  • pon el lavavajillas en pausa
  • quiero usar el friegaplatos
  • vuelve a encender la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salon .
  • Continuer l'aspirateur .
  • arrête l'aspirateur
  • est-ce que l'aspirateur est en marche
  • lance la machine à laver
  • mets l'aspirateur en pause

hi-IN

  • कमरे में वैक्यूम चलाओगी
  • क्या वैक्यूम चल रहा है?
  • डिशवॉशर को कुछ देर रोको
  • वैक्यूम को अनपॉज़ करो
  • वैक्यूम को चालू कर दो
  • वैक्यूम को बंद कर दो

it-IT

  • Mi accendi l'aspirapolvere in cucina ?
  • fa' partire aspirapolvere
  • fai ripartire l'aspirapolvere
  • la lavatrice è in funzione
  • metti in pausa l'aspirapolvere
  • stoppa l'aspirapolvere

ja-JP

  • お掃除ロボット を リビング で動かして
  • 台所の食洗機 を一時停止してください
  • 掃除機 は作動してる
  • 掃除機 を停止して
  • 掃除機 を再開してください
  • 洗濯機 をスタートさせて

ko-KR

  • 거실 에서 청소기 돌려
  • 건조기 돌아가고 있나
  • 세탁기 좀 돌려 줘
  • 식기 세척기 다시 시작해
  • 청소기 일시 정지
  • 청소기 작동 멈춰 줘

nl-NL

  • De schoonmaakrobot inschakelen in de keuken .
  • Is de stofzuiger klaar
  • hervat de stofzuiger
  • pauzeer de stofzuiger
  • start mijn stofzuiger
  • stop de stofzuiger

pt-BR

  • Inicia o aspersor no jardim
  • Iniciar o aspirador de pó na sala .
  • iniciar a máquina de lavar
  • o aspirador está parado?
  • parar a pausa na máquina de lavar roupa
  • parar o aspirador de pó
  • pausar o aspirador de pó

sv-SE

  • Kör igång sprinklern på gräsmattan .
  • har dammsugaren i vardagsrummet startat?
  • kör igång dammsugaren igen
  • pausa dammsugaren
  • starta tvättmaskinen
  • stoppa dammsugaren

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.