soporte Contactar con Soporte | Estadoestado del sistema del sistema
Contenido de la página

    Repositorios de reproductores

    En este tema, aprenderá cómo la API de administración de jugadores utiliza la API de Delivery System para almacenar y mantener información sobre Brightcove Players.

    Resumen

    Para publicar reproductores en una CDN, la API de administración de reproductores utiliza la API del sistema de entrega. La API del sistema de entrega le permite crear un repositorio git, cuyo contenido se hospeda en players.brightcove.net. Cuando se crea un reproductor, Brightcove crea un repositorio entre bastidores. Cada vez que se vuelve a publicar el reproductor, ya sea directamente solicitado por un editor o cuando se publica una actualización del reproductor de Brightcove, hay una confirmación correspondiente y una inserción en ese repositorio.

    Los repositorios de Git, entre otras cosas, proporcionan un historial de cambios a lo largo del tiempo. Al depurar un reproductor, a veces puede ser muy útil obtener una copia de este repositorio para que pueda examinar el historial de cambios usted mismo. En primer lugar, aprenderá cómo recuperar información general sobre su reproductor, utilizando la herramienta de línea de comandos curl y/o el plugin Chrome Postman. A continuación, aprenderá a ver el historial de reproductores para su creación y publicación.

    Información del jugador

    Los que estén cómodos en la línea de comandos probablemente quieran usar curl para obtener información del jugador, mientras que aquellos más cómodos con una GUI elegirán la opción Cartero.

    Usar curl

    Si no está familiarizado con curl y establecer variables de entorno, lea las dos primeras secciones del paso a paso: Gestión de Jugadores. Asegúrese de que se han establecido las siguientes variables de entorno:

    • CORREO
    • ID_CUENTA
    • ID_PLAYER_

    A continuación, puede utilizar la siguiente declaración curl para obtener información sobre su jugador.

          curl \
            --header "Content-Type: application/json" \
            --user $EMAIL \
            --request GET \
            https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/embeds/default

    La API devolverá una respuesta similar a la siguiente:

          {
            "branches": {
              "master": {
                "video_cloud": true,
                "updated_at": "2015-02-23T18:36:39.323Z"
              },
              "preview": {
                "video_cloud": true,
                "updated_at": "2015-02-23T18:36:39.323Z"
              }
            },
            "publish_request": {
              "comment": "Player publish request",
              "author": "mboles@brightcove.com",
              "status": "COMPLETE",
              "requested_at": "2015-02-26T16:29:33.207Z",
              "queue_msg_id": "33533986-10d3-4585-8dcd-7ea52f3d2879",
              "errorCode": null,
              "errorMessage": null,
              "buildLog": "http://players.brightcove.net/1507807800001/0d92f482-49d9-44e6-ba1d-e2360dab838a_default/logs/33533986-10d3-4585-8dcd-7ea52f3d2879.log",
              "retries": 0,
              "elapsed_time": 12
            },
            "name": "MySamplePlayer",
            "id": "default",
            "url": "http://players.brightcove.net/1507807800001/0d92f482-49d9-44e6-ba1d-e2360dab838a_default/index.html",
            "embed_code": "<iframe src='//players.brightcove.net/1507807800001/0d92f482-49d9-44e6-ba1d-e2360dab838a_default/index.html' allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>",
            "embed_in_page": "http://players.brightcove.net/1507807800001/0d92f482-49d9-44e6-ba1d-e2360dab838a_default/in_page.embed",
            "repository_url": "https://repos.api.brightcove.com/v1/accounts/1507807800001/repos/0d92f482-49d9-44e6-ba1d-e2360dab838a_default",
            "preview_url": "http://preview-players.brightcove.net/v1/accounts/1507807800001/players/0d92f482-49d9-44e6-ba1d-e2360dab838a/master/embeds/default/preview/index.html",
            "preview_embed_code": "<iframe src='//preview-players.brightcove.net/v1/accounts/1507807800001/players/0d92f482-49d9-44e6-ba1d-e2360dab838a/master/embeds/default/preview/index.html' allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>"
          }

    Uso de Postman

    Postman proporciona una interfaz de usuario más amigable para interactuar con la API. Si no está familiarizado con Postman, lea el documento Usar Cartero para solicitudes HTTP para obtener una comprensión básica. No se crean variables de entorno cuando se utiliza Postman. En su lugar, crea la ubicación URL con los valores apropiados en la URL. Por ejemplo, a continuación se muestra una URL adecuada para su uso en Postman, que contiene la cuenta y el ID de jugador.

          https://players.api.brightcove.com/v2/accounts/1507807800001/players/6aac508a-741e-41a2-bc7a-5805644cf089/embeds/default

    Para utilizar Postman, realice lo siguiente:

    1. Introduzca la dirección URL en la parte superior del formulario.
    2. Establezca el método HTTP en GET.
    3. Cree un encabezado utilizando Content-Type y el valor correspondiente application/json.
    4. Haga clic en el botón Enviar .
    5. Introduzca sus credenciales de Studio cuando se le solicite.

    A continuación, se devolverá la respuesta. Para facilitar la visualización, asegúrese de hacer clic en los botones Pretty y JSON justo encima de la respuesta.

    Ejemplo de Cartero
    Ejemplo de Cartero

    Historial del jugador

    En esta sección va a utilizar comandos git. Para obtener un tutorial muy breve sobre git, consulte el documento Overview de Git .

    Primero clonar un repositorio de jugador. Se creará un directorio con el nombre del ID del reproductor, en el directorio donde emita el git clone comando.

    1. Abra una Terminal/símbolo del sistema y desplácese hasta la ubicación en la que desee crear la carpeta.
    2. A continuación, cree una URL para el repositorio del reproductor en el formulario:
            https://repos.api.brightcove.com/v1/accounts/ACCOUNT_ID/repos/PLAYER_ID_default

      Ejemplo:

            https://repos.api.brightcove.com/v1/accounts/1507807800001/repos/0d92f482-49d9-44e6-ba1d-e2360dab838a_default
    3. En el símbolo del sistema, cree o muévase a un directorio en el que desee clonar el repositorio del reproductor.
    4. Una vez que esté en ese directorio, ingrese el siguiente comando git para clonar el repositorio del jugador, sustituyendo su propia cuenta y sus ID de jugador:
            git clon https://repos.api.brightcove.com/v1/accounts/1507807800001/repos/0d92f482-49d9-44e6-ba1d-e2360dab838a_default
      y presione Return/Enter.
    5. En la respuesta, debería ver algo como lo siguiente:
            Clonación en '0d92f482-49d9-44e6-ba1d-e2360dab838a_default'...
            remoto: Recuento de objetos: 39, hecho.
            remoto: Compresión de objetos: 100% (31/31), hecho.
            remoto: Total 39 (delta 13), reutilizado 0 (delta 0)
            Desempaquetar objetos: 100% (39/39), hecho.
            Comprobando conectividad... hecho.
    6. En la línea de comandos (o en el administrador de archivos), localice el directorio del reproductor clonado para asegurarse de que fue clonado en la ubicación deseada; se nombrará de la siguiente manera:
            {player_id}_default
    7. En la línea de comandos, cambie los directorios al directorio del repositorio del reproductor clonado que localizó en el paso anterior.
    8. Introduzca el comando:
            git log
      y presione Return/Enter.
    9. Debería ver una respuesta similar a la siguiente:
            comprometer b4ed1c2e3d429cc41b704fd44bebdc31f661a95c
            Autor: bc86ece6-b3dd-4d78-a67d-93b503dc1c2e < mboles@brightcove.com >
            Fecha:   jue Feb 26 16:29:43 2015 +0000
            
                Solicitud de publicación del reproductor
            
            commit 6c854213b2b2597225c36212dc8be545fcf2c104
            Autor: bc86ece6-b3dd-4d78-a67d-93b503dc1c2e < mboles@brightcove.com >
            Fecha:   jue Feb 26 16:28:13 2015 +0000
            
                Solicitud de publicación del reproductor
            
            commit 7f78d49cb678259351f83a94e655f88607de077f
            Autor: 6b112bd1-987c-41a2-84ac-f9dd8302b567 < mboles@brightcove.com >
            Fecha:   Lun Feb 23 18:36:49 2015 +0000
            
                Jugador creado
    10. Los ID de confirmación se utilizarán para obtener información más detallada. Consulte Información de confirmación para obtener más detalles.

    Información de confirmación

    Lo siguiente se puede utilizar para recopilar información diferente sobre las confirmaciones del jugador. Por supuesto, tendrá que sustituir sus identificadores de confirmación particulares, que se pueden obtener de la respuesta del historial del jugador como se muestra en la sección anterior.

    • Mostrar detalles sobre una única confirmación (solicitud de publicación)
            git show e6e14ecda8e7790bf7d91e5e794507e776eef770
    • Mostrar diferencias entre confirmaciones (solicitudes de publicación)
            git diff e6e14ecda8e7790bf7d91e5e794507e776eef770 64a28431b3727d798510343caacb263c2829572d
    • Mostrar qué archivos cambiaron en cada confirmación
            git log —nombre-status

    Última actualización de la página el 29-09-2020