Bienvenue dans le Centre des développeurs Google Home, la nouvelle destination pour apprendre à développer des actions pour la maison connectée. Remarque : Vous continuerez à créer des actions dans la console Actions.
Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Schéma de traçabilité avec StopStop pour la maison connectée

action.devices.traits.StartStop : cette caractéristique 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'extinction. Les appareils qui héritent de cette caractéristique fonctionnent différemment lorsqu'ils sont activés et au démarrage. Par exemple, certains lave-linge peuvent être allumés et leurs paramètres modifiés avant de démarrer l'opération.

Contrairement aux appareils dont l'état est simplement activé ou désactivé, certains appareils qui peuvent démarrer et s'arrêter peuvent également s'interrompre lors d'une opération. Les appareils qui peuvent être mis en pause cesseront de fonctionner, mais à leur reprise, ils conserveront leur état d'interruption. Le rétablissement de la configuration d'un appareil est différent du démarrage et du redémarrage, quel que soit l'état actuel de l'appareil, l'opération reprend depuis le début.

Certains appareils peuvent être compatibles avec certaines zones. Par exemple, un arroseur peut avoir plusieurs zones d'arrosage et permettre d'arroser des zones spécifiques séparément, tandis qu'un aspirateur peut permettre de nettoyer des pièces spécifiques.

Appareil : ATTRIBUTES

Les appareils associés à cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez la page Traitement des intents.

Attributs Type Description
pausable Booléen

(Par défaut : false)

Indique si l'appareil peut être suspendu 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 disponible.

Exemples

Appareil pouvant être suspendu et compatible avec plusieurs zones.

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

Appareil : STATES

Les entités présentant 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 la page Traitement des intents.

États Type Description
isRunning Booléen

Obligatoire.

Indique si l'appareil est en fonctionnement.
isPaused Booléen

Indique si l'appareil est explicitement mis en pause. Si cette valeur est "true", cela signifie que la valeur de isRunning est "false", mais qu'elle 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 dotés 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 la page 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 commencer l'exécution.
multipleZones Array

Indique deux ou plusieurs zones dans lesquelles démarrer l'exécution. 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

Suspendre ou réactiver l'appareil.

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

Paramètres

Paramètres Type Description
pause Booléen

Obligatoire.

True pour suspendre, false pour réactiver.

Exemples

Suspendez l'appareil.

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

L'utilisateur a tenté de suspendre un appareil, mais celui-ci ne peut pas être 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 liées à l'appareil

Consultez la liste complète des erreurs et exceptions.