Передача параметров во flash ролик с помощью FlashVars

Что такое FlashVars?
FlashVars это технология, с помощью которой можно передавать данные из html страницы во флеш-ролик. Данные передаются в виде пары имя/значение.
Так как freeDEXpano может работать с переменными, использование FlashVars значительно расширяет возможности настройки роликов freeDEXpano и интеграции в веб страницы.

Передача переменных из HTML с помощью FlashVars

При встраивании в HTML, из страницы можно создавать или переназначать переменные с помощью FlashVars.
Если переменная с таким именем уже задана в XML, то у нее изменится значение. Если такой переменной еще нет, то будет создана новая переменная с указанным именем.
Таким образом обеспечиваются значения переменных по умолчанию (в XML можно задавать значения по умолчанию, а через FlashVars переназначать их из HTML).

Есть 3 зарезервированных имени переменных, которые передаются через FlashVars и указывая значение которых можно открыть опредленную сцену из определнного файла настроек или загрузить SWF файл со встроенными ресурсами:

swf имя файла swf, который должен быть загружен при смене сцены.
xml имя файла xml, который должен быть использован при смене сцены или первом открытии ролика.
scene имя сцены, которая должна быть отображена при смене сцены или первом открытии ролика.

Использование FlashVars для указания путей к файлам

По умолчания freeDEXpano ищет файл настроек XML с тем же названием, что и файл программы, но с расширением *.xml. В то же время, часто возникает необходимость использовать файл настроек с другим именем или файл расположен в другой директории или даже на другом сайте. С помощью FlashVars легко указать программе, какой именно файл настроек использовать.


Допустим, что наш сайт имеет следующую структуру:



1 - сайт;
2 - страница, в которую встраивается флеш ролик;
3 - папка с изображениями панорам;
4 - папка, где находятся все файлы программы и плагинов freeDEXpano;
5 - файл настроек.


Встроим swf ролик в html страницу с помощью swfobject или любым другим удобным вам способом.
Указываем имя swf файла относительно страницы, в которую мы его встраиваем. В данном случае путь будет следующим: "swf/fdp_2_3_1.swf". Обратите внимание, что имя файла указывается одновременно в двух местах.


Далее начинаем передавать параметры с помощью FlashVars.

Первым укажем путь от страницы до файла настроек. В данном случае путь будет следующим: "xml/settings.xml", а строка FlashVars: "xml=xml/settings.xml". Обратите внимание, что параметр указывается одновременно в двух местах.


Вторым укажем путь к директории, в которой находятся изображения. В данном случае путь будет следующим: "images/office/", а строка FlashVars: "img_path=images/office/". Обратите внимание, что параметр указывается одновременно в двух местах, а переменные разделяются между собой знаком "&".


Третьим укажем путь к директории, в которой находятся плагины. В данном случае путь будет следующим: "swf/", а строка FlashVars "plugs_path=swf/". Обратите внимание, что параметр указывается одновременно в двух местах, а переменные разделяются между собой знаком "&".


Использование переменных переданных с помощью FlashVars

Мы передали в flash ролик 3 переменные: xml, img_path, plugs_path.
Но мало просто передать переменные в ролик, необходимо правильно их использовать. Для этого откроем файл настроек и укажем где использовать заданные нами переменные.


Переменная img_path используется для задания пути к изображениям, поэтому ее мы вставим перед именами изображений панорамы. Получатся подобные строки: 'p_front="${img_path}office_front_p.jpg"'. Это значит, что при воспроизведении ролика будет подставлено значение переменной 'img_path=images/office/' + 'office_front_p.jpg' = 'images/office/office_front_p.jpg'.

Теперь вы в разных директориях можете разместить разные панорамы, но для их воспроизведения использовать один и тот же файл настроек, а путь к нужной панораме указывать только в html с помощью FlashVars.


Переменная plugs_path используется для задания пути к плагинам freeDEXpano, поэтому ее мы вставим перед именами подключаемых плагинов. Получатся подобные строки: 'plugin file="${plugs_path}buttons_default_6.swf"'. Это значит, что при воспроизведении ролика будет подставлено значение переменной 'plugs_path=swf/' + 'buttons_default_6.swf' = 'swf/buttons_default_6.swf'.

Теперь вы можете разместить файл программы freeDEXpano и ее плагины в одном месте и использовать их на любой странице на вашем сайте, задавая пути к ним с помощью FlashVars.


NEED HELP IN TRANSLATION

These pages can be translated from Russian language with help of Google.Translate
But translation can be incorrect.
If you know any language, you can help the author translate this website to your language.

плагины поддержка форум RSS share