Управление окружением в переговорной

Через Толк-киоск можно управлять его окружением. Например, интегрировать киоск с устройствами, расположенными в переговорной. А с помощью внешнего API, к которому подключены устройства, регулировать уровень освещения или температуру.

Чтобы управление было возможно, на вашей стороне должен быть настроен сервис API с подключенными к нему устройствами.

Как управлять окружением

1. На планшете-контроллере нажмите на значок  .

   

2. Откроется окно с параметрами устройств в виде шкалы значений. Измените параметры нужного устройства, передвигая ползунок по шкале.

   

Подключение и настройка

Для каждого устройства нужно настроить методы API. С помощью них устройство получает и передает значения во внешний ресурс. Обработку запросов от устройств необходимо организовать на вашей стороне (например, через внешний сервис API с подключенными к нему устройствами). 

Запросы API к серверу выполняются от каждого планшета-контроллера, т. е. из внутренней сети организации. Поэтому на стороне внешнего сервиса должны быть выполнены настройки:

• На сервере, к которому обращаются умные устройства, установлены валидные сертификаты. Они должны иметь доверенные корневые сертификаты из списка центра сертификации. Например, Let’s Encrypt.
• На сервере должны быть разрешены CORS-политики до собственного домена пространства Толк (пример домена xxxxx.ktalk.ru).

Чтобы настроить управление окружением с киоска:

Настройка доступна только пользователям с ролями «Администратор пространства» или «Администратор переговорных».

1. На главной странице Толка нажмите на значок .

   

2. Выберите киоск из списка.

3. Перейдите в раздел «Управление окружением» и нажмите «Добавить» → «Слайдер».

   

    

4. Укажите параметры устройства:

   • «Название». Оно будет отображаться в настройках и на планшете-контроллере в переговорной.

   • «Показать на киоске»: включите, если нужно отображать устройство на планшете киоска. 

   • «Управляется с киоска»: включите, если нужно разрешить управлять устройством с планшета киоска.

     

      

5. Укажите параметры слайдера: единицы измерения, максимальное и минимальное значение параметров устройства и их названия, шаг для изменения значения и частоту обновления.

   

    

6. Укажите параметры получения и отправки данных. Это методы, по которым устройство будет обращаться к внешнему API.

   • URL: URL до экшена (action) внешнего API. Примеры:
     
     https://api.testclient.net/public/domain/get

https://api.testclient.net/public/domain/post
      

   • «Заголовки запроса»: набор строк, который будет подставляться в заголовок запроса. Запись в формате JSON-объекта. Здесь же можно указать ключ авторизации в вашем сервисе API.
     
     { "kiosk":1, "value":"$value" }
      

   • «Шаблон ответа»: JSON-объект, который является шаблоном ответа на запрос значения. Место для значения помечается как $value . Пример:
     
     { "someObject": { "someFiled": "$value" }}
      

   • «Шаблон запроса»: JSON-объект, который является шаблоном запроса на отправку значения. Место для значения помечается как $value  . Пример:
     
     { "someObject": { "someFiled": "$value" }}
      

     

      

7. Нажмите «Сохранить и проверить». Сервис проверит, корректно ли заполнены значения:

   • Если поля заполнены корректно и API-запрос выполнен успешно — настройки сохранятся. Устройство отобразится на планшете-контроллере (если выбран параметр «Показать на киоске»).

   • Если поля заполнены некорректно, сервис подскажет, какие поля нужно отредактировать. Настройки не будут сохранены.

   • Если API-запрос будет завершен с ошибкой, сервис сообщит об этом и покажет текст ответа API. При этом настройки сохранятся. Устройство отобразится на планшете киоска (если выбран параметр «Показать на киоске»), но может работать с ошибками.

     

      

Чтобы удалить устройство, перейдите на вкладку «Управление окружением» и нажмите на значок  рядом с устройством.

Возможные проблемы при работе с устройствами

Бесконечная загрузка устройства

 

 

Возможные причины:

• На вашей стороне не настроены CORS-политики. На сервере настройте разрешение CORS до собственного домена пространства Толк (пример домена xxxxx.ktalk.ru).
• Ваш API-сервис долгое время не отвечает. Проверьте его работоспособность.