API´s Introducción

API´s

 

Las APIS de magma video son un conjunto de funciones que según sus limitaciones de acceso se distingen 2 grupos.

API Privada

Estas son de acceso privado y sólo pueden utilizarse a traves del envío de una llave por medio del HTTP HEADER Authentication. Estas contienen las mismas funciones que la API publica y agrega funciones de control, ingesta de archivos, y estadísticas elavoradas.

API Pública

Son de acceso publico a través de llamados desde un Browser en forma directa. Están limitadas a búsquedas y no incluyen funciones administrativas. Estas APIs permiten crear en forma rápida aplicaciones web, sin necesidad de crear proxies ya que son perfectamente integrables por medio de AJAX.

Estas APIs pueden habitlitarse en el panel de control de magma y permiten realizar control de acceso a través de la verificación del dominio por medio de un HTTP HEADER de respuesta Access-Control-Allow-Origin. Este header debe configurarse usando el portal de administración.

Administración de Roles y Permisos de Usuarios

Administración de Roles y Permisos de Usuarios

 

La plataforma Magma cuenta con distintos tipos de usuarios que cuentan con permisos distintos para realizar determinadas operaciones.

 

Se provee de un Usuario con el Rol de Administrador que cuenta con todas las capacidades permitidas como también de generar otros usuarios de distintos roles.

 

A continuación se listan los permisos para cada Rol:

 

parte1parte2parte3

Ingesta y Watchfolder

La ingesta o inserción de piezas multimedia a la plataforma se realiza a través de dos posibles métodos.

Inserción a través del portal web

A través del portal web se puede insertar varias piezas en forma simultánea. Para ello dirigirse a la sección VOD, ingesta.

Haciendo click en nuevo video, se puede realizar la subida de la pieza de video y la carátula que desee utilizarse.

Screen Shot 2015-02-13 at 10.05.11 AM

Una vez que de completa la Metadata se hace click en subir y comienza la subida.

Screen Shot 2015-02-13 at 10.10.44 AM

En cualquier momento puede cancelarse tanto la subida como el proceso de trascodificación. Para ello debe posarse el puntero del mouse sobre la pieza que se desea cancelar y y se debe hacer click en el botón con forma de X.

Screen Shot 2015-02-13 at 10.13.10 AM

Inserción de WatchFolder

El servicio de FTP Watch Folder permite monitorear carpetas FTP y subir las piezas multimedia que se suban en ellas.

Para configurar este servicio, debe dirigirse a la sección VOD, watchfolder.

Screen Shot 2015-02-13 at 10.17.59 AM

Seleccionar la cuenta desea haciendo click en la cuenta activa (primera linea en negro, para el ejemplo “VOD – 20017”). Completar los datos según el siguiente criterio:

  • HOST: debe ser la ip o el dominio (No utilizar URLs, por ejemplo, está mas usar ftp://…).
  • USERNAME: nombre de usuario de la cuenta de ftp.
  • PASSWORD: password de usuario de la cuenta de ftp.
  • FOLDER: carpeta dentro del ftp donde se encuentran las piezas.
  • RECURSIVO: si se selecciona esta opción, el monitor del watchfolder buscará en subcarpetas hasta 3 niveles.

El watchfolder realiza el monitores de archivos cada 15 minutos.

Home

 

 

La pantalla de Home es la primera que se ve una vez iniciado sesión, está conformada por 6 ítems.

 

sassss

 

 

 

 

 

 

  1. Botón de Magma.Video

El botón de Magma.Video se utiliza para volver a la pantalla de Home y se encuentra en las demás secciones de la plataforma.

  1. Video en vivo

El botón de Video en vivo  te envía a la pantalla del mismo nombre, donde se pueden crear, administrar y distribuir Streamings en vivo.  Ver en el punto 2) Video en Vivo para más detalle.

  1. Video bajo demanda

El botón de Video bajo demanda te envía a la pantalla de Video bajo demanda, donde se puede subir videos, crear listas de reproducción, clasificarlos y distribuirlos. Ver el punto 3) Video bajo demanda para más detalle.

  1. WorkBench

Al ingresar a la pantalla de WorkBench se pueden crear y administrar Video Players a medida. También se pueden actualizar skins, seleccionar players de terceros y otros. Para más detalle ver el punto 4) WorkBench.

  1. Cuenta de Usuario

En este botón usted abre una ventana, en la cual lo posibilita de ingresar datos personales como Nombre, Apellido y Teléfono. También posee la opción de cambiar su contraseña y hay un pequeño enlace en la parte superior derecha para Cerrar la Sesión.

  1. Uso y Configuración

Al abrir la pantalla de Uso y Configuración le permite administrar las cuentas de usuario y de reporte, asimismo también analizar los datos de facturación. Ver el punto 5) Uso y Configuración para más detalle.

 

Monitorear

Al seleccionar el botón Monitorear, se abrirá un menú en el que usted podrá ver una lista con las distintas cuentas. Cada Cuenta está conformada por: Nombre de cuenta, Numero de cuenta, Fecha que fue creada la cuenta y  Concurrencia de usuarios únicos. En la parte superior de la lista de cuentas, se encuentra un buscador y palabras claves, para organizar la lista.

Al hacer click en cualquiera de las cuentas se abre el menú correspondiente a la cuenta, este está conformada por el player del streaming en vivo en la parte central. A la derecha cuadros de texto que indican Usuarios Concurrentes, Usuarios Únicos y Reproducciones Totales. En la parte superior hay un código QR donde el usuario al hacer click es enviado a una nueva página donde puede monitorear el streaming en vivo. Y en la parte inferior todas las estadísticas del Streaming

Monitoreo 1

 

El primer gráfico de estadísticas es el que indica la cantidad de usuarios concurrentes minuto a minuto, en los últimos 20 minutos de Streaming.

monitoreo 2

El segundo gráfico es el de Geo Estadísticas, este indica desde que país están viendo el streaming los usuarios concurrentes. Este gráfico se actualiza cada 5 minutos.

monitoreo 3

El tercer gráfico indica la cantidad de Players con Error que hubo minuto a minuto en los últimos 20 minutos.

monitoreo 4

El cuarto y último gráfico indica la cantidad de players que nunca comenzaron a reproducirse, minuto a minuto en los últimos 20 minutos. Que significa esto, que el player apareció en la página web pero el usuario nunca le dio Play.

monitoreo 5

Administrar

Al igual que la pantalla de Monitoreo, al seleccionar el botón de Administrar, en la parte izquierda de la pantalla se abre la misma lista con todas las cuentas de la plataforma.

Al seleccionar una cuenta se abre un menú en la parte central de la página.

La primera opción que aparece es la de “Opciones”, esta sección cuenta con un menú para distintas acciones:

  • la de “titulo” para insertar un titulo en el player.
  • la de Preload Vast para insertar publicidad al Streaming.
  • la de Preload Skip Time para la cantidad de tiempo que quieres que dure la publicidad.
  • la de Google Analytics ID utilizada para ver las estadísticas del streaming.
  • la de comscore.
  • la de limite de concurrencia que permite poner un tope de usuarios concurrentes.
  • la de limite de volumen que permite poner un volumen máximo.

La Segunda opción que aparece es la de “Filtros”, donde aparecen dos cuadros de texto

  • Filtro por dominios, donde se pueden filtrar los usuarios según su domino
  • Filtro por Región, donde se pueden filtrar los usuarios según su región, para cada región se utilizan letras claves, por ejemplo Brasil = “Br”.

Luego se puede ver un cuadro con información de enconding donde se puede ver los nombres de los servidores y los datos de autenticación si es que los tiene.

Finalmente esta el menú para modificar el código de Iframe del player, como el alto y ancho del player entre otros.

Estadisticas

Al hacer click en el botón de ScreenHunter_60 Sep. 08 08.40, es enviado a una pantalla en blanco donde en la parte superior se lee un cartel que diceScreenHunter_61 Sep. 08 08.41, a la izquierda dos iconos, uno de estadísticas SAS1 y otro de una esfera ss , y  al lado derecho un calendario ScreenHunter_62 Sep. 08 08.43.

Al hacer click en “Seleccione una Publicación” se abre una lista con todas las cuentas de Streaming, selecciona su cuenta, luego elije un día, semana o rango de días (al ser un rango deberá clickear el primer día y luego el ultimo del rango que desea seleccionar), y finalmente elija uno de los dos iconos antes mencionados( las estadisticas o la esfera).

 

Si elije el siguiente icono: ss

 

Asi mismo en este icono encontraremos 2 iconos mas:

  • ScreenHunter_63 Sep. 08 08.49En el cual se puede ver un mapamundi que muestra de que parte del mundo los usuarios vieron el streaming.

Si colocamos el cursor arriba de algún país se vera la cantidad de visitas que tuvo el streaming.

  • ScreenHunter_64 Sep. 08 08.51En el cual podremos ver una tabla con los paises en los cuales se reprodujo el streaming, la cantidad de usuarios unicos y la impresion del mismo.

 

Si elije el siguiente icono:SAS1

Primero podrá ver un Resumen que le indica:

  • Cantidad de Usuarios Únicos
  • Reproducciones Totales
  • Tiempo Promedio de Reproducciones
  • Tiempo acumulado
  • Bitrate Promedio
  • Volumen total de trafico

ScreenHunter_72 Sep. 08 09.24

 

A continuación se ve un gráfico de “Concurrencia”, que muestra la cantidad de reproducciones por cada minuto. Si colocamos el cursor en alguna parte del perímetro del gráfico se vera en un cartel emergente la cantidad el hora, fecha y cantidad de reproducciones en ese momento.

ScreenHunter_65 Sep. 08 08.57

 

 

Seguido de este gráfico tenemos una tabla titulada “Dispositivos”, en la cual encontraremos el porcentaje de teléfonos mobiles, tablets y computadoras que reprodujeron el streaming.

ScreenHunter_66 Sep. 08 09.01

 

Luego, tenemos otra tabla en la cual se detalla el porcentaje de dispositivos mobiles con sistema operativo Android, iOS, WPhone y Rim.

ScreenHunter_67 Sep. 08 09.07

 

 

También hay una tabla seguida de la anterior que nos indica el porcentaje de Computadoras con sistema operativo Windows, Mac OSX, Linux, y otros.

ScreenHunter_68 Sep. 08 09.09

Debajo de estas tablas se encuentra un gráfico de barras en la cual se detalla el porcentaje de reproducciones por día segun la calidad 346Kbps, 596Kbs, 946Kbps, 1396Kbps y 2096Kbps.

ScreenHunter_69 Sep. 08 09.12

 

En el cual, si ponemos el click sobre el gráfico, podremos ver el día, fecha, calidad y porcentaje de reproducción.

ScreenHunter_70 Sep. 08 09.15

 

Y por ultimo un gráfico en el cual se ve la cantidad de cesiones por cantidad de tiempo que estuvo en el player.

ScreenHunter_71 Sep. 08 09.22