Skype URI Tutorial - Web Pages y Referencia API

Skype URI tutorial: Las páginas web Aprenda cómo incorporar funcionalidad de comunicación de Skype en sus páginas web. Última modificación: 02 de junio 2014 Se aplica a: Skype En este articulo Usar Skype URI en páginas web ¿Cómo puedo determinar si se ha instalado un cliente de Skype? Qué hacer si no está instalado un cliente de Skype Recursos adicionales

Usar Skype URI en páginas web  

Skype ofrece dos maneras para usar Skype URI en tus páginas web: Skype Botones Función Skype.ui JavaScript Cada uno de estos enfoques determina, además, si se instala un cliente de Skype, y toma la acción apropiada. Por supuesto, porque el uso de un URI de Skype en una página web no es realmente diferente de utilizar cualquier otro hipervínculo, siempre puede establecer el valor del atributo href de su etiqueta de anclaje a la URI de Skype. Por ejemplo: Llame el Echo / Sound Servicio de prueba de Skype Sin embargo, su página web debe determinar si se ha instalado un cliente de Skype, y tomar las medidas adecuadas si no lo es.

Skype Botones Botones de Skype le proporcionará un bloque generado de HTML que tiene un URI de Skype en su núcleo. Si todo lo que quiero hacer es tener la gente llama o chatear con ustedes a través de Skype, a continuación, sólo tiene que utilizar el formulario para especificar el tipo de botón que desee, y pegue el fragmento de código en su página web. Botones de Skype intentarán determinar si se ha instalado un cliente de Skype, y tomar las medidas apropiadas según sea necesario. Si va a añadir múltiples botones de Skype a su página web: 1. Retire la siguiente línea de todo pero la primera instancia:

2.

Modificar atributo id del elemento div y la propiedad elemento para que cada instancia tiene hacer juego valores únicos en su página web. Por ejemplo: SkypeButton_Call_ # echo123_01, SkypeButton_Call_ # echo123_02

Función Skype.ui JavaScript

  

La función Skype.ui JavaScript permite incrustar dinámicamente URI de Skype que tienen una apariencia predefinida y la interfaz de usuario similar a los botones de Skype, pero ofrece opciones de formato adicionales y funcionalidades, tales como tamaño de punto, color, video, llamadas de conferencia, y multichats.Skype. ui intentará determinar si se ha instalado un cliente de Skype, y tomar las medidas apropiadas según sea necesario. El patrón de diseño básico para añadir Skype URI para sus páginas web implica: Importación del skype-uri.js archivo desde http://www.skypeassets.com/i/scom/js/ en su página web. El uso de una etiqueta div para marcar en la que desea colocar el URI Skype en tu página web. La invocación de la función de generador, Skype.ui, para crear y añadir un elemento de anclaje, en base a una representación JSON del objeto de Skype, y añadirlo a tu página web. Por ejemplo, la siguiente figura muestra un fragmento de código que agrega un URI Skype que inicia una llamada de audio a la Echo / Sound Servicio de prueba de Skype: Figura 1. ejemplo de código JavaScript

Nota

Los objetos JavaScript y funciones contenidas en skype-uri.js están cubiertos por la licencia de Apache, Ve enhttp://www.apache.org/licenses/. Activos Image

  

Embedded botones de uso de Skype URI para cambiar el enfoque al cliente de Skype, a partir de una llamada, y la puesta en marcha o reunirse con una charla.Enlace asociado del botón incluye una etiqueta img src quién es atributo especifica el activo imagen correspondiente. Las relaciones botón / imagen activos actuales son: Focus Shift Llamada de audio o vídeo Charla Tamaños compatibles (en píxeles) son 10, 12, 14, 16, 24 y 32. Los colores admitidos son azul Skype y blanco, tanto en fondos transparentes. El Skype objeto por defecto usando 16 píxeles, imágenes azules de Skype. Usted puede cambiar el tamaño, el color, o los dos al incluir el de imagen y / o propiedades imageColor. Por ejemplo, el siguiente código incorpora una "llamada" Skype URI que utiliza el 32 píxeles, activo imagen en blanco: HTML

Skype.ui ({ nombre: "llamar", elemento: "call_32", participantes: ["echo123"], de imagen: 32, imageColor: "blanco" });

Inserción de la URI de Skype

La función Skype.ui genera y se incrusta un enlace Skype URI en su página web. La función acepta un solo argumento de una instancia de un objeto de Skype, que se especifica el uso de JSON. En caso de éxito, la función devuelve cierto. En caso de fallo, la función devuelve falso. El objeto de Skype reconoce las propiedades que figuran en la Tabla 1. A menos que se indique lo contrario, los valores nulos y la cadena vacía son equivalentes a la omisión de la propiedad. Para una útil tabla que detalla las combinaciones de valores de propiedad asociados a los diferentes tipos de Skype URI, consulte la referencia rápida Skype.ui. Tabla 1. Propiedades de que el objeto de Skype reconoce

Propiedad

Descripción

nombre

El nombre de la URI de Skype. Actualmente los valores reconocidos son: llamar - Realizar una llamada de audio o vídeo. chatear - Iniciar / reiniciar una charla. desplegable - dinámicamente elegir si desea realizar una llamada o iniciar / re Si se omite, "llamada de audio" se da a entender si no se especifica ninguno de los partic Skype" se da a entender si no se especifican los participantes.

elemento

El valor del atributo id del elemento que contendrá el enlace Skype URI generado (n Siempre es necesario.

participantes

Una serie de uno o más nombres de Skype (o números de teléfono) que son el objetivo u Requerido si el nombre se especifica como llamada o el chat. No hay un límite pred tenga en cuenta que las llamadas de video de grupo se limitan actualmente a un máximo Los participantes también están opcionalmente en forma de lista separada por comas, inm Ver referencia de la API de Skype URI para advertencias específicas de la platafo participantes; por ejemplo, los clientes de Skype móviles (iOS y Android) no son compat conferencia.

listParticipants:  

vídeo  

Ya sea a la lista del participante Nombres de Skype y / o números de teléfono de inmedia valores son: verdad - una lista de los participantes. falsa (o cualquier valor que no sea cierto) - No liste los participantes. El valor predeterminado es falso. Ignorados si no hay participantes para mostrar.

Si esto es una llamada de video. Los valores son: verdad - Videollamada. falsa (o cualquier valor que no sea cierto) - llamada de audio. El valor predeterminado es falso. Se ignora si este URI Skype no es una llamada explíc especifica como distinta de llamada o desplegable.

tema

La cadena de tema opcional para una llamada de conferencia, grupo de chat de vídeo, o m espacios de valor en concreto, dos puntos y barras inclinadas, se escaparon de forma adic Por ejemplo: tema: "Mecánica Cuántica 401 (habitación: 7; 02/17/2012)" es escapó automáticamente para producir: Quantum% 20Mechanics% 20 401% 20 (Habitación% 3A% 207;% 2.00 Se ignora si hay menos de dos participantes, o si este URI Skype no es una llamada explí se especifica como distinta de llamada, el chat, o desplegable. Al igual que los participantes, la cadena tema está también opcionalmente incluye como generado.

listTopic

 

Ya sea a la lista de la cadena de tema inmediatamente después del enlace generado. Los v cierto - Liste la cadena de tema. falsa (o cualquier valor que no sea cierto) - No liste la cadena de tema. El valor predeterminado es falso. Ignorada si no hay una cadena de tema a la lista.

 

¿Qué tamaño del activo de imagen para su uso. Los valores son: Omitido, null, una cadena vacía, o un tamaño no compatible - Utilice el tamaño 999 - Utilice el tamaño especificado, que debe ser uno de los tamaños admitidos El tamaño por defecto es de 16 píxeles.

  

¿Qué texto variante de color del activo imagen a utilizar, en función de los antecedentes omitido, null, una cadena vacía, o un color no compatible - Utilizar el color pre skype - Utilice la variante azul Skype. blanco - Usar la variante blanco. El color por defecto es azul Skype.

tamaño de la imagen

imageColor

Skype.ui referencia rápida

Esta referencia rápida detalla los valores de la propiedad objeto de Skype que necesita para pasar a Skype.ui el fin de generar los distintos tipos de Skype URI.

Porque siempre se requiere el elemento (y listParticipants, listTopic, de imagen y imageColor son siempre opcional), no se incluyen en la tabla. 2. Skype valores de las propiedades de objeto de tabla

Skype URI

nombre

Cambiar el enfoque al cliente de Skype

  

Audio de llamada de diálogo

    

Audio de llamada de conferencia     

omitido nulo cadena vacía

participantes   

omitido nulo cadena vacía

llamada desplegable (seleccione Llamar) omitido nulo cadena vacía

Exactamente un

llamada desplegable (seleccione Llamar) omitido nulo cadena vacía

Mínimo de dos

Vídeo llamada de diálogo

 

llamada desplegable (seleccione Llamar)

Exactamente un

Videollamada en grupo (GVC)

 

llamada desplegable (seleccione Llamar)

Mínimo de dos (actualmen diez)

Chat en-diálogo

 

charla desplegable (seleccione Llamar)

Exactamente un

Multi-Chat

 

charla desplegable (seleccione Llamar)

Mínimo de dos

¿Cómo puedo determinar si se ha instalado un cliente de Skype? Para las páginas web que se ejecuta en los navegadores, para determinar si un cliente de Skype está disponible varía de automático a compleja y poco

fiable.Algunos navegadores en algunas plataformas simplemente interceptan el fracaso de navegación, por lo que es difícil, si no imposible, que su código para recuperarse del error percibido. Para las versiones a partir de: Internet Explorer 10 que se ejecuta en Windows 8, el navegador detecta que no hay ninguna aplicación asociada con el skype:esquema, y alerta al usuario. Figura 2. cuadro de diálogo de Windows Store

  

Para la mayoría de los navegadores principales que se ejecuta en la mayoría de las plataformas, los botones de Skype y la función Skype.ui detectar que el cliente de Skype no está instalado, y redirigir al usuario a la específica de la plataforma de cliente de Skype página de descarga en skype.com. Otras combinaciones de navegador / plataforma podrían pedirá que seleccione una aplicación, e incluso podría enumerar Skype, pero fallará en silencio incluso si decide Skype. Todavía otras combinaciones de navegador / plataforma podrían comportan como si se ha instalado el cliente de Skype cuando no lo es, o simplemente fallan en silencio. En la actualidad, las siguientes combinaciones de navegador / plataforma no detectan correctamente si está instalado el cliente de Skype: Cualquier navegador que se ejecuta en Windows Phone 8 Google Chrome se ejecuta en Android (Gingerbread, Honeycomb, Ice Cream Sandwich y Jelly Bean) Nativo navegador de Android (icono de "globo") que se ejecuta en Android (Gingerbread, Honeycomb, Ice Cream Sandwich y Jelly Bean)

Qué hacer si no está instalado un cliente de Skype Versiones de navegador que comienzan con Internet Explorer 10 que se ejecuta en Windows 8 incluyen un enlace a la tienda como parte de su alerta cada vez que detecta que ninguna aplicación está asociada con el skype: esquema. Simplemente haga clic en el icono de la tienda para ir a la entrada del cliente de Skype. Figura cuadro de diálogo 3. Windows Store

Para la mayoría de los navegadores principales que se ejecuta en la mayoría de las plataformas, los botones de Skype y la función Skype.ui redirigir automáticamente al usuario de la plataforma específica del cliente de Skype página de descarga en skype.com cada vez que detecta que ningún cliente de Skype está instalado. Para todas las demás combinaciones -específicamente navegador / plataforma Windows Phone 8 y Android plataformas usted podría considerar la inclusión de una entrada de nota o FAQ alertar a los usuarios que el hecho de que deben tener un cliente de Skype instalado en su dispositivo móvil, portátil o de escritorio.También puede considerar la inclusión de un enlace en la Plataforma de dispositivo móvil o el específico de la plataforma de cliente de Skype página de descargapágina de descarga en skype.com.

Referencia de la API de Skype URI Aprende a usar Skype URI para agregar funcionalidad de Skype a sus aplicaciones de cliente. Última modificación: 19 de marzo 2015 Se aplica a: Skype En este articulo API de Skype URI soportados Start / enfoque cambie al cliente de Skype Llamadas de audio Chats Recursos adicionales Esta referencia de la API detalla la funcionalidad, las opciones y la sintaxis de cada Skype URI compatible. Utilice esta referencia si usted está interesado en la creación de aplicaciones para Windows, Android y iOS plataformas y dispositivos móviles, o la creación de correos electrónicos habilitados URI Skype o bloques de firma. Si usted está interesado en la creación de páginas web habilitados para Skype URI, consulte la función Skype.ui JavaScript.

API de Skype URI soportados URI de Skype soportados actualmente incluyen:  



El cambio de enfoque al cliente de Skype. Iniciando llamadas de audio a otros usuarios de Skype, teléfonos o dispositivos móviles, tanto de uno a uno los diálogos y conferencias multipartidistas. Iniciando llamadas de video a otro usuario de Skype.



El envío de mensajes instantáneos a un individuo o el establecimiento de un multichat grupo.

Start / enfoque cambie al cliente de Skype Efecto 

Si el cliente de Skype no se está ejecutando, se inicia el cliente de Skype, y cambia el foco a la ventana principal de Skype.



Si el cliente de Skype ya está en ejecución-interruptores se centran en el cliente de Skype.



Si el cliente de Skype ya está en marcha y tiene el actual enfoque ningún efecto; el cliente de Skype conserva enfocar.



Si la URI Skype inicia el cliente de Skype, el enfoque se ajusta a la ventana principal del cliente de Skype (auto-login está habilitado), o para su inscripción en el cuadro de diálogo (auto-login no está habilitado). Si el cliente de Skype ya está en ejecución, el foco se establece en la ventana principal de Skype, incluso si un cuadro de diálogo cliente de Skype, tales como el cuadro de diálogo Herramientas> Opciones, está abierta. Sintaxis skype: Ejemplo skype: Advertencias En iOS, este URI Skype no sólo cambia el enfoque al cliente de Skype, pero también intenta iniciar una llamada.

Llamadas de audio Apoyo Skype URI relacionada con llamar a uno-a-uno diálogos, conferencias telefónicas y videollamadas. Por defecto, iniciar una llamada de resultados en el cliente de Skype local de mostrar un diálogo de confirmación antes de continuar con la llamada. En ese diálogo, el usuario puede optar por no mostrar la confirmación en el futuro.

Si su llamada especifica múltiples participantes, las identidades de Skype individuales Nombres o números de teléfono-se deben separar con punto y coma; por ejemplo: participant1; participant2; participant3

Llamada implícita Audio Efecto Llamadas de otras personas en Skype, teléfonos o dispositivos móviles Esta es una versión implícita del skype:? ParticipantList llame Skype URI. A diferencia de la versión explícita, no se puede suministrar vídeo o conferencia tema argumentos -como adicional -con el comando. Por lo tanto, el valor implícito del argumento video es falso (llamada de audio), y el valor implícito del argumento tema es nulo / ninguno especificado. Sintaxis skype: participant1 [; participant2; ... participant9] Ejemplo: Uno a uno de diálogo skype: skype.test.user.1 Ejemplo: Conferencia skype: skype.test.user.1; skype.test.user.2; skype.test.user.3 Advertencias Clientes móviles de Skype (iOS y Android) no son compatibles con el inicio / hosting llamadas de conferencia.

Llamada explícita Audio Efecto Las llamadas a otros usuarios de Skype, teléfonos o dispositivos móviles Esta versión explícita del comando que permite suministrar tema de la conferenciaargumentos -como adicional -con el comando. El argumento tema de la conferencia (tema) le permite especificar una cadena para participantes de la llamada para mostrar como el tema de conversación en

lugar de los nombres de Skype o números de teléfono de los participantes de la llamada originador / conferencias. Debes escapar ciertos caracteres especiales, como espacios en blanco. Por ejemplo, especifique: Mi Conferencia Tema como: Mi% 20Conference% 20Topic De lo contrario, el cliente de Skype interpretará el valor del argumento tópico como Mi, y las siguientes palabras podría causar argumentos posteriores a ser ignorados o malinterpretados lo contrario. Mientras que su URI Skype puede especificar vídeo = false para indicar específicamente una llamada de audio, la práctica común es simplemente omite el argumento. Ver llamada implícita Audio y Videollamada. Sintaxis skype:? participant1 [; participant2; ... participant9] llamar [& topic = topicString] Ejemplo: Uno a uno de diálogo llamada skype.test.user.1: Skype? Ejemplo: Conferencia, ningún tema llamada skype.test.user.3; skype.test.user.1; skype.test.user.2: Skype? Ejemplo: Conferencia, fijando el tema skype:? skype.test.user.1; skype.test.user.2; 16505550123 llame & topic = Geek% 20Conspiracy Advertencias 

El argumento tema opcional se aplica a las llamadas de conferencia solamente.



Caracteres especiales en el argumento tema opcional valor específicamente por espacios en blanco deben escaparon.



Clientes móviles de Skype (iOS y Android) no son compatibles con el inicio / hosting llamadas de conferencia.

Videollamada Efecto Las llamadas a otros usuarios de Skype, y automáticamente se enciende la alimentación de vídeo del originador de la llamada (si una webcam local está disponible). Sintaxis skype: participant1 [; participant2; ... participant9] llamar y video = true? Ejemplo: Uno a uno de diálogo skype:? skype.test.user.1 llamar y video = true Ejemplo: Conferencia skype:? skype.test.user.1; skype.test.user.2; skype.test.user.3 llamar y video = true Advertencias 

Especificación de varios participantes se traduce en una videollamada grupal. o

El número de participantes está limitado a diez, con un máximo recomendado de cinco para la mejor calidad de la llamada.



Los clientes móviles de Skype (iOS y Android) no son compatibles con el inicio / hosting videollamadas grupales.



Actualmente, los participantes en los dispositivos móviles pueden unirse a las llamadas de video de grupo vía única voz.

Chats Charla-relacionado Skype URI apoyar ambos diálogos uno a uno y chats en grupo. Si tu chat especifica múltiples participantes, las identidades de Skype individuales Nombres de sólo deben ser separados por punto y coma; por ejemplo:

participant1; participant2; participant3 Si ya existe una conversación con el mismo participante o participantes, el cliente de Skype o clientes abren la conversación existente. Si el tema de una conversación existente difiere de la especificada por el URI Skype, el cliente Skype cambia el tema de conversación al nuevo valor.

Abrir / crear el chat Efecto Abre la conversación que coincide con la lista especificada de los participantes, o crea una nueva charla con los participantes si no existe ninguna conversación a juego. Para conversaciones existentes, el valor del argumento opcional tema especificado sustituye el nombre o nombres de conversación existente y la cadena de título. Sintaxis skype:? participant1 [; participant2; ... participant9] charlar [& topic = topicString] Ejemplo: diálogo skype:? skype.test.user.1 el chat Ejemplo: multichat; estableciendo el tema skype:? skype.test.user.1; skype.test.user.2 chatear & topic = Quantum% 20Mechanics% 20101 Advertencias  

El argumento tema opcional sólo se aplica a multichats. Caracteres especiales en el argumento tópico valor específicamente por espacios en blanco deben escaparon.



Mac OS X ignora cualquier argumento tema.



iOS no es compatible.



Android sólo reconoce el participante inicial; multichats no son compatibles.