대화형 작업이 2023년 6월 13일에 지원 중단되었습니다. 자세한 내용은
대화 작업 지원 중단을 참고하세요.
기기 특성
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
기기 유형의 기능은 각 속성에 추가하는 특성에서 비롯됩니다.
각 기기 유형에는 권장되는 여러 특성이 있지만 원하는 속성을 추가할 수 있습니다.
| 이름 |
기기 특성 |
설명 |
권장 기기 유형 |
| 밝기 |
action.devices.traits.Brightness |
절대 밝기 설정은 0에서 100까지 정규화된 범위입니다. 개별 조명은 LED 구성에 따라 범위의 모든 포인트를 지원하지 않을 수 있습니다. |
조명 가이드 |
| ColorSpectrum |
action.devices.traits.ColorSpectrum |
이는 RGB 색상 범위를 취하는 '전체' 색상 전구에 적용됩니다. 조명에는 ColorSpectrum과 ColorTemperature의 조합을 사용할 수 있습니다. 강조 조명과 LED 스트립에는 Spectrum만 있을 수 있지만 독서 전구에는 온도만 있습니다. 스마트 전구의 기본 전구나 바보등은 둘 다 없습니다. |
조명 가이드 |
| 색상 온도 |
action.devices.traits.ColorTemperature |
이는 켈빈의 색상 포인트를 사용하는 '따뜻한' 전구에 적용됩니다. 이는 일반적으로 ColorSpectrum과는 다른 모달리티이며, 스펙트럼으로는 연결할 수 없는 화이트온을 온도를 통해 사용할 수 있습니다. Google에서는 사용 가능한 특성에 따라 요청 및 조명 유형에 따라 사용하기에 적합한 모드를 선택할 수 있습니다. 예를 들어 거실 조명을 흰색으로 설정하면 일부 전구에 온도 명령어를 전송하고, 스펙트럼 명령어를 LED 스트립으로 전송할 수 있습니다. |
조명 가이드 |
| 도크 |
action.devices.traits.Dock |
이 특성은 충전을 위해 반환하라고 명령할 수 있는 셀프 휴대기기용으로 설계되었습니다. |
다양한 가전제품 |
| 사용 안함 |
action.devices.traits.OnOff |
플러그와 스위치, 미래의 여러 기기를 비롯하여 바이너리가 사용 설정 및 사용 중지된 모든 기기의 기본 사용 설정 및 사용 중지 기능이 있습니다. |
조명 가이드 |
| 시작 중지 |
action.devices.traits.StartStop |
기기를 시작하고 중지하는 것은 기기를 켜거나 끄는 것과 비슷한 기능을 제공합니다. 이 특성 함수를 상속하는 기기는 사용 설정 시와 시작 시 다르게 작동합니다. 켜기 및 끄기만 있는 기기와 달리 시작 및 중지가 가능한 일부 기기도 작업을 실행하는 동안 일시중지할 수 있습니다. |
모두 - 가전제품, 진공청소기 등, 전력을 초과하는 특정 활동 동작이 있는 기타 제품 |
| 온도 설정 |
action.devices.traits.TemperatureSetting |
이 특성은 온도 포인트와 모드를 모두 처리하는 방법을 다룹니다. |
온도 조절기 가이드 |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2023-12-02(UTC)
[null,null,["최종 업데이트: 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) |"]]
