Paper Contacter le support | état du système L'état du système

Player Dépôts

Dans cette rubrique, vous apprendrez comment le Player Management API utilise le Delivery System API pour stocker et maintenir des informations sur Brightcove Players.

Vue d'ensemble

Afin de publier players à un CDN, le Player Management API utilise le Delivery System API. le Delivery System API vous permet de créer un dépôt git dont le contenu est hébergé sur players.brightcove.net. Quand un player est créé, Brightcove crée un référentiel dans les coulisses. Chaque fois que le player est republié, que ce soit directement demandé par un éditeur ou lorsqu'un Brightcove player la mise à jour est publiée, il y a un commit correspondant et un push vers ce référentiel.

Les référentiels Git, entre autres, fournissent un historique des changements au fil du temps. Lors du débogage d'un player, il peut parfois être très utile d'obtenir une copie de ce référentiel afin que vous puissiez examiner l'historique des modifications vous-même. Tout d'abord, vous apprendrez à récupérer des informations générales sur votre player, en utilisant l'outil de ligne de commande curl et / ou le plugin Chrome Postman. Vous apprendrez ensuite à voir player histoire de la création et de l'édition.

Player information

Ceux qui sont à l'aise sur la ligne de commande voudront probablement utiliser curl pour obtenir player informations, tandis que ceux plus à l'aise avec une interface graphique choisiront l'option Postman.

Utilisation de curl

Si vous n'êtes pas familier avec les variables d'environnement curl et de réglage, lisez les deux premières sections du Pas à pas: Player des programmes. Assurez-vous que les variables d'environnement suivantes sont définies:

  • COURRIEL
  • IDENTIFIANT DE COMPTE
  • PLAYER_ID

Vous pouvez ensuite utiliser l'instruction curl suivante pour obtenir des informations sur votre player.

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

L'API renverra une réponse similaire à celle-ci:

      {
        "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>"
      }

Utilisation de Postman

Postman fournit une interface utilisateur plus conviviale pour interagir avec l'API. Si vous n'êtes pas familier avec Postman, lisez le Utiliser Postman pour les requêtes HTTP doc pour une compréhension de base. Vous ne créez pas de variables d'environnement lorsque vous utilisez Postman. Au lieu de cela, vous créez l'emplacement de l'URL avec les valeurs appropriées dans l'URL. Par exemple, ce qui suit montre une URL appropriée à utiliser dans Postman, contenant le compte et player ID.

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

Pour utiliser Postman, procédez comme suit:

  1. Entrez l'URL en haut du formulaire.
  2. Définissez la méthode HTTP sur ÉCONOMISEZ.
  3. Créer un en-tête en utilisant Content-Type et la valeur correspondante application / json.
  4. Cliquez Envoyer .
  5. Entrez vos informations d'identification Studio lorsque vous y êtes invité.

La réponse sera alors retournée. Pour faciliter la visualisation, assurez-vous de cliquer sur le Assez et JSON boutons juste au-dessus de la réponse.

Exemple de postier
Exemple de postier

Player Histoire

Dans cette section, vous utiliserez les commandes git. Pour un très bref tutoriel sur git, voir le Présentation de Git document.

Vous allez d'abord cloner un player repo. Un répertoire sera créé au nom du player ID, dans le répertoire où vous émettez le git clone commander.

  1. Ouvrez une invite Terminal / Commande et accédez à l'emplacement dans lequel vous souhaitez créer le dossier.
  2. Ensuite, créez une URL pour le player repo sous la forme:
          https://repos.api.brightcove.com/v1/accounts/ACCOUNT_ID/repos/PLAYER_ID_default

    Exemple:

          https://repos.api.brightcove.com/v1/accounts/1507807800001/repos/0d92f482-49d9-44e6-ba1d-e2360dab838a_default
  3. À l'invite de commandes, créez ou déplacez-vous vers un répertoire dans lequel vous souhaitez cloner le player dépôt.
  4. Une fois que vous êtes dans ce répertoire, entrez la commande git suivante pour cloner le player référentiel, en remplaçant votre propre compte et player ids:
          git clone https://repos.api.brightcove.com/v1/accounts/1507807800001/repos/0d92f482-49d9-44e6-ba1d-e2360dab838a_default
    et appuyez sur retour / Entrée.
  5. Dans la réponse, vous devriez voir quelque chose comme:
          Cloning into '0d92f482-49d9-44e6-ba1d-e2360dab838a_default'...
          remote: Counting objects: 39, done.
          remote: Compressing objects: 100% (31/31), done.
          remote: Total 39 (delta 13), reused 0 (delta 0)
          Unpacking objects: 100% (39/39), done.
          Checking connectivity... done.
  6. Sur la ligne de commande (ou dans votre gestionnaire de fichiers), localisez le cloné player pour vous assurer qu'il a été cloné à l'emplacement souhaité; il sera nommé comme suit:
          {player_id}_default
  7. Sur la ligne de commande, changez les répertoires en clonés player répertoire du référentiel que vous avez localisé à l'étape précédente.
  8. Entrez la commande:
          git log
    et appuyez sur retour / Entrée.
  9. Vous devriez voir une réponse similaire à celle-ci:
          commit b4ed1c2e3d429cc41b704fd44bebdc31f661a95c
          Author: bc86ece6-b3dd-4d78-a67d-93b503dc1c2e <mboles@brightcove.com>
          Date:   Thu Feb 26 16:29:43 2015 +0000
          
              Player publish request
          
          commit 6c854213b2b2597225c36212dc8be545fcf2c104
          Author: bc86ece6-b3dd-4d78-a67d-93b503dc1c2e <mboles@brightcove.com>
          Date:   Thu Feb 26 16:28:13 2015 +0000
          
              Player publish request
          
          commit 7f78d49cb678259351f83a94e655f88607de077f
          Author: 6b112bd1-987c-41a2-84ac-f9dd8302b567 <mboles@brightcove.com>
          Date:   Mon Feb 23 18:36:49 2015 +0000
          
              Player created
  10. Les ID de validation seront utilisés pour obtenir des informations plus détaillées. Voir Commit Information pour plus de détails.

Valider les informations

Les éléments suivants peuvent être utilisés pour recueillir différentes informations sur player s'engage. Bien sûr, vous devrez remplacer vos ID de validation particuliers, qui peuvent être obtenus auprès de player réponse historique comme indiqué dans la section précédente.

  • Afficher les détails sur une seule validation (demande de publication)
          git show e6e14ecda8e7790bf7d91e5e794507e776eef770
  • Afficher les différences entre les validations (demandes de publication)
          git diff e6e14ecda8e7790bf7d91e5e794507e776eef770 64a28431b3727d798510343caacb263c2829572d
  • Afficher les fichiers modifiés dans chaque commit
          git log --name-status

Dernière mise à jour de la page le 12 juin 2020