تم إيقاف إجراءات المحادثات نهائيًا في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على
إنهاء إجراءات المحادثة.
سمات الجهاز
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تأتي وظائف أنواع الأجهزة من السمات التي تضيفها إلى كلٍّ منها.
يتضمن كل نوع جهاز عددًا من السمات المقترَحة، ولكن يمكنك إضافة السمات التي تريدها.
| الاسم |
سمات الجهاز |
الوصف |
أنواع الأجهزة المقترَحة |
| السطوع |
action.devices.traits.Brightness |
يتراوح نطاق مستوى السطوع المطلق بين 0 و100 (قد لا تتيح الأضواء الفردية كل نقطة في النطاق بناءً على إعدادات ضوء LED). |
دليل الإضاءة |
| ColorSpectrum |
action.devices.traits.ColorSpectrum |
وينطبق ذلك على المصابيح "الكاملة" التي تستخدم نطاقات ألوان RGB. يمكن أن تحتوي الأضواء على أي خيار مع ColorSpectrum وColorTemperature، فمصابيح الإضاءة وأشرطة LED قد تحتوي فقط على Spectrum،
أمّا بعض مصابيح القراءة فتحتوي على درجة الحرارة فقط. ولا يتوفّر أي من المصابيح الأساسية أو المصابيح الغبيقة على المقابس الذكية. |
دليل الإضاءة |
| درجة الحرارة بالألوان |
action.devices.traits.ColorTemperature |
وينطبق هذا على مصابيح "الدفء" التي تلتقط نقطة لون في "كيلفين". وتكون هذه العلامة منفصلة بشكل عام عن ColorSpectrum،
وقد تتوفّر نقاط بيضاء عبر درجة الحرارة لا يمكن الوصول إليها من خلال Spectrum. استنادًا إلى
السمات المتاحة، قد تختار Google الوضع المناسب لاستخدامه بناءً على الطلب ونوع الإضاءة
(على سبيل المثال، قد ترسل مصابيح الإضاءة في غرفة المعيشة باللون الأبيض طلبات إلى درجة حرارة لبعض المصابيح
وأوامر Spectrum إلى أشرطة 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. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2023-12-02 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2023-12-02 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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) |"]]
