Инструкция к астрокубикам

Астрокубики — это уникальное гибридное устройство‚ сочетающее в себе миниатюрный кубический спутник (CubeSat-формат 1U–3U)‚ настольный планетарий и интерактивный конструктор для изучения космоса. В отличие от классических «zoom-встреч» или «онлайн-агентов»‚ которые сегодня используются для дистанционной работы‚ астрокубики переводят цифровой опыт в физический мир‚ позволяя запускать настоящие орбитальные эксперименты прямо из дома или класса.

Комплектация

• Кубик 1U (10 × 10 × 10 см) — основной модуль с солнечными батареями‚ магнитным торquer’ом и камерой 5 MP.
• Базовая станция — соединяется с ПК/Mac через USB-C и эмулирует наземный центр управления (аналог Zoom Meeting SDK‚ но для спутников).
• Магнитная площадка «орбита» — имитирует микрогравитацию и позволяет кубику парить на воздушной подушке.
• QR-карточки миссий — 40 заданий от самостоятельной съёмки Земли до запуска мини-спутников-«beakona».
• Кабель Type-C ↔ Type-C и кейс EVA для переноски.

Шаг 1. Подготовка к «запуску»

1. Активация аккаунта
   
   Зайдите на https://astroblocks.cc/activate‚ введите серийный номер (S/N на днище кубика) и выберите режим:
   • Education, для школ и вузов (бесплатный tier наподобие Zoom Basic).
   • Pro, дополнительные API-вызовы для хакатонов и R&D.
2. Установка ПО «AstroHub»
   
   Скачайте версию под Windows/macOS/Linux. При первом запуске вас попросят:
   • Connection Name: произвольное имя (например‚ «Класс 9А»).
   • Account ID‚ Client ID‚ Client Secret, генерируются автоматически после активации аккаунта (аналог OAuth-ключей Zoom‚ но для спутников).
3. Создание «комнаты миссии»
   
   В интерфейсе AstroHub нажмите “Create Mission Room”‚ задайте:
   • название миссии‚
   • время жизни (от 5 минут до 48 часов непрерывной работы)‚
   • уровень безопасности (0–3‚ где 0 = открытый доступ без пароля‚ 3 = двухфакторная аутентификация).

Шаг 2. Сборка и первый «полёт»

⚠️ Помните: астрокубики не предназначены для запуска на настоящую орбиту; это наземный симулятор‚ но с реальными датчиками и связью.

Физическая сборка

• Установите кубик на магнитную площадку «орбита».
• Убедитесь‚ что солнечные панели ориентированы на светодиодный «Солнце» (встроенный в площадку).
• Подключите кабель Type-C к базовой станции — вверху появится красный индикатор (аналог красной точки записи в Zoom).

Подключение к «Mission Room»

1. В AstroHub выберите “Join Mission”.
2. Введите:
   • Meeting ID: это номер миссии (например‚ 7842-1633-5555).
   • Passcode: указывается при создании миссии.
   • User Name: позывной экипажа (до ).
3. Нажмите “Connect”. Статус в правом верхнем углу должен измениться на Recording (аналог записи Zoom-сессии).

Шаг 3. Управление полётом

Интерфейс «Mission Dashboard»

Пример команды

Чтобы снять «земную» картинку в стиле CubeSat:

1. Запустите стабилизацию: установите магнитный торquer по оси Z на +25 %.
2. Откройте вкладку Camera и нажмите Capture.
3. Файл сохранится локально в ~/AstroHub/missions/{ID}/frames/.

Шаг 4. Работа с API и автоматизация

Астрокубики предоставляют REST-API‚ максимально похожее на Zoom API:

POST https://api.astroblocks.cc/v1/missions
Authorization: Bearer <Client-Secret>
Content-Type: application/json
{ "topic": "Урок астрономии 7А"‚
 "type": 2‚ // 1 = instant‚ 2 = scheduled
 "start_time": "2026-05-06T09:00:00Z"‚
 "duration": 45‚ // минут
 "password": "Jupiter7"‚
 "settings": {
 "auto_recording": "local"‚
 "ai_companion": true
 }

}

Ответ содержит id‚ join_url и start_url‚ которые можно встроить в Google Календарь или Microsoft 365 (аналог Zoom-интеграции).

Шаг 5. Синхронизация с Zoom и Office 365

1. В AstroHub откройте Settings → Integrations.
2. Выберите Zoom и нажмите Link Account. Понадобятся те же Account ID‚ Client ID‚ Client Secret вашего Zoom-аккаунта.
3. Активируйте Auto-Stream: картинка с камеры астрокубика будет транслироватся в Zoom Webinar в реальном времени (720p‚ 30 fps).
4. Для Office 365 включите Calendar Sync — миссии будут появляться как встречи с прикреплённой ссылкой https://astroblocks.cc/join/{mission_id}.

Распространённые проблемы и их решения

• Не создаётся файл записи (аналог «красная точка‚ но файла нет» из интернет-источников).
  
  Причина: не включена опция auto_recording или закончилось место на диске.
  
  Решение: проверьте ~/AstroHub/logs/ и освободите ≥ 1 ГБ.
• Ошибка “account may not be compatible” при Office 365.
  
  Причина: у аккаунта Education tier отключены графовые API.
  
  Решение: подать заявку на Pro tier или использовать публичный календарь iCal.
• Не удаётся одновременно присоединиться гостю (аналог Zoom issue «host leaves‚ guest joins»).
  
  Решение: установите флаг "allow_join_before_host": true при создании миссии.

Дополнительные возможности Pro-аккаунта

• Онлайн-агент — запуск «астро-бота» на виртуальной орбите; можно программировать на Python (SDK доступен через pip install astroblocks-sdk).
• AI Companion — генерирует автоматические сводки полёта (summary_content) в формате markdown и отправляет их на e-mail.
• API-вебхуки — мгновенные события mission.started‚ mission.ended‚ beacon.deployed.

Астрокубики — это не просто игрушка‚ а полноценная платформа для обучения и R&D‚ объединяющая физику‚ астрономию и современные API-подходы. Следуя данной инструкции‚ вы сможете «запустить» собственный спутник без миллионных бюджетов и головной боли‚ сопоставимой с интеграцией Zoom в корпоративную экосистему.

Удачных полётов и ясного неба — как на орбите‚ так и в вашем классе!