Paper Contacter le support | état du système L'état du système
Contenu de la page

    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 Envoyez .
    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