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ée, qu'elle soit directement demandée 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 technique
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 Direction. Assurez-vous que les variables d'environnement suivantes sont définies:
- 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 Envoyez .
- 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
- 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
- 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