Локальная интеграция по HTTP

Сервис Seemetrix поддерживает интеграцию с другими программами посредством локального HTTP API. Seemetrix-клиент принимает запросы на порту 8081.

После отправки запроса возвращается один из перечисленных кодов:

  • “200 ОК” - запрос успешно выполнен;
  • “400 Bad Request” - допущена ошибка в аргументах запроса;
  • “404 Not Found” - запрос не найден;
  • “500 Server Error” - внутренняя ошибка.

Получение данных о людях, находящихся перед камерой

Сервис Seemetrix предоставляет возможность получения данных о людях, находящихся перед камерой, в форматах JSON и XML посредством HTTP-запроса на устройство.

JSON

Сервис Seemetrix предоставляет возможность получения данных о людях, находящихся перед камерой, в формате JSON посредством HTTP-запроса http://localhost:8081/getPersons?format=json на устройство. В режиме реального времени отображаются сведения по каждому текущему просмотру:

  • age - возраст (kids, young adult, adult, senior);
  • attentive - параметр, показывающий, смотрит ли человек на экран (в камеру) (true/false);
  • duration - время просмотра (в мс);
  • emotion - преобладающая во время просмотра эмоция (happy, angry, surprise, neutral);
  • gender - пол (male, female);
  • id - идентификатор просмотра;
  • face - размер лица и его положение в кадре в относительных и абсолютных величинах.

Формат результата:

{
    "persons": [
        {
            "age": "young",
            "attentive": true,
            "duration": 4545,
            "emotion": "neutral",
            "face": {
                "absolute": {
                    "size": 140,
                    "x": 275,
                    "y": 259
                },
                "relative": {
                    "size": 0.291666,
                    "x": 0.430352,
                    "y": 0.54112
                }
            },
            "gender": "male",
            "id": 37
        }
    ]
}

XML

Сервис Seemetrix предоставляет возможность получения данных о людях (общее количество, количество мужчин/женщин/детей, молодых, среднего возраста и пожилых, а также уточненные данные), стоящих перед камерой, в формате XML посредством HTTP GET-запроса на устройство.

Например:http://localhost:8081/

Формат результата следующий:

<result>
    //Информация о людях, присутствующих перед камерой
    //сейчас все значения 0, данный блок не используется
    <presence>
        <audienceSize>0</audienceSize>
        <gender>
            <males>0</males>
            <females>0</females>
            <unknown>0</unknown>
        </gender>
        <ageGroup>
            <children>0</children>
            <adults>0</adults>
            <seniors>0</seniors>
        </ageGroup>
        <detailed>
            <males>
                <children>0</children>
                <adults>0</adults>
                <seniors>0</seniors>
            </males>
            <females>
                <children>0</children>
                <adults>0</adults>
                <seniors>0</seniors>
            </females>
        </detailed>
    </presence>
    //Информация о людях, смотрящих в камеру
    <viewers>
        //Общее количество зрителей
        <audienceSize>1</audienceSize>
        //Распределение по полу
        <gender>
            //Сейчас присутствует мужчин - 1
            <males>1</males>
            //Сейчас присутствует женщин - 0
            <females>0</females>
            //Неопределенных - 0
            <unknown>0</unknown>
        </gender>
        //Возрастное распределение зрителей
        <ageGroup>
            //Детей - 0
            <children>0</children>
            //Молодых - 1
            <youngs>1</youngs>
            //Взрослых - 0
            <adults>0</adults>
            //Пожилых - 0
            <seniors>0</seniors>
        </ageGroup>
        //Детальная информация о присутствующих
        <detailed>
            //Среди мужчин
            <males>
                //Детей - 0
                <children>0</children>
                //Молодых - 1
                <youngs>1</youngs>
                //Взрослых - 0
                <adults>0</adults>
                //Пожилых - 0
                <seniors>0</seniors>
            </males>
            //Среди женщин
            <females>
                //Детей - 0
                <children>0</children>
                //Молодых - 0
                <youngs>0</youngs>
                //Взрослых - 0
                <adults>0</adults>
                //Пожилых - 0
                <seniors>0</seniors>
            </females>
        </detailed>
    </viewers>
</result>

Привязка статистики к медиа-контенту

Сервис Seemetrix позволяет ассоциировать статистику с медиа-контентом, который в данный момент проигрывается на экране. Для этого необходимо отправить клиентскому приложению HTTP-запросы о начале и окончании проигрывания медиаролика. Просмотры, которые будут собраны в момент проигрывания медиаролика, будут отображаться на вкладке media в разделе “Аналитика”.

Для идентификации медиаролика используется его имя, которое будет отображаться в личном кабинете.

Доступны следующие запросы:

  • startMedia

Запускает медиаролик с заданным именем. Параметры: name - имя медиаролика (строка в urlencoded). Пример: http://localhost:8081/startMedia?name=media1.

Также возможно задать продолжительность воспроизведения медиаролика с помощью параметра duration (опционально) - требуется указать продолжительность в секундах (целое число). Пример: http://localhost:8081/startMedia?name=media1&duration=60

Несколько медиароликов могут проигрываться одновременно.

  • stopMedia

Останавливает медиаролик с заданным именем. Параметры: name - имя медиаролика (строка в urlencoded). Пример: http://localhost:8081/stopMedia?name=media1.

В случае, если имя медиаролика не было указано, будут остановлены все медиаролики. Пример: http://localhost:8081/stopMedia