Модифицированный Mi Home с переводом действий, условий и статусов (русский и английский языки)

Понемногу автоматизируя свой быт с помощью компонентов умного дома от Xiaomi/Mijia/Aqara, мне изрядно поднадоело при написании сценариев каждый раз по скриншотам переводить с китайского условия и действия. Конечно, со временем их расположение (да и значение некоторых иероглифов) запоминается, но ведь "это же не наш метод" :)

NOTA BENE

Mi Home более не используется в моей домашней автоматизации, что естественным образом сказалось на моей заинтересованности в данном проекте. Парадигма его развития (а точнее - актуализации) на данный момент такова:

• переводом и адаптацией плагинов я не занимаюсь;
• обновления будут собираться преимущественно на стабильных релизах;
• новые версии будут проверяться только на возможность установки, проверка функционирования полностью остаётся за пользователями;
• комментарии, обсуждения, предложения и прочее - всё происходит в телеграм-группе.

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

* * * * *

19/01/20

• Добавлена возможность принудительного направления определённых API-запросов в китайское облако, что может решить проблемы (или создать новые) с работой плагинов некоторых устройств в "чужом" регионе: монитор растений, зубные щётки, тонометр, автомобильный очиститель воздуха. Активируется с помощью внешнего конфигурационного файла "plugins.json", по умолчанию параметр выключен. Подробности уточняйте в группе Telegram;
• Отключены малополезные баннеры с информацией о рекомендуемых сценариях внутри плагинов. Информацию о качестве сигнала пока оставил, но скорее всего тоже отключу в следующем релизе;
• Экспериментально добавлена поддержка умной розетки Aqara (lumi.plug.maeu01). Работает только с шлюзом Aqara, и только в регионе, отличном от Китая!

СПИСОК ИЗМЕНЕНИЙ

Отличия от оригинала

1. Добавлен перевод действий/условий, статусов и карточек для большинства устройств, некоторые правки перевода и вёрстки интерфейса;
2. Для упрощения дальнейшего перевода, все данные из облака запрашиваются с английской локализацией; плагинам также сообщается необходимость использовать английский язык (т.к. некоторые из них используют по-умолчанию китайский язык в случае отсутствия запрошенной локали). Отличие от альтернативной версии в том, что я не заменяю английскую локализацию на русскую (что дало бы эффект визуально схожий указанному выше), благодаря чему оба языка остаются доступны.
   UPD: Т.к. стало появляться всё больше переведённых производителем плагинов (хотя на большинство без слёз не взглянешь), необходимость использовать английскую локализацию теперь сообщается только тем плагинам, в которых язык по-умолчанию - китайский. Т.е. все нормальные плагины будут пытаться использовать выбранную в системе локализацию, а список "особо одарённых" - принудительно будут использовать английскую (как не трудно догадаться, русской в них всё равно нет). К сожалению, для нового RN-формата плагинов такой возможности форсировать локализацию пока нет;
3. Добавлена возможность сбора различных строковых данных (статусы/действия/уведомления и токены) в файл на карте памяти для их дальнейшего перевода (подробности в статье);
4. Изменено место хранения плагинов для возможности их ручной замены без рута. Решение отличается от представленного на форуме тем, что используется не корень внешнего накопителя, а стандартная папка приложения на внешнем накопителе, т.е. "/sdcard/Android/data/com.xiaomi.smarthome/files". Такое расположение позволяет при удалении приложения средствами системы, автоматически удалять и папку с плагинами (что кажется мне правильным);
5. Восстановлена возможность сценариев отключать самих себя. Думаю, что производитель задолбался бороться с кривыми циклически выполняющимися условиями, и просто отключил эту возможность (пусть и немного в ущерб гибкости). Используйте с умом и осторожностью;
6. Удалено бесполезное в наших широтах и мозолящее глаза условие по изменению погоды в Китае;
7. Отключено большинство китайских элементов интерфейса (магазин, рекомендуемые сцены, голосовое управление и пр.), т.е. приложение будет выглядеть так, как будто выбран регион отличный от Китая;
8. Составы меню "Профиль" и "Настройки" приведены к китайскому варианту (более функциональному) на всех регионах; исключение - пункт "Другие устройства платформы", он доступен только в Китае;
9. Отключены кнопка голосового управления и новостной баннер в настройках;
10. Отключены онскрин-реклама и пуш-уведомления с ней;
11. Добавлено цветовое разделение облачных и локальных сценариев: в списках сценариев (кроме списков дочерних устройств) названия облачных будут отображаться тёмно-синим цветом;
12. Добавлено отображение токена устройства в информации о сети (для каждого в отдельности) и в списке общих устройств (все сразу). Также в информации о сети отображается ID устройства и его модель. Все перечисленные данные можно копировать в буфер обмена долгим тапом;
13. Добавлено отображение идентификатора сценария (us_id) в его свойствах, его тоже можно скопировать в буфер обмена;
14. В манифест добавлен атрибут "fake-signature" c оригинальной подписью. Т.о. плагины, выполняющие проверку подписи (например AC Partner и IR Controller), будут полноценно работать на версиях Android, поддерживающих Signature Spoofing;
15. Благодаря наработкам и доброй воле пользователя rezmus (и моему скромному участию), добавлена возможность подключения любых версий устройств во всех доступных регионах. Т.е. приложение теперь будет успешно находить и позволять подключать устройство, например, для европейского рынка, даже если выбран регион "Китай" (и наоборот). Данное изменение не решает проблему некоторых плагинов и устройств, которые имеют дополнительные механизмы контроля подключения к конкретному облаку: в такой ситуации по-прежнему будут требоваться дополнительные манипуляции с плагином и/или устройством. Также существуют устройства, для которых на региональных серверах в принципе не реализованы необходимые сервисы: такие девайсы возможно использовать только в регионе "Китай";
16. Реализована возможность дополнять (и даже создавать) условия/действия автоматизаций с помощью файлов-шаблонов (автор rezmus). Это полезно для моделей, в которых производитель решил ограничить функционал автоматизации, или неудачно подобрал её параметры. Я постараюсь включать непосредственно в мод существующие на момент создания шаблоны таких модификаций от автора метода, но реализована также загрузка из папки на устройстве, т.е. для их обновления переустановка или ожидание новой версии приложения не понадобятся;
17. Добавлен механизм, позволяющий использовать кастомные шаблоны автоматизации (см. выше) для дочерних Zigbee устройств, в некоторых случаях - даже если они не предусмотрены производителем (автор rezmus). В качестве примера работы созданы гибкие условия уровня освещенности шлюза и датчика движения Aqara, новое действие установки цвета подсветки шлюза (требуется измененный плагин);
18. Для энтузиастов - добавлена возможность логирования различных данных (действия/уведомления/токены и т.п.). Чтобы включить сбор данных, необходимо создать папку "/sdcard/vevs/logs" и перезапустить приложение с полной его остановкой/выгрузкой (или сам телефон). Информация об устройствах, условия/действия сценариев будут собраны все разом при обновлении списка устройств и/или списка сценариев, а уведомления - каждое в отдельности по мере их появлении на устройстве. Чтобы прекратить сбор данных - удаляем указанную папку и полностью перезапускаем приложение или телефон;
19. Для суровых энтузиастов - добавлено логирование сообщений MIIO и MIOTSPEC (новый протокол, приходящий на смену MIIO) при управлении устройством из плагина во всех режимах работы (локальном и облачном);
20. Отключена стандартная проверка обновлений приложения, т.к. установка официальной версии поверх мода всё равно не возможна (касается только самого приложения);
21. Добавлена возможность принудительно загружать MPK-плагины вместо RN-плагинов для выбранных устройств с помощью внешнего конфигурационного файла "plugins.json". Подробности уточняйте в группе Telegram.

Функции, доступные подписчикам

1. Добавлено автоматическое обновление мода с сервера проекта;
2. Добавлена функция автоматической загрузки некоторых модифицированных плагинов с сервера проекта. Благодаря rezmus, нам доступны моды с отключенной проверкой региона для большинства пылесосов Roborock, а также нормально работающие в российском облаке плагины для увлажнителей (перевод тоже выполнен). Важный момент: я пока не планирую их систематически обновлять до актуальных версий, а обновления от производителя приходить не будут (по понятным причинам).

ИНФОРМАЦИЯ О ПОДПИСКЕ

Дисклеймер ("ты туда не ходи")

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

1. Если вы ранее не использовали мод, не знаете в чём его отличия от оригинала, а после прочтения данной статьи смысл периодических донатов будет вам непонятен - ни в коем случае не оформляйте подписку! Сначала попользуйтесь модом просто так, составьте своё собственное мнение о (бес)полезности как мода, так и подписки лично для вас.
2. Донат-подписка - это добровольное пожертвование, а не оплата услуг или продукта. Никаких дополнительных личных консультаций, гарантий, ответственности или долгосрочных обязательств с моей стороны не подразумевается. Я всегда стараюсь всё делать настолько хорошо, насколько могу, и ваши регулярные пожертвования - добровольный акт признания этих усилий, а не оплата моего времени. Если вы не разделяете и/или не согласны уважать точку зрения автора в этом вопросе - ни в коем случае не оформляйте подписку, т.к. мы гарантированно не найдём общего языка, не стоит тратить время друг-друга.

В чём смысл подписки, кроме благодарности автору?

Никаких чудес или скрытых возможностей после оформления подписки не будет, сам мод ничем не отличается от общедоступной версии, но приятный (надеюсь) бонус для подписчиков всё же предусмотрен :) Разница в работе приложения существует лишь в той части, которая является полностью моей разработкой: возможность автоматического обновления самого мода и загрузки некоторых (особенно часто вызывающих проблемы) модифицированных плагинов с сервера проекта. Для подписчиков весь процесс полностью прозрачен, как в оригинальном приложении: упомянутые плагины будут самостоятельно загружаться сразу из моего облака, а обновления мода появляться в стандартных уведомлениях самого приложения. Для пользователей без донат-подписки эти функции недоступны, и в качестве информационно-мотивирующего элемента в уведомлениях постоянно отображается фиктивное сообщение об обновлении с напоминанием о её отсутствии. При отказе от продления подписки, мод теряет возможность автоматического обновления и загрузки модифицированных плагинов с сервера проекта.

Я решил поддержать автора подпиской, как это сделать?

В качестве платформы для подписок я выбрал проект Boosty, разрабатываемый и принадлежащий Mail.ru Group. Никаких других вариантов нет, и пока не планируется. Если у вас возникают проблемы с работой платформы - пожалуйста, обращайтесь в техподдержку Boosty, я на подобные вопросы ни в чате, ни в личку отвечать не буду. Для вопросов же по работе самой подписки я создал новый закрытый чат, ссылка на который есть в сообщении-инструкции для донаторов. В целом, процесс подписки на данный момент таков:

1. Перешли по ссылке на донат-платформу;
2. Прочитали информацию "Об авторе" (по желанию) и сообщение "Привет!" (обязательно);
3. Оформили подписку;
4. Очень внимательно прочитали ставшее доступным сообщение "Инструкция" и выполнили описанные там несложные действия.

Не хочу ничего платить, можно пользоваться как раньше?

Можно. Сам мод, как и раньше, остаётся доступен для ручного скачивания и обновления со страниц моего блога, но публикация новых версий будет происходить несколько позже (в среднем - на 3 дня), чем распространение обновления для подписчиков. Так же в блоге доступны для свободного скачивания все имеющиеся у меня модифицированные плагины и архив старых версий приложения.

СКАЧАТЬ ВЕРСИЮ 5.6.50 *
СКАЧАТЬ МОДЫ ПЛАГИНОВ *
АРХИВ ПРОШЛЫХ ВЕРСИЙ
ОБСУДИТЬ В TELEGRAM
ПОКОРМИТЬ КАПИБАРУ :)

* прямой переход по ссылке возможен только со страниц этого блога, или после введения пароля 24781364 (имя пользователя вводить не надо)