JavaScript-команды
Данное руководство описывает стандартные JavaScript-команды, доступные для использования в кнопках, виджетах и скриптах пользовательского интерфейса (Смарт-Логика ⚡, события addEventListener, таймеры и сценарии ИИ) в среде Socrates.Studio и собранных автономных клиентских приложениях.
- Управление окном 3D-виджета и интерфейсом
Команды управления размерами окна симулятора и отображением приборных панелей.
| Команда | Описание | Пример вызова |
| window.MujocoStudio.toggleFullscreen() | Разворачивает 3D-полигон на весь физический экран монитора или возвращает его обратно в исходный блок верстки. Автоматически пересчитывает перспективу камеры. | btn_fs.addEventListener(‘click’, () => window.MujocoStudio.toggleFullscreen()); |
| document.getElementById(‘mujoco-hud-telemetry’).style.display = ‘none’ | ‘flex’ | Скрывает или показывает плавающую панель инженерной телеметрии (координаты камеры, масштаб мира, положение курсора в 3D). | btn_hud.addEventListener(‘click’, () => { var h = document.getElementById(‘mujoco-hud-telemetry’); if(h) h.style.display = h.style.display === ‘none’ ? ‘flex’ : ‘none’; }); |
- Управление физической симуляцией (MuJoCo Core)
Официальный фасад window.Socrates.sim для прямого контроля над временем и шагом симуляции.
| Команда | Описание | Пример вызова |
| window.Socrates.sim.toggle(btnElement) | Тоггл Старт / Пауза. Переключает состояние физики. Если в качестве аргумента передана сама кнопка (this), автоматически меняет ее текст (▶ Старт ⇄ ⏸ Пауза) и цвет фона (Зеленый ⇄ Красный). | btn_run.addEventListener(‘click’, function() { window.Socrates.sim.toggle(this); }); |
| window.Socrates.sim.play() | Принудительно запускает расчет физики и анимацию систем частиц. | window.Socrates.sim.play(); |
| window.Socrates.sim.pause() | Ставит симуляцию на паузу с сохранением всех накопленных скоростей и импульсов тел. | window.Socrates.sim.pause(); |
| window.Socrates.sim.reset() | Останавливает симуляцию и мгновенно возвращает все тела полигона в исходные сборочные координаты и кватернионы. | btn_reset.addEventListener(‘click’, () => window.Socrates.sim.reset()); |
- Динамическая загрузка миров и сред полигона
Позволяет переключать полигоны и среду «на лету» без перезагрузки веб-страницы.
| Команда | Описание | Пример вызова |
| window.SocratesBridge.loadWorld(worldName) | Запрашивает через WebSocket свежий граф мира из гБД (MainPolygon, RobotLab или любой именованный полигон) и перестраивает сцену со всеми телами, связями и рельефом. | sel_world.addEventListener(‘change’, function() { window.SocratesBridge.loadWorld(this.value); }); |
| window.updateWorldEnvironment(size, hasWater, waterLevel, density, pressure, windX) | Мгновенно меняет масштаб мира, границу зеркала воды, плотность жидкости и скорость бокового ветра. | window.updateWorldEnvironment(100, true, 0.0, 1000, 1.2, 10.0); |
| window.setSkyBackground(base64Jpeg) | Динамически натягивает панорамную текстуру неба (Skybox) из строки Base64. | window.setSkyBackground(mySkyBase64); |
| window.setTerrainTexture(base64Png) | Накладывает текстуру грунта на рельеф полигона в проекции 1:1. | window.setTerrainTexture(myGroundBase64); |
- Управление сущностями (Роботы, суставы, шасси)
Фасад window.Socrates.robot предназначен для прямого управления кинематикой машин, приводами и сенсорами.
| Команда | Параметры | Описание |
| window.Socrates.robot.rotate(partId, angleDeg) | partId (string) — имя детали<br>angleDeg (float) — угол в градусах | Мгновенно выставляет угол сервопривода/шарнира детали. |
| window.Socrates.robot.animate(partId, angleDeg, durationSec) | partId (string)<br>angleDeg (float)<br>durationSec (float) — секунды | Плавно интерполирует угол поворота сустава за указанное время. Идеально для анимации манипуляторов. |
| window.Socrates.robot.drive(direction, powerPercent, durationSec) | direction (‘FORWARD’, ‘BACKWARD’, ‘LEFT’, ‘RIGHT’, ‘STOP’)<br>powerPercent (0..100%0..100%) | Запускает вращение колес шасси с заданной мощностью на определенное время (или непрерывно при duration = 0). |
| window.Socrates.robot.gripper(openPercent) | openPercent (0..100%0..100%) | Управляет раскрытием захвата клешни манипулятора (0%0% — сжато, 100%100% — полностью раскрыто). |
- Шина событий Мира (WorldEvents)
Позволяет из кнопок интерфейса или скриптов логики искусственно генерировать физические события, активирующие эффекты (взрывы, включение сопел, аварийные тревоги).
codeJavaScript
window.WorldEvents.emit({
name: “collision”, // Имя события-триггера
sourceId: “part_hull”, // Источник (ID узла)
targetId: “stone_obstacle”, // С кем контакт (или null)
point: { x: 0, y: 1.5, z: 0 }, // Точка в пространстве
power: 500.0 // Сила / Мощность в Ньютонах
});
Пример использования кнопки «Детонация»:
codeJavaScript
btn_detonate.addEventListener(‘click’, function() {
window.WorldEvents.emit({
name: “explosion”,
sourceId: “barrel_fuel”,
power: 10000.0
});
});
- Связь с ядром ИИ Socrates AI и Бортовой Телеметрией
Команды для взаимодействия пользовательского интерфейса с нейросетевыми агентами и голосовым вводом.
| Команда | Описание | Пример вызова |
| window.Socrates.sendText(text, mode, tag) | Отправляет текстовое сообщение или команду в чат ядра Socrates AI (tag: ‘_Input’). | window.Socrates.sendText(“Двигайся к точке сбора”, 0, “_Input”); |
| window.Socrates.speak(text, rate, pitch) | Озвучивает текст через синтезатор речи (TTS) бортового компьютера. | window.Socrates.speak(“Внимание, препятствие впереди!”, 1.0, 1.0); |
| window.Socrates3D.sendCameraSnapshot() | Делает моментальный скриншот с бортовой 3D-камеры робота и отправляет изображение в зрительную кору ИИ (_InputImage). | btn_snap.addEventListener(‘click’, () => window.Socrates3D.sendCameraSnapshot()); |
| window.Socrates3D.sendTelemetry(sensorId, message) | Отправляет пакет телеметрических данных сенсора в семантическую память агента. | window.Socrates3D.sendTelemetry(“range_1”, “Дистанция критическая”); |
- Практические примеры для редактора Скриптов страницы
Пример 1. Пульт управления поворотной турелью
codeJavaScript
// Поворот башни влево по нажатию кнопки
btn_turret_left.addEventListener(‘click’, function() {
window.Socrates.robot.animate(“Turret_Part”, -45.0, 0.8);
window.Socrates.speak(“Башня влево”, 1.2);
});
// Возврат в нулевое положение
btn_turret_center.addEventListener(‘click’, function() {
window.Socrates.robot.animate(“Turret_Part”, 0.0, 0.5);
});
Пример 2. Автоматический экстренный тормоз по датчику дальномера
codeJavaScript
// Проверка дистанции каждые 100 мс
setInterval(function() {
var distCm = window.Socrates.robot.getDistance(“front_sonar”);
// Вывод телеметрии на цифровой индикатор
var display = document.getElementById(“telemetry_dist”);
if (display) display.innerText = distCm.toFixed(1) + ” см”;
// Аварийный останов при сближении менее 15 см
if (distCm < 15.0) {
window.Socrates.robot.drive(“STOP”, 0, 0);
window.Socrates.sim.pause();
window.Socrates.speak(“Аварийная остановка”, 1.0);
}
}, 100);
Пример 3. Кнопка экстренного развертывания на весь экран
codeJavaScript
btn_fullscreen_custom.addEventListener(‘click’, function() {
window.MujocoStudio.toggleFullscreen();
});