App Cloud
- Overview and general topics
- Product Updates
- Glossary
- The App Cloud SDK
- Creating an app template
- Tutorials
- Content optimization
- Development tips and best practices
- Packaging a template
- Creating apps from a template
- Publishing an app
- Delivering ads
- Push Notifications
- Analytics
- Managing users and accounts
Player Debugger
Media API: Introducción al uso de JavaScript
Este documento describe los pasos básicos para empezar a realizar consultas a Media API con JavaScript. En este documento, se presupone que está familiarizado con el lenguaje de programación JavaScript y que conoce las restricciones de seguridad entre dominios que Flash impone a las solicitudes HTTP realizadas con JavaScript. Estos son algunos de los documentos que puede consultar antes de continuar:
- Acerca del objeto XMLHttp
- Problemas de seguridad entre dominios con el objeto XDMLHttp (XML.com)
- Realización de solicitudes entre dominios con las etiquetas de script dinámicas (XML.com)
Mejores prácticas
El uso de JavaScript 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 JavaScript, el token se encuentra en texto sin formato en la fuente de JavaScript, lo que representa un objetivo fácil. El uso en el servidor ofrece un mayor nivel de seguridad. Lea este documento de mejores prácticas para la seguridad del token si desea obtener más información.
También se debe tener en cuenta la seguridad entre dominios. Las políticas de navegador sobre la seguridad entre dominios dificultan la implementación de aplicaciones AJAX. En estos ejemplos, utilizaremos la técnica de etiquetas de script dinámicas, que se describe de forma más detallada a continuación.
Por último, al realizar solicitudes de JavaScript, 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 código JavaScript. Consulte este documento de mejores prácticas en SEO con Media API.
Recomendamos el uso de un lenguaje de servidor, como PHP, Java o ColdFusion, para trabajar con Media API.
Realización de solicitudes y análisis de los resultados
La forma más fácil de realizar una solicitud HTTP entre dominios a Media API es con la estrategia de etiquetas de script dinámicas. Los navegadores no comprueban la etiqueta de script del atributo src, por lo que puede definir que el src sea una dirección URL en otro servidor, y permitir así la comunicación eficaz entre dominios. Sin embargo, al solicitar el src, el servidor debe devolver JavaScript válido. Media API permite especificar un parámetro "callback". Con este parámetro, la respuesta JSON se incluye en una llamada a función, en la que el nombre de la función es el valor del parámetro callback. Por ejemplo:
// Make a request like this: http://api.brightcove.com/services/library?queryparams&callback=response // and the response will be returned as: // response(... json data ...); // // which will invoke a function "response" that you defined in your code
Con esta estrategia, la parte más complicada de realizar una solicitud es crear la sintaxis de la llamada. Por otro lado, puesto que la respuesta se devuelve como objetos nativos de JavaScript, la parte más complicada de tratar la respuesta es analizar los resultados y mostrarlos de acuerdo con los requisitos de diseño de su sitio. La sintaxis de la API Media Read tiene el aspecto siguiente:
<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 Read de Brightcove es http://api.brightcove.com/services/post. .
A continuación…
Los documentos siguientes le guían a través de algunos ejemplos que le ayudarán a ponerse en marcha:
