La lista de acciones disponibles mediante el protocolo Mobincube son:
Section – Permite abrir una sección nativa de la App.
Call – Permite hacer una llamada telefónica.
Browser – Abre una URL en el navegador externo del teléfono.
SMS – Permite enviar un SMS
Route – Abre el navegador GPS del móvil para llevar al usuario a un destino.
Share – Abre el panel para compartir contenido con otras Apps (social share)
Interstitial – Abre un anuncio de tipo interstitial.
Play – Permite reproducir un archivo local de audio.
Stop – Detiene la reproducción de un archivo local de audio.
Player – Abre el reproductor audio/video por defecto del móvil y permite reproducir streaming desde URLs externas
Track - La acción TRACK permite registrar un evento en la herramienta de análisis que haya activa en cada momento (GoogleAnalytics, CleverTap, Flurry, etc.). Por defecto, si hubiera más de una herramienta activa, se registrará el evento en todas ellas.
A continuación explicaremos que parámetros utiliza cada acción y como usarla. Recordad que es importante codificar la URL para evitar problemas de interpretación: encodeURIComponent() en Javascript.
Section
Propósito: Permite abrir una sección nativa de la App.
Nombre de la acción: section
Parámetros: Nombre de la sección.
Ejemplo URL: mobincube://action/section/contactSection
Call
Propósito: Permite hacer una llamada telefónica.
Nombre de la acción: call
Parámetros: Cadena de texto que contiene el número de teléfono al que llamar
Ejemplo URL: mobincube://action/call/00361346734
Browser
Propósito: Abre una URL en el navegador externo del teléfono.
Nombre de la acción: browser
Parámetros: Cadena de texto con la URL que se tiene que abrir.
Ejemplo URL: mobincube://action/browser/www.mywebpage.com
(recuerda to encodear la dirección correctamente con encondeURIComponent(uri)para eliminar caracteres no admitidos :ejemplo
JS:
var uri = "http://facebook.mywebsite.com";
var res = encodeURIComponent(uri);
HTML:
<a href="mobincube://action/browser/'
+res+
'"> pulsa aqui</a>
SMS
Propósito: Permite rellenar un SMS con el número de teléfono del destino y un texto inicial a completar por el usuario.
Nombre de la acción: sms
Parámetros: una cadena de texto conteniendo en primer lugar el teléfono de destino, seguido de un espacio y el texto que rellenará
Ejemplo URL: mobincube://action/sms/00361346734 Texto de mensaje predefinido
Notas: Esta acción rellena el destino y el cuerpo del SMS pero no lo envía directamente. Requiere que el usuario confirme él envió del SMS
Los parámetros de esta acción tienen que llevar codificación URL para que la App pueda interpretarlos: http://www.w3schools.com/tags/ref_urlencode.asp
Route
Propósito: Abre el navegador GPS del móvil para llevar al usuario a un destino.
Nombre de la acción: route
Parámetros: cadena de texto que contiene la posición GPS del destino y, separado con un espacio, una etiqueta optativa con el formato “<latitud,longitud> [<label>]” como ejemplo “40.449324,-3.692240 Madrid”
Ejemplo URL: mobincube://action/route/40.449324,-3.692240 Madrid
Notas: Los parámetros de esta acción tienen que llevar codificación URL para que la App pueda interpretarlos: http://www.w3schools.com/tags/ref_urlencode.asp
Share
Propósito: Abre el panel para compartir contenido con otras Apps (social share)
Nombre de la acción: share
Parámetros: Una cadena de texto con lo que se quiera compartir
Ejemplo URL: mobincube://action/share/Esto es un texto para compartir
Notas: Imágenes, audios, videos… se tendrán que compartir mediante URL porque la App no tiene acceso al recurso de la web.
Los parámetros de esta acción tienen que llevar codificación URL para que la App pueda interpretarlos: http://www.w3schools.com/tags/ref_urlencode.asp
Interstitial
Propósito: Abre un anuncio de tipo interstitial.
Nombre de la acción:interstitial
Parámetros: Ninguno
Ejemplo URL: mobincube://action/interstitial
Play
Propósito: Permite reproducir un archivo local de audio.
Nombre de la acción: play
Parámetros: Objeto JSON que contiene resource y opciones.
Resource es el ID del recurso audio que se tiene que reproducir.
Como options tenemos loop, para saber si el recurso se tiene que reproducir en bucle (true) o una única vez (false)
Ejemplo JSON:
//reproducirá en bucle el recurso 1234 de tipo audio.
{
"resource": "@audio1234",
"loop": true
}
Nota: Es necesario conocer el ID del audio dentro de la App, dato que aún no ofrecemos en mobincube, por lo que esta funcionalidad aún está un poco limitada
Ejemplo URL: mobincube://action/play/{ "resource": "@audio1234", "loop": true}
Notas: El recurso audio a reproducir tiene que estar ya dentro de la App para que se pueda reproducir mediante el gestor de recursos.
Stop:
Propósito: Detiene y cancela el recurso audio indicado en el parámetro, o en caso de no venir indicado, detiene todas las reproducciones de audio en curso. Nombre de la acción: stop
Parámetros: Objeto JSON que contiene el nombre del recurso o null.
{"resource": "@audio1234”} //Parara el recurso @audio1234
{"resource": null} // Parara todos los recursos audio que se estén reproduciendo
Ejemplo URL: mobincube://action/stop/{ "resource": "@audio1234”}
mobincube://action/stop/{ "resource": null}
Player
Propósito: Abre el reproductor audio/video por defecto del móvil y permite reproducir streaming desde URLs externas
Parámetros: Objeto JSON que indica el resource que contiene el audio. Puede ser una URL para reproducir un streaming, un recurso audio estático en la App o un campo de un visor de datos.
//url de un streaming externo
/http%3A%2F%2Fwww.nasa.gov%2Fmultimedia%2Fnasatv%2FNTV-Public-IPS.m3u8
(cuidado, que he de ir encodeada)
//id recurso estático
{"resource":"@audio1234"}
//id recurso en base de datos
{"resource":"(nombreColumna)"}
Ejemplo URL:
mobincube://action/player/http%3A%2F%2Fwww.nasa.gov%2Fmultimedia%2Fnasatv%2FNTV-Public-IPS.m3u8
mobincube://action/player/{ "resource":"@audio1234”}
mobincube://action/player/{ "resource":"(nombreColumna)"
Track:
La acción TRACK permite registrar un evento en la herramienta de análisis que haya activa en cada momento (GoogleAnalytics, CleverTap, Flurry, etc.). Por defecto, si hubiera más de una herramienta activa, se registrará el evento en todas ellas.
Parámetros:
Esta acción consta de dos parámetros que se pasan a la acción como una cadena de texto separada por comas.
"eventName,eventValue"
Ejemplos:
Click,boton login
Acceso pantalla, Reservas
Ejemplo URL:
mobincube://action/track/click,Boton Login