API

Общая информация по сценариям

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

С помощью них, можно реализовать действительно интерактивные проекты. Например, визуальный квест, викторину, интерактивные демонстрации и пр. 

Сценарии пишутся либо с помощью JavaScript кода, либо если вы не владеете навыками программирования, по "блокам" - с помощью визуального редактора, сценарий складывается мышкой буквально из кирпичиков. С блоками, обычно могут разобраться даже школьники начальных классов. 

ВАЖНО! Сценарии "привязываются" непосредственно к панорамам. В рамках одной панорамы, нельзя запускать сценарии, которые были сделаны для другой панорамы. Однако, между панорамами можно сохранять какие либо состояния или переменные. Например, в сценарии к первой панораме мы сохранили состояние "найдено ключей - 1", а другие панорамы туры должны запускать свои собственные сценарии, которые учитывают это состояние. Звучит сложно, но думаю дальше будет проще.

Как создать сценарий.

Откройте панораму, для которой вам нужно создать сценарий, нажмите "действия" и выберите "Сценарии". Откроется окно, в котором вы можете создавать, редактировать или управлять сценариями. По кнопке "Сценарий по блокам", создается сценарий с визуальным редактором, а по кнопке "Сценарий JavaScript", сценарий, код которого вы пишите самостоятельно используя API (только в Pro тарифе). 

После создания сценария, вы можете дать ему нормальное имя, что важно если этот сценарий вы будете запускать "по клику". Так же, вы можете временно выключить его. А права находится кнопка "редактировать", которая запускает непосредственно редактор для этого сценария, а так же кнопка "удалить". 

Как запускаются сценарии.

Есть два типа сценариев:

Запуск при старте. Сценарий автоматически запускается, когда эта панорама открывается.  Открыться она может как при старте тура, так и при переходе из других панорам. Это бывает полезно, если нужно сделать какие то предварительные приготовления - создать переменные, скрыть или показать какие либо элементы, включить специальную визуальную панель. 

Сделать сценарий именно по клику можно вот так: создайте сценарий и нажмите кнопку "по клику". Она сменится на "При старте" и теперь этот сценарий будет запускаться при старте. В рамках одной панорамы, можно создавать только один стартовый сценарий. Если вы выберите другой, то с остальных уберется эта отметка автоматически.

Запуск по клику. Сценарий запускается, если кликнуть на объект. В качестве объекта для клика, может быть все что угодно что годится для клика - Иконка, Иконка на плоскости, Текст, Полигон и т.д. 

Создать объект для клика очень просто. Сначала создайте сценарий, переименуйте для удобства и убедитесь что на нем стоит ярлык "по клику". 

Теперь в редакторе панорам, при добавлении медиа, в списке медиа появится этот сценарий. Выберите нужный сценарий и настройте внешний вид как для обычного медиа или для перехода. В просмотрщике тура по ссылке, вы можете кликнуть по этой иконке и убедиться что сценарий работает.