JavaScript-команды

Данное руководство описывает стандартные JavaScript-команды, доступные для использования в кнопках, виджетах и скриптах пользовательского интерфейса (Смарт-Логика ⚡, события addEventListener, таймеры и сценарии ИИ) в среде Socrates.Studio и собранных автономных клиентских приложениях.

  1. Управление окном 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’; });

 

  1. Управление физической симуляцией (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());

 

  1. Динамическая загрузка миров и сред полигона

Позволяет переключать полигоны и среду «на лету» без перезагрузки веб-страницы.

Команда Описание Пример вызова
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);

 

  1. Управление сущностями (Роботы, суставы, шасси)

Фасад 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% — полностью раскрыто).

 

  1. Шина событий Мира (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

});

});

 

  1. Связь с ядром ИИ 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. Практические примеры для редактора Скриптов страницы

Пример 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();

});