Главная / Аддоны / XiaoMusic
🎵 Музыкальный аддон

Руководство по XiaoMusic

Полное руководство по установке, настройке и использованию XiaoMusic - музыкального аддона для HomeAssistant с поддержкой умных колонок Xiaomi.

О XiaoMusic

Что такое XiaoMusic?

XiaoMusic - это мощный музыкальный аддон для HomeAssistant, предназначенный для интеграции умных колонок Xiaomi в вашу систему умного дома. С его помощью вы можете:

  • Воспроизводить музыку на умных колонках Xiaomi
  • Управлять воспроизведением через HomeAssistant
  • Создавать плейлисты и очереди воспроизведения
  • Интегрировать музыку в автоматизации
  • Использовать различные источники аудио
  • Управлять громкостью и другими параметрами

Основные возможности

🎵

Музыка

Воспроизведение аудиофайлов, потоковое вещание и поддержка различных форматов

🔊

Колонки Xiaomi

Полная поддержка умных колонок Xiaomi разных моделей

🎛️

Управление

Управление через интерфейс HomeAssistant и голосовые команды

🔄

Автоматизация

Интеграция с автоматизациями и сценариями HomeAssistant

📋

Плейлисты

Создание и управление плейлистами и очередями воспроизведения

🌐

Онлайн-сервисы

Поддержка онлайн-сервисов и стриминговых платформ

Установка XiaoMusic

⚠️ Перед установкой

Убедитесь, что у вас установлена последняя версия HomeAssistant и у вас есть права администратора для установки аддонов.

Способ 1: Установка через репозиторий

Самый простой способ установки XiaoMusic - через добавление репозитория аддонов.

  1. Откройте Home Assistant

    Перейдите в меню "Настройки" → "Аддоны" → "Магазин аддонов"

  2. Добавьте репозиторий

    Нажмите на меню (три точки) → "Аддоны" → "Добавить репозиторий"

  3. Введите URL репозитория

    Введите адрес репозитория XiaoMusic и нажмите "Добавить"

  4. Найдите XiaoMusic

    В списке аддонов найдите XiaoMusic и нажмите на него

  5. Установите аддон

    Нажмите кнопку "Установить" и дождитесь завершения установки

Способ 2: Ручная установка

Если вы предпочитаете ручную установку, следуйте этим инструкциям:

  1. Подключитесь по SSH

    Подключитесь к вашему HomeAssistant через SSH

  2. Перейдите в папку аддонов

    cd /usr/share/hassio/addons

  3. Скачайте XiaoMusic

    git clone https://github.com/your-repo/xiaomusic.git

  4. Перезагрузите HomeAssistant

    Перезапустите HomeAssistant для обнаружения нового аддона

Настройка XiaoMusic

Основная конфигурация

После установки необходимо настроить XiaoMusic для работы с вашими устройствами:

  • Учетные данные Xiaomi: Введите ваш логин и пароль от аккаунта Xiaomi
  • Выбор устройств: Выберите умные колонки, которые хотите использовать
  • Настройки звука: Настройте качество воспроизведения и громкость по умолчанию
  • Источники музыки: Добавьте пути к вашей музыкальной коллекции или онлайн-сервисы
  • Интеграция с HomeAssistant: Настройте сущности и автоматизации

Пример конфигурации

# configuration.yaml

xiaomusic:
  username: "your_xiaomi@email.com"
  password: "your_password"
  devices:
    - device_id: "xiaomi_speaker_1"
      name: "Гостиная"
    - device_id: "xiaomi_speaker_2"
      name: "Спальня"
  music_folder: "/media/music"
  default_volume: 50
  auto_start: true

Использование

🎮

Через интерфейс

Управляйте воспроизведением через интерфейс HomeAssistant - используйте карточки медиа-плеера для управления музыкой на каждой колонке.

🎤

Голосовые команды

Используйте голосовые ассистенты для управления музыкой: "Воспроизвести джаз в гостиной", "Пауза", "Следующий трек".

⚙️

Автоматизация

Создавайте автоматизации для воспроизведения музыки по расписанию или при определенных событиях в умном доме.

📱

Мобильное приложение

Управляйте музыкой через мобильное приложение HomeAssistant из любой точки мира.

Примеры автоматизаций

🌅 Будильник с музыкой

Автоматическое воспроизведение любимой музыки по утрам в определенное время 

automation:
  - alias: "Morning Music Alarm"
    trigger:
      - platform: time
        at: "07:00:00"
    action:
      - service: xiaomusic.play
        data:
          device_id: "xiaomi_speaker_1"
          playlist: "morning_jazz"
          volume: 30

🏠 Музыка при прибытии домой

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

automation:
  - alias: "Welcome Home Music"
    trigger:
      - platform: state
        entity_id: person.you
        to: "home"
    action:
      - service: xiaomusic.play
        data:
          device_id: "xiaomi_speaker_1"
          playlist: "relaxing"
          volume: 40

🎉 Музыка для вечеринок

Быстрое включение праздничного плейлиста одной кнопкой или голосовой командой 

automation:
  - alias: "Party Mode Music"
    trigger:
      - platform: state
        entity_id: input_boolean.party_mode
        to: "on"
    action:
      - service: xiaomusic.play
        data:
          device_id: "xiaomi_speaker_1"
          playlist: "party_mix"
          volume: 70
      - service: xiaomusic.play
        data:
          device_id: "xiaomi_speaker_2"
          playlist: "party_mix"
          volume: 70

Устранение проблем

❗ Распространенные проблемы

Проблема: XiaoMusic не обнаруживает колонки Xiaomi

Решение: Проверьте подключение к интернету, убедитесь, что колонки находятся в той же сети, и перезапустите аддон

Проблема: Музыка не воспроизводится

Решение: Проверьте формат аудиофайлов, убедитесь, что путь к музыкальной папке указан правильно, проверьте логи аддона

Проблема: Прерывистое воспроизведение

Решение: Проверьте качество сетевого подключения, попробуйте снизить качество воспроизведения

Проблема: Не работают голосовые команды

Решение: Убедитесь, что интеграция с голосовым ассистентом настроена правильно, проверьте синтаксис команд

Полезные советы

💡

Групповое воспроизведение

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

📊

Мониторинг звука

Используйте датчики уровня шума для автоматической регулировки громкости в зависимости от времени суток.

🎯

Сценарии

Создавайте сценарии для разных ситуаций: утро, работа, отдых, вечеринка, сон.

🔄

Обновление

Регулярно обновляйте XiaoMusic для получения новых функций и исправлений ошибок.

Поддержка и ресурсы

Нужна помощь?

Если у вас возникли вопросы или проблемы при использовании XiaoMusic, вы можете обратиться за помощью:

  • 📚 Документация: Изучите официальную документацию XiaoMusic
  • 💬 Форум: Задайте вопросы на форуме сообщества HomeAssistant
  • 🐛 Bug reports: Сообщайте о найденных ошибках в репозитории проекта
  • 💡 Telegram чат: Присоединяйтесь к чату Home Assistant для общения с другими пользователями