Introducción
Obtener todos los perfiles de ingesta para una cuenta es sencillo: es solo una simple llamada a la API. Lo que es menos sencillo es lo que haces con ellos. Si va a mostrar los perfiles a los usuarios en algún tipo de aplicación para que los seleccionen cuando estén ingiriendo videos, existen algunos problemas potenciales que debe conocer y resolver:
Hay dos tipos de perfiles de Dynamic Delivery que pueden devolverse:
- Perfiles "estáticos": del tipo ordinario con un conjunto fijo de interpretaciones.
- perfiles "dinámicos" que utilizan Codificación sensible al contexto (CAE) para determinar automáticamente el conjunto óptimo de representaciones para crear dentro de las restricciones establecidas en el perfil.
Si su organización tiene preferencia por el tipo de perfil que se utiliza, o si hay casos en los que uno puede ser preferible al otro, probablemente desee agrupar y distinguir claramente los dos tipos.
El propósito de esta muestra es mostrarle cómo recuperar los perfiles de la cuenta y filtrar los resultados para los diferentes tipos y para los perfiles personalizados que se han creado en la cuenta.
Obtener credenciales
Para utilizar la API de Ingest Profiles, necesitará las credenciales adecuadas.
La forma más sencilla de obtener credenciales en la mayoría de los casos es a través de la sección Autenticación de API de administración de Studio (requiere permisos de administrador en tu cuenta). Consulte Administración de credenciales de autenticación de API para obtener más información. En la mayoría de los casos, probablemente solo desee obtener permisos para todas las operaciones de la API de perfiles de ingesta:
Si los permisos que necesita no están disponibles en Studio, o si prefiere obtenerlos directamente de la API de OAuth, utilice su elección de Obtener credenciales de cliente documentos que se enumeran a continuación. Sea cual sea la opción que elija, tendrá que solicitar los permisos de operación correctos. Lo siguiente se puede usar con cURL o Postman para obtener todos los permisos para la API de Ingest Profiles:
"operations": [
"video-cloud/ingest-profiles/profile/read",
"video-cloud/ingest-profiles/profile/write",
"video-cloud/ingest-profiles/account/read",
"video-cloud/ingest-profiles/account/write"
]
La aplicación
Código fuente
Encuentra todo el código asociado a este ejemplo en este repositorio de GitHub.
Aplicación de muestra
Ver la pluma Ejemplo de API de perfiles de ingesta: Obtener todos los perfiles de una cuenta por los servicios de aprendizaje de Brightcove (@rcrooks1969 ) en CódigoPen.
Uso de CodePen
Estos son algunos consejos para utilizar eficazmente el CodePen anterior:
- Cambie la visualización real del reproductor haciendo clic en el Resultado botón.
- Haga clic en el HTML / CSS / JS botones para mostrar UNO de los tipos de código.
- Hacer clic Editar en CodePen en la esquina superior derecha para bifurcar este CodePen en su propia cuenta.
- Encuentra todo el código asociado a este ejemplo en este repositorio de GitHub.
Código proxy
Para crear su propia versión de la aplicación de muestra en esta página, debe crear y alojar su propio proxy. (Los proxies utilizados por Brightcove Learning Services solo aceptan solicitudes de dominios de Brightcove.) Un proxy de ejemplo, muy similar al que usamos, pero sin las comprobaciones que bloquean solicitudes de dominios que no son de BrightCove, se puede encontrar en este repositorio de GitHub. También encontrará instrucciones básicas para utilizarlo allí y una guía más elaborada para crear aplicaciones alrededor del proxy en Uso de las API REST.