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 appareils associés à 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

  • Début de bitte den Staubsauger im Wohnzimmer
  • Geschirrspüler wieder anstellen
  • Staubsauger abschaltène
  • Staubsauger pausieren
  • Bitte Starte die Waschmaschine

en-US

  • j'ai besoin de my roomba pour commencer à m'exécuter dans la salle de jeu
  • Suspendre le sèche-linge dès maintenant
  • démarrer le sèche-linge dès maintenant
  • arrêter le lave-vaisselle
  • réactiver le lave-vaisselle

es-ES

  • Parar la lavande
  • el Aspirador pon en el dortorio principal
  • Poon el lavavajillas en pausa
  • Quiero Us el friegaplatos
  • vulve a encender la aspiradora

fr-FR

  • Allumer l'aspirateurle salon
  • Continuer l'aspirateur .
  • 😩 l'aspirateur
  • lancer la machine la machine à laver
  • mets l'aspirateur en pause

Erreurs liées à l'appareil

Consultez la liste complète des erreurs et exceptions.