Traits de l'appareil
Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.
La fonctionnalité des types d'appareils provient des caractéristiques que vous ajoutez à chacune d'elles. Chaque type d'appareil possède un certain nombre de caractéristiques recommandées, mais vous pouvez ajouter celles de votre choix.
| Nom | Caractéristiques de l'appareil | Description | Types d'appareils recommandés |
| Luminosité | action.devices.traits.Brightness | Le réglage absolu de la luminosité est compris dans une plage normalisée comprise entre 0 et 100. Il est possible que les voyants individuels ne soient pas compatibles avec tous les points de couverture en fonction de leur configuration LED. | Guide clair |
| ColorSpectre | action.devices.traits.ColorSpectrum | Cela s'applique aux ampoules "complètes" qui utilisent des plages de couleurs RVB. Les ampoules peuvent combiner ColorSpectrum et ColorTemperature. Les ampoules d'accentuation et les bandes LED peuvent simplement intégrer le spectre, alors que certaines ampoules de lecture affichent simplement la température. Les ampoules de base (ou ampoules connectées) ne sont pas concernées. | Guide clair |
| Température de couleur | action.devices.traits.ColorTemperature | Cela s'applique aux ampoules "tièdes" qui prennent un point de couleur dans Kelvin. Il s'agit généralement d'une modalité distincte de celle de ColorSpectrum, et il est possible que des points blancs soient disponibles via Température. En fonction des caractéristiques disponibles, Google peut choisir le mode approprié à utiliser en fonction de la requête et du type d'éclairage (par exemple, Mettre les lumières du salon en blanc peut envoyer des commandes de température à certaines ampoules et des commandes spectre à des bandes LED). | Guide clair |
| Quai | action.devices.traits.Dock | Cette caractéristique est conçue pour les appareils mobiles qu'il est possible de commander pour le recharger. | Divers appareils |
| Activé | action.devices.traits.OnOff | La fonctionnalité de base d'activation et de désactivation de tout appareil sur lequel le binaire est activé et désactivé, y compris les prises et les interrupteurs, ainsi que de nombreux futurs appareils. | Guide clair |
| Démarrer | action.devices.traits.StartStop | 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. Contrairement aux appareils simplement dotés d'un état "allumé et éteint", certains appareils qui peuvent démarrer et s'arrêter peuvent également être suspendus pendant l'exécution de l'opération. | N'importe lequel : appareils et aspirateurs principalement, et autres comportements présentant une activité spécifique supérieure à la puissance |
| TempératureSetting | action.devices.traits.TemperatureSetting | Cette caractéristique aborde la gestion des modes et des points de température. | Guide du thermostat |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2023/12/02 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2023/12/02 (UTC)."],[[["\u003cp\u003eDevice functionality is determined by assigned traits.\u003c/p\u003e\n"],["\u003cp\u003eEach device type has suggested traits, but you can customize them.\u003c/p\u003e\n"],["\u003cp\u003eTraits control actions like brightness, color, on/off state, and temperature.\u003c/p\u003e\n"],["\u003cp\u003eSome traits are recommended for specific device types, like lights or thermostats.\u003c/p\u003e\n"]]],["Device functionality is defined by added traits. Available traits include `Brightness` (0-100 range), `ColorSpectrum` (RGB), and `ColorTemperature` (Kelvin). `Dock` is for self-mobile devices returning for charging. `OnOff` provides basic on/off, while `StartStop` allows starting, stopping, and pausing. `TemperatureSetting` handles temperature points and modes. Each trait has recommended device types, but any combination can be used.\n"],null,["# Device Traits\n\nThe functionality for device types comes from the traits that you add to each one.\nEach device type has a number of recommended traits, but you can add whichever ones you\nwant.\n\n| Name | Device Traits | Description | Recommended Device Types |\n|--------------------------------------------------------------------------|--------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|\n| [Brightness](/assistant/sdk/reference/traits/brightness) | `action.devices.traits.Brightness` | Absolute brightness setting is in a normalized range from 0 to 100 (individual lights may not support every point in the range based on their LED configuration). | [Light Guide](/assistant/smarthome/guides/light) |\n| [ColorSpectrum](/assistant/sdk/reference/traits/colorspectrum) | `action.devices.traits.ColorSpectrum` | This applies to \"full\" color bulbs that take RGB color ranges. Lights may have any combination of ColorSpectrum and [ColorTemperature](/assistant/sdk/reference/traits/colortemperature); accent lights and LED strips may just have Spectrum, whereas some reading bulbs just have Temperature. Basic bulbs, or dumb lights on smart plugs, have neither. | [Light Guide](/assistant/smarthome/guides/light) |\n| [ColorTemperature](/assistant/sdk/reference/traits/colortemperature) | `action.devices.traits.ColorTemperature` | This applies to \"warmth\" bulbs that take a color point in Kelvin. This is generally a separate modality from [ColorSpectrum](/assistant/sdk/reference/traits/colorspectrum), and there may be white points available via Temperature that cannot be reached by Spectrum. Based on available traits, Google may pick the appropriate mode to use based on request and light type (for example, *Make the living room lights white* might send Temperature commands to some bulbs and Spectrum commands to LED strips). | [Light Guide](/assistant/smarthome/guides/light) |\n| [Dock](/assistant/sdk/reference/traits/dock) | `action.devices.traits.Dock` | This trait is designed for self-mobile devices that can be commanded to return for charging. | Various appliances |\n| [OnOff](/assistant/sdk/reference/traits/onoff) | `action.devices.traits.OnOff` | The basic on and off functionality for any device that has binary on and off, including plugs and switches as well as many future devices. | [Light Guide](/assistant/smarthome/guides/light) |\n| [StartStop](/assistant/sdk/reference/traits/startstop) | `action.devices.traits.StartStop` | Starting and stopping a device serves a similar function to turning it on and off. Devices that inherit this trait function differently when turned on and when started. Unlike devices that simply have an on and off state, some devices that can start and stop are also able to pause while performing operation. | Any - mostly appliances and vacuums and other things that have specific activity behavior above and beyond power |\n| [TemperatureSetting](/assistant/sdk/reference/traits/temperaturesetting) | `action.devices.traits.TemperatureSetting` | This trait covers handling both temperature point and modes. | [Thermostat Guide](/assistant/smarthome/guides/thermostat) |"]]
