Govee (независимый издатель) (предварительная версия)

Интеграция смарт-устройств Govee с приложениями с API разработчика Govee. Управление светом, изменение цветов, настройка яркости и настройка таймеров. Доступ к состоянию устройства в режиме реального времени для расширенной разработки приложений.

Этот соединитель доступен в следующих продуктах и регионах:

Govee

Обеспечивает простую интеграцию с интеллектуальными системами освещения Govee , что позволяет пользователям легко управлять устройствами и управлять ими. Он позволяет использовать широкий спектр функций, включая настройку параметров света, изменение цветов, изменение яркости и доступ к состоянию устройства в режиме реального времени.

Возможность автоматизировать и настраивать настройки освещения делает этот соединитель особенно полезным для повышения атмосферы в умных домах, создания динамических сцен освещения для различных случаев и интеграции интеллектуального освещения в более широкие системы автоматизации дома. Он предлагает удобный и интуитивно понятный способ персонализации взаимодействия с освещением и полностью использовать возможности интеллектуальной технологии освещения Govee.

Издатель: Ричард Уилсон

Предпосылки

Прежде чем использовать соединитель Govee, необходимо получить ключ API разработчика Govee. Выполните следующие действия, чтобы получить ключ:

Получение ключа API разработчика Govee

1. Скачайте домашнее приложение Govee:

   • Для iOS: Govee Home в App Store
   • Для Android: Govee Home на Google Play

2. Доступ к вашему профилю:

   • Откройте домашнее приложение Govee и перейдите на страницу "Мой профиль", нажав значок профиля (👤).

3. Перейдите к параметрам:

   • Щелкните значок параметров (⚙️), расположенный в правом верхнем углу, чтобы получить доступ к меню "Параметры".

4. Применить к ключу API:

   • В меню "Параметры" выберите "Применить к ключу API".

5. Полный формат приложения:

   • Заполните обязательные поля для имени и "Причина для приложения".
     • Примеры причин включают домашнюю автоматизацию, интеграцию сторонних производителей или учебные цели.

6. Примите условия обслуживания:

   • Внимательно ознакомьтесь с условиями обслуживания API разработчика Govee. После понимания условий установите флажок, чтобы указать ваше принятие.

7. Отправка приложения:

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

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

Поддерживаемые операции

1. Выполнение команды на устройстве

Эта операция позволяет отправлять различные команды для управления устройством Govee.

• Входные свойства:
  • MAC-адрес устройства: Уникальный MAC-адрес устройства Govee для управления.
  • Модель устройства: Номер модели устройства Govee.
  • Сведения о команде: Объект, содержащий команду, выполняемую. Он включает в себя:
    • Имя: Имя команды (например, "turn", "яркость", "цвет", "colorTem").
  • Дополнительные параметры (на основе команды):
    • Включение или отключение: (необязательно) — используется при выполнении команды "включить".
    • Яркость: (необязательно) Числовое значение (0–100) — используется, когда команда имеет значение "яркость".
    • Цвет: (необязательно) Объект с "r", "g", "b" значениями, используемыми при команде "цвет".
    • Цветовая температура: (необязательно) Числовое значение для цветовой температуры, используемое при выполнении команды colorTem.

2. Получение сведений об устройстве

Получение сведений о конкретном устройстве Govee или всех устройствах, связанных с вашей учетной записью.

• Входные свойства:
  • MAC-адрес устройства: (необязательно) MAC-адрес конкретного устройства Govee, для которого запрашиваются сведения. Если опущено, возвращается информация для всех устройств.
  • Модель устройства: (необязательно) Модель устройства Govee. Если он указан вместе с MAC-адресом, он обновляет запрос к конкретному устройству.

Документация по API

Подробные сведения об API Разработчика Govee Lights, включая его возможности, конечные точки, параметры и ответы, см. в официальной документации по API Govee. В документации приведены полные рекомендации и примеры, которые помогут эффективно интегрировать и использовать API в приложениях и рабочих процессах.

Известные проблемы и ограничения

В настоящее время известные проблемы или ограничения не существуют. Всегда обратитесь к этому разделу для получения обновленных сведений.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Ограничения регулирования

Действия

Выполнение команды на устройстве

Получение сведений об устройстве