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 du cycle de vie d'un cycle de maison connectée

action.devices.traits.RunCycle : cette caractéristique représente tout appareil dont la durée d'exécution peut être interrogée.

Les appareils de ce type indiquent leur nombre total de cycles au début de l'opération et chaque cycle en cours d'exécution. Cela permet à l'utilisateur d'effectuer des requêtes, par exemple:

  • Sur quel cycle est mon sèche-linge ?
  • Combien de cycles restants pour le lave-vaisselle ?
  • Que fait le sèche-linge ?
  • Quand le lavage va-t-il se terminer ?

Certains appareils affichent une durée dans un format non cyclique. Tout appareil qui s'exécute pendant une période donnée peut signaler le temps restant, sans cycle. Cela gère également les cas où les cycles peuvent ne pas être cohérents (par exemple, les lave-vaisselle n'utilisent pas toujours tous les cycles). Par exemple, un utilisateur peut demander Combien de temps mon aspirateur va-t-il durer ? pour obtenir la durée exprimée en unités par rapport au temps restant. Cela s'applique également aux appareils répertoriés ci-dessus. Combien de temps mes sèche-linge sont-ils disponibles ? renvoie une durée en minutes.

Les appareils peuvent renvoyer ce qu'ils savent, et la réponse de l'Assistant affichera la réponse la plus pertinente avec les données disponibles (par exemple, Le lave-vaisselle est en marche et prendra environ 20 minutes).

RunCycle est actuellement une caractéristique en lecture seule. Il ne possède aucune commande, il n'indique que les états à interroger. À l'avenir, des mécanismes pourront être mis en place pour réexécuter des cycles ou ignorer des cycles (bonne pour l'arrosage, mauvais pour les machines à laver).

Appareil : ATTRIBUTES

Aucune.

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
currentRunCycle Array

Obligatoire.

Contient les synonymes du cycle en cours dans chaque langue acceptée.

[item, ...] Objet

Noms de synonymes de cycle.

currentCycle Chaîne

Obligatoire.

Cycle actuel en cours.

nextCycle Chaîne

Facultatif. Prochain cycle à effectuer.

lang Chaîne

Obligatoire.

Code de langue des noms de cycle donnés. Consultez la page Langues acceptées.

currentTotalRemainingTime Entier

Obligatoire.

Temps restant en fonctionnement, en secondes.

currentCycleRemainingTime Entier

Obligatoire.

Temps restant pour le cycle en cours, en secondes.

Exemples

L'appareil est à rincer pendant encore 5 minutes, et l'opération se terminera dans 20 minutes.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 1200,
  "currentCycleRemainingTime": 300
}

L'appareil est à rincer pendant cinq minutes supplémentaires avant de passer en rotation.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "nextCycle": "spin",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 600,
  "currentCycleRemainingTime": 300
}

Appareil COMMANDS

Aucune.

NOTIFICATIONS de l'appareil

Les appareils dotés de cette caractéristique peuvent renvoyer la charge utile de notification suivante dans le cadre d'un changement d'état d'un appareil. Pour en savoir plus sur l'implémentation des notifications, consultez Notifications pour les actions de maison connectée.

Champs Type Description
RunCycle

Obligatoire.

Charge utile de la notification.

Compatible avec l'un des systèmes suivants:
0 Objet

Réussite

priority Entier

Obligatoire.

Représente le niveau de notification. La valeur actuellement acceptée est 0, ce qui indique que la notification doit être lue à voix haute.

status Chaîne

Obligatoire.

Résultat de l'opération.

Valeurs acceptées :

SUCCESS
currentCycleRemainingTime Entier

Obligatoire.

Temps restant pour le cycle en cours, en secondes.

1 Objet

Échec

priority Entier

Obligatoire.

Représente le niveau de notification. La valeur actuellement acceptée est 0, ce qui indique que la notification doit être lue à voix haute.

status Chaîne

Obligatoire.

Résultat de l'opération.

Valeurs acceptées :

FAILURE
errorCode Chaîne

Obligatoire.

La valeur peut être n'importe quel code d'erreur pour cette caractéristique, par exemple deviceStuck.

Exemples

L'appareil a terminé de fonctionner.

{
  "RunCycle": {
    "priority": 0,
    "status": "SUCCESS",
    "currentCycleRemainingTime": 0
  }
}

Une erreur s'est produite lors du cycle en cours.

{
  "RunCycle": {
    "priority": 0,
    "status": "FAILURE",
    "errorCode": "deviceStuck"
  }
}

Erreurs liées à l'appareil

Consultez la liste complète des erreurs et exceptions.