دليل أجهزة التبريد المنزلية الذكية
action.devices.types.AIRCOOLER - مبرّدات الهواء هي أجهزة تتيح التبريد والتحكّم في الرطوبة. تكون هذه الأجهزة عادةً خفيفة الوزن وقابلة للحمل بشكل أكبر من أجهزة تكييف الهواء، وتحتوي على خزان مياه متصل بها. قد لا تتيح مبردات الهواء إمكانية التدفئة أو ضبط درجات حرارة دقيقة. قد تشمل التفاعلات مع مبرّدات الهواء تغيير سرعة المروحة وإعدادات الرطوبة.
يشير هذا النوع إلى ظهور رمز "مبرّد الهواء" على الجهاز وبعض العناصر ذات الصلة المرادفات والأسماء المستعارة.
إمكانيات الجهاز
راجع وثائق السمات المقابلة تفاصيل التنفيذ، مثل السمات والحالات التي يجب أن تتيحها خدمتك، وكيفية إنشاء ردود EXECUTE وQUERY.
السمات المطلوبة
هذه السمات والأوامر مطلوبة، إذا كانت منطبقة على
الخاص بك. إذا لم يكن جهازك يتيح هذه السمات، أدخِل رمز الخطأ
functionNotSupported في استجابة QUERY أو EXECUTE. عرض
الأخطاء والاستثناءات لمزيد من المعلومات.
-
action.devices.traits.FanSpeed -
action.devices.traits.HumiditySetting -
action.devices.traits.OnOff -
action.devices.traits.TemperatureSetting
متطلبات الجودة
- وقت الاستجابة: يجب أن يكون أقل من أو يساوي 1000 ملي ثانية.
- الموثوقية: يجب أن تكون أكبر من أو تساوي 97%.
مثال على جهاز: مبرّد هواء بسيط
يحتوي هذا القسم على مثال على حمولات النية بالشراء التي تمثّل "مبرّد هواء" شائعًا بناءً على نوع الجهاز والسمات المذكورة أعلاه. إذا قمتَ بإضافة أو إزالة سمات في التنفيذ، عليك تعديل ردودك وفقًا لذلك لتعكس هذه التغييرات.
نموذج رد المزامنة
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.AIRCOOLER",
"traits": [
"action.devices.traits.FanSpeed",
"action.devices.traits.HumiditySetting",
"action.devices.traits.OnOff",
"action.devices.traits.TemperatureSetting"
],
"name": {
"name": "Simple air cooler"
},
"willReportState": true,
"attributes": {
"humiditySetpointRange": {
"minPercent": 0,
"maxPercent": 50
},
"availableFanSpeeds": {
"speeds": [
{
"speed_name": "off_key",
"speed_values": [
{
"speed_synonym": [
"Off",
"0"
],
"lang": "en"
}
]
},
{
"speed_name": "low_key",
"speed_values": [
{
"speed_synonym": [
"Low",
"1"
],
"lang": "en"
}
]
},
{
"speed_name": "medium_key",
"speed_values": [
{
"speed_synonym": [
"Medium",
"2"
],
"lang": "en"
}
]
},
{
"speed_name": "high_key",
"speed_values": [
{
"speed_synonym": [
"High",
"3"
],
"lang": "en"
}
]
}
],
"ordered": true
},
"availableThermostatModes": [
"off",
"cool",
"on",
"fan-only",
"eco"
],
"thermostatTemperatureUnit": "C"
},
"deviceInfo": {
"manufacturer": "smart-home-inc",
"model": "hs1234",
"hwVersion": "3.2",
"swVersion": "11.4"
}
}
]
}
}
نموذج رد QUERY
{
"requestId": "6894439706274654514",
"inputs": [
{
"intent": "action.devices.QUERY",
"payload": {
"devices": [
{
"id": "123"
}
]
}
}
]
}
{
"requestId": "6894439706274654514",
"payload": {
"devices": {
"123": {
"status": "SUCCESS",
"online": true,
"on": true,
"currentFanSpeedSetting": "low_key",
"thermostatMode": "cool",
"thermostatTemperatureAmbient": 25,
"thermostatTemperatureSetpoint": 20,
"humiditySetpointPercent": 15,
"humidityAmbientPercent": 10
}
}
}
}
نماذج أوامر التنفيذ
SetFanSpeed
للحصول على تفاصيل إضافية حول معاملات الأوامر،
عرض
action.devices.traits.FanSpeed
المرجع.
{
"requestId": "6894439706274654518",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.SetFanSpeed",
"params": {
"fanSpeed": "high_key"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654518",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentFanSpeedSetting": "high_key"
}
}
]
}
}
SetHumidity
للحصول على تفاصيل إضافية حول معاملات الأوامر،
عرض
action.devices.traits.HumiditySetting
المرجع.
{
"requestId": "6894439706274654520",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.SetHumidity",
"params": {
"humidity": 20
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654520",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"humiditySetpointPercent": 20,
"humidityAmbientPercent": 10
}
}
]
}
}
OnOff
للحصول على تفاصيل إضافية حول معاملات الأوامر،
عرض
action.devices.traits.OnOff
المرجع.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OnOff",
"params": {
"on": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"on": true
}
}
]
}
}
ThermostatTemperatureSetpoint
للحصول على تفاصيل إضافية حول معاملات الأوامر،
عرض
action.devices.traits.TemperatureSetting
المرجع.
{
"requestId": "6894439706274654522",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.ThermostatTemperatureSetpoint",
"params": {
"thermostatTemperatureSetpoint": 22
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654522",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"thermostatMode": "cool",
"thermostatTemperatureSetpoint": 22,
"thermostatTemperatureAmbient": 25.1
}
}
]
}
}
ThermostatSetMode
للحصول على تفاصيل إضافية حول معاملات الأوامر،
عرض
action.devices.traits.TemperatureSetting
المرجع.
{
"requestId": "6894439706274654524",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.ThermostatSetMode",
"params": {
"thermostatMode": "cool"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654524",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"thermostatMode": "cool",
"thermostatTemperatureSetpoint": 22,
"thermostatTemperatureAmbient": 25.1
}
}
]
}
}