Перейти к основному содержимому
Подсказка

Навык iRidium для Google Home

голосовое управление оборудованием через Google Home и iRidium

документация обновлена 01.01.2024


Google Assistent - голосовой ассистент от Google, встроенный в колонку голосового управления Google Home, а также другие устройства типа:

  • Google Home Mini;
  • Google Home Max;
  • Harman JBL Link 10;
  • Harman JBL Link 20;
  • Harman JBL Link 300;
  • Harman JBL Link 500;
  • и другие.

С помощью навыка "iRidium" Google Assistant может управлять умным домом через iRidium cloud и сервер iRidium. Вы можете произнести команду "Включи свет" и лампочка загорится. Произнесите "Выключи свет" и лампочка погаснет. Всё просто!

GHome_scheme11.png


Поддерживаемые устройства:

  • диммеры и выключатели;
  • дверные замки;
  • развлекательные устройства, например, smart-телевизоры;
  • умные домашние камеры;
  • термостаты и вентиляторы;
  • микроволновки;
  • и многое другое.

Работа в iRidium Pro

Добавление драйвера и устройств

  1. Создайте серверный проект;

  1. Добавьте драйвер Google Home Network в проект;

GoogleHome1.png


  1. Добавьте умные устройства;

GoogleHome2.png


  1. Переименуйте устройства, для удобного управления ими.

Переименовывать обратные связи устройств нельзя, так как они несут строго определенный смысл.

GoogleHome3.png


Описание устройств и обратных связей

Устройства Google Home - это не реальные устройства, а только лишь интерфейс между реальными устройствами и ассистентом. Вы должны реализовать функционал этих устройств в iRidium server или обеспечить связи с соответствующими физическими устройствами по тому или иному протоколу. iRidium предоставляет интерфейс с тремя типами устройств:

  • Switch
  • Dimmer
  • HVAC

Однако это не ограничивает вас в возможностях работы с другими устройствами. Например, вы можете реализовать управление реле, используя бинарное устройство типа Switch.

Вам необязательно использовать все обратные связи устройств, используйте только те, которые вам нужны.

Switch

Примеры применения:

  • выключатель;
  • свет;
  • реле.
PowerСостояние вкл/отклturnOn
turnOff
"OK, Google, turn on device name"
"OK, Google, turn off device name"

Curtain

Примеры применения:

  • шторы и жалюзи с электроприводом.
Open PercentПроцент открытияOpen
Close
setPercentage
"OK, Google, open the device name",
"OK, Google, close the device name",
"OK, Google, open the device name to 10%"
Open DirectionНаправление открытияsetDirection:
LEFT,
RIGHT,
UP,
DOWN,
IN,
OUT
"OK, Google, open the device name left",
"OK, Google, open the device name right",
"OK, Google, open the device name up",
"OK, Google, open the device name down".

Dimmer

Примеры применения:

  • одноканальный диммер;
  • электрический теплый пол.
PowerСостояние вкл/отклturnOn
turnOff
"OK, Google, turn on device name"
"OK, Google, turn off device name"
LevelПроцентsetPercentage
incrementPercentage
decrementPercentage
"OK, Google, set device name to hundred percents"
"OK, Google, increase device name by five percents"
"OK, Google, decrease device name by two percents"

HVAC

Примеры применения: * термостат; * кондиционер; * вентилятор; * электрический теплый пол.

PowerСостояние вкл/отклturnOn
turnOff
"OK, Google, turn on device name"
"OK, Google, turn off device name"
LevelЗадание в процентахsetPercentage
incrementPercentage
decrementPercentage
"OK, Google, set device name to fifty percent"
"OK, Google, increase device name by five percents"
"OK, Google, decrease device name by two percents"
TargetTemperatureЗаданная температура в градусахsetTargetTemperature
incrementTargetTemperature
decrementTargetTemperature
getTargetTemperature
"OK, Google, set device name to thirty degrees"
"OK, Google, increase device name by five degrees"
"OK, Google, reduce device name by two degrees"
"OK, Google, make it warmer in here"
"OK, Google, make it cooler in here"
"OK, Google, what is device name target temperature?"
SensorTemperatureТемпература с датчикаgetTemperatureReading
getTargetTemperature
"OK, Google, what device name temperature?"
CoolTargetTemperaturerowspan="2"Верхняя уставка температурыgetTemperatureReading
getTargetTemperature
"OK, Google, what temperature is my device name set to?"
HeatTargetTemperatureНижняя уставка температуры
TemperatureModeРежим работыThermostatModeOK, Google, setdevice nameheating

TemperatureMode может принимать следующие значения: *IR.SUB_DEVICE_STATE_CLIMATE_TEMP_MODE_AUTO; *IR.SUB_DEVICE_STATE_CLIMATE_TEMP_MODE_COOLING, *IR.SUB_DEVICE_STATE_CLIMATE_TEMP_MODE_DRY, *IR.SUB_DEVICE_STATE_CLIMATE_TEMP_MODE_FAN, *IR.SUB_DEVICE_STATE_CLIMATE_TEMP_MODE_HEATING, *IR.SUB_DEVICE_STATE_CLIMATE_TEMP_MODE_OFF.

Используйте эти константы, чтобы назначать режим работы термостата с помощью скрипта.

Создание скрипта

Скрипт обеспечивает прием голосовых команд от Ассистента и перенаправляет их на реальные устройства. В данном примере это устройства в сети Modbus TCP.

  1. Перейдите в редактор скрипта, нажав кнопку JS .

  2. Нажмите + , затем выберите New Script .

  3. Добавьте следующий скрипт.


var Google = IR.GetDevice("Google Home Network");
var Modbus = IR.GetDevice("Modbus TCP");
IR.AddListener(IR.EVENT_START,0,function() {
Google.SetFeedback("Thermostat:TemperatureMode", IR.SUB_DEVICE_STATE_CLIMATE_TEMP_MODE_COOLING);
Google.SetFeedback("Thermostat:HeatTargetTemperature", 30);
Google.SetFeedback("Thermostat:CoolTargetTemperature", 28);
Google.SetFeedback("Thermostat:SensorTemperature", 24);
IR.AddListener(IR.EVENT_TAG_CHANGE, Google, function(name, value) {
switch (name) {
case "Switch:Power":
Modbus.Set("Light", value);
break;
case "Dimmer:Power":
Modbus.Set("Dimmer_ON", value);
break;
case "Dimmer:Level":
Modbus.Set("Dimmer_Brightness", value);
break;
}
IR.Log("GOOGLE! Device tag: " + name + " , value: " + value);
});
});

Загрузка проекта в iRidium Cloud и на сервер.

  1. Авторизируйтесь на сайте iRidium.

  2. Загрузите файл проекта .sirpz в облако iRidium cloud.

add_project.png


  1. Запустите iRidium server.

  1. Зайдите в веб-интерфейс сервера, набрав в адресной строке браузера:

:8888


(Если iRidium server запускается на том же компьютере, на котором он настраивается, то наберите:
127.0.0.1:8888)


  1. Наберите пароль доступа по умолчанию 2007. Нажмите кнопку "LOGIN".

Login_server.png


  1. Найдите вкладку Cloud / Projects .

cloud_projects.png


  1. Загрузите проект из облака на сервер, нажав кнопку "CLOUD SYNC" и затем "Download" напротив нужного проекта.

cloud_sync.png


Ассистент работает только через iRidium cloud, поэтому он не сможет работать, если проект будет загружен на сервер через iRidium transfer.

Настройка Google Home

Регистрация умной колонки

Google Home настраивается с помощью приложения Google Home App на смартфонах или планшетах.



В любом случае потребуется наличие Wi-Fi на устройстве для прямого соединения с умной колонкой.



  1. Зарегистрируйтесь на сайте Google, если у вас ещё нет учётной записи.

  1. На мобильном устройстве скачайте и установите приложения Google Home App и Google Assistant App .

  1. Приложение автоматически просканирует сеть и определит доступное устройство.


Операционные системы, на которых Google Home App может работать:

  • Android 6.0 и выше;
  • iOS 10 и выше.

Убедитесь, что в Вашем регионе приложения Google Home App и Google Assistant App доступны для скачивания из Google Play и App Store.

barsik_in_gass.png


Установка навыка

Навык устанавливается только в приложении Google Assistant App .


  1. Запустите приложение. В правом верхнем углу нажмите кнопку обзора.

GAss_main1.png


  1. В правом верхнем углу нажмите кнопку меню.

GAss_menu1.png


  1. В нем выберите пункт “Настройки”.

GAss_settings.png


  1. В настройках ассистента выберите параметр “Автоматизация дома”.

GAss_home_control.png


  1. В появившемся окне нажмите на кнопку добавления устройств.

GAss_add_device.png


  1. Выберите из списка “i3 Control”.

GAss_add_i3control.png


  1. Вы попадете на форму регистрации на сайте iRidium mobile. Введите данные своей учётной записи интегратора и нажмите Login .

Sign_in_iRidium.png


  1. В выпадающем списке выберите объект, с которым будет работать Google Home. Нажмите Grant Access .

Grant_access.png


  1. Google Assistant успешно подключился к объекту iRidium. Теперь в Google Assistant появятся все устройства из проекта.

GAss_added_devices.png


Их можно можно распределить по комнатам.

Device_details.png

GAss_Rooms.png

Устройства теперь также доступны в приложении Google Home и их можно использовать.

GHome_main.png

GHome_main01.png

Если вы скорректируете проект, то не забудьте загрузить его в iRidium cloud, затем обновите его в iRidium server.

Тестирование проекта

Проект для сервера можно запустить на том же компьютере, на котором производится работа в iRidium studio. Но проект следует загружать только через iRidium cloud.

Произносите голосовые команды в колонку Google Home и ассистент передаст команды в iRidium server, и тот, в свою очередь, исполнит команды согласно скрипту.