Introducción a Media API con ActionScript

Este documento describe los pasos básicos para que pueda empezar a realizar consultas a Media API con ActionScript. En este documento, se presupone que está familiarizado con el lenguaje de programación ActionScript y que conoce las restricciones de seguridad entre dominios que Flash impone a las solicitudes HTTP realizadas con ActionScript. En nuestros servidores, disponemos de un archivo de políticas para habilitar las llamadas entre dominios. Estos son algunos de los documentos que puede consultar antes de continuar:

Mejores prácticas de seguridad. El uso de ActionScript para acceder a Media API conlleva importantes riesgos e inconvenientes. La seguridad del token es el principal. Si un hacker dispone de acceso a su token, puede acceder a su biblioteca de contenido y, en algunas ocasiones, reproducir el contenido sin que lo sepa. En ActionScript, el token se compila en el SWF, pero un hacker podría extraerlo si descompilara su código fuente. Lea este documento de mejores prácticas para la seguridad del token si desea obtener más información.

Mejores prácticas de SEO. Al realizar solicitudes de ActionScript no aprovecha las ventajas de SEO que Media API ofrece para introducir metadatos en sus páginas. Los rastreadores de motores de búsqueda no ejecutan aplicaciones Flash. Consulte este documento de mejores prácticas en SEO con Media API.

Realización de solicitudes y análisis de los resultados

Gracias a la clase LoadVars de ActionScript 2 y a la clase URLLoader de ActionScript 3, la realización de solicitudes HTTP desde Flash es mucho más sencilla. ActionScript gestionará la solicitud, tratará la respuesta y le enviará una notificación cuando los resultados estén listos. A continuación puede ver un ejemplo de AS2:

// crear solicitud
var url:String = "http://api.brightcove.com/services/library?command=find_all_videos
  &video_fields=id,name,referenceId&token=BMkaixIhjbhxfa5ATEGTzXm9CrmR8urXRDr9o7bbc64.";
var lv:LoadVars = new LoadVars();
 
lv.onLoad = function (success:Boolean) {
	// tratar resultados
}
 
lv.load(url);

A continuación puede ver un ejemplo de AS3:

var loader:URLLoader;
var url:String = "http://api.brightcove.com/services/library?command=find_all_videos
  &video_fields=id,name,referenceId&token=BMkaixIhjbhxfa5ATEGTzXm9CrmR8urXRDr9o7bbc64.";
var request:URLRequest = new URLRequest(url);
 
loader = new URLLoader();
loader.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
loader.addEventListener(Event.COMPLETE, loaderCompleteHandler);
 
try {
	loader.load(request);
}
catch (error:SecurityError)
{
	trace("A SecurityError has occurred.");
}
 
function errorHandler(evt:Event) {
     // analizar resultados
}
function loaderCompleteHandler(evt:Event) {
	// analizar resultados
}

Observe cómo llamamos al método de Media API en ambos casos. El formato de la llamada a método de lectura es:

<URL>?command=<method_name>&<arguments>=<values>&token=<API_token>

La dirección URL de todas las llamadas a la API Media Read de Brightcove es http://api.brightcove.com/services/library. La dirección URL de todas las llamadas a la API Media Write de Brightcove es http://api.brightcove.com/services/post. En este ejemplo, el método es find_all_videos. En los parámetros de la consulta, pasamos el argumento video_fields, que indica a find_all_videos el valor del token de la API y qué campos queremos en el objeto devuelto.

Análisis de los resultados

ActionScript 3 no tiene soporte nativo para JSON. La biblioteca as3core, que se puede descargar en GitHub, ofrece un método bastante estandarizado para tratar JSON. Consulte Acceso a Media API desde Flex en AS3 para obtener un ejemplo que utilice as3corelib.