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

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

NOTA BENE

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

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

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

* * * * *

02/12/20

• !!! Внимание !!! ВЕРСИЯ БЕЗ НАТИВНОЙ ПОДДЕРЖКИ ARM64! Работать должно везде, но установка на свой страх и риск!
• ! VERY-BETA ! Китайцы ОЧЕНЬ многое поменяли в коде, я постарался всё отследить, но не исключены проблемы;
• Множественные архитектурные изменения, связанные с последними 'нововведениями' производителя;
• Исправлена ошибка открытия настроек в плагине одноклавишных выключателей;
• Добавлены и обновлены шаблоны автоматизаций для некоторых устройств.

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

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

1. Добавлен перевод действий/условий, статусов и карточек для большинства устройств, некоторые правки перевода и вёрстки интерфейса;
2. Для упрощения дальнейшего перевода, все данные из облака запрашиваются с английской локализацией; плагинам также сообщается необходимость использовать английский язык (т.к. некоторые из них используют по-умолчанию китайский язык в случае отсутствия запрошенной локали). Отличие от альтернативной версии в том, что я не заменяю английскую локализацию на русскую (что дало бы эффект визуально схожий указанному выше), благодаря чему оба языка остаются доступны.
   UPD: Т.к. стало появляться всё больше переведённых производителем плагинов (хотя на большинство без слёз не взглянешь), необходимость использовать английскую локализацию теперь сообщается только тем плагинам, в которых язык по-умолчанию - китайский. Т.е. все нормальные плагины будут пытаться использовать выбранную в системе локализацию, а список "особо одарённых" - принудительно будут использовать английскую (как не трудно догадаться, русской в них всё равно нет). К сожалению, для нового RN-формата плагинов такой возможности форсировать локализацию пока нет;
3. Изменено место хранения плагинов для возможности их ручной замены без рута. Решение отличается от представленного на форуме тем, что используется не корень внешнего накопителя, а стандартная папка приложения на внешнем накопителе, т.е. '/sdcard/Android/data/com.xiaomi.smarthome/files'. Такое расположение позволяет при удалении приложения средствами системы, автоматически удалять и папку с плагинами (что кажется мне правильным);
4. Добавлена возможность хранения во внешней папке '/sdcard/vevs/files/' некоторых вспомогательных файлов, в т.ч. плагинов (актуально для пользователей Android 11+). Для активации проверьте права приложения на доступ ко внутренней памяти, создайте указанную папку и полностью перезапускаете MiHome через настройки телефона, после чего папку по оригинальному пути (см. предыдущий пункт) можно удалить;
5. Удалено бесполезное в наших широтах и мозолящее глаза условие по изменению погоды в Китае (можно включить в файле 'custom.json');
6. Отключено большинство китайских элементов интерфейса (магазин, рекомендуемые сцены, голосовое управление и пр.), т.е. приложение будет выглядеть так, как будто выбран регион отличный от Китая;
7. Составы меню "Профиль" и "Настройки" приведены к китайскому варианту (более функциональному) на всех регионах; исключение - пункт 'Другие устройства платформы', он доступен только в Китае;
8. Отключены функции голосового управления (т.к. поддерживается только китайский язык) и новостной баннер в настройках, онскрин-реклама и пуш-уведомления с ней;
9. Добавлено цветовое разделение облачных и локальных сценариев: в списках сценариев (кроме списков дочерних устройств) названия облачных будут отображаться тёмно-синим цветом;
10. Добавлено отображение модели/токена/DID устройства в пункт 'Информация о сети' (внутри большинства плагинов), а также отображение модели/токена/DID/IP-адреса/плагина в меню 'Изменить имя' на главной странице приложения (по долгому нажатию на иконку устройства). Все перечисленные данные можно копировать в буфер обмена долгим тапом;
11. Добавлено отображение идентификатора сценария (us_id) в его свойствах, его тоже можно скопировать в буфер обмена;
12. В манифест добавлен атрибут 'fake-signature' c оригинальной подписью. Т.о. плагины, выполняющие проверку подписи (например AC Partner и IR Controller), будут полноценно работать на версиях Android, поддерживающих Signature Spoofing;
13. Благодаря наработкам и доброй воле пользователя rezmus (и моему скромному участию), добавлена возможность подключения любых версий устройств во всех доступных регионах. Т.е. приложение теперь будет успешно находить и позволять подключать устройство, например, для европейского рынка, даже если выбран регион 'Китай' (и наоборот). Данное изменение не решает проблему некоторых плагинов и устройств, которые имеют дополнительные механизмы контроля подключения к конкретному облаку: в такой ситуации по-прежнему будут требоваться дополнительные манипуляции с плагином и/или устройством. Также существуют устройства, для которых на региональных серверах в принципе не реализованы необходимые сервисы: такие девайсы возможно использовать только в регионе 'Китай';
14. Реализована возможность дополнять (и даже создавать) условия/действия автоматизаций с помощью файлов-шаблонов (автор rezmus). Это полезно для моделей, в которых производитель решил ограничить функционал автоматизации, или неудачно подобрал её параметры. Я постараюсь включать непосредственно в мод существующие на момент создания шаблоны таких модификаций от автора метода, но реализована также загрузка из папки на устройстве, т.е. для их обновления переустановка или ожидание новой версии приложения не понадобятся;
15. Добавлен механизм, позволяющий использовать кастомные шаблоны автоматизации (см. выше) для дочерних Zigbee устройств, в некоторых случаях - даже если они не предусмотрены производителем (автор rezmus). В качестве примера работы созданы гибкие условия уровня освещенности шлюза и датчика движения Aqara, новое действие установки цвета подсветки шлюза (требуется измененный плагин);
16. Для энтузиастов - добавлена возможность логирования различных данных (действия/уведомления/токены/ключи сопряжения и т.п.). Чтобы включить сбор данных, необходимо проверить права приложения на доступ ко внутренней памяти, создать папку '/sdcard/vevs/logs' и перезапустить приложение с полной его остановкой/выгрузкой из памяти. Информация об устройствах и их шаблоны автоматизаций будут собраны все разом при обновлении списка устройств и/или списка сценариев, а уведомления - каждое в отдельности по мере их появлении на устройстве. Чтобы прекратить сбор данных - удаляем указанную папку и полностью перезапускаем приложение или телефон;
17. Для суровых энтузиастов - добавлено логирование сообщений MIIO и MIOTSPEC (новый протокол, приходящий на смену MIIO) при управлении устройством из плагина во всех режимах работы (локальном и облачном);
18. Отключена стандартная проверка обновлений приложения, т.к. установка официальной версии поверх мода всё равно не возможна (касается только самого приложения);
19. Добавлена возможность принудительно загружать стандартные MPK-плагины вместо RN-плагинов для выбранных устройств с помощью внешнего конфигурационного файла 'custom.json'. Подробности уточняйте в группе Telegram;
20. Отключены малополезные баннеры с информацией о рекомендуемых сценариях и качестве сигнала внутри плагинов;
21. Добавлена поддержка умной розетки Aqara 'lumi.plug.maeu01', изначально не поддерживаемой приложением. Работает только с шлюзом Aqara, и только в регионе, отличном от Китая!
22. Добавлена возможность принудительного направления определённых API-запросов в китайское облако, что может решить проблемы (или создать новые) с работой плагинов некоторых устройств в 'чужом' регионе: монитор растений, зубные щётки, тонометр, автомобильный очиститель воздуха. Управляется с помощью внешнего конфигурационного файла 'custom.json', по умолчанию параметр включен, подробности в группе Telegram.
23. Для некоторых камер Chuangmi отключена региональная блокировка со стороны облака;
24. Отключены проверка и уведомление о наличии root-доступа.
25. Форсирована загрузка полного (официального) списка поддерживаемых шлюзом дочерних ZigBee-устройств в процессе подключения, независимо от региона. Это не расширяет список фактически доступных для подключения устройств, а просто не позволяет программе скрывать устройства из другого региона;
26. Условие 'NFC-метка' теперь должно работать на любом устройстве, дополнительно добавлена возможность использования самых распространённых меток меньшего размера - NTAG213 (управляется параметром в 'custom.json');
27. На будущее - добавлена возможность включить скрытое производителем условие автоматизации по геопозиции (так же параметром в 'custom.json'), хотя судя по всему оно ещё не реализовано полностью и пока работать не будет;
28. Очень экспериментально, с массой ограничений, добавлена возможность интерактивно управлять через плагины (без автоматизации) некоторыми устройствами, подключенными к другим региональным серверам (отличным от выбранного в приложении). Реализовано не для всех типов устройств, работа в процессе, подробности в группе Телеграм;
29. Инструкции по сбросу устройств теперь принудительно загружаются из Китайского облака, т.к. в региональных облаках они вообще отсутствуют для большинства устройств;
30. Добавлена адаптивная иконка приложения для более гармоничного отображения на современных версиях Android (спасибо @sviperz);
31. Добавлено автоматическое включение BLE-шлюза на устройствах, где он был не только скрыт производителем, но и аппаратно выключен. Функция управляется параметром файла 'custom.json', по умолчанию включена, подробности в группе Телеграм;
32. Добавлен запрос разрешения на доступ ко внутренней памяти при первом запуске приложения, т.к. китайцы его недавно убрали, а оно необходимо для некоторых функций мода;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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