Introduction
Dans la plupart des cas, le Profils d'acquisition standard devrait bien fonctionner pour vos vidéos. Au cas où vous auriez besoin de créer un profil personnalisé, cet exemple vous permet de le faire à l'aide de l'API Ingest Profiles.
Cet exemple vous montre comment utiliser l'API Ingest Profiles à partir d'une application Web. Étant donné que les API Brightcove ne sont pas compatibles CORS et que les demandes doivent être effectuées du côté serveur, l'application envoie les informations nécessaires à un proxy, qui effectue ensuite la demande d'API et renvoie la réponse au client. Le proxy ici est écrit en PHP, mais n'importe quel langage côté serveur fera l'affaire. Il vous suffit de pouvoir envoyer une requête POST à l'application via Internet.
Obtenir des informations
Pour utiliser le CMS API vous aurez besoin des informations d'identification appropriées.
Dans la plupart des cas, le moyen le plus simple d'obtenir des informations d'identification consiste à utiliser la section Authentification de l'API Studio Admin (nécessite des autorisations d'administrateur sur votre compte). Voir Gestion des informations d'identification d'authentification API pour plus de détails. Dans la plupart des cas, vous souhaitez probablement simplement obtenir des autorisations pour toutes les opérations de l'API Ingest Profiles :
Si les autorisations dont vous avez besoin ne sont pas disponibles dans Studio, ou si vous préférez les obtenir directement à partir de l'API OAuth, utilisez votre choix de Obtenir les informations d'identification du client documents énumérés ci-dessous. Quelle que soit l'option que vous choisissez, vous devrez demander les autorisations d'opération correctes. Les éléments suivants peuvent être utilisés avec cURL ou Postman pour obtenir toutes les autorisations pour l'API Ingest Profiles :
"operations": [
"video-cloud/ingest-profiles/profile/read",
"video-cloud/ingest-profiles/profile/write",
"video-cloud/ingest-profiles/account/read",
"video-cloud/ingest-profiles/account/write"
]
Créer une application de profil d'ingestion
Code source
Retrouvez tout le code associé à cet exemple dans ce référentiel GitHub.
Exemple d'application
Notez que les rendus avec « progressif » dans le nom sont des rendus MP4 qui peuvent être téléchargés, mais ne sont généralement pas utilisés pour la lecture dans Brightcove Player. Pour plus d'informations , consultez la section MP4 dans Dynamic Delivery. Tous les profils doivent inclure au moins une version Dynamic Delivery, faute de quoi le traitement des vidéos associées à ce profil échouera.
Voir le stylo Exemple d'API de profils d'ingestion : Créez un profil de diffusion dynamique personnalisé par Brightcove Learning Services (@rcrooks1969) sur CodePen.
Utilisation du CodePen
Voici quelques conseils pour utiliser efficacement le CodePen ci-dessus :
- Basculez l'affichage réel du lecteur en cliquant sur le bouton Résultat bouton.
- Clique le HTML/CSS/JS pour afficher UN des types de code.
- Cliquez sur Modifier sur CodePen dans le coin supérieur droit pour insérer ce CodePen dans votre propre compte.
- Retrouvez tout le code associé à cet exemple dans ce référentiel GitHub.
Code proxy
Afin de créer votre propre version de l'exemple d'application sur cette page, vous devez créer et héberger votre propre proxy. (Les proxy utilisés par Brightcove Learning Services n'acceptent que les demandes des domaines Brightcove.) Un exemple de proxy, très similaire à celui que nous utilisons, mais sans les contrôles qui bloquent les demandes provenant de domaines non-BrightCove, peut être trouvé dans ce dépôt GitHub. Vous y trouverez également des instructions de base pour l'utiliser, ainsi qu'un guide plus détaillé sur la création d'applications autour du proxy dans Utilisation des API REST.