BLENDAIM 1.5 — ИНСТРУКЦИЯ
Android-телефон → камера Blender

Приложение Android называется BlendAim. Аддон Blender 1.4 сохраняет
название PhoneCam в панели N. Это совместимые части одного комплекта.

1. ЧТО В КОМПЛЕКТЕ

BlendAim-Android-1.5.apk — приложение для телефона.
BlendAim-Blender-1.4.zip — аддон Blender. Этот внутренний ZIP не распаковывайте.
BlendAim-Guide-1.5.txt — эта инструкция.
SHA256.txt — контрольные суммы файлов для проверки целостности.

Сначала распакуйте внешний архив BlendAim-1.5-Share.zip в любую папку.
Для использования исходники, Android Studio и инструменты разработчика не нужны.

2. ЧТО ПОНАДОБИТСЯ

• Android 8.0 или новее и датчик ориентации; предпочтителен телефон с гироскопом.
• Компьютер с Blender. Работа проверена на Blender 5.0.1 и Android 13.
  В аддоне заявлен минимум Blender 3.6, но другие версии отдельно не проверялись.
• Телефон и компьютер в одной доверенной локальной сети.
  Телефон подключается по Wi-Fi; компьютер может быть подключён кабелем к тому же роутеру.
• Открытое окно 3D Viewport в Blender для передачи изображения камеры.

USB-кабель для работы не нужен. Версии для iPhone в этом комплекте нет.
Один телефон управляет одной выбранной камерой.

3. УСТАНОВКА АДДОНА В BLENDER

1) Сохраните свою сцену. Для первого запуска удобно открыть отдельную тестовую сцену.
2) Откройте Edit → Preferences → Add-ons.
3) В меню со стрелкой справа сверху выберите Install from Disk.
   В других версиях Blender этот пункт может называться Install…
4) Выберите BlendAim-Blender-1.4.zip из распакованного комплекта.
   Не выбирайте внешний архив комплекта или APK.
5) Включите PhoneCam — Android Camera Controller, если аддон не включился автоматически.
6) Сохраните настройки, если у вас отключено их автоматическое сохранение.
7) Вернитесь в сцену. Наведите мышь на 3D Viewport, нажмите N.
   В правой боковой панели откройте вкладку PhoneCam.

4. УСТАНОВКА ПРИЛОЖЕНИЯ НА ТЕЛЕФОН

1) Передайте BlendAim-Android-1.5.apk на Android-телефон любым удобным способом.
2) Откройте APK через файловый менеджер или загрузки.
3) Если Android попросит, разрешите установку из этого источника
   для приложения, которым открываете APK, затем нажмите «Установить».
4) Откройте BlendAim. После установки разрешение источника можно снова отключить.

Приложение устанавливается из APK, а не из Google Play. Аккаунт не нужен.
Телефонная камера и микрофон для работы PhoneCam не используются.

5. ПОДГОТОВКА КАМЕРЫ И СЕРВЕРА

1) В панели PhoneCam в Blender выберите объект Camera.
   Подходит обычная локальная редактируемая камера без родителя и constraints.
   Для сложного рига создайте отдельную камеру без этих связей.
2) Выставьте удобную начальную позицию камеры.
3) Оставьте UDP port = 39570 для первого подключения.
4) Нажмите Start server. Пустой код подключения будет создан автоматически.
5) Запишите Pair code и IPv4 компьютера из панели.

Выбирайте адрес адаптера Wi-Fi/Ethernet вашей локальной сети.
Пример: 192.168.1.100 — это только пример, у вас будет свой адрес.
127.0.0.1, адреса 169.254.x.x и адреса VPN обычно не подходят для подключения по Wi-Fi.
Камера, код и порт меняются после остановки сервера кнопкой Stop server.

6. ПОДКЛЮЧЕНИЕ ТЕЛЕФОНА

1) Подключите телефон к той же локальной сети, что и компьютер.
2) В настройках BlendAim откройте «Подключение» и введите IPv4 компьютера, UDP-порт и Pair code из Blender.
3) Нажмите «Подключиться к Blender».
4) Дождитесь подтверждения связи от Blender.
5) Держите телефон горизонтально: после подключения откроется полноэкранное управление.
6) Возьмите телефон в удобную нейтральную позу и нажмите «Центр».

Если Windows запросит сетевой доступ для Blender, разрешите его для доверенной
частной сети. Для управления используется UDP 39570, для предпросмотра TCP 39571.
Если меняете UDP-порт, порт изображения всегда равен UDP-порту + 1.
В телефоне и Blender должен быть указан один и тот же UDP-порт.
Сетевые поля находятся в отдельных настройках: кнопка с ползунками → «Подключение».

Передача идёт внутри локальной сети. Не требуется открывать порты роутера в интернет.
Код подключения ограничивает доступ, но соединение не шифруется:
используйте доверенную сеть и не публикуйте код посторонним.

7. ПОВОРОТ И ПЕРЕМЕЩЕНИЕ

Поворот телефона поворачивает камеру. Можно держать телефон горизонтально
любой стороной; после смены положения снова нажмите «Центр», если это нужно.
При повороте телефона влево камера должна смотреть влево, при наклоне — вверх/вниз.

«Центр» делает текущую позу телефона нейтральной относительно текущей камеры.
Эта кнопка не возвращает камеру в исходную позицию и не удаляет ключи.

Круглый джойстик слева:
• вверх/вниз — вперёд/назад относительно направления камеры;
• влево/вправо — движение в стороны;
• чем дальше отклонение от центра, тем быстрее движение;
• отпустите палец, чтобы остановить движение.

Кнопки подъёма и спуска справа перемещают камеру по мировой вертикали Z.
Перенос самого телефона по комнате не перемещает камеру: это управление
поворотом по датчикам и перемещением через экран, без пространственного AR-трекинга.

«Пауза» / HOLD замораживает управление и останавливает запись ключей.
«Продолжить» включает управление; запись после паузы включается отдельно.

Откройте настройки кнопкой с ползунками. Во вкладке «Управление» доступны блокировки перемещения по мировым осям X/Y/Z.
Например, блокировка Z сохраняет высоту при движении вперёд с наклонённой камерой.
Эти переключатели не блокируют поворот. Lock roll в Blender блокирует крен.

Move speed в Blender задаёт максимальную скорость движения в единицах сцены/с.
Если единицы сцены соответствуют метрам, это метры в секунду.
Для начала подойдёт значение 2. Сглаживание около 80 мс — отправная точка:
больше сглаживание → мягче движение, но заметнее задержка.

8. ПОЛНЫЙ ЭКРАН И ИЗОБРАЖЕНИЕ

В полном экране доступны предпросмотр, джойстик, подъём/спуск, «Центр»,
«Пауза», отдельные REC и STOP, таймер и состояние записи.
Кнопка возврата к настройкам не отключает соединение.
Закройте настройки кнопкой назад. На главном экране кнопка разворота
рядом с «Камера Blender» открывает полноэкранное управление.

На телефоне показывается ракурс выбранной камеры Blender, а не изображение
с камеры телефона. Это предпросмотр 3D Viewport, а не финальный рендер.
Оставьте 3D Viewport открытым для нужной сцены.

Частота изображения зависит от сложности сцены, видеокарты и сети.
Целевая частота не гарантирует столько же реальных кадров в секунду.
Для плавности начните с простого режима отображения сцены и разрешения предпросмотра
256–480 пикселей по длинной стороне. Уменьшение разрешения и целевой частоты
снижает нагрузку; 15–24 кадра/с подходят для первого теста.

9. ЗАПИСЬ КЛЮЧЕВЫХ КАДРОВ

REC записывает анимацию камеры в Blender, а не видеофайл на телефоне.

1) Сохраните .blend. Для нового дубля используйте отдельную камеру или копию
   сцены/анимации, если нужно сохранить предыдущий результат.
2) В Blender установите текущий кадр таймлайна, с которого должен начаться дубль.
3) Подключите телефон, нажмите «Центр», убедитесь, что управление работает.
4) Нажмите REC. Дождитесь подтверждённого состояния записи.
5) Двигайте камеру. На телефоне растут таймер, число записанных отсчётов и номер кадра;
   в Blender выбранная камера выделяется, а таймлайн перемещается вместе с записью.
6) Нажмите STOP. Ключи останутся в Blender.
7) Сохраните .blend вручную: PhoneCam не сохраняет файл проекта автоматически.

Записываются location и rotation_quaternion выбранной камеры.
Номера кадров рассчитываются по времени и FPS сцены; при нагрузке возможны пропуски.
Следующий дубль начинается с текущего кадра. Если вернуть таймлайн назад и снова
нажать REC, ключи в этом диапазоне могут быть заменены.

Для просмотра остановите управление (Stop server в Blender), выберите камеру,
перейдите на первый кадр дубля и нажмите пробел для воспроизведения.
Для финального рендера назначьте эту камеру активной камерой сцены и используйте
обычные инструменты рендера Blender. Сам APK готовый ролик не экспортирует.

10. ПАМЯТЬ ТЕЛЕФОНА И ОБРЫВ СВЯЗИ

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

При уходе приложения в фон соединение закрывается. Вернувшись, подключитесь заново.
При потере свежих данных движение прекращается, а при потере связи запись
останавливается. После восстановления связи нажмите REC заново — продолжение
записи не включается автоматически. Уже записанные ключи не удаляются.

11. ЕСЛИ ЧТО-ТО НЕ РАБОТАЕТ

Нет вкладки PhoneCam:
Проверьте, что аддон включён в Preferences → Add-ons. Нажимайте N именно
над 3D Viewport; вкладка находится в его боковой панели.

Нет связи:
Проверьте Start server, IP, одинаковые порт и код. IP компьютера может измениться
после переподключения к сети. Убедитесь, что устройства не разделены гостевой
сетью/изоляцией клиентов. VPN тоже может мешать локальному подключению.
В брандмауэре разрешите Blender или нужные UDP/TCP-порты для частной сети;
не отключайте брандмауэр целиком. «Порт занят» — остановите второй сервер
или задайте другой UDP-порт одновременно в Blender и телефоне.

Управление есть, изображения нет:
Оставьте 3D Viewport открытым, проверьте выбранную камеру и TCP-порт UDP+1.
Разрешение только UDP позволяет двигать камеру, но не передавать предпросмотр.

Изображение есть, но REC не подтверждается:
Проверьте UDP-связь и установку обеих частей именно версии 1.4.
Одного изображения недостаточно для подтверждения управления и записи.
Выключите HOLD, проверьте датчик ориентации и свежесть соединения.

REC работает, но ключей не видно:
Выберите именно камеру из панели PhoneCam и нужный диапазон кадров в Timeline
или Dope Sheet. Следите за числом отсчётов и кадром на телефоне/в панели аддона.
Запись в другой объект или в ключи встроенной камеры телефона не производится.

Камера не двигается или движение ограничено:
Проверьте HOLD, блокировки X/Y/Z и Move speed. Используйте отдельную локальную
камеру без родителя/constraints. Поворот и перемещение проверяйте по отдельности.

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

Предпросмотр тормозит:
Уменьшите сложность отображения сцены, размер предпросмотра и целевую частоту.
Используйте стабильный Wi-Fi рядом с роутером и закройте тяжёлые задачи на компьютере.
Сильное сглаживание тоже добавляет задержку реакции управления.

12. ОБНОВЛЕНИЕ И УДАЛЕНИЕ

Перед обновлением сохраните .blend и остановите сервер.
Отключите старый PhoneCam в Add-ons, установите новый ZIP и включите аддон.
При необходимости перезапустите Blender после сохранения работы.
APK с той же подписью можно установить поверх старой версии, сохранив настройки.
Если Android сообщает о конфликте подписи, проверьте происхождение обеих сборок;
удаление старого приложения удалит и его настройки.

Для удаления: удалите приложение обычным способом на Android; в Blender отключите
и удалите аддон через Preferences. Уже сохранённая анимация в .blend останется.

КОНТРОЛЬ ЦЕЛОСТНОСТИ (НЕОБЯЗАТЕЛЬНО)

В PowerShell: Get-FileHash -Algorithm SHA256 -LiteralPath 'путь к файлу'
Сравните результат с SHA256.txt. Это проверка повреждений при передаче,
а не независимое подтверждение происхождения комплекта.

ВЕРСИЯ 1.5
Обновлены интерфейс, отдельные настройки, матовый джойстик, шрифты и иконки.
Протокол управления и формат ключей совместимы с аддоном 1.4.
Платная активация и 7-дневный пробный доступ пока не включены в эту сборку.