
Si su tour virtual ha sido preparado para ser incorporado a una página web, es necesario tener en cuenta que en su utilización intervienen dos entornos: el cliente y el servidor.
El cliente o "agente de usuario" es el dispositivo encargado de interpretar el tour virtual y presentarlo en forma visible al usuario final. Normalmente el cliente es un programa "navegador" (o "browser", por ejemplo, Internet Explorer, Mozilla Firefox, Opera, Apple Safari, Google Chrome, etc) que se ejecuta en el ordenador del usuario.
El servidor es el dispositivo encargado de almacenar el tour virtual y entregárselo al cliente cuando éste se lo solicite a través del canal adecuado, siguiendo un protocolo preestablecido. Normalmente el servidor es un programa "servidor de web" (por ejemplo, Apache, Microsoft Internet Information Server, etc) que se ejecuta como servicio en un ordenador remoto al cual se tiene acceso a través de Internet mediante el protocolo HTTP; no obstante, a veces el servidor también puede ser el sistema de archivos local del propio cliente, en cuyo caso la comunicación entre cliente y servidor no necesita de acceso a la red, posibilitando así la distribución de copias del tour virtual a usuarios finales en cualquier soporte de almacenamiento.
Requisitos del cliente:
Para la correcta visualización del tour virtual se deben cumplir ciertos requisitos en el ordenador donde lo vayamos a visualizar (ordenador del usuario final):
1) Disponer de un navegador actualizado, tal como Internet Explorer o Mozilla Firefox en una versión reciente.
2) El navegador debe tener habilitado el soporte para el lenguaje Javascript. Normalmente, todos los navegadores tienen dicho soporte en su configuración por defecto ("de fábrica"), pero dicho soporte podría haber sido deshabilitado por el usuario en las opciones del navegador, o estar bloqueado por algún software de seguridad tal como un antivirus, antiespías, filtro de privacidad, etc.
3) El navegador debe tener soporte para Adobe Flash Player, versión 9.0.28 o superior. Dicho soporte puede obtenerse gratuitamente en http://www.adobe.com/go/getflashplayer y es necesario para multitud de aplicaciones, por ejemplo, juegos en línea, álbumes de fotos digitales, videos de YouTube, etc. El soporte es independiente para cada navegador, por tanto, si se tienen varios navegadores en el ordenador, debe descargarse el complemento ("add-on" o "plugin") de Flash Player para cada uno de ellos. Si el tour virtual no puede verse, lo primero que hay que hacer es asegurarse de que el complemento de Flash Player está actualizado a la versión más reciente.
En ibizavirtualtours.com disponemos de una página de diagnóstico que puede serle de utilidad para verificar si el cliente cumple los requisitos. Para ello, visite la dirección http://ibizavirtualtours.com/9/2/diag.html desde el ordenador del usuario final.
Requisitos del servidor:
En el sistema de archivos del servidor se dedicará una carpeta, que inicialmente
deberá estar vacía, para almacenar el tour virtual. Si se tienen varios tours, es importante que
no se guarden compartiendo la misma carpeta, para evitar sobreescribir archivos de un tour con
archivos de otro. El requisito principal es que los varios archivos y carpetas que componen el
tour virtual se encuentren almacenados siguiendo cierta estructura, que se describe a continuación.
Supongamos que el tour ha recibido el nombre "NOMBRETOUR".
Contenido de la carpeta del tour virtual:
- Archivos:
• swfobject.js
• twviewer.swf
• config_NOMBRETOUR.bin
• images_NOMBRETOUR.zip
• resources_NOMBRETOUR.zip
- Subcarpetas:
• map
• resources
• scene
• sounds
Todos los archivos y subcarpetas del tour virtual preparado que nosotros le entregamos
se encuentran empaquetados en un archivo comprimido de tipo .ZIP cuyo contenido ya está organizado
respetando la mencionada estructura. Por tanto, es suficiente con descomprimir ese archivo .ZIP en
la carpeta vacía que se ha reservado.
Después, el administrador y/o el diseñador de su sitio web tendrán
que hacer algo de trabajo creando una página en la que integrar el tour. Para ello, pueden basarse en
el archivo .HTML de ejemplo que le entregamos con el tour.
Instrucciones para el diseñador web
Lo que sigue son instrucciones detalladas para el diseñador de su sitio web acerca de cómo crear una página en la cual el tour virtual esté integrado:
1) Mover los archivos y carpetas necesarios a una carpeta vacía, que denominaremos "carpeta del tour virtual".
Dichos archivos y carpetas necesarios son los detallados más arriba en esta misma página. Los únicos archivos
que pueden moverse a otro lugar son twviewer.swf y swfobject.js, en cuyo caso el código fuente
de la página web deberá adaptarse reflejando esta modificación.
2) En un lugar apropiado del código HTML de la página (normalmente en la sección
delimitada por <HEAD> ... </HEAD>), insertar el siguiente código:
<script type="text/javascript" src="swfobject.js"></script>
El script swfobject.js es código abierto gratuito cuya misión es facilitar la integración y gestión de objetos de
Adobe Flash en páginas web en general. Estas instrucciones se ajustan a la documentación de swfobject v. 1.5 que se pueden
encontrar en http://blog.deconcept.com/swfobject/
Si el archivo swfobject.js no está en la misma carpeta que la página web, en este paso debe adaptarse el atributo
src del elemento <script> precediendo swfobject.js con la ruta relativa correspondiente.
3) En el lugar del código HTML correspondiente a la posición en la página donde
queremos que se muestre el tour virtual, insertar:
<div id="flashcontent">
Para poder ver correctamente el tour virtual, se necesita Flash Player versión 9.0.28 o superior.
Por favor, descargue la versión más reciente de
<a href="http://www.adobe.com/go/getflashplayer" target="_blank">Flash Player
</a> e instálela en su ordenador.
</div>
<script type="text/javascript">
var so = new SWFObject("twviewer.swf", "sotester", "960", "640", "9.0.28", "#FFFFFF");
so.addParam("allowNetworking", "all");
so.addParam("allowScriptAccess", "always");
so.addParam("allowFullScreen", "true");
so.addParam("scale", "noscale");
so.addVariable("base", "");
so.addVariable("lwImg", "");
so.addVariable("lwBgColor", "255,255,255,255");
so.addVariable("lwBarBgColor", "255,0,0,0");
so.addVariable("lwBarColor", "255,0,255,0");
so.addVariable("lwBarBounds", "0,0,960,640");
so.addVariable("lwlocation", "0");
so.addVariable("lwShowLoadingPercent", "true");
so.addVariable("lwTextColor", "255,255,255,255");
so.addVariable("iniFile", "config_NOMBRETOUR.bin");
so.addVariable("progressType", "1");
so.addVariable("swfFile", "resources/NOMBRETOURMIN_IbizaVirtualTours_logo_animado.swf");
so.addVariable("href", location.href);
so.write("flashcontent");
</script>
Donde NOMBRETOUR debe reemplazarse por el nombre del tour virtual.
Por ejemplo, si el tour virtual tiene por nombre "Campo_Y_Playa", entonces
la línea anterior correspondiente sería:
so.addVariable("iniFile", "config_Campo_Y_Playa.bin");
y NOMBRETOURMIN es el nombre del tour en minúsculas, o sea, en el
mismo ejemplo:
so.addVariable("swfFile", "resources/campo_y_playa_IbizaVirtualTours_logo_animado.swf");
Si el archivo twviewer.swf no está en la misma carpeta que la página web, en este paso deben precederse las referencias al mismo
con la ruta relativa correspondiente.
Nota importante: El código Javascript que se ha descrito es compatible solamente con el script swfobject.js
que nosotros entregamos junto con el tour virtual (swfobject v. 1.5).
Existen versiones más recientes de swfobject que pueden descargarse a través de Internet y
es perfectamente posible utilizarlas con nuestros tours virtuales, sin embargo, el código aquí expuesto debe modificarse
para que sea compatible. Por ejemplo, el código siguiente es compatible con swfobject v. 2.x:
<div id="flashcontent">
Para poder ver correctamente el tour virtual, se necesita Flash Player versión 9.0.28 o superior.
Por favor, descargue la versión más reciente de
<a href="http://www.adobe.com/go/getflashplayer" target="_blank">Flash Player
</a> e instálela en su ordenador.
</div>
<script type="text/javascript">
var flashvars = {
base: "",
iniFile: "config_NOMBRETOUR.bin",
swfFile: "resources/NOMBRETOURMIN_IbizaVirtualTours_logo_animado.swf",
progressType: "1",
lwBgColor: "255,255,255,255",
lwImg: "",
lwBarBgColor: "255,0,0,0",
lwBarColor: "255,0,255,0",
lwBarBounds: "0,0,960,640",
lwlocation: "0",
lwShowLoadingPercent: "true",
lwTextColor: "255,255,255,255",
href: location.href
};
var params = {
allowNetworking: "all",
allowScriptAccess: "always",
allowFullScreen: "true",
scale: "noscale",
bgcolor: "#FFFFFF"
};
var attributes = {
id: "VirtualTour",
name: "VirtualTour"
};
swfobject.embedSWF("twviewer.swf", "flashcontent", "960", "640", "9.0.28", null, flashvars, params, attributes);
</script>
Nuestros tours se diseñan normalmente para enmarcarse en una caja de 960x640 pixels
dentro de la página web (de ahí los valores 960 y 640 que aparecen en el código de más arriba).
Junto con el tour suministramos algunos archivos .HTML de ejemplo que
pueden utilizarse para visualizar el tour directamente desde el sistema de archivos del cliente,
y examinando el código fuente, que es muy simple, para comprender cómo integrarlos en una página
web cualquiera.
Personalización
Todo lo que ocurre durante la reproducción del tour virtual está regido por el archivo
encriptado config_NOMBRETOUR.bin, el cual puede ser interpretado solamente por la aplicación de Adobe
Flash twviewer.swf. La modificación directa del archivo config_NOMBRETOUR.bin no es posible, tan solo
se puede volver a generar a partir del proyecto fuente modificado, y para ello es necesario que se ponga
en contacto con nosotros, ya que nuestra empresa se reserva todos los derechos sobre las fuentes de
los tours virtuales. Igualmente están encriptadas las fotografías de alta resolución que se encuentran
en la carpeta scene y por tanto éstas tampoco se pueden modificar ni sustituir por otras.
No obstante, sí es posible personalizar sin demasiado esfuerzo algunas cosas:
1) Parámetros de SWFObject:
Con la versión 1.5 de la librería swfobject.js, en la línea
var so = new SWFObject("URL_VISOR", "sotester", "960", "640", "9.0.28", "#FFFFFF");
o bien, con la versión 2.x de dicha librería, en la línea
swfobject.embedSWF("URL_VISOR", "flashcontent", "960", "640", "9.0.28", null, flashvars, params, attributes);
se puede personalizar el siguiente parámetros:
• "URL_VISOR": URL relativa del archivo visor de tours virtuales
(twviewer.swf) con respecto a la página web actual. Normalmente su valor será "twviewer.swf", a menos que
se haya movido dicho archivo a otra carpeta, en cuyo caso se adaptará el valor a la nueva ubicación, y también se establecerá la variable base (ver
más abajo) para que refleje la ruta relativa de la carpeta del tour virtual con respecto a la nueva ubicación de twviewer.swf.
2) Variables aceptadas por el visor de tours virtuales twviewer.swf:
Estas variables se pasan a twviewer.swf mediante las instrucciones so.addVariable("VARIABLE", "VALOR") con swfobject 1.5
o como propiedades del objeto flashwars con swfobject 2.x, según los ejemplos del apartado 3 de la sección "Instrucciones para el diseñador web".
• base: URL relativa de la carpeta del tour virtual con respecto a la URL del
archivo twviewer.swf. Combinando esta variable apropiadamente con el parámetro URL_VISOR mencionado más arriba, se puede tener el
archivo twviewer.swf en una carpeta distinta de la del tour virtual, y por tanto, es posible tener una sola
copia de dicho archivo, compartida por todos los tours virtuales que haya en el sitio web.
Las variables descritas a continuación afectan todas a la "pantalla de carga" que se presenta al usuario hasta que se hayan descargado los archivos necesarios para comenzar a visualizar el tour virtual.
• lwImg: URL de un archivo de imagen (tipo .jpg, .gif, ...) o animación (.swf) de fondo
para la pantalla de carga.
• lwBgColor: Color(*) de fondo de la pantalla de carga.
• lwBarBounds: Posición y tamaño del indicador de progreso de carga, expresado como "POS_X,POS_Y,ANCHO,ALTO", en pixels.
El indicador puede ser una barra estándar (pre-integrada en el software) o una animación de Adobe Flash.
• progressType: Tipo de indicador de progreso de carga. Los posibles valores son:
"0": El indicador es una barra de progreso estándar.
"1": El indicador es una animación de Adobe Flash especificada por swfFile.
• swfFile: URL de la animación indicadora de progreso de carga. Puede dejarse en blanco con progressType
establecido en "1" si no se desea ningún indicador.
Las siguientes cuatro variables solamente tienen aplicación cuando progressType toma el valor "0":
• lwBarBgColor: Color(*) de fondo de la barra de progreso estándar.
• lwBarColor: Color(*) de primer plano de la barra de progreso estándar.
• lwShowLoadingPercent: Establece si, en la barra de progreso estándar, se mostrará un texto indicando el porcentaje de carga
completado hasta el momento. El texto mostrado sería "Loading 100%" (o el porcentaje que corresponda). La palabra Loading
está pre-programada y no puede cambiarse. Los posibles valores son:
"false": No se mostrará el texto.
"true": El texto se mostrará.
• lwTextColor: Color(*), en la barra de progreso estándar, del texto indicador del porcentaje de carga.
(*) Los colores en estas variables se expresan en formato decimal separado por comas, transparencia+RGB, con valores entre 0 y 255. Por ejemplo,
"255,0,0,0" es negro opaco, "127,255,255,255" es blanco semitransparente.
(Información actualizada el 29/08/2010)
Inicio
| Contacto
Creación de visitas virtuales 360° | www.IbizaVirtualTours.com
Llámenos y le informaremos
Tel 971 80 40 76