Player Dépôts

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:

Entrez l'URL en haut du formulaire.
Définissez la méthode HTTP sur ÉCONOMISEZ.
Créer un en-tête en utilisant Content-Type et la valeur correspondante application / json.
Cliquez Envoyer .
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.

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.

Ouvrez une invite Terminal / Commande et accédez à l'emplacement dans lequel vous souhaitez créer le dossier.

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

À l'invite de commandes, créez ou déplacez-vous vers un répertoire dans lequel vous souhaitez cloner le player dépôt.
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.

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.

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
```
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.
Entrez la commande:
```
      git log
```
et appuyez sur retour / Entrée.

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

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
```