Установка SDK
Комплект не требует игрового движка или установки глобального npm-пакета.
Подключение
Распакуйте архив в рабочий каталог. Сохраните src/vorivox.js вместе с src/vorivox.d.ts. Для обычного JavaScript используйте относительный ES import. В TypeScript включите разрешение модулей, совместимое с вашим bundler, и проверку типов. Файл package.json помечен private: публичная публикация в npm не является частью процесса.
Локальный запуск
Обслуживайте каталог по HTTP, а не открывайте index.html через file://. Из корня комплекта выполните команду ниже и откройте /examples/canvas-demo/. Сервер привязан только к loopback. Для демонстрации не нужны Node.js или контроллер; Node нужен для автоматических тестов.
Разделение режимов
Mock импортируется отдельным модулем. Отсутствующий или ошибочный manifest никогда не включает демонстрацию автоматически. В release bundle не импортируйте mock.js и не добавляйте переключатель обхода лицензирования.
Пример кода
Фрагмент интеграции: переменные игрового проекта задаются приложением. Полный запускаемый пример — в Playground.
python3 -m http.server 8766 --bind 127.0.0.1
# http://127.0.0.1:8766/examples/canvas-demo/
# SDK regression tests, from the kit root:
npm test